
NAT Tunnel: NATの背後から簡単にサービスを提供するためのツール
注記: 旧Python版は最終版であり、メンテナンスされていません。 その手順はこのファイルの末尾にあります。旧Python版は 現在のC版と互換性がありません。C版のみを使用してください。
パブリックIPを持ち、ポートがフィルタリングされていないサーバーに アクセスできる場合、そのサーバー上でNAT Tunnel (NT) サーバーを、 NATの背後にある自分のマシン上でNTクライアントを実行できます。 サーバーには2つの開放ポートが必要です。1つはNTクライアントとの 通信 (--admin)、もう1つは通常のクライアントが接続するための ポート (--public: これはユーザーに使用してもらいたいポートです)。
NTクライアントはサーバーのadmin ip/portへの接続を開きます。 サーバーが新しい接続を受信するとすぐにNTクライアントへ通知し、 NTクライアントはサーバーへの新しいトンネル接続を作成し、 それがNTクライアント側の目的のサービス (--local) に接続されます。
adminインターフェース上のNTクライアントとNTサーバー間の接続は、 不正使用を防ぐために共有シークレットで保護されています。 パケットを傍受できる攻撃者は、シークレットの複雑さが不十分な場合、 それを解読できる可能性があります。少なくとも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]:https://raw.githubusercontent.com/rofl0r/nat-tunnel/master/port%E3%81%A8%E3%81%97%E3%81%A6%E3%83%94%E3%82%A2%E3%82%92%E5%A0%B1%E5%91%8A%E3%81%97%E3%80%81%E5%8F%8C%E6%96%B9%E3%81%8C%E4%B8%A1%E6%96%B9%E3%81%AE%E5%BD%A2%E5%BC%8F%E3%82%92%E8%A7%A3%E6%9E%90%E3%81%97%E3%81%BE%E3%81%99%E3%80%82
サーバー署名鍵を一度生成します:
./natsrv --genkey server.key
これは0600権限で秘密鍵を書き込み、公開鍵の16進数を出力します。 その16進数文字列をクライアントに--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、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、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 intrinsicsを自動的に使用します。スカラー実装はフォールバックとして 残ります。-march=nativeなしで有効化するには:
make CPPFLAGS="-msha -msse4.1"
これにより、SHA-NI と SSE4.1 をサポートする任意の x86 CPU を必要とし、他の -march=native 機能を必要としないバイナリがビルドされます。これらのフラグを付けない通常の make は、どこでも引き続き動作します。
i7-1160G7 で測定した、16 KiB ブロックの生の SHA256: スカラー -O2 は約 257 MB/s、SHA-NI -O2 は約 1574 MB/s (約 6 倍高速)。
トンネルソケットには送信と受信のタイムアウトがあり、 --timeout SECS で設定します (デフォルト 1800、0 で無効化)。デフォルト値は 意図的に保守的に設定されています。llama.cpp のような遅いサーバーで 毎秒 10 トークンを下回る場合や、巨大なシステムプロンプトのアップロードは、 正当に何分もブロックする可能性があります。短い値は そのようなトンネルを切断し、長い値はデッドソケットの検出を遅らせます。 制御ソケットにはタイムアウトが設定されないため、アイドル状態の制御 接続が切断されることはありません。
すべてのソケットは TCP キープアライブを使用し、アイドル時間 30 秒ごとに プローブを送信します (間隔 5 秒、プローブ 3 回)。これにより、サイレントに 死んだピアはデフォルトの 2 時間ではなく約 45 秒で検出されます。
クライアントとサーバーはどちらも 1 つのポーリングループを実行します。どちらの 側も accept でブロックしません。クライアントは制御ソケット とスペアソケットをまとめてポーリングし、スペアにデータ、エラーが 現れた場合、または 5 秒ごとのデスチェックに失敗した場合にスペアを 再アームします。サーバーは管理 リスナー、パブリックリスナー、制御ソケット、および スペアソケットをまとめてポーリングします。その結果、サーバーは スペアを持たない間もパブリックポートにサービスを提供し、 制御ソケットの監視を決して停止しません。
ライブのスペアが存在しないときに到着したパブリック接続は、 即座にリセットされます。ピアはハングではなく失敗を認識します。 すでに FIN または RST を示しているスペアは、ペアリングされる前に 破棄され再アームされるため、死んだスペアがトンネルに到達することは ありません。読み取り可能なデータだけでは、ペアリングされようとしている スペアの死とはみなされません。トンネルのバイトが正当に転送中である 可能性があるためです。
スイート全体を実行するには:
make test
これには python3 が必要で、最初に natsrv をビルドします。スイートは ループバックポート上で実際のサーバーとクライアントのプロセスを起動します。各テストは 独自のポート、作業ディレクトリ、ログを取得するため、失敗が次のテストに 漏れることはありません。
テストは名前で選択でき、一覧表示もできます:
python3 tests/natt.py --list
python3 tests/natt.py spare_rst control_rst
障害注入は管理ポートの前にある TCP プロキシを使用します (tests/natt.py、クラス FaultProxy)。受け入れられた各接続には accept 順に ID が付与され、クライアントハローから読み取られたロールが 割り当てられるため、制御ソケットとスペアソケットが区別されます。テストは RST で切断する、FIN で切断する、またはフリーズする (両方のソケットを開いたまま バイトの転送を停止する) ことができます。制御ソケットのフリーズは、 サイレントに死んだパスをモデル化します。ピアのカーネルはループバック上で キープアライブプローブに応答し続けるため、control_blackhole テストは代わりに iptables でパケットをドロップします。このテストには root が必要で、 それ以外の場合はスキップされます。
遅いテストは TCP キープアライブを通じてブラックホールを検出します。これには 約 45 秒かかります。これらは要求時のみ実行されます:
make test-slow
すべてのコンソール出力は stderr に送られ、1 行につき 1 回の dprintf() 呼び出し (マクロ dolog、microsocks の sockssrv.c から移植) を通じて行われます。stderr は行バッファリングされず、dprintf は fd に直接書き込みます。どちらも stdio ロックを必要としないため、 dolog はどのスレッドからも安全であり、行の後に fflush は 不要です。ログは 2> file でリダイレクトしてください。
タイムスタンプはメッセージと同じ dprintf 呼び出しの一部です。 したがって、同時ハンドシェイクが行内で インターリーブされることは決してありません。実際にはメインスレッドのみが出力するため、 順序は読みやすいままです。
ヘルプテキスト (--help) は CLI 呼び出しへの応答であり、 stdout に送られます。それ以外のすべて (--genkey の出力を含む) は stderr に送られます。
管理ポートに接続するすべてのピアは、サーバーハローを受け取り、その後、有効なクライアントハローを受け取るまで1.5秒の期限が与えられます。共有シークレットを持たないピアはMACチェックに失敗し、そのソケットはリセットされます。したがって、通りすがりのポートスキャナーはハンドシェイクを1回消費するだけで、稼働中の制御ソケットを切断することはありません。共有シークレットを証明できるピアのみが稼働中の制御ソケットを置き換えることができ、これにより再起動したクライアントが引き継ぎます。ハンドシェイクはメインのポーリングループ内で実行されるため、停止したスキャナーがループを遅延させるのは最大でもハローの期限までです。
バイナリの長さプレフィックス付きフレーム: タイプバイト、ビッグエンディアンのuint16ペイロード長、ペイロード。タイプ: 1 サーバーハロー、2 クライアントハロー、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