RPT - Reverse Proxy Tool

一个高性能的内网穿透工具，将局域网个人电脑、服务器代理映射到公网

📖 目录

• 项目简介
• 功能特性
• 项目架构
• 使用场景
• 快速开始
• GUI 桌面客户端
• 配置详解
• 部署指南
• Dashboard 管理面板
• Go 客户端
• SSL 证书
• 常见问题
• Star History

🚀 项目简介

RPT (Reverse Proxy Tool) 是一款基于 Netty 的内网穿透工具，通过在公网服务器与内网客户端之间建立安全隧道，将内网服务暴露到公网，实现外部访问。

工作原理

sequenceDiagram
    participant U as 🌐 外部用户
    participant S as 🖥️ rpt-server (公网)
    participant C as 💻 rpt-client (内网)
    participant L as 🏠 内网服务

    Note over C,S: 1️⃣ 建立连接阶段
    C->>S: SSL 双向认证握手
    S->>S: 验证客户端证书 + Token
    S-->>C: 认证通过，隧道建立
    C->>S: 上报端口映射配置 (TCP/UDP/HTTP)
    S->>S: 绑定公网端口 & 注册域名路由

    Note over U,L: 2️⃣ TCP/UDP 代理流程
    U->>S: 连接公网 remotePort (如 4389)
    S->>S: 匹配端口映射规则 & IP地域过滤
    S->>C: 通过 SSL 隧道转发请求
    C->>L: 连接本地服务 localIp:localPort (如 127.0.0.1:3389)
    L-->>C: 返回响应数据
    C-->>S: 通过 SSL 隧道回传
    S-->>U: 返回给外部用户

    Note over U,L: 3️⃣ HTTP 代理流程 (端口复用)
    U->>S: HTTP 请求 test.domain.com:80
    S->>S: 解析 Host 域名路由 & Basic Auth 验证
    S->>C: 通过 SSL 隧道转发 HTTP 请求
    C->>L: 转发到本地 Web 服务 (如 127.0.0.1:8080)
    L-->>C: 返回 HTTP 响应
    C-->>S: 通过 SSL 隧道回传
    S-->>U: 返回 HTTP 响应

    Note over U,L: 4️⃣ 连接保活
    loop 心跳检测
        C->>S: 心跳包
        S-->>C: 心跳响应
    end

graph TB
    subgraph "公网服务器 rpt-server"
        S["rpt-server<br/>Netty 服务端"]
        S --> TCP_BIND["TCP 端口监听<br/>remotePort: 4389, 7379..."]
        S --> UDP_BIND["UDP 端口监听<br/>remotePort: 4389..."]
        S --> HTTP_BIND["HTTP/HTTPS 端口复用<br/>80 / 443"]
        HTTP_BIND --> ROUTE["域名路由<br/>Host → 客户端映射"]
        S --> AUTH["Token 授权<br/>端口范围限制"]
        S --> GEO["IP 地域过滤<br/>MaxMind GeoIP"]
        S --> DASH["Dashboard 管理面板<br/>流量统计 / 流速监控"]
        S --> SSL_S["SSL 双向认证"]
    end

    subgraph "SSL 加密隧道"
        TUNNEL["🔒 加密数据通道<br/>Protostuff 序列化"]
    end

    subgraph "内网环境 rpt-client"
        C["rpt-client<br/>Netty / Go 客户端"]
        C --> P1["代理连接池"]
        P1 --> RDP["远程桌面<br/>127.0.0.1:3389"]
        P1 --> SSH["SSH 服务<br/>127.0.0.1:22"]
        P1 --> WEB["Web 应用<br/>127.0.0.1:8080"]
        P1 --> DB["数据库<br/>127.0.0.1:3306"]
        P1 --> OTHER["其他服务<br/>FTP/SMTP/打印机..."]
    end

    SSL_S <--> TUNNEL
    TUNNEL <--> C

✨ 功能特性

🏗️ 项目架构

