アップデート一覧に戻る
New releaseSep 12, 2026

pingtunnel master-d7cd0d6ab5f18e7d8d050385e8d240b3b2f41e6c

Pingtunnelは、TCP/UDPトラフィックをICMP経由で送信するツールです。

共有

Pingtunnel

codecov

Pingtunnelは、ICMP Echo(Ping)パケット上でTCP/UDP/SOCKS5トラフィックをトンネリングし、厳格なネットワークファイアウォールや帯域制限されたTCP/UDPトラフィックを回避するネットワークツールです。

⚠️ 注意: このツールは厳密に学習および研究目的を意図しています。いかなる違法な目的にも使用しないでください。

image


🌟 機能

  • 統合されたv3セキュリティアーキテクチャ: 従来の数値キーと個別の暗号化スイッチは廃止されました。単一の共有パスワード(-password)が相互認証とエンドツーエンドのAEAD暗号化(デフォルトはchacha20-poly1305、オプションでaes256/aes128)を制御します。
  • 複数のモード:
    • SOCKS5プロキシ: 1つのコマンドでローカルSOCKS5プロキシを起動でき、オプションでユーザー名/パスワード認証も可能です。
    • TCPポートフォワーディング: 特定のリモートTCPポート(例: SSH、Web、RDP)に到達できます。
    • UDPポートフォワーディング: ゲームのUDPトラフィック、DNS 53などを転送できます。
    • サーバー側の二次フォワーディング(-forward): サーバーは受信トラフィックを上流のSOCKS5/HTTPプロキシ経由でリレーできます。
  • 柔軟な設定(設定ファイルモードを推奨):
    • 設定ファイルで直接実行: pingtunnel config.json または pingtunnel -c config.json
    • カレントディレクトリのconfig.jsonはデフォルトで自動的に読み込まれます。
    • コマンドラインフラグは常に対応する設定ファイルの値を上書きします。
  • 劣悪なネットワークでも堅牢: 内蔵の帯域幅適応型輻輳制御アルゴリズム(bb)がバッファブロートやパケットロスによる停止を抑制します。

🚀 クイックスタート

オプション1: 設定ファイルモード(推奨)

サンプルファイルはリポジトリに同梱されています。サーバーIPと強力なパスワードを入力するだけです:

1. サーバー設定(config-server.json)

{
  "type": "server",
  "password": "YOUR_STRONG_PASSWORD_HERE",
  "encrypt": "chacha20",
  "icmp_listen": "0.0.0.0"
}

サーバーを起動します(root / 管理者権限が必要です):

sudo ./pingtunnel config-server.json
# or: sudo ./pingtunnel -c config-server.json

2. クライアント設定(SOCKS5 プロキシモード、config-client-socks5.json)

{
  "type": "client",
  "listen": "127.0.0.1:1080",
  "server": "YOUR_SERVER_IP",
  "socks5": true,
  "password": "YOUR_STRONG_PASSWORD_HERE",
  "encrypt": "chacha20"
}

クライアントを起動します:

./pingtunnel config-client-socks5.json
# or: ./pingtunnel -c config-client-socks5.json

次に、ブラウザまたはシステムのプロキシを SOCKS5 127.0.0.1:1080 に設定します。


オプション 2: コマンドライン (CLI)

1. サーバーを起動する

パブリック IP を持つマシン上で実行します:

sudo ./pingtunnel -type server -password YOUR_STRONG_PASSWORD_HERE

(任意) 干渉を避けるため、Linux カーネルのデフォルトの ICMP エコー応答を無効にします:

echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all

2. クライアントを起動する

  • SOCKS5 プロキシモード:
    ./pingtunnel -type client -l 127.0.0.1:1080 -s YOUR_SERVER_IP -socks5 -password YOUR_STRONG_PASSWORD_HERE
    
  • TCP ポートフォワーディング(デフォルトモード、例:リモート内部 192.168.1.100:22 をローカルポート 2222 にマッピング):
    ./pingtunnel -type client -l :2222 -s YOUR_SERVER_IP -t 192.168.1.100:22 -password YOUR_STRONG_PASSWORD_HERE
    
  • UDP フォワーディング(例: ローカルポート 5353 からパブリック DNS 8.8.8.8:53 へ):
    ./pingtunnel -type client -l :5353 -s YOUR_SERVER_IP -t 8.8.8.8:53 -udp -password YOUR_STRONG_PASSWORD_HERE
    

🐳 Docker

サーバーの実行

docker run --name pingtunnel-server -d \
  --restart=always \
  --privileged \
  --network host \
  esrrhs/pingtunnel ./pingtunnel -type server -password YOUR_STRONG_PASSWORD_HERE

マウントされた設定ファイルを使用して実行する

docker run --name pingtunnel-server -d \
  --restart=always \
  --privileged \
  --network host \
  -v /etc/pingtunnel/server.json:/app/server.json:ro \
  esrrhs/pingtunnel ./pingtunnel /app/server.json

📖 詳細な使用方法とチューニングガイド

より高度なオプションとトポロジ(サーバー側セカンダリプロキシ、ポートフォワーディング、SOCKS5認証、フロー制御と輻輳チューニング)については、以下を参照してください: 👉 USAGE.md - Pingtunnelの使用方法と設定ガイド

カテゴリ