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