rpt/
├── rpt-base/          # 基础模块 - 公共协议、编解码、工具类
├── rpt-server/        # 服务端 (Java) - 部署在公网服务器
├── rpt-client/        # 客户端 (Java) - 部署在内网机器
├── rpt-client-go/     # 客户端 (Go) - 轻量级Go实现
├── rpt-desktop/       # 桌面客户端 (JavaFX)
├── rpt-desktop-go/    # 桌面客户端 (Wails + Go)
└── doc/               # 文档资源

技术栈

🎯 使用场景

• 远程桌面 — 在外网通过 RDP 远程连接公司/家中电脑
• Web 开发调试 — 本地支付接口回调调试、微信公众号/小程序本地调试
• SSH 远程访问 — 远程连接内网 Linux 服务器
• 数据库连接 — 远程连接内网 MySQL、Redis 等数据库
• HTTP 反向代理 — 共享 80/443 端口为多个内网 Web 服务提供公网访问
• DNS 转发 — UDP 代理实现 DNS 请求转发
• 游戏联机 — 代理游戏服务器实现公网联机
• 打印机共享 — 远程连接内网打印机

⚡ 快速开始

前置条件

第一步：编译构建

# 克隆项目
git clone https://github.com/iamlinhui/rpt.git
cd rpt

# 构建 Java 服务端和客户端
mvn clean package -Dmaven.test.skip=true

# 构建 Go 客户端 (可选)
cd rpt-client-go
go build -o rpt-client-go

第二步：部署服务端

将 rpt-server/target/rpt-server-*.jar 和 server.yml 上传到公网服务器：

java -jar rpt-server-2.6.1.jar -c server.yml

第三步：启动客户端

Java 客户端：

java -jar rpt-client-2.6.1.jar -c client.yml

Go 客户端：

./rpt-client-go -config client.yml

第四步：验证连接

客户端启动后会自动连接服务端并注册端口映射。例如配置了 localPort: 3389 → remotePort: 4389，则可以通过 公网IP:4389 访问内网的 3389 端口服务。

🖥️ GUI 桌面客户端

提供基于 Wails 的图形界面客户端，无需手动编辑配置文件。

界面	截图
主界面
系统配置
TCP 映射配置
HTTP 映射配置
删除映射配置
控制台输出

编译桌面客户端

cd rpt-desktop-go
wails build

编译后的可执行文件在 build/bin/ 目录下。

📝 配置详解

服务端配置 server.yml

# 服务端绑定IP (0.0.0.0表示监听所有网卡)
serverIp: 0.0.0.0

# 服务端与客户端通讯端口
serverPort: 6167

# 服务端CA证书路径 (默认ca.crt)
serverCaPath: ca.crt

# 服务端证书路径 (默认server.crt)
serverCertPath: server.crt

# 服务端私钥路径 (默认pkcs8_server.key)
serverKeyPath: pkcs8_server.key

# HTTP重定向端口 (为0则不开启，默认0)
httpPort: 80

# HTTPS复用端口 (为0则不开启，默认0)
httpsPort: 443

# 域名证书公钥 (httpsPort为0时不生效)
domainCert: domain.crt

# 域名证书私钥 (httpsPort为0时不生效)
domainKey: pkcs8_domain.key

# 是否限制连接暴露端口的IP必须在当前地区国家 (默认false)
ipFilter: true

# Dashboard管理面板端口 (为0则不开启，默认0)
dashboardPort: 8000

# Dashboard登录账号
dashboardUser: admin

# Dashboard登录密码
dashboardPassword: admin

# 客户端授权Token列表
token:
  - clientKey: b0cc39c7-1b78-4ff6-9486-020399f569e9
    minPort: 4000    # 允许绑定的最小端口 (默认1024)
    maxPort: 8000    # 允许绑定的最大端口 (默认65535)
  - clientKey: 4befea7e-a61c-4979-b012-47659bab6f21
    minPort: 9000
    maxPort: 9999

