┌─────────────┐      ┌─────────────┐      ┌─────────────┐      ┌──────────────┐
│ アプリケーション │─────▶│   クライアント  │─────▶│   サーバー   │─────▶│  インターネット │
│   (ブラウザ)  │ TCP │ SOCKS5:1080 │ SMTP │  ポート587  │ TCP │              │
│             │◀─────│             │◀─────│             │◀─────│              │
└─────────────┘      └─────────────┘      └─────────────┘      └──────────────┘
                            │                    │
                            │   メールトラフィックに見える     │
                            │                    │
                            ▼                    ▼
                     ┌────────────────────────────────┐
                     │     DPI ファイアウォール          │
                     │  ✅ 見える: 通常のSMTPセッション  │
                     │  ❌ 見えない: トンネルデータ       │
                     └────────────────────────────────┘

curl -sSL https://raw.githubusercontent.com/x011/smtp-tunnel-proxy/main/install.sh | sudo bash

smtp-tunnel-adduser bob      # ユーザー追加 + クライアントZIP生成
smtp-tunnel-listusers        # 全ユーザー一覧表示
smtp-tunnel-deluser bob      # ユーザー削除

smtp-tunnel-update           # コードのみ更新、設定/証明書/ユーザーは保持

SMTP Tunnel Proxy Client
User: alice

[INFO] Starting SMTP Tunnel...
[INFO] SOCKS5 proxy will be available at 127.0.0.1:1080

Connecting to myserver.duckdns.org:587
Connected - binary mode active
SOCKS5 proxy on 127.0.0.1:1080

cd alice
pip install -r requirements.txt
python client.py

# ファイルをダウンロード
scp [email protected]:/etc/smtp-tunnel/ca.crt .

# config.yaml を作成:
cat > config.yaml << EOF
client:
  server_host: "myserver.duckdns.org"
  server_port: 587
  socks_port: 1080
  username: "alice"
  secret: "your-secret-from-admin"
  ca_cert: "ca.crt"
EOF

# クライアントを実行
python client.py -c config.yaml

export ALL_PROXY=socks5://127.0.0.1:1080

# curl
curl -x socks5h://127.0.0.1:1080 https://ifconfig.me

# git
git config --global http.proxy socks5://127.0.0.1:1080

# 環境変数
export ALL_PROXY=socks5://127.0.0.1:1080

# VPSのIPが表示されるはず
curl -x socks5://127.0.0.1:1080 https://ifconfig.me

users:
  alice:
    secret: "auto-generated-secret"
    # whitelist:              # オプション: 特定のIPに制限
    #   - "192.168.1.100"
    #   - "10.0.0.0/8"        # CIDR表記対応
    # logging: true           # オプション: falseでこのユーザーのログを停止

  bob:
    secret: "another-secret"
    whitelist:
      - "203.0.113.50"        # BobはこのIPからのみ接続可能
    logging: false            # Bobのアクティビティをログに記録しない

# 状態確認
sudo systemctl status smtp-tunnel

# 設定変更後に再起動
sudo systemctl restart smtp-tunnel

# ログ表示
sudo journalctl -u smtp-tunnel -n 100

# アンインストール
sudo /opt/smtp-tunnel/uninstall.sh

python server.py [-c CONFIG] [-d]

  -c, --config    設定ファイル（デフォルト: config.yaml）
  -d, --debug     デバッグログを有効にする

python client.py [-c CONFIG] [--server HOST] [--server-port PORT]
                 [-p SOCKS_PORT] [-u USERNAME] [-s SECRET] [--ca-cert FILE] [-d]

  -c, --config      設定ファイル（デフォルト: config.yaml）
  --server          サーバーのドメインを上書き
  --server-port     サーバーのポートを上書き
  -p, --socks-port  ローカルのSOCKSポートを上書き
  -u, --username    ユーザー名
  -s, --secret      シークレットを上書き
  --ca-cert         CA証明書のパス
  -d, --debug       デバッグログを有効にする

smtp-tunnel-adduser <username> [-u USERS_FILE] [-c CONFIG] [--no-zip]
    新しいユーザーを追加し、クライアントパッケージを生成

smtp-tunnel-deluser <username> [-u USERS_FILE] [-f]
    ユーザーを削除（-f で確認をスキップ）

smtp-tunnel-listusers [-u USERS_FILE] [-v]
    全ユーザーを一覧表示（-v で詳細情報）

smtp-tunnel-update
    サーバーを最新バージョンに更新（設定/証明書/ユーザーは保持）

smtp_proxy/
├── 📄 server.py               # サーバー（VPS上で実行）
├── 📄 client.py               # クライアント（ローカルで実行）
├── 📄 common.py               # 共有ユーティリティ
├── 📄 generate_certs.py       # 証明書生成ツール
├── 📄 config.yaml             # サーバー/クライアント設定
├── 📄 users.yaml              # ユーザーデータベース
├── 📄 requirements.txt        # Python依存関係
├── 📄 install.sh              # ワンライナーサーバーインストーラ
├── 📄 smtp-tunnel.service     # systemdユニットファイル
├── 🔧 smtp-tunnel-adduser     # ユーザー追加スクリプト
├── 🔧 smtp-tunnel-deluser     # ユーザー削除スクリプト
├── 🔧 smtp-tunnel-listusers   # ユーザー一覧スクリプト
├── 🔧 smtp-tunnel-update      # サーバー更新スクリプト
├── 📄 README.md               # このファイル
└── 📄 TECHNICAL.md            # 技術文書

/opt/smtp-tunnel/              # アプリケーションファイル
/etc/smtp-tunnel/              # 設定ファイル
  ├── config.yaml
  ├── users.yaml
  ├── server.crt
  ├── server.key
  └── ca.crt
/usr/local/bin/                # 管理コマンド
  ├── smtp-tunnel-adduser
  ├── smtp-tunnel-deluser
  ├── smtp-tunnel-listusers
  └── smtp-tunnel-update

# 詳細ログを有効にする
python server.py -d
python client.py -d

# systemdログを表示
journalctl -u smtp-tunnel -f