这是一个基于 FRP 的内网穿透解决方案，包含服务端和客户端程序，支持自动启动和服务化管理。
.
├── frps # 服务端可执行文件
├── frps.toml # 服务端配置文件
├── frps.service # 服务端systemd服务文件
├── install-server.sh # 服务端安装脚本
├── .env.example # 环境变量配置示例
├── linux-x86-client/ # Linux客户端目录
│ ├── frpc # Linux客户端可执行文件
│ ├── frpc.toml # Linux客户端配置文件
│ ├── frpc.service # Linux客户端systemd服务文件
│ └── install-client.sh # Linux客户端安装脚本
└── windows-x86-client/ # Windows客户端目录
├── frpc.exe # Windows客户端可执行文件
├── frpc.toml # Windows客户端配置文件
├── install-service.bat # Windows客户端服务安装脚本
└── uninstall-service.bat # Windows客户端服务卸载脚本
- 将项目文件上传到 CloudStudio
- 运行安装脚本：
sudo ./install-server.sh
- 服务状态管理：
# 查看服务状态
systemctl status frps
# 重启服务
systemctl restart frps
# 停止服务
systemctl stop frps
# 查看服务日志
journalctl -u frps -f
服务端配置文件 frps.toml：
- 端口 7000: 客户端连接端口
- 端口 7500: Web管理界面端口
- 默认账号: admin/admin
访问 Web 管理界面：http://127.0.0.1:7500 (默认配置)
服务启动状态：安装后服务将自动启动并设置为开机自启动
- 设置环境变量（可选，不设置将使用默认配置）：
export FRP_SERVER_ADDR=your-server-ip
export FRP_SERVER_PORT=7000
export FRP_CLIENT_NAME=my-device
- 运行安装脚本：
sudo ./install-client.sh
- 服务管理：
# 查看服务状态
systemctl status frpc
# 重启服务
systemctl restart frpc
# 停止服务
systemctl stop frpc
# 查看服务日志
journalctl -u frpc -f
默认配置说明：如果不设置环境变量，客户端将使用默认配置连接到
127.0.0.1:7000
- 修改
install-service.bat中的环境变量：
set FRP_SERVER_ADDR=your-server-ip
set FRP_SERVER_PORT=7000
set FRP_CLIENT_NAME=my-device
- 以管理员身份运行安装脚本：
install-service.bat
- 服务管理：
# 查看服务状态
sc query FRPClient
# 重启服务
sc stop FRPClient
sc start FRPClient
# 查看服务日志
# 日志保存在 Windows 事件查看器中
- 卸载服务：
uninstall-service.bat
默认配置说明：如果不修改环境变量，客户端将使用默认配置连接到
127.0.0.1:7000技术说明：使用Windows原生
sc命令创建服务，无需第三方工具
客户端默认配置了多个常用服务的TCP代理，包括SSH、Web服务、数据库等。具体配置如下：
| 服务名称 | 本地端口 | 远程端口 | 用途说明 |
|---|---|---|---|
| SSH | 22 | 6000 | SSH远程连接 |
| Web开发 | 8080 | 6080 | 本地Web开发服务器 |
| MySQL | 3306 | 6306 | MySQL数据库访问 |
| Redis | 6379 | 6379 | Redis缓存访问 |
| PostgreSQL | 5432 | 5432 | PostgreSQL数据库访问 |
| 备用1 | 6001 | 6001 | 自定义服务备用 |
| 备用2 | 6002 | 6002 | 自定义服务备用 |
| 备用3 | 6003 | 6003 | 自定义服务备用 |
| 服务名称 | 本地端口 | 远程端口 | 用途说明 |
|---|---|---|---|
| 远程桌面 | 3389 | 3389 | Windows远程桌面连接 |
| SSH | 22 | 6000 | SSH服务(如Git Bash/WSL) |
| Web开发 | 8080 | 6080 | 本地Web开发服务器 |
| IIS网站 | 80 | 6080 | IIS默认网站 |
| SQL Server | 1433 | 61433 | SQL Server数据库 |
| MySQL | 3306 | 6306 | MySQL数据库访问 |
| 备用1 | 6001 | 6001 | 自定义服务备用 |
| 备用2 | 6002 | 6002 | 自定义服务备用 |
| 备用3 | 6003 | 6003 | 自定义服务备用 |
注意：只有本地对应端口有服务在运行时，相应的代理才会生效。
在 frpc.toml 中添加新的代理配置：
# HTTP代理
[[proxies]]
name = "web"
type = "http"
localIP = "127.0.0.1"
localPort = 80
customDomains = ["your-domain.com"]
# HTTPS代理
[[proxies]]
name = "web-secure"
type = "https"
localIP = "127.0.0.1"
localPort = 443
customDomains = ["your-domain.com"]
# TCP代理
[[proxies]]
name = "database"
type = "tcp"
localIP = "127.0.0.1"
localPort = 3306
remotePort = 3306
客户端支持通过环境变量灵活配置服务器地址：
| 环境变量 | 说明 | 默认值 |
|---|---|---|
| FRP_SERVER_ADDR | 服务器IP地址 | 127.0.0.1 |
| FRP_SERVER_PORT | 服务器端口 | 7000 |
| FRP_CLIENT_NAME | 客户端标识名称 | default-client |
配置说明：默认配置适用于在同一台机器上测试，实际部署时需要将
FRP_SERVER_ADDR修改为实际的服务器IP地址。
Linux:
# 方法1：导出环境变量
export FRP_SERVER_ADDR=127.0.0.1
export FRP_SERVER_PORT=7000
sudo ./install-client.sh
# 方法2：在运行时指定
sudo FRP_SERVER_ADDR=127.0.0.1 FRP_SERVER_PORT=7000 ./install-client.sh
Windows:
修改 install-service.bat 中的环境变量设置，例如：
set FRP_SERVER_ADDR=127.0.0.1
set FRP_SERVER_PORT=7000
- 远程SSH访问：通过远程端口6000连接SSH服务
ssh server-ip -p 6000 - Web开发调试：通过远程端口6080访问本地8080端口的Web应用
http://server-ip:6080 - 数据库访问：远程访问MySQL、Redis、PostgreSQL等数据库服务
- 自定义服务：使用备用端口6001-6003部署自定义服务
- 远程桌面连接：通过远程端口3389访问Windows桌面
- Web开发调试：通过远程端口6080访问本地IIS或开发服务器
- 数据库管理：远程访问SQL Server、MySQL等数据库
- SSH访问：通过远程端口6000访问WSL或Git Bash的SSH服务
- 开发环境共享：将本地开发环境暴露给团队成员或客户
- 家庭网络访问：从外部访问家庭网络中的设备和服务
- 测试环境部署：临时暴露测试服务供外部测试
- 备份服务同步：通过备用端口配置备份和数据同步服务
- 修改Web管理界面的默认用户名和密码
- 合理配置防火墙规则，只开放必要的端口
- 使用域名和HTTPS保护敏感数据传输
- 定期更新FRP到最新版本
- 检查配置文件语法是否正确
- 确认端口未被占用
- 查看服务日志：
journalctl -u frps或journalctl -u frpc
- 确认服务器地址和端口配置正确
- 检查网络连通性和防火墙设置
- 验证服务端是否正常运行
- 检查本地服务状态：确认对应本地端口有服务在运行
# Linux检查端口占用 netstat -tlnp | grep :22 netstat -tlnp | grep :8080 # Windows检查端口占用 netstat -an | findstr :22 netstat -an | findstr :8080 - 确认端口映射配置：检查frpc.toml中的localIP和localPort是否正确
- 查看服务端状态：访问Web管理界面 http://127.0.0.1:7500 检查连接和代理状态
- 检查防火墙设置：确保本地防火墙允许对应端口的连接
# 运行服务端卸载脚本
sudo ./uninstall-server.sh
# 运行客户端卸载脚本
sudo ./linux-x86-client/uninstall-client.sh
运行 windows-x86-client/uninstall-service.bat 即可。
注意：卸载脚本只会删除系统服务，配置文件和可执行文件会保留，如需完全删除请手动删除相关目录。
本项目基于原FRP项目，遵循相应的开源许可证。
About
35/F,Tencent Building,Kejizhongyi Avenue,Nanshan District,Shenzhen