服务端配置参数说明

客户端配置 client.yml

# 服务端IP (公网服务器IP或域名)
serverIp: 123.45.67.89

# 服务端通讯端口 (与server.yml的serverPort一致)
serverPort: 6167

# 客户端CA证书路径 (默认ca.crt)
clientCaPath: ca.crt

# 客户端证书路径 (默认client.crt)
clientCertPath: client.crt

# 客户端私钥路径 (默认pkcs8_client.key)
clientKeyPath: pkcs8_client.key

# 授权密钥 (与server.yml中token列表对应)
clientKey: b0cc39c7-1b78-4ff6-9486-020399f569e9

# 端口映射配置列表
config:
  # TCP代理示例：远程桌面
  - proxyType: TCP
    localIp: 127.0.0.1
    localPort: 3389
    remotePort: 4389
    description: rdp-tcp

  # UDP代理示例：远程桌面UDP
  - proxyType: UDP
    localIp: 127.0.0.1
    localPort: 3389
    remotePort: 4389
    description: rdp-udp

  # TCP代理示例：Redis
  - proxyType: TCP
    localIp: 127.0.0.1
    localPort: 6379
    remotePort: 7379
    description: redis

  # HTTP代理示例：Web应用
  - proxyType: HTTP
    localIp: 127.0.0.1
    localPort: 8080
    domain: test.domain.com       # 访问域名
    token: admin:admin            # Basic认证 (可选)
    description: tomcat

客户端配置参数说明

三种代理类型对比

📦 部署指南

方式一：直接运行 (推荐快速体验)

# 服务端
java -jar rpt-server-2.6.1.jar -c server.yml

# 客户端
java -jar rpt-client-2.6.1.jar -c client.yml

方式二：生产环境部署 (Java)

在 jar 包的当前目录下，新建 conf 文件夹，将配置文件和证书放入其中。

目录结构

/opt/rpt-server/
├── rpt-server-2.6.1.jar
├── conf/
│   ├── server.yml
│   ├── ca.crt
│   ├── server.crt
│   ├── pkcs8_server.key
│   ├── domain.crt          # HTTPS域名证书 (可选)
│   ├── pkcs8_domain.key    # HTTPS域名私钥 (可选)
│   └── Country.mmdb        # GeoIP数据库 (可选)
└── logs/

/opt/rpt-client/
├── rpt-client-2.6.1.jar
├── conf/
│   ├── client.yml
│   ├── ca.crt
│   ├── client.crt
│   └── pkcs8_client.key
└── logs/

启动脚本 start.sh

java -server -d64 -XX:+UseG1GC -XX:MaxGCPauseMillis=200 -Dnetworkaddress.cache.ttl=600 \
     -Djava.security.egd=file:/dev/./urandom -Djava.awt.headless=true -Duser.timezone=Asia/Shanghai -Duser.country=CN \
     -Dclient.encoding.override=UTF-8 -Dfile.encoding=UTF-8 -Xbootclasspath/a:./conf \
     -jar rpt*.jar > /dev/null 2>&1 & echo $! > pid.file &

停止脚本 stop.sh

kill $(cat pid.file)

方式三：Docker 部署

rpt-server

# 1. 构建镜像
cd rpt-server
mvn clean package -Dmaven.test.skip=true
docker build -f Dockerfile -t rpt-server .

# 2. 准备配置文件目录
mkdir -p /opt/rpt/conf
# 将 server.yml、ca.crt、server.crt、pkcs8_server.key 放入 /opt/rpt/conf/
# 如需 HTTPS: 放入 domain.crt、pkcs8_domain.key
# 如需 IP 过滤: 放入 Country.mmdb

# 3. 启动容器 (host 网络模式，直接暴露所有端口)
docker run -d \
  --network host \
  -v /opt/rpt/conf:/home/rpt/conf \
  --restart=always \
  --name rpt-server \
  rpt-server

