
NAT Tunnel: для простого обслуживания из-за NAT
ПРИМЕЧАНИЕ: старая версия на Python является окончательной и не поддерживается. Инструкции для неё находятся в конце этого файла. Она несовместима с текущей версией на C. Используйте только C.
Если у вас есть доступ к серверу с публичным IP и нефильтруемыми портами, вы можете запустить сервер NAT Tunnel (NT) на сервере, а NT-клиент — на вашей машине за NAT. Серверу требуются 2 открытых порта: один для связи с NT-клиентом (--admin), другой для подключения обычных клиентов (--public: это порт, который вы хотите, чтобы использовали ваши пользователи).
NT-клиент открывает соединение с admin ip/port сервера. Как только сервер получает новое соединение, он сигнализирует NT-клиенту, который затем создаёт новое туннельное соединение с сервером, а оно, в свою очередь, подключается к нужному сервису на стороне NT-клиента (--local)
Соединение между NT Client и NT Server на admin-интерфейсе защищено общим секретом от несанкционированного использования. Злоумышленник, способный перехватывать пакеты, может взломать секрет, если он недостаточно сложен. Рекомендуется не менее 10 случайных символов и цифр.
Пример: У вас есть HTTP-сервер, слушающий на вашей локальной машине на порту 80. Вы хотите сделать его доступным на публичном IP вашего облачного сервера/VPS/и т.п. на порту 8000. Мы используем порт 7000 на облачном сервере для канала управления.
Сервер:
./natsrv --mode server --secret-file secret.txt --server-key server.key --public 0.0.0.0:8000 --admin 0.0.0.0:7000
Клиент:
./natsrv --mode client --secret-file secret.txt --server-pubkey PUBKEY_HEX --local localhost:80 --admin example.com:7000
Работают и IPv4, и IPv6 везде. Синтаксис адреса — host:port. Для IPv6-литералов используйте квадратные скобки: [::1]:8080, [2001:db8::1]:7000. Голый IPv6-адрес без скобок отклоняется, поскольку двоеточия делают порт неоднозначным. Для имён хостов IPv4 предпочтителен, а IPv6 используется как запасной вариант; явный числовой литерал всегда имеет приоритет для своего семейства. Адрес прослушивания 0.0.0.0 означает IPv4 на всех интерфейсах, :: означает IPv6 на всех интерфейсах. В протоколе сервер сообщает пира как ip:port для IPv4 и [ip]:port для IPv6, и обе стороны разбирают обе формы.
Сгенерируйте подписывающий ключ сервера один раз:
./natsrv --genkey server.key
Это записывает приватный ключ с правами 0600 и выводит публичный ключ в hex. Передайте эту hex-строку клиенту как --server-pubkey. Серверу требуется --server-key, клиенту требуется --server-pubkey. Предпочитайте --secret-file PATH вместо --secret на общих машинах, поскольку --secret утекает через ps aux.
Собирайте с помощью обычного GNU Make (3.82 или новее):
make
Это создаёт ./natsrv. Makefile начинается с -include config.mak перед первой целью, поэтому локальный config.mak может постоянно задавать CFLAGS, CPPDFGS, LDFLAGS и прочее. Makefile добавляет свои собственные значения по умолчанию с помощью CFLAGS += -Wall -std=c99. Опции в командной строке Make также передаются:
make CPPFLAGS=-DHAVE_GETRANDOM
make CFLAGS="-Wall -Wextra -std=c99 -pedantic"
make USE_SODIUM=1
make clean
HAVE_GETRANDOM: по умолчанию случайные данные берутся из /dev/urandom. Определите HAVE_GETRANDOM, чтобы использовать вместо этого системный вызов getrandom() (Linux 3.17+ / glibc 2.25+). Оба пути завершаются с ошибкой при сбое. Компоновка по умолчанию — -lpthread, плюс -lsodium при USE_SODIUM=1. Сам код написан на C99 и переносим без расширений GNU99. Для отступов используются табуляции, следуя стилю кода microsocks.
Шифрование туннеля использует XSalsa20. По умолчанию оно обеспечивается встроенным кодом TweetNaCl (tweetnacl.c, tweetnacl.h). С USE_SODIUM=1 вместо этого линкуется libsodium. Код sha256 в sha256.c написан с нуля; для сборки по умолчанию никакая криптографическая библиотека не нужна.
На x86 с расширениями Intel SHA sha256.c автоматически использует интринсики SHA-NI, когда компилятор определяет SHA и SSSE3. Скалярная реализация остаётся запасной. Включите это без -march=native:
make CPPFLAGS="-msha -msse4.1"
Эта сборка создаёт бинарный файл, которому требуется любой x86 CPU с поддержкой SHA-NI и SSE4.1, без других возможностей -march=native. Обычный make без этих флагов по-прежнему работает везде.
Измерено на i7-1160G7, чистый SHA256 блоков по 16 КиБ: scalar -O2 — около 257 МБ/с, SHA-NI -O2 — около 1574 МБ/с (примерно в 6 раз быстрее).
Сокеты туннеля имеют таймауты отправки и приёма, задаваемые через --timeout SECS (по умолчанию 1800, 0 отключает их). Значение по умолчанию намеренно консервативно: медленный сервер, такой как llama.cpp ниже 10 токенов в секунду, или загрузка огромного системного промпта, может законно блокироваться на много минут. Меньшие значения убивают такие туннели; большие значения задерживают обнаружение мёртвого сокета. Управляющие сокеты никогда не получают таймаут, поэтому простаивающее управляющее соединение не убивается.
Все сокеты используют TCP keepalive с пробами каждые 30 секунд простоя (интервал 5 секунд, 3 пробы), поэтому молча мёртвый пир обнаруживается примерно за 45 секунд вместо 2 часов по умолчанию.
Клиент и сервер оба запускают один цикл poll. Ни один из концов не блокируется в accept. Клиент опрашивает управляющий сокет и резервный сокет вместе, и он перевооружает резервный, когда резервный показывает данные, ошибку или проваливает проверку на смерть каждые 5 секунд. Сервер опрашивает слушатель администрирования, публичный слушатель, управляющий сокет и резервный сокет вместе. В результате сервер обслуживает публичный порт, пока у него нет резерва, и он никогда не перестаёт следить за управляющим сокетом.
Публичное соединение, приходящее, когда нет живого резерва, сбрасывается сразу. Пир видит сбой, а не зависание. Резерв, который уже показывает FIN или RST, отбрасывается и перевооружается до сопряжения, поэтому мёртвый резерв никогда не достигает туннеля. Одни только читаемые данные не считаются признаком смерти резерва, который вот-вот будет сопряжён, поскольку байты туннеля могут законно находиться в пути.
Запустить весь набор:
make test
Это требует python3 и сначала собирает natsrv. Набор запускает настоящие процессы сервера и клиента на loopback-портах. Каждый тест получает свои порты, рабочий каталог и логи, поэтому сбой никогда не перетекает в следующий тест.
Тесты можно выбирать по имени и перечислять:
python3 tests/natt.py --list
python3 tests/natt.py spare_rst control_rst
Инъекция сбоев использует TCP-прокси перед портом администрирования (tests/natt.py, класс FaultProxy). Каждое принятое соединение получает id в порядке accept и роль, прочитанную из его клиентского hello, поэтому управляющий сокет и резервный сокет различаются. Тест может сбросить один из них через RST, сбросить через FIN или заморозить, т.е. прекратить пересылку байтов, пока оба сокета остаются открытыми. Заморозка управляющего сокета моделирует молча мёртвый путь. Ядро пира продолжает отвечать на пробы keepalive на loopback, поэтому тест control_blackhole вместо этого отбрасывает пакеты через iptables. Этот тест требует root и иначе пропускается.
Медленные тесты обнаруживают blackhole через TCP keepalive, что занимает около 45 секунд. Они запускаются только по запросу:
make test-slow
Весь консольный вывод идёт в stderr через один вызов dprintf() на строку (макрос dolog, портированный из microsocks sockssrv.c). stderr не буферизуется построчно, а dprintf пишет напрямую в fd. Ни тому, ни другому не нужна блокировка stdio, поэтому dolog безопасен из любого потока и fflush не требуется после строки. Направляйте лог через 2> file.
Откройте для себя самые используемые инструменты нашего сообщества.
Данных о популярности пока нет.