┌─────────────┐      ┌─────────────┐      ┌─────────────┐      ┌──────────────┐
│ 应用程序     │─────▶│ 客户端      │─────▶│ 服务器      │─────▶│ 互联网       │
│  (浏览器)    │ 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           # 可选：禁用可停止记录该用户日志

  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 <用户名> [-u USERS_FILE] [-c CONFIG] [--no-zip]
    添加新用户并生成客户端包

smtp-tunnel-deluser <用户名> [-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