
NAT Tunnel: NAT 뒤에서 손쉽게 서비스를 제공합니다
참고: 이전 Python 버전은 최종 버전이며 더 이상 유지보수되지 않습니다. 해당 버전에 대한 안내는 이 파일의 끝부분에 있습니다. 이 버전은 현재의 C 버전과 호환되지 않습니다. C 버전만 사용하십시오.
공인 IP와 필터링되지 않은 포트를 가진 서버에 접근할 수 있다면, 서버에서 NAT 터널(NT) 서버를 실행하고, NAT 뒤에 있는 자신의 기기에서 NT 클라이언트를 실행할 수 있습니다. 서버는 두 개의 열린 포트가 필요합니다: 하나는 NT 클라이언트와의 통신용(--admin), 다른 하나는 일반 클라이언트가 접속하기 위한 포트(--public: 사용자들이 사용하기를 원하는 포트)입니다.
NT 클라이언트는 서버의 admin ip/port로 연결을 엽니다. 서버가 새 연결을 수신하면 즉시 NT 클라이언트에 신호를 보내고, 클라이언트는 서버로 새로운 터널 연결을 생성하며, 이 연결은 NT 클라이언트 측의 원하는 서비스(--local)로 연결됩니다.
admin 인터페이스에서 NT 클라이언트와 NT 서버 간의 연결은 무단 사용을 방지하기 위해 공유 비밀(shared secret)로 보호됩니다. 패킷을 가로챌 수 있는 공격자는 비밀의 복잡성이 충분하지 않으면 이를 크랙할 수 있습니다. 최소 10개의 무작위 문자와 숫자를 권장합니다.
예시: 로컬 머신의 포트 80에서 수신 대기하는 HTTP 서버가 있습니다. 이를 클라우드 서버/VPS 등의 공인 IP의 포트 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 모든 인터페이스를 의미합니다. 전송 시 서버는 피어를 IPv4의 경우 ip:port로, IPv6의 경우 [ip]:port로 보고하며, 양측 모두 두 형식을 파싱합니다.
서버 서명 키를 한 번 생성하십시오:
./natsrv --genkey server.key
이 명령은 0600 권한으로 개인 키를 기록하고 공개 키 hex를 출력합니다. 이 hex 문자열을 클라이언트에 --server-pubkey로 전달하십시오. 서버는 --server-key를, 클라이언트는 --server-pubkey를 요구합니다. 공유 기기에서는 --secret 대신 --secret-file PATH를 선호하십시오. --secret은 ps aux를 통해 노출되기 때문입니다.
일반 GNU Make(3.82 이상)로 빌드하십시오:
make
이 명령은 ./natsrv를 생성합니다. Makefile은 첫 번째 타깃 앞에 -include config.mak으로 시작하므로, 로컬 config.mak에서 CFLAGS, CPPDPGS, 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+). 두 경로 모두 실패 시 안전하게 종료됩니다(fail closed). 기본 링크 옵션은 -lpthread이며, USE_SODIUM=1일 때 -lsodium이 추가됩니다. 코드 자체는 C99이며 GNU99 확장 없이 이식 가능합니다. 들여쓰기에는 microsocks 코드 스타일에 따라 탭을 사용합니다.
터널 암호화는 XSalsa20을 사용합니다. 기본적으로 번들된 TweetNaCl 코드(tweetnacl.c, tweetnacl.h)에서 제공됩니다. USE_SODIUM=1일 때는 대신 libsodium에 링크합니다. sha256.c의 sha256 코드는 처음부터 작성되었으며, 기본 빌드에는 암호화 라이브러리가 필요하지 않습니다.
Intel SHA 확장이 있는 x86에서, 컴파일러가 __SHA__와 __SSSE3__를 정의하면 sha256.c는 SHA-NI 인트린직을 자동으로 사용합니다. 스칼라 구현은 대체 경로로 남아 있습니다. -march=native 없이 활성화하려면:
make CPPFLAGS="-msha -msse4.1"
SHA-NI와 SSE4.1 지원이 있는 x86 CPU만 있으면 되는 바이너리를 빌드하며, 다른 -march=native 기능은 필요하지 않습니다. 해당 플래그 없이 일반 make를 실행해도 어디서나 동작합니다.
i7-1160G7에서 16 KiB 블록의 raw SHA256을 측정한 결과: scalar -O2는 약 257 MB/s, SHA-NI -O2는 약 1574 MB/s입니다(약 6배 빠름).
터널 소켓에는 송수신 타임아웃이 있으며, --timeout SECS로 설정합니다(기본값 1800, 0은 비활성화). 기본값은 의도적으로 보수적입니다. llama.cpp처럼 초당 10 토큰 미만인 느린 서버나 거대한 시스템 프롬프트 업로드는 정당하게 수 분 동안 블록될 수 있습니다. 더 짧은 값은 이러한 터널을 종료시키고, 더 긴 값은 죽은 소켓 감지를 지연시킵니다. 제어 소켓에는 타임아웃이 적용되지 않으므로 유휴 제어 연결은 종료되지 않습니다.
모든 소켓은 유휴 시간 30초마다 프로브를 보내는 TCP keepalive를 사용합니다(5초 간격, 3회 프로브). 따라서 조용히 죽은 피어는 기본값인 2시간이 아니라 약 45초 만에 감지됩니다.
클라이언트와 서버 모두 하나의 poll 루프를 실행합니다. 어느 쪽도 accept에서 블록되지 않습니다. 클라이언트는 제어 소켓과 예비 소켓을 함께 폴링하며, 예비 소켓에 데이터가 있거나, 오류가 있거나, 5초마다 수행되는 사망 검사에 실패하면 예비 소켓을 다시 무장합니다. 서버는 관리 리스너, 공용 리스너, 제어 소켓, 예비 소켓을 함께 폴링합니다. 결과적으로 서버는 예비 소켓이 없을 때도 공용 포트를 처리하며, 제어 소켓 감시를 절대 멈추지 않습니다.
활성 예비 소켓이 없을 때 도착한 공용 연결은 즉시 리셋됩니다. 피어는 행(hang)이 아니라 실패를 보게 됩니다. 이미 FIN 또는 RST가 표시된 예비 소켓은 페어링 전에 삭제되고 다시 무장되므로, 죽은 예비 소켓이 터널에 도달하는 일은 없습니다. 페어링 직전의 예비 소켓에서는 읽을 수 있는 데이터만으로 사망으로 처리하지 않습니다. 터널 바이트가 정당하게 전송 중일 수 있기 때문입니다.
전체 스위트를 실행하려면:
make test
python3가 필요하며 natsrv를 먼저 빌드합니다. 스위트는 루프백 포트에서 실제 서버와 클라이언트 프로세스를 시작합니다. 각 테스트는 자체 포트, 작업 디렉터리, 로그를 가지므로 실패가 다음 테스트로 누출되지 않습니다.
테스트는 이름으로 선택하고 나열할 수 있습니다:
python3 tests/natt.py --list
python3 tests/natt.py spare_rst control_rst
장애 주입은 관리 포트 앞의 TCP 프록시를 사용합니다 (tests/natt.py, FaultProxy 클래스). 수락된 각 연결은 수락 순서대로 id를 받고 클라이언트 hello에서 읽은 역할을 부여받으므로, 제어 소켓과 예비 소켓이 구분됩니다. 테스트는 RST로 하나를 끊거나, FIN으로 끊거나, 동결할 수 있습니다. 즉, 두 소켓이 모두 열린 상태에서 바이트 전달을 중지합니다. 제어 소켓의 동결은 조용히 죽은 경로를 모델링합니다. 피어 커널은 루프백에서 keepalive 프로브에 계속 응답하므로, control_blackhole 테스트는 대신 iptables로 패킷을 드롭합니다. 해당 테스트는 root가 필요하며 그렇지 않으면 건너뜁니다.
느린 테스트는 약 45초가 걸리는 TCP keepalive를 통해 블랙홀을 감지합니다. 요청 시에만 실행됩니다:
make test-slow
모든 콘솔 출력은 stderr로 가며, 한 줄당 하나의 dprintf() 호출을 통해 이루어집니다(매크로 dolog, microsocks sockssrv.c에서 이식). stderr는 줄 버퍼링되지 않으며, dprintf는 fd에 직접 씁니다. 둘 다 stdio 잠금이 필요 없으므로 dolog는 어떤 스레드에서도 안전하고 한 줄 뒤에 fflush가 필요하지 않습니다. 로그는 2> file로 지정하십시오.
타임스탬프는 메시지와 동일한 dprintf 호출의 일부입니다. 따라서 동시 핸드셰이크가 한 줄 안에서 절대 뒤섞이지 않습니다. 실제로는 메인 스레드만 출력하므로 순서가 읽기 좋게 유지됩니다.
도움말 텍스트(--help)는 CLI 호출에 대한 응답이며 stdout으로 갑니다. --genkey 출력을 포함한 그 밖의 모든 것은 stderr로 갑니다.
admin 포트에 연결하는 모든 피어는 서버 hello를 받은 뒤 유효한 클라이언트 hello를 보내기까지 1.5초의 기한을 갖습니다. 공유 비밀 없이 접속한 피어는 MAC 검사에 실패하고 소켓이 리셋됩니다. 따라서 무작위 포트스캐너는 핸드셰이크 한 번만 소모할 뿐이며, 활성 제어 소켓을 끊어뜨리지 못합니다. 공유 비밀을 증명한 피어만이 활성 제어 소켓을 교체할 수 있으며, 재시작된 클라이언트가 이 방식으로 제어권을 넘겨받습니다. 핸드셰이크는 메인 poll 루프 안에서 실행되므로, 지연되는 스캐너가 루프를 지연시키는 시간은 최대 hello 기한까지입니다.
바이너리 길이 접두사 프레임: 타입 바이트 + 빅 엔디언 uint16 페이로드 길이 + 페이로드. 타입: 1 서버 hello, 2 클라이언트 hello, 3 제어, 4 터널, 5 오류, 6 종료. 터널 데이터 자체는 예비 채널의 터널 프레임 안에 담긴 원시 바이트 스트림이며, 요청 바이트가 2(sk2)일 때 XSalsa20으로 암호화됩니다. 제어 프레임은 CONN 피어 주소를 전달하며 항상 암호화됩니다.
핸드셰이크는 2회 왕복입니다. 서버는 임시 X25519 공개 키, 기능 바이트, 16바이트 논스, 그리고 장기 키로 서명한 Ed25519 서명을 보냅니다. 클라이언트는 고정된 서버 공개 키로 이를 검증한 뒤, 자신의 임시 키, 요청 바이트(0 adm, 1 skt 평문 터널, 2 sk2 암호화 터널), 그리고 X25519 공유 비밀과 --secret 또는 --secret-file의 공유 비밀로 키를 설정한 트랜스크립트에 대한 MAC을 보냅니다. 이 MAC이 클라이언트 인가이며, 공유 비밀만으로는 임시 개인 키 없이 인가할 수 없고, 임시 키 교환은 전방 비밀성을 제공합니다. 스트림 키는 공유 비밀과 트랜스크립트 해시로부터 유도됩니다. CONN 피어 주소는 서버가 암호화되지 않은 터널 트래픽을 허용하더라도 제어 채널에서 항상 암호화됩니다. 기본적으로 터널은 암호화됩니다. 이 옵션은 처리량을 향상시키거나, 백엔드가 이미 암호화되어 있는 경우(예: HTTPS) 오버헤드를 줄일 수 있습니다. 이는 터널 트래픽에만 적용되며, 제어 트래픽은 암호화된 상태로 유지됩니다. 기능 바이트의 비트 0은 와이어 상에서 해당 설정을 반영합니다.
키: 서버 서명 키는 위의 --genkey로 생성됩니다. 공유 환경에서는 --secret보다 --secret-file PATH를 권장합니다.
아래 텍스트는 예전의 Python 전용 문서입니다. nt02 C 와이어 프로토콜을 설명하지 않습니다.
서버 (IPv4):
natsrv.py --mode server --secret s3cretP4ss --public 0.0.0.0:8000 --admin 0.0.0.0:7000
클라이언트 (IPv4):
natsrv.py --mode client --secret s3cretP4ss --local localhost:80 --admin example.com:7000
서버 (IPv6, 대괄호에 주의):
natsrv.py --mode server --secret s3cretP4ss --public [::]:8000 --admin [::]:7000
클라이언트 (IPv6 업스트림, IPv4 로컬):
natsrv.py --mode client --secret s3cretP4ss --local localhost:80 --admin [2001:db8::1]:7000