┌─────────────┐      ┌─────────────┐      ┌─────────────┐      ┌──────────────┐
│ Application │─────▶│   Client    │─────▶│   Server    │─────▶│  Internet    │
│  (Browser)  │ TCP  │ SOCKS5:1080 │ SMTP │  Port 587   │ TCP  │              │
│             │◀─────│             │◀─────│             │◀─────│              │
└─────────────┘      └─────────────┘      └─────────────┘      └──────────────┘
                            │                    │
                            │   Looks like       │
                            │   Email Traffic    │
                            ▼                    ▼
                     ┌────────────────────────────────┐
                     │     DPI Firewall               │
                     │  ✅ Sees: Normal SMTP Session  │
                     │  ❌ Cannot see: Tunnel Data    │
                     └────────────────────────────────┘

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 <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