diff --git a/family/how-to/hulynet-rasputin.md b/family/how-to/hulynet-rasputin.md new file mode 100644 index 00000000..8f3f4ffb --- /dev/null +++ b/family/how-to/hulynet-rasputin.md @@ -0,0 +1,252 @@ +--- +title: HulyNet на TrueNAS как резервный выход Rasputin +created: '2026-11-17' +updated: '2026-11-17' +tags: + - hulynet + - truenas + - rasputin + - openwrt +--- + +# HulyNet на TrueNAS как резервный выход Rasputin + +На TrueNAS `192.168.2.197` уже работает `ix-hulynet-hulynet-1`. Проверены IPv4-маршрут, DNS и HTTPS через `hulyscale0`. SOCKS-вход и переключение Rasputin пока не развёрнуты. При проверке 17.11.2026 SSH к LAN-адресу Rasputin `192.168.6.1` был недоступен с текущей точки входа. Перед переключением выполнить команды со стороны его LAN. + +```text +LAN Rasputin → tun0 → badvpn-tun2socks → 127.0.0.1:11080 (SSH -L) + → TrueNAS SSH → SOCKS5 в сетевом пространстве hulynet → HulyNet +``` + +Меняются выход клиентского TCP и внешний upstream действующего `clientdns`. Основной Xray с VLESS остаётся запущен для возврата на `127.0.0.1:1080`. DNS-процесс службы `clientdns` продолжает обслуживать клиентов, его исходящие запросы идут через новый SOCKS. Локальные DNS-имена и существующие прямые исключения Rasputin сохраняются. Этот способ рассчитан на TCP и текущую схему клиентского DNS. Транзит произвольного UDP и сквозной IPv6 этой схемой не проверены. Reverse-канал Kraken для входящего доступа управляется отдельно. [[family/how-to/rasputin-router|Rasputin]] · [[personal/tech/xray-reverse-tunnel-kraken-truenas|Reverse-туннель Xray]] + +## 1. Подготовить SOCKS на TrueNAS + +В SSH-сеансе на TrueNAS проверить, что клиент подключён, DNS смотрит на TUN и маршрут к публичному IPv4 идёт через `hulyscale0`: + +```sh +docker exec ix-hulynet-hulynet-1 hulyscale status +docker exec ix-hulynet-hulynet-1 resolvectl query -4 hulynet.nothing.md +docker exec ix-hulynet-hulynet-1 ip -4 route get 1.1.1.1 +``` + +Собрать отдельный образ. Команды выполняются при подготовке резервного выхода в будущем: + +```sh +docker build -t local/hulynet-socks:1 - <<'DOCKERFILE' +FROM debian:13-slim +RUN apt-get update \ + && apt-get install -y --no-install-recommends iproute2 microsocks \ + && rm -rf /var/lib/apt/lists/* +DOCKERFILE +``` + +В TrueNAS **Apps → hulynet → Edit** сохранить копию текущего YAML. Добавить `socks` внутрь существующего `services`, на одном уровне с `hulynet`. Оставить текущие тома `config` и `identity`: в них лежит действующая регистрация. Сохранение может перезапустить приложение. + +```yaml + socks: + image: local/hulynet-socks:1 + pull_policy: never + network_mode: service:hulynet + restart: unless-stopped + user: '65534:65534' + cap_drop: [ALL] + security_opt: [no-new-privileges:true] + entrypoint: + - /bin/sh + - -ec + - | + while :; do + if ip -4 route get 1.1.1.1 | grep -q ' dev hulyscale0 ' && + grep -Eq '^nameserver[[:space:]]+127\.0\.0\.53$$' /etc/resolv.conf; then + vpn_ip=$$(ip -o -4 addr show dev hulyscale0 | awk 'NR == 1 {sub(/\/.*/, "", $$4); print $$4}') + if [ -n "$$vpn_ip" ]; then + exec microsocks -i 0.0.0.0 -p 11080 -b "$$vpn_ip" + fi + fi + sleep 2 + done +``` + +`socks` использует сеть контейнера `hulynet`. У сервиса нет `ports`, соединение принимает SSH-сервер NAS и перенаправляет его на внутренний IPv4 контейнера. MicroSocks слушает TCP и привязывает исходящие сокеты к IPv4 TUN. [Compose network mode](https://docs.docker.com/reference/compose-file/services/#network_mode) · [MicroSocks](https://github.com/rofl0r/microsocks) + +```sh +HULY_IP=$(docker inspect ix-hulynet-hulynet-1 \ + --format '{{(index .NetworkSettings.Networks "ix-hulynet_default").IPAddress}}') +printf 'HULY_IP=%s\n' "$HULY_IP" +docker exec ix-hulynet-socks-1 cat /etc/resolv.conf +docker exec ix-hulynet-hulynet-1 ss -lnt '( sport = :11080 )' +docker ps --filter label=com.docker.compose.project=ix-hulynet --format '{{.Names}} {{.Ports}}' +``` + +На 17.11.2026 внутренний адрес был `172.16.20.2`. После пересоздания контейнера снова снять `HULY_IP`; при смене адреса обновить `permitopen` на NAS и назначение `-L` на Rasputin. SOCKS должен слушать внутри контейнера, у TrueNAS не должно быть публикации порта `11080`. + +## 2. Поднять SSH-проброс с Rasputin + +Войти на Rasputin из его LAN по `ssh root@192.168.6.1`. Проверить доступность NAS и наличие команд. WAN-адрес на роутере определить по `ip route get`, поскольку он менялся. + +```sh +ip -4 route get 192.168.2.197 +command -v dbclient +command -v dropbearkey +command -v curl +nc -w 3 192.168.2.197 22 +``` + +На 17.11.2026 глобальная настройка TrueNAS — `AllowTcpForwarding no`. Сохранить её. Для `huly-ssh` добавить исключение в **System → Services → SSH → Advanced Options → Auxiliary Parameters**. Перед сохранением проверить временную копию `/etc/ssh/sshd_config` с добавленным блоком через `sudo sshd -t -f <копия>` и держать открытым локальный доступ к NAS на время применения. [SSH в TrueNAS 24.10](https://www.truenas.com/docs/scale/24.10/printview/scaleuireference/#ssh-service-screen) · [Настройки OpenSSH](https://man.openbsd.org/sshd_config) + +```sshconfig +Match User huly-ssh + AllowTcpForwarding local + PasswordAuthentication no + KbdInteractiveAuthentication no +Match all +``` + +После применения проверить, что для `huly-ssh` выводится `allowtcpforwarding local`, а для обычного администратора — `allowtcpforwarding no`. В `addr` подставить адрес, с которого NAS видит Rasputin. При первом соединении сверить отпечаток SSH-ключа NAS по `ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub` на NAS. [OpenSSH authorized_keys](https://man.openbsd.org/sshd#AUTHORIZED_KEYS_FILE_FORMAT) · [Dropbear dbclient](https://manpages.debian.org/trixie/dropbear-bin/dbclient.1.en.html) + +```sh +RAS_IP=192.168.2.157 # пример; сначала проверить фактический адрес +for user in huly-ssh truenas_admin; do + sudo sshd -T -C "user=$user,host=rasputin,addr=$RAS_IP" | grep '^allowtcpforwarding ' +done +``` + +Проверить проброс в отдельном сеансе Rasputin. Подставить свежий `HULY_IP`: + +```sh +HULY_IP=172.16.20.2 +dbclient -N -K 20 -o ExitOnForwardFailure=yes \ + -i /etc/dropbear/hulynet_ed25519 \ + -L "127.0.0.1:11080:${HULY_IP}:11080" huly-ssh@192.168.2.197 +``` + +Во втором сеансе Rasputin: + +```sh +curl -fsS --max-time 15 --socks5-hostname 127.0.0.1:11080 \ + https://hulynet.nothing.md/VERSION +``` + +До изменения маршрута LAN этот запрос должен вернуть версию релиза. Для одного приложения достаточно того же SSH-проброса с его машины и SOCKS5 `127.0.0.1:11080` с разрешением имён через прокси, используя собственный разрешённый SSH-ключ. + +Если резервный выход должен переживать разрыв SSH или перезагрузку Rasputin, остановить пробный `dbclient` через Ctrl-C и создать сервис OpenWrt. Вставить текущий `HULY_IP`: + +```sh +cat > /etc/init.d/hulynet-ssh <<'RC' +#!/bin/sh /etc/rc.common +START=94 +STOP=11 +USE_PROCD=1 + +start_service() { + local dbclient + dbclient=$(command -v dbclient) || return 1 + procd_open_instance + procd_set_param env HOME=/root + procd_set_param command "$dbclient" -N -K 20 -o ExitOnForwardFailure=yes \ + -i /etc/dropbear/hulynet_ed25519 \ + -L 127.0.0.1:11080:172.16.20.2:11080 huly-ssh@192.168.2.197 + procd_set_param respawn 3600 5 0 + procd_close_instance +} +RC +chmod 0755 /etc/init.d/hulynet-ssh +/etc/init.d/hulynet-ssh start +/etc/init.d/hulynet-ssh enable +curl -fsS --max-time 15 --socks5-hostname 127.0.0.1:11080 \ + https://hulynet.nothing.md/VERSION +``` + +## 3. Переключить Rasputin с VLESS на HulyNet + +Выполнять по LAN через SSH. Сначала должен пройти предыдущий `curl` через SOCKS. Для трансформации JSON нужен `jq` на Rasputin (`opkg update && opkg install jq`, если отсутствует). Сохраняются два файла для точечного отката. Не перезапускать весь `network` или firewall. + +```sh +set -eu +curl -fsS --max-time 15 --socks5-hostname 127.0.0.1:11080 \ + https://hulynet.nothing.md/VERSION >/dev/null +command -v jq >/dev/null +tun=/etc/init.d/tunvpn +dns=/etc/clientdns/xray.json +backup=/root/hulynet-before-$(date +%Y%m%d-%H%M%S) +umask 077 +mkdir "$backup" +cp -p "$tun" "$backup/tunvpn" +cp -p "$dns" "$backup/clientdns-xray.json" +printf 'Откат из %s\n' "$backup" + +test "$(grep -Fc -- '--socks-server-addr 127.0.0.1:1080' "$tun")" -eq 1 +cp -p "$tun" "$tun.hulynet-new" +sed 's/--socks-server-addr 127\.0\.0\.1:1080/--socks-server-addr 127.0.0.1:11080/' \ + "$backup/tunvpn" > "$tun.hulynet-new" +cp -p "$dns" "$dns.hulynet-new" +jq -e ' + def target: .tag == "tunnel" and .protocol == "socks" and + (.settings.servers | length == 1 and .[0].address == "127.0.0.1" and .[0].port == 1080); + if ([.outbounds[] | select(target)] | length) == 1 then + .outbounds |= map(if target then .settings.servers[0].port = 11080 else . end) + else error("clientdns upstream differs from documented layout") end +' "$backup/clientdns-xray.json" > "$dns.hulynet-new" +sh -n "$tun.hulynet-new" +/usr/bin/xray run -test -config "$dns.hulynet-new" -format json