# 或者指定端口映射
docker run -d \
  -p 6167:6167 \
  -p 80:80 \
  -p 443:443 \
  -p 8000:8000 \
  -p 4000-9999:4000-9999 \
  -v /opt/rpt/conf:/home/rpt/conf \
  --restart=always \
  --name rpt-server \
  rpt-server

rpt-client (Java)

# 1. 构建镜像
cd rpt-client
mvn clean package -Dmaven.test.skip=true
docker build -f Dockerfile -t rpt-client .

# 2. 准备配置文件目录
mkdir -p /opt/rpt/conf
# 将 client.yml、ca.crt、client.crt、pkcs8_client.key 放入 /opt/rpt/conf/

# 3. 启动容器
docker run -d \
  --network host \
  -v /opt/rpt/conf:/home/rpt/conf \
  --restart=always \
  --name rpt-client \
  rpt-client

rpt-client-go

# 1. 构建镜像
cd rpt-client-go
docker build -f Dockerfile -t rpt-client-go .

# 2. 准备配置文件目录
mkdir -p /opt/rpt/conf
# 将 client.yml、ca.crt、client.crt、pkcs8_client.key 放入 /opt/rpt/conf/

# 3. 启动容器
docker run -d \
  --network host \
  -v /opt/rpt/conf:/home/rpt/conf \
  --restart=always \
  --name rpt-client-go \
  rpt-client-go

提示：客户端使用 --network host 模式时可直接访问宿主机的本地服务（如 127.0.0.1:3389）。若不使用 host 模式，localIp 需改为宿主机的 Docker 网桥 IP（通常为 172.17.0.1）或使用 host.docker.internal。

使用 Docker Hub 镜像（免构建）

# rpt-server
docker run -d --network host -v /opt/rpt/conf:/home/rpt/conf --restart=always --name rpt-server promptness/rpt-server:2.6.1

# rpt-client (Java)
docker run -d --network host -v /opt/rpt/conf:/home/rpt/conf --restart=always --name rpt-client promptness/rpt-client:2.6.1

# rpt-client-go
docker run -d --network host -v /opt/rpt/conf:/home/rpt/conf --restart=always --name rpt-client-go promptness/rpt-client-go:2.6.1

Docker Hub 镜像地址：

• https://hub.docker.com/r/promptness/rpt-server
• https://hub.docker.com/r/promptness/rpt-client
• https://hub.docker.com/r/promptness/rpt-client-go

方式四：注册 Linux 系统服务

Go 客户端 systemd 服务

创建 /etc/systemd/system/rpt-client-go.service：

[Unit]
Description=RPT Client Go
After=network.target

[Service]
Type=simple
WorkingDirectory=/opt/rpt
ExecStart=/opt/rpt/rpt-client-go -config client.yml
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable rpt-client-go
sudo systemctl start rpt-client-go
sudo systemctl status rpt-client-go

Java 客户端 systemd 服务

创建 /etc/systemd/system/rpt-client.service：

[Unit]
Description=RPT Client Java
After=network.target

[Service]
Type=simple
WorkingDirectory=/opt/rpt-client
ExecStart=/usr/bin/java -server -XX:+UseG1GC -XX:MaxGCPauseMillis=200 -Dnetworkaddress.cache.ttl=600 -Djava.security.egd=file:/dev/./urandom -Djava.awt.headless=true -Duser.timezone=Asia/Shanghai -Dclient.encoding.override=UTF-8 -Dfile.encoding=UTF-8 -Xbootclasspath/a:./conf -jar rpt-client-2.6.1.jar
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

方式五：注册 Windows 服务

1. 下载 WinSW，将 WinSW-x64.exe 重命名为 rpt-client.exe
2. 与 rpt-client.jar 放在同一目录
3. 创建 rpt-client.xml：

