Сервис на домашнем сервере в России работает, а в его логе раз за разом одно и то же. OpenRouter, через который он спрашивает языковую модель, отвечает 403 Access denied by security policy. Запрос к Telegram API вообще не возвращается и висит до таймаута. Код исправен: обоим сервисам не нравится адрес, с которого пришёл запрос.
В уроке про ingress и egress ты видел ответ на это — egress-прокси, одна дверь наружу, через которую сервисы выходят с чужого адреса. В этом гайде ты построишь такую дверь сам, от аренды машины до подключения сервиса. Ровно так устроен выход и у самого курса: стек egress из репозитория DevOps/egress, по которому написан этот текст. Сразу оговорка: это маршрутизация трафика своих сервисов, правила работодателя и законы о прокси она не отменяет.
Что строим и почему так
Начнём с картины целиком, чтобы каждый следующий шаг ложился на своё место. Сервисы на домашнем сервере отдают запросы не в интернет, а маленькому контейнеру-туннелю. Тот держит одно ssh-соединение до арендованного сервера за рубежом, и уже оттуда запрос уходит к сайту.
VDS (virtual dedicated server) — виртуальная машина у хостинг-провайдера, которую сдают в аренду помесячно. Самое интересное в схеме — что на ней ничего нет. Ssh-сервер там стоит с завода, а умение пробрасывать через себя соединения у него встроенное. Мы не ставим на VDS ни одной программы и не открываем ни одного нового порта.
Это не мелочь. Открытый прокси без пароля находят сканеры за часы, и через него начинают ходить чужие люди: рассылать спам, перебирать пароли. Жалобы придут провайдеру на твой адрес. Вот как выглядят три способа, которыми обычно делают такую дверь.
| способ | плюсы | минусы |
|---|---|---|
| ssh -D, туннель с домашнего сервера | на VDS ничего не ставится, новых портов нет, вход только по ключу | только TCP; программам без SOCKS нужен переходник privoxy |
| свой Squid или 3proxy с паролем | обычный HTTP-прокси, его понимает любой клиент | ставить и обновлять на VDS, порт открыт всему интернету, пароль легко перебирают |
| WireGuard | быстрый, умеет UDP, заворачивает весь трафик машины | ставится на обе стороны, нужен открытый UDP-порт, в части российских сетей его соединения режут |
Прочитаем первую строку. SOCKS — простой протокол посредника: клиент говорит «соедини меня с вот этим адресом», посредник соединяет и дальше молча передаёт байты. Ssh умеет быть таким посредником сам. Нам не нужен UDP, нам нужны HTTPS-запросы к двум-трём API, поэтому выбираем первый способ.
Строить начнём с другого конца — с машины за рубежом.
VDS
Подойдёт любой провайдер, у которого площадка не в России: Нидерланды, Финляндия, Германия. Хватит минимального тарифа — одно ядро и 512 МБ памяти: ssh-сессия почти ничего не потребляет. Систему при заказе выбери Ubuntu 24.04. Провайдер пришлёт адрес и пароль от root либо попросит твой публичный ключ — как входить по ключу, ты знаешь из урока про SSH.
Адрес 203.0.113.10 здесь и дальше — пример, подставляй адрес своего VDS. Первым делом зайди на машину и проверь, какой страной её видит интернет.
curl -s https://ipinfo.io/country NL
Сервис ipinfo.io отвечает двумя буквами — кодом страны, откуда пришёл запрос. Флаг -s убирает у curl полосу загрузки. Ждёшь что угодно, кроме RU. Бывает, что провайдер продаёт «европейский» адрес, а базы геолокации всё равно считают его российским — тогда сайты тоже будут так считать, и такой VDS не годится.
Машина есть, теперь нужен ключ, которым туннель будет на неё входить.
Ключ только для туннеля
Своим личным ключом туннель пользоваться не должен. Ключ будет лежать на домашнем сервере рядом с контейнером, и если его когда-нибудь утащат, утащат только право гонять трафик, а не вход на VDS.
Шаг 1. Каталог стека и ключ
Всё, что относится к туннелю, живёт в одном каталоге — стеке: там будут compose-файл, сборка образа и секреты. Создай его на домашнем сервере и перейди внутрь.
mkdir -p ~/egress/secrets ~/egress/tunnel cd ~/egress
Теперь ключ. Флаг -t ed25519 выбирает современный тип ключа, -f — куда положить файл, -N "" — пустая фраза-пароль: туннель запускается сам, и вводить пароль будет некому.
ssh-keygen -t ed25519 -f secrets/id_ed25519 -N "" Generating public/private ed25519 key pair. Your identification has been saved in secrets/id_ed25519 Your public key has been saved in secrets/id_ed25519.pub …
Появились два файла. id_ed25519 — закрытая половина, она никуда не уходит. id_ed25519.pub — открытая, её отдают VDS. Посмотри открытую:
cat secrets/id_ed25519.pub ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI… anton@lenovo
Строка из трёх частей: тип ключа, сам ключ и комментарий, по которому потом понятно, чей он. Скопируй её целиком.
Шаг 2. Ключ на VDS с ограничениями
На VDS открой файл ~/.ssh/authorized_keys — список ключей, которым разрешён вход. Там уже есть строка с твоим личным ключом: её не трогай, иначе сам потеряешь доступ. Новую строку добавь в конец, а перед ключом допиши ограничения.
restrict,port-forwarding,command="/bin/false" ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI… anton@lenovoСлова через запятую до пробела — опции ключа, ssh-сервер применяет их к каждому входу этим ключом.
Почему это безопасно: даже с украденным ключом нельзя ни открыть терминал, ни выполнить команду, ни что-то поменять на VDS. Можно только то, ради чего ключ заведён. В репозитории egress строка записана без command=: restrict и так не даёт терминала, но команду без терминала ssh-сервер всё ещё выполнит. Третья опция закрывает и это.
Шаг 3. Проверка: шелла быть не должно
Проверим, что ограничения работают. С домашнего сервера попробуй войти новым ключом как обычно; флаг -i говорит, каким ключом входить.
ssh -i secrets/id_ed25519 root@203.0.113.10 PTY allocation request failed on channel 0
PTY — терминал, без которого нет приглашения командной строки. Сервер отказал в нём, и соединение тут же закрылось: приглашения root@…# ты не увидишь. Это и есть правильный результат. Если вдруг ты попал в обычный шелл — ssh-сервер не видит опций, и чаще всего строка записана не тому пользователю или с опечаткой.
При первом входе ssh спросит Are you sure you want to continue connecting (yes/no/[fingerprint])?. Ответь yes, а что это был за вопрос и почему контейнер не сможет на него ответить, разберём дальше.
known_hosts
При первом входе на незнакомую машину ssh показывает её отпечаток — короткую сводку ключа самого сервера — и спрашивает, тот ли это сервер. Ответ записывается в файл known_hosts, и в следующий раз ssh сверяет отпечаток молча. Так ssh защищает от подмены: если кто-то встанет между тобой и VDS, отпечаток не совпадёт.
Контейнер на вопрос ответить не сможет, его некому задать. Поэтому записываем отпечаток заранее, руками.
Шаг 4. Снять отпечаток
Программа ssh-keyscan стучится на ssh-порт и печатает ключ сервера. Флаг -t ed25519 — взять ключ этого типа, > — записать результат в файл.
ssh-keyscan -t ed25519 203.0.113.10 > secrets/known_hosts # 203.0.113.10:22 SSH-2.0-OpenSSH_9.6p1 Ubuntu-3ubuntu13.5
Строка с решёткой — служебная, она ушла на экран, а не в файл: какой адрес и какая версия ssh-сервера ответили. Сам ключ лёг в secrets/known_hosts.
Шаг 5. Сверить отпечаток
Записать мало — надо убедиться, что записал ключ именно своего VDS. Флаг -l у ssh-keygen печатает отпечаток, -f — из какого файла.
ssh-keygen -lf secrets/known_hosts 256 SHA256:Xq3v…k8Lw 203.0.113.10 (ED25519)
Теперь та же команда на самом VDS, по файлу ключа сервера:
ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub 256 SHA256:Xq3v…k8Lw root@vds (ED25519)
Читать нужно часть после SHA256:. Совпала — ключ настоящий. В контейнере ssh будет запущен с опцией StrictHostKeyChecking=yes: «не спрашивай, а сверяй с файлом и при несовпадении отказывай». Это и есть смысл шага: туннель никогда не подключится к чужой машине, даже если адрес кто-то подменит.
Ключ и отпечаток готовы — можно поднять туннель руками и посмотреть, как он работает.
Туннель руками
Прежде чем заворачивать туннель в контейнер, запусти его в обычном терминале. Так ты увидишь, что каждая часть работает, а не будешь гадать, что сломалось внутри контейнера.
Шаг 6. Поднять туннель
ssh -N -D 1080 -i secrets/id_ed25519 root@203.0.113.10Флаг -N — не выполнять на VDS никаких команд, только держать соединение. Именно поэтому command= из шага 2 туннелю не мешает: команда не запускается вовсе. Флаг -D 1080 — открыть на домашнем сервере порт 1080 и работать на нём SOCKS-посредником. Всё, что придёт на этот порт, уедет по ssh и выйдет в интернет уже на VDS.
Команда ничего не печатает и не возвращает приглашение — так и должно быть, она держит канал. Окно не закрывай.
Шаг 7. Проверить из второго окна
Открой второе окно на домашнем сервере и спроси страну дважды: напрямую и через туннель.
curl -s https://ipinfo.io/country RU curl -x socks5h://127.0.0.1:1080 https://ipinfo.io/country NL
Флаг -x отправляет запрос через посредника. Схема socks5h:// — SOCKS, где имя сайта разрешает в адрес сам посредник; это то же, что флаг --socks5-hostname, только короче. Буква h важна: имя ipinfo.io превратит в адрес DNS-сервер VDS, а не российский. Российский DNS для части заблокированных имён отдаёт адрес заглушки, и без h запрос уйдёт туда.
RU, потом NL — туннель работает. Останови его в первом окне через Ctrl+C. Но если закрыть окно или оборвётся связь, туннель умрёт вместе с ним — это решаем дальше.
Чтобы жил всегда: контейнер
Туннель в окне терминала живёт, пока живёт окно. Сервисам нужна дверь, которая открыта всегда и сама поднимается после обрыва. Для этого заворачиваем ssh в контейнер, а запускать и перезапускать его поручаем Docker Compose. Файлы пишем в ~/egress/tunnel и ~/egress через nano.
Шаг 8. Dockerfile
Образ — маленький Alpine с двумя программами. Первая часть файла tunnel/Dockerfile:
FROM alpine:3.20 RUN apk add --no-cache openssh-client privoxy COPY privoxy.conf /etc/privoxy/egress.conf COPY entrypoint.sh /entrypoint.sh RUN chmod +x /entrypoint.sh
FROM берёт за основу Alpine — дистрибутив на 8 МБ. apk add — менеджер пакетов Alpine, ставит ssh-клиент и privoxy; --no-cache не оставляет в образе список пакетов. COPY кладёт внутрь два наших файла, chmod +x разрешает запуск скрипта.
Зачем privoxy. SOCKS понимают не все программы: встроенный fetch в Node и многие библиотеки для API умеют только HTTP-прокси. Privoxy — переходник: принимает HTTP-прокси-запросы на порту 8080 и отдаёт их в тот же SOCKS на 1080. Вторая часть файла:
HEALTHCHECK --interval=30s --timeout=5s --retries=3 \ CMD nc -z 127.0.0.1 1080 && nc -z 127.0.0.1 8080 || exit 1 ENTRYPOINT ["/entrypoint.sh"]
Healthcheck — проверка здоровья: раз в 30 секунд Docker выполняет команду внутри контейнера. nc -z проверяет, что порт принимает соединения. Открыты оба — контейнер healthy, три неудачи подряд — unhealthy. ENTRYPOINT — что запустить при старте контейнера.
Шаг 9. entrypoint.sh
Скрипт запуска tunnel/entrypoint.sh по частям. Начало — подготовка:
#!/bin/sh set -eu : "${TUNNEL_SSH_TARGET:?TUNNEL_SSH_TARGET (user@host) не задан}" install -m 600 /ssh/id_ed25519 /tmp/id_ed25519
set -eu — остановиться на первой ошибке и на незаданной переменной. Третья строка ничего не делает, если переменная TUNNEL_SSH_TARGET задана, и падает с понятной фразой, если нет. Четвёртая копирует ключ в контейнер с правами 600 — «читать может только владелец». Ssh откажется работать с ключом, который видят другие, а файл с домашнего сервера смонтирован только для чтения, менять ему права нельзя.
Дальше privoxy. Без особых флагов он уходит в фон и не мешает следующей строке.
echo "[egress] privoxy :8080 → socks5 127.0.0.1:1080" privoxy /etc/privoxy/egress.conf
И сам туннель — тот же ssh -N -D, что ты запускал руками, плюс опции для жизни без человека:
echo "[egress] ssh -D 1080 → $TUNNEL_SSH_TARGET" exec ssh -N -D 0.0.0.0:1080 \ -o ExitOnForwardFailure=yes \ -o ServerAliveInterval=30 -o ServerAliveCountMax=3 \ -o StrictHostKeyChecking=yes -o UserKnownHostsFile=/ssh/known_hosts \ -o BatchMode=yes -i /tmp/id_ed25519 "$TUNNEL_SSH_TARGET"
Главная мысль здесь: ssh при любой беде выходит. Вышел ssh — завершился контейнер — Compose запустил его заново. exec заменяет скрипт на ssh, и сигнал остановки от docker stop попадает прямо в ssh, а не в оболочку, которая его проглотит. Как программы получают сигналы — подробнее в Wiki.
Шаг 10. Конфиг privoxy
Privoxy умеет вырезать рекламу и править страницы — нам это не нужно, от него требуется только переходник. Файл tunnel/privoxy.conf, первая часть:
listen-address 0.0.0.0:8080 forward-socks5t / 127.0.0.1:1080 . toggle 0
listen-address — где принимать запросы. forward-socks5t — все адреса (/) отдавать в SOCKS на 1080; буква t значит то же, что h у curl: имя разрешает VDS. Точка в конце — «дальше без ещё одного HTTP-прокси». toggle 0 выключает все фильтры. Вторая часть закрывает лишнее:
enable-remote-toggle 0 enable-edit-actions 0 accept-intercepted-requests 0 socket-timeout 300 logdir /tmp
Первые две строки запрещают включать фильтры и править правила через веб-страницу privoxy. Третья — принимать только запросы, явно адресованные прокси. socket-timeout 300 не обрывает долгие ответы, например распознавание голоса. logdir — куда писать журнал.
Шаг 11. compose.yaml и .env
Остался файл, который всё это запускает. ~/egress/compose.yaml, сам сервис:
name: egress services: tunnel: build: tunnel container_name: egress-tunnel environment: TUNNEL_SSH_TARGET: ${TUNNEL_SSH_TARGET:?задать в .env} volumes: - ./secrets:/ssh:ro
build: tunnel — собрать образ из каталога tunnel. container_name — имя, по которому клиенты будут находить туннель. Переменная берётся из файла .env, а :? не даст запустить стек, если её забыли. В volumes каталог secrets попадает внутрь как /ssh, ro — только чтение. Вторая часть:
networks: - egress restart: unless-stopped networks: egress: name: egress_network
restart: unless-stopped — перезапускать всегда, кроме ручной остановки. Секция networks создаёт свою сеть egress_network. Почему не общую сеть обратного прокси, где живут сайты: тогда выход за рубеж получили бы все её участники. Сюда попадёт только тот, кого подключили явно. И обрати внимание — нет секции ports: наружу не публикуется ничего.
Файл ~/egress/.env — одна строка:
TUNNEL_SSH_TARGET=root@203.0.113.10Адрес должен быть тем же, что ты писал в ssh-keyscan: отпечаток записан для адреса, и имя вместо него ssh не сопоставит.
Шаг 12. Запуск
Флаг -d запускает в фоне, --build собирает образ перед стартом.
docker compose up -d --build … ✔ Container egress-tunnel Started
Через полминуты посмотри состояние:
docker compose ps NAME IMAGE SERVICE STATUS PORTS egress-tunnel egress-tunnel tunnel Up 40 seconds (healthy)
Колонки COMMAND и CREATED здесь убраны ради ширины. Читаем STATUS: Up и (healthy) — healthcheck увидел оба порта. Пустая колонка PORTS — то, что нужно: снаружи туннель не виден. (health: starting) в первые секунды — норма, проверка ещё не прошла ни разу. Что туннель сказал при старте, видно в журнале:
docker logs egress-tunnel [egress] privoxy :8080 → socks5 127.0.0.1:1080 [egress] ssh -D 1080 → root@203.0.113.10
Две строки из echo и больше ничего — значит, ssh подключился молча, как и должен. Ошибка здесь появилась бы третьей строкой.
Шаг 13. Проверка из сети туннеля
Порты не опубликованы, поэтому проверять надо изнутри сети egress_network. Скрипт ~/egress/check.sh запускает одноразовый контейнер с curl в этой сети и спрашивает страну через оба входа.
#!/bin/sh img=curlimages/curl:8.11.1 docker run --rm --network egress_network $img \ -s --socks5-hostname egress-tunnel:1080 https://ipinfo.io/country docker run --rm --network egress_network $img \ -s -x http://egress-tunnel:8080 https://ipinfo.io/country
--rm удаляет контейнер после работы, --network сажает его в сеть туннеля. Первый запрос идёт через SOCKS, второй — через privoxy.
sh check.sh NL NL
При первом запуске Docker сначала скачает образ curl, и над ответом будет несколько строк загрузки. Две страны VDS — работают оба входа. Дверь готова, осталось провести к ней сервис.
Подключить сервис
Сервису-клиенту нужны две вещи: оказаться в сети туннеля и узнать, что ходить надо через прокси. Обе пишутся в его собственный compose-файл, туннель трогать не нужно.
Шаг 14. Фрагмент compose клиента
Сервис в примере называется app. Сначала сеть:
services: app: networks: [default, egress] networks: egress: external: true name: egress_network
default оставляем, иначе сервис потеряет связь со своей базой и соседями по стеку. external: true — сеть не создавать, а взять уже существующую; её создал стек egress, поэтому он должен быть запущен первым. Теперь переменные окружения — настройки, которые программа читает при старте:
environment: HTTPS_PROXY: http://egress-tunnel:8080 NO_PROXY: localhost,127.0.0.1 NODE_USE_ENV_PROXY: "1"
HTTPS_PROXY — куда отправлять HTTPS-запросы; эту переменную понимают curl, Python-библиотеки requests и httpx и многие другие. NO_PROXY — куда ходить напрямую; допиши сюда имена соседних сервисов, к которым клиент ходит по HTTP, иначе и они поедут за рубеж и не найдутся. NODE_USE_ENV_PROXY — для Node 24 и новее: без этого флага встроенный fetch переменную HTTPS_PROXY молча игнорирует. Если клиент умеет SOCKS — например, бот на aiogram, — ему вместо этого дают адрес socks5://egress-tunnel:1080 в его собственной настройке прокси.
Шаг 15. Проверка изнутри клиента
Перезапусти клиента через docker compose up -d и проверь, что переменные до него дошли.
docker compose exec app env | grep PROXY HTTPS_PROXY=http://egress-tunnel:8080 NO_PROXY=localhost,127.0.0.1 NODE_USE_ENV_PROXY=1
exec app выполняет команду внутри работающего контейнера, env печатает его переменные, grep оставляет нужные. Все три на месте. Если в образе клиента есть curl, спроси страну его глазами:
docker compose exec app curl -s https://ipinfo.io/country NL
Curl сам прочитал HTTPS_PROXY и ушёл через туннель. Если curl в образе нет, смотри на сам сервис: в его логе на месте 403 Access denied by security policy должны появиться обычные ответы.
Поломки
Ломается туннель предсказуемо, и почти всегда причину видно в одном из двух мест: в docker logs egress-tunnel или в ошибке клиента. Таблица — от того, что видишь, к тому, что делать.
| что видишь | причина | что делать |
|---|---|---|
| в логе туннеля Permission denied (publickey) | VDS не принял ключ: строка не в том authorized_keys, не тот пользователь в .env, опечатка | повторить шаг 3 руками; смотреть, что TUNNEL_SSH_TARGET совпадает с пользователем |
| в логе туннеля Host key verification failed | отпечатка нет в known_hosts или он сменился — например, VDS переустановили | снова шаги 4 и 5; адрес в .env должен совпадать с адресом в ssh-keyscan |
| контейнер перезапускается по кругу | ssh выходит сразу после старта — причина третьей строкой в логе | docker logs egress-tunnel, потом строки выше |
| клиент: соединение с egress-tunnel:8080 отклонено | privoxy не запущен, обычно из-за ошибки в privoxy.conf; статус unhealthy | проверить конфиг и пересобрать: docker compose up -d --build |
| клиент: не удаётся найти имя egress-tunnel | клиент не подключён к сети egress_network | добавить сеть в compose клиента, шаг 14 |
| при запуске клиента: сеть egress_network не найдена | стек egress не запущен, сеть создаёт он | сначала поднять туннель, потом клиента |
| запросы через SOCKS висят до таймаута | ssh-сессия мертва или VDS недоступен | ssh сам выйдет через 90 секунд; если нет — проверить VDS напрямую |
| страна всё ещё RU | нет HTTPS_PROXY у клиента, Node без NODE_USE_ENV_PROXY, библиотека не читает переменные | шаг 15; в документации библиотеки найти, как ей задать прокси явно |
Одно правило на все строки: если клиент получает RU, туннель обычно ни при чём — проверь check.sh. Покажет страну VDS — значит, дело в настройке клиента. Docker сам не перезапускает контейнер со статусом unhealthy: увидел его — перезапусти руками через docker compose restart.
Итог
Готово, если всё ниже правда:
curl -s https://ipinfo.io/countryна VDS печатает неRU;- вход с ключом туннеля по ssh не даёт шелла, а сразу закрывается;
docker compose psв~/egressпоказываетUpи(healthy), колонкаPORTSпустая;sh check.shдважды печатает страну VDS;- у клиента в
envвидныHTTPS_PROXYиNO_PROXY, а для Node ещёNODE_USE_ENV_PROXY; - в логе сервиса вместо
403от OpenRouter и таймаутов Telegram — обычные ответы.
Одна вещь, о которой стоит помнить: дверь одна на всех. Если VDS ляжет, без выхода наружу останутся сразу все подключённые сервисы, поэтому адрес провайдера и вход в его панель держи под рукой.