Kite - SSH 隧道反向代理

将内网服务器上的 Web 服务通过云服务器暴露给外部访问。基于 SSH 端口转发，安全可靠。

架构

                        SSH -R tunnel
Client (内网)  ◄──────────────────────────►  Server X (云)
  localhost:3000  ──►  X:10001                  ┃
  localhost:8888  ──►  X:10002                  ┃
                                                ┃
Browser ──► X:34321 (Dashboard / Reverse Proxy) ┛

流程：

1. Client 调用 /pre_connect 提交公钥，Server 验证 API Key 后返回 SSH 连接信息
2. Client 建立 SSH 端口转发隧道（ssh -R）
3. Client 定期调用 /connect（默认 30s）上报映射信息和心跳
4. 用户在 Dashboard 点击服务条目后获取 Cookie，后续请求自动转发到对应端口

安装

pip install kite-strings

使用

1. 在云服务器 X 上启动 Server

设置环境变量：

export KITE_APIKEY="your-secret-api-key"
export KITE_SSH_IP="x.example.com"
export KITE_SSH_PORT="22"                # 默认 22
export KITE_SSH_USER="kite"

启动服务：

kite-server --port 34321

2. 在内网服务器上启动 Client

kite-client --server http://X:34321 \
            --apikey your-secret-api-key \
            --map 3000:my-api \
            --map 8888:jupyter

3. 访问

• Dashboard：http://X:34321 查看服务列表和状态
• 连接服务：在 Dashboard 点击 "Connect :PORT" 获取代理 Cookie
• 断开代理：访问 http://X:34321/_deselect 清除 Cookie
• 始终查看 Dashboard：访问 http://X:34321/_dashboard

API

防火墙要求

Server X 需要开放：

• Dashboard 端口（默认 34321）
• SSH 端口（默认 22）
• 映射端口范围（默认从 10001 开始，取决于客户端数量）