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:6234
    S->>S: 解析 Host 域名路由 和 Cookie 会话验证
    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

✨ 功能特性

特性	说明
🔌 TCP 代理	支持任何 TCP 上层协议：RDP远程桌面、SSH、FTP、数据库连接等
📡 UDP 代理	支持任何 UDP 上层协议：DNS转发、游戏服务器代理等
🌐 HTTP 端口复用	多个客户端共用服务端 HTTP 端口，通过域名区分路由
🔒 SSL 双向认证	客户端与服务端双向 SSL 验证，数据加密传输
🌍 IP 地域过滤	基于 MaxMind GeoIP 数据库限制访问来源国家
🔑 Token 授权	每个客户端独立密钥，可限制端口绑定范围
⬆️ 协议升级	HTTP 请求支持升级为 WebSocket、HTTP/2
📊 Dashboard	内置 Web 管理面板，实时监控在线客户端、流量统计、流速监控
⚡ 零拷贝传输	基于 Netty ByteBuf retainedSlice 全链路零拷贝，堆外内存直接转发
🔄 断线自动重连	客户端指数退避自动重连 + 心跳保活，网络波动后自动恢复隧道
🖥️ 桌面客户端	提供 GUI 桌面客户端，开箱即用
🐳 Docker 部署	提供 Docker 镜像，一键启动
🐹 Go 客户端	轻量级 Go 实现，无需 JVM 环境

🏗️ 项目架构

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

技术栈

组件	技术
服务端	Java 8+, Netty 4.1, Protostuff
Java 客户端	Java 8+, Netty 4.1
Go 客户端	Go 1.20+
桌面客户端	Wails (Go + Web前端)
序列化	Protostuff
配置文件	YAML (SnakeYAML / Jackson)
日志	Logback
IP 地域库	MaxMind GeoIP2
构建工具	Maven / Go Modules

🎯 使用场景

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

⚡ 快速开始

前置条件

组件	要求
公网服务器	一台具有公网 IP 的服务器
Java 客户端	JDK/JRE 8+
Go 客户端	无需额外运行环境 (独立二进制)
服务端	JDK/JRE 8+

第一步：编译构建

# 克隆项目
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-*.jar -c server.yml

第三步：启动客户端

Java 客户端：

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

Go 客户端：

./rpt-client-go -c 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: 6234

# 限制连接暴露端口的IP必须属于这些国家 (ISO码,逗号分隔,如 CN,HK) 留空=关闭国家过滤(放行所有)
ipFilterCountry: CN,HK

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

# 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

服务端配置参数说明

参数	类型	默认值	说明
`serverIp`	String	`0.0.0.0`	服务端绑定的IP地址
`serverPort`	int	`6167`	服务端与客户端通讯端口
`serverCaPath`	String	`ca.crt`	服务端CA证书路径
`serverCertPath`	String	`server.crt`	服务端证书路径
`serverKeyPath`	String	`pkcs8_server.key`	服务端私钥路径
`httpPort`	int	`0`	HTTP重定向端口，为0不开启
`ipFilterCountry`	String	空	允许访问的国家ISO码(逗号分隔,如 `CN,HK`)，留空=关闭国家过滤
`dashboardPort`	int	`0`	Dashboard管理面板端口，为0不开启
`dashboardUser`	String	-	Dashboard登录账号
`dashboardPassword`	String	-	Dashboard登录密码
`token[].clientKey`	String	-	客户端授权密钥 (UUID)
`token[].minPort`	int	`1024`	允许绑定的最小端口号
`token[].maxPort`	int	`65535`	允许绑定的最大端口号

