如果你家里有 NAS、软路由、开发机,或者想把本地运行的服务暴露到公网访问,frp(Fast Reverse Proxy) 是目前最主流的开源内网穿透工具。它采用 服务端(frps)+ 客户端(frpc) 的架构:公网服务器负责中转流量,内网机器负责主动连接。
本文以 Ubuntu 系统为例,手把手带你完成 frps 服务端的标准部署。教程全部采用官方最新的 TOML 配置格式,并结合 systemd 实现后台守护与开机自启,避开新手最容易踩的权限、端口和旧版配置坑。
一、 前置准备
在开始之前,你需要准备以下环境:
- 一台拥有公网 IP 的云服务器(如阿里云、腾讯云等),系统为 Ubuntu 22.04。
- SSH 连接工具(如 FinalShell、Xshell、Tabby 或系统自带终端),以
root身份登录服务器。 - 文件存放目录:本文以
/www/wwwroot/frp为例(如果你安装了宝塔面板,这个路径会非常顺手;没装宝塔也可以直接放在/usr/local/frp)。
二、 下载并准备 frps 程序
- 创建存放目录并进入
mkdir -p /www/wwwroot/frp
cd /www/wwwroot/frp
- 下载最新版 frp
前往官方 GitHub Releases 页面([https://github.com/fatedier/frp/releases](https://github.com/fatedier/frp/releases))查看最新版本号。普通 x86_64 架构的云服务器选择 linux_amd64 版本(ARM 架构服务器选择 linux_arm64)。
你可以直接在本地下载解压后,只把 frps 和 frps.toml 这两个文件上传到 /www/wwwroot/frp 目录;也可以在服务器上用命令行下载解压(以 v0.72.0 为例,请替换为当前最新版本):
wget https://github.com/fatedier/frp/releases/download/v0.72.0/frp_0.72.0_linux_amd64.tar.gz
tar -zxvf frp_0.72.0_linux_amd64.tar.gz
cp frp_0.72.0_linux_amd64/frps /www/wwwroot/frp
cp frp_0.72.0_linux_amd64/frps.toml /www/wwwroot/frp
- 赋予可执行权限与目录归属
确认目录下已经有 frps 和 frps.toml 后,给程序加上执行权限:
chmod +x /www/wwwroot/frp/frps
关于运行用户的说明:
如果你安装了宝塔面板,系统里会有www用户,建议把目录归属权交给www:chown -R www:www /www/wwwroot/frp* 如果你是纯净版 Ubuntu(没装宝塔),执行id www会提示用户不存在,此时建议将下文中的www全部替换为www-data(Ubuntu 默认 Web 用户)或直接使用root。
三、 编写新版 TOML 配置文件
早期网上的教程大多使用 frps.ini 和 [common] 写法,但新版 frp 已经正式弃用 INI 格式(强行使用会在日志里报 WARNING: ini format is deprecated,且未来版本将彻底移除支持)。
执行命令编辑配置文件:
vim /www/wwwroot/frp/frps.toml
清空原有内容,粘贴以下标准 TOML 配置(请务必修改里面的端口、账号、密码和 Token):
# 服务端与客户端(frpc)通信的监听端口,默认 7000,建议改成自定义高位端口
bindPort = 7000
# Web 监控面板(Dashboard)配置
# 注意:新版 TOML 默认只监听 127.0.0.1,必须显式写 0.0.0.0 才能从公网浏览器访问
webServer.addr = "0.0.0.0"
webServer.port = 7500
webServer.user = "admin"
webServer.password = "YourStrongPassword123!"
# 客户端连接鉴权配置(强烈建议开启,防止服务器被他人白嫖)
auth.method = "token"
auth.token = "YourSuperSecretToken_ChangeMe"
配置避坑指南
- 双引号不能省:TOML 语法中,所有字符串(IP、用户名、密码、Token)都必须用双引号包裹,数字(端口号)不需要引号。
- 关于
enablePrometheus监控项:很多老教程会加上enable_prometheus = true。Prometheus 是给专业运维搭配 Grafana 画监控大屏和做自动告警用的,个人自用完全不需要开,删掉即可,还能避免新版 frp 的弃用警告。
四、 配置 systemd 实现后台运行与开机自启
直接命令行运行 ./frps -c frps.toml 会在关闭 SSH 窗口后立刻断开。生产环境必须交给 Ubuntu 的 systemd 来托管,实现后台常驻、崩溃自动重启、开机自启。
- 创建服务文件
vim /etc/systemd/system/frps.service
- 写入优化后的服务配置
[Unit]
Description=Frp Server Service
# 确保在网络完全就绪后再启动,避免重启服务器时因网卡未就绪而报错
After=network-online.target syslog.target
Wants=network-online.target
[Service]
Type=simple
# 若未安装宝塔面板,请将 www 改为 www-data 或 root
User=www
Group=www
WorkingDirectory=/www/wwwroot/frp
ExecStart=/www/wwwroot/frp/frps -c /www/wwwroot/frp/frps.toml
# 异常退出时自动重启,间隔 5 秒
Restart=on-failure
RestartSec=5s
# 调大文件描述符上限,防止高并发穿透连接时触发系统句柄限制导致断连
LimitNOFILE=1048576
# 赋予非 root 用户监听 1024 以下端口(如 80、443)的权限
AmbientCapabilities=CAP_NET_BIND_SERVICE
[Install]
WantedBy=multi-user.target
避坑提示: 网上有些旧教程会在
[Service]里写ExecReload=/bin/kill -HUP $MAINPID。千万不要加这行!frps不支持通过SIGHUP信号热重载,如果误操作执行了systemctl reload frps,反而会导致服务直接退出。
- 重载配置并启动服务
# 让 systemd 重新读取服务配置
systemctl daemon-reload
# 设置开机自启并立即启动 frps(一条命令等价于 enable + start)
systemctl enable --now frps
五、 放行防火墙与云服务器安全组
服务跑起来后,如果外网连不上,99% 是因为端口没放行。需要同时检查两层防火墙:
- 云服务器安全组(必做)
登录你的云服务商控制台(阿里云 ECS / 腾讯云轻量等),找到对应服务器的安全组/防火墙规则,在入方向放行以下 TCP 端口:
7000(你配置的bindPort)7500(你配置的webServer.port)- 后续客户端
frpc打算映射出来的公网端口(例如8080、2222等,也可以直接放行一个端口段如10000-20000)。
- 服务器内部防火墙(二选一)
- 装了宝塔面板:进入宝塔后台 -> 左侧 安全 -> 系统防火墙 -> 添加上述端口规则。
- 未装宝塔(使用系统 UFW):如果开启了
ufw,执行命令放行:
ufw allow 7000/tcp
ufw allow 7500/tcp
六、 验证部署是否成功
按顺序执行以下 4 步检查,全部通过即代表服务端完美运行:
- 检查运行状态
systemctl status frps
看到绿色的 Active: active (running) 且状态为 enabled,说明进程正常且开机自启已生效。
- 查看完整启动日志(确认无报错和警告)
journalctl -u frps -n 20 --no-pager
正常情况下应该能看到类似如下的干净输出:
frps tcp listen on 0.0.0.0:7000dashboard listen on 0.0.0.0:7500frps started successfully
- 确认端口监听状态
ss -tulpn | grep frps
确认 7000 和 7500 端口均处于 LISTEN 状态。
- 浏览器访问面板
在本地电脑浏览器地址栏输入 http://你的服务器公网IP:7500,输入 frps.toml 中设置的账号密码,能顺利进入 frps 监控页面即大功告成!
七、 日常运维常用命令速查
以后修改了 frps.toml 配置文件,或者需要排查问题时,直接用以下命令即可:
| 操作目的 | 执行命令 |
|---|---|
| 启动服务 | systemctl start frps |
| 停止服务 | systemctl stop frps |
| 重启服务(改完配置后执行) | systemctl restart frps |
| 查看运行状态 | systemctl status frps |
| 实时查看运行日志 | journalctl -u frps -f |
| 取消开机自启 | systemctl disable frps |
(注:为了你的服务器安全,发文前记得检查一遍,本文中的端口、账号密码和 Token 均已替换为示例占位符,切勿将真实密码和 Token 发布到公开网络。)