<service>
    <id>rpt-client</id>
    <name>rpt-client</name>
    <description>RPT Client - Reverse Proxy Tool</description>
    <executable>java</executable>
    <arguments>-server -d64 -XX:+UseG1GC -XX:MaxGCPauseMillis=200 -Dnetworkaddress.cache.ttl=600 -Djava.security.egd=file:/dev/./urandom -Djava.awt.headless=true -Duser.timezone=Asia/Shanghai -Duser.country=CN -Dclient.encoding.override=UTF-8 -Dfile.encoding=UTF-8 -Xbootclasspath/a:./conf -jar rpt-client.jar</arguments>
</service>

4. 执行注册：

rpt-client.exe install
rpt-client.exe start

📊 Dashboard 管理面板

服务端内置 Web Dashboard，提供实时监控和管理功能。

开启方式

在 server.yml 中配置 dashboardPort 为非零端口即可：

dashboardPort: 8000
dashboardUser: admin
dashboardPassword: admin

启动服务端后访问 http://服务器IP:8000，输入账号密码即可进入。

功能

REST API

🐹 Go 客户端

使用 Go 语言实现的轻量级客户端，功能与 Java 客户端一致，适合不便安装 JVM 的环境。

命令行参数

证书路径已移至 client.yml 配置文件中（clientCaPath、clientCertPath、clientKeyPath），不配置则使用默认值。

编译

cd rpt-client-go
go build -o rpt-client-go

交叉编译

# Linux amd64
GOOS=linux GOARCH=amd64 go build -o rpt-client-go

# Linux arm64 (树莓派等)
GOOS=linux GOARCH=arm64 go build -o rpt-client-go

# Windows
GOOS=windows GOARCH=amd64 go build -o rpt-client-go.exe

# macOS (Intel)
GOOS=darwin GOARCH=amd64 go build -o rpt-client-go

# macOS (Apple Silicon)
GOOS=darwin GOARCH=arm64 go build -o rpt-client-go

🔐 SSL 证书

RPT 使用 SSL 双向认证确保通讯安全。项目自带测试用证书，生产环境请务必替换。

证书生成流程

自建CA → 生成服务端/客户端私钥 → 生成CSR → 签发x509证书 → PKCS#8编码

1. 安装 OpenSSL

• Linux: apt install openssl 或 yum install openssl
• Windows: 下载 Win32OpenSSL
• macOS: brew install openssl

2. 建立 CA

openssl req -new -x509 -keyout ca.key -out ca.crt -days 36500

3. 生成私钥

# 服务端
openssl genrsa -des3 -out server.key 1024

# 客户端
openssl genrsa -des3 -out client.key 1024

4. 生成 CSR

# 服务端
openssl req -new -key server.key -out server.csr

# 客户端
openssl req -new -key client.key -out client.csr

⚠️ 如果生成 server.csr 后再生成 client.csr 提示错误，请关闭当前终端重新打开执行。

5. 签发证书

# 服务端
openssl x509 -req -days 3650 -in server.csr -CA ca.crt -CAkey ca.key -CAcreateserial -out server.crt

# 客户端
openssl x509 -req -days 3650 -in client.csr -CA ca.crt -CAkey ca.key -CAcreateserial -out client.crt

6. PKCS#8 编码

# 服务端
openssl pkcs8 -topk8 -in server.key -out pkcs8_server.key -nocrypt

# 客户端
openssl pkcs8 -topk8 -in client.key -out pkcs8_client.key -nocrypt

证书分发

⚠️ Server 和 Client 使用同一个 ca.crt，即由同一 CA 签发。

🔄 更新 IP 地域库

服务端支持基于 MaxMind GeoIP 数据库的 IP 地域过滤功能。

下载地址：

• MaxMind GeoLite2
• Loyalsoldier/geoip
• Dreamacro/maxmind-geoip

将下载的 Country.mmdb 放入服务端的 conf 文件夹中。

❓ 常见问题

-Dprism.order=sw

📋 支持的 TCP 上层协议

📋 TODO

• Dashboard 管理面板（流量统计、流速监控、客户端管理）
• 集群运维版本

⭐ Star History

📄 License

MIT License