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

253 lines
15 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
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 </dev/null
```
Для автозапуска на Rasputin создать отдельный ключ. Публичную часть добавить на TrueNAS отдельному непривилегированному SSH-пользователю `huly-ssh` без групп `docker` и администраторов. Аккаунту нужны постоянный домашний каталог, вход по ключу и разрешённый `ssh -L`. На действующем админском аккаунте ключ не добавлять.
```sh
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`:
```text
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](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 </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:
```sh
# На 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 может продолжать работать.
```sh
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.