客户端配置 `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            # 登录认证凭据 (可选, 格式 user:pass)
    description: tomcat

客户端配置参数说明

参数	类型	说明
`serverIp`	String	服务端公网IP或域名
`serverPort`	int	服务端通讯端口
`clientCaPath`	String	客户端CA证书路径（默认 `ca.crt`）
`clientCertPath`	String	客户端证书路径（默认 `client.crt`）
`clientKeyPath`	String	客户端私钥路径（默认 `pkcs8_client.key`）
`clientKey`	String	客户端授权密钥
`config[].proxyType`	String	代理类型：`TCP` / `UDP` / `HTTP`
`config[].localIp`	String	内网目标服务IP
`config[].localPort`	int	内网目标服务端口
`config[].remotePort`	int	服务端暴露端口 (TCP/UDP模式)
`config[].domain`	String	访问域名 (HTTP模式，支持 `*.domain.com` 通配符)
`config[].token`	String	登录认证凭据 `用户名:密码`，未配置则无需登录 (可选)
`config[].description`	String	映射描述信息

三种代理类型对比

类型	协议	端口	域名	适用场景
TCP	TCP	需要指定 `remotePort`	不需要	RDP、SSH、数据库、FTP 等
UDP	UDP	需要指定 `remotePort`	不需要	DNS转发、游戏服务器等
HTTP	HTTP	复用服务端 HTTP 端口	需要配置 `domain`	Web应用、API接口等

📦 部署指南

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

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

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

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

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

目录结构

/opt/rpt-server/
├── rpt-server-*.jar
├── conf/
│   ├── server.yml
│   ├── ca.crt
│   ├── server.crt
│   ├── pkcs8_server.key
│   └── Country.mmdb        # GeoIP数据库 (可选)
└── logs/

/opt/rpt-client/
├── rpt-client-*.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/
# 如需 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 6234:6234 \
  -p 7476:7476 \
  -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 镜像地址：

方式四：注册 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 -c 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 服务

下载 WinSW，将 WinSW-x64.exe 重命名为 rpt-client.exe
与 rpt-client.jar 放在同一目录
创建 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>

执行注册：

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

📊 Dashboard 管理面板

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

开启方式

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

dashboardPort: 7476
dashboardUser: admin
dashboardPassword: admin

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

功能

功能	说明
服务状态	运行时间、在线客户端数、历史连接数
客户端列表	查看所有在线客户端的 ClientKey、远程地址、连接时间、代理端口
流量统计	每个客户端的入站/出站总流量
实时流速	基于 5 秒滑动窗口的入站/出站实时流速
域名绑定	查看 HTTP 代理的域名路由和在线状态
踢出客户端	一键断开指定客户端连接
自动刷新	页面每 5 秒自动刷新数据
响应式布局	支持 PC 和移动端访问

REST API

方法	路径	说明
GET	`/api/status`	服务状态
GET	`/api/clients`	在线客户端列表
DELETE	`/api/clients/{id}`	踢出指定客户端
GET	`/api/domains`	HTTP 域名绑定列表

🐹 Go 客户端

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

命令行参数

参数	默认值	说明
`-config`, `-c`	`conf/client.yml` 或 `client.yml`	客户端配置文件路径

证书路径已移至 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	`ca.crt`、`server.crt`、`pkcs8_server.key`
Client	`ca.crt`、`client.crt`、`pkcs8_client.key`

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

🔄 更新 IP 地域库

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

下载地址：

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

❓ 常见问题

Q: 客户端连接不上服务端？

检查服务端防火墙是否开放 serverPort 端口（默认 6167）
检查 client.yml 中 serverIp 和 serverPort 是否正确
检查 clientKey 是否与服务端 token 列表匹配
检查 SSL 证书是否由同一 CA 签发

Q: TCP 端口映射后无法访问？

检查服务端防火墙是否开放 remotePort 对应端口
检查 remotePort 是否在服务端 token 配置的 minPort ~ maxPort 范围内
检查内网目标服务是否正常运行
如果配置了 ipFilterCountry，确认访问者 IP 所在国家是否在白名单内

Q: HTTP 代理如何配置域名？

将域名 DNS 解析到公网服务器 IP（A 记录）
支持通配符域名 *.domain.com，例如 test.domain.com
客户端 client.yml 中 domain 字段填写完整域名
服务端需开启 httpPort

📋 支持的 TCP 上层协议

协议	用途
HTTP/HTTPS	Web 浏览
FTP	文件传输
SSH	安全远程登录
RDP	远程桌面
SMTP/POP3	邮件收发
Telnet	远程登录
SOCKS	代理协议

⭐ Star History

📄 License

MIT License

Name		Name	Last commit message	Last commit date
Latest commit History 398 Commits
doc		doc
rpt-base		rpt-base
rpt-client-go		rpt-client-go
rpt-client		rpt-client
rpt-desktop-go		rpt-desktop-go
rpt-server		rpt-server
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
go.work		go.work
pom.xml		pom.xml

Folders and files

Latest commit

History

Repository files navigation