Files
obsidian-vault/family/how-to/hulynet-rasputin.md
T

15 KiB
Raw Blame History

title, created, updated, tags
title created updated tags
HulyNet на TrueNAS как резервный выход Rasputin 2026-11-17 2026-11-17
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.

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 · personal/tech/xray-reverse-tunnel-kraken-truenas

1. Подготовить SOCKS на TrueNAS

В SSH-сеансе на TrueNAS проверить, что клиент подключён, DNS смотрит на TUN и маршрут к публичному IPv4 идёт через hulyscale0:

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

Собрать отдельный образ. Команды выполняются при подготовке резервного выхода в будущем:

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: в них лежит действующая регистрация. Сохранение может перезапустить приложение.

  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 · MicroSocks

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, поскольку он менялся.

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 </dev/null

Для автозапуска на Rasputin создать отдельный ключ. Публичную часть добавить на TrueNAS отдельному непривилегированному SSH-пользователю huly-ssh без групп docker и администраторов. Аккаунту нужны постоянный домашний каталог, вход по ключу и разрешённый ssh -L. На действующем админском аккаунте ключ не добавлять.

umask 077
test -f /etc/dropbear/hulynet_ed25519 || \
  dropbearkey -t ed25519 -f /etc/dropbear/hulynet_ed25519
dropbearkey -y -f /etc/dropbear/hulynet_ed25519 | sed -n '/^ssh-ed25519 /p'

В authorized_keys пользователя huly-ssh записать публичный ключ с ограничениями на одной строке. Подставить свежий HULY_IP:

restrict,port-forwarding,permitopen="172.16.20.2:11080",command="/usr/bin/false" ssh-ed25519 <публичный-ключ-Rasputin>

На 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 · Настройки OpenSSH

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 · Dropbear dbclient

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:

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:

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:

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.

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 </dev/null

mv "$tun.hulynet-new" "$tun"
mv "$dns.hulynet-new" "$dns"
/etc/init.d/tunvpn restart
/etc/init.d/clientdns restart
ip rule show
ip route show table vpn
ps w | grep '[b]advpn-tun2socks'

Схема после переключения: table vpn по-прежнему указывает на tun0, процесс tun2socks использует порт 11080. С LAN-клиента выполнить запросы ниже. Проверка для rasputin.lan подтверждает, что локальный DNS сохранён. При запросе HTTPS на TrueNAS должны расти счётчики TUN:

# На LAN-клиенте
dig @192.168.6.1 hulynet.nothing.md A
dig +tcp @192.168.6.1 hulynet.nothing.md A
dig @192.168.6.1 rasputin.lan A
curl -4fsS --max-time 20 https://hulynet.nothing.md/VERSION

# На TrueNAS, до и после запросов с LAN-клиента
docker exec ix-hulynet-hulynet-1 ip -s link show hulyscale0

У клиента новый внешний DNS идёт через HulyNet к прежнему DNS-провайдеру из clientdns. Запросы через SOCKS с передачей имени разрешаются на стороне TrueNAS через systemd-resolved HulyNet. Обычная проверка curl с самого Rasputin без SOCKS проверяет WAN роутера, поскольку policy routing для tun0 применяется к входящему трафику br-lan.

4. Вернуть Xray

Подставить точный каталог, показанный в шаге переключения. Скопировать только два изменённых файла и перезапустить эти службы. После проверки отката можно остановить отдельный SSH-проброс. Восстановление TrueNAS YAML требуется только для удаления SOCKS; сам HulyNet может продолжать работать.

set -eu
backup=/root/hulynet-before-ГГГГММДД-ЧЧММСС
test -s "$backup/tunvpn"
test -s "$backup/clientdns-xray.json"
cp -p "$backup/tunvpn" /etc/init.d/tunvpn
cp -p "$backup/clientdns-xray.json" /etc/clientdns/xray.json
/etc/init.d/tunvpn restart
/etc/init.d/clientdns restart
curl -fsS --max-time 15 --socks5-hostname 127.0.0.1:1080 \
  https://hulynet.nothing.md/VERSION
/etc/init.d/hulynet-ssh stop
/etc/init.d/hulynet-ssh disable

После отката повторить DNS и HTTPS с LAN-клиента. Эти команды переключения и отката подготовлены по сохранённым конфигурациям и требуют первой проверки на живом Rasputin.