运维部署
内网穿透
frp
Linux运维

从零部署 frps 内网穿透服务端(新版 TOML 配置 + systemd 保姆级教程)

阿瑞
2026-11-20
1651 阅读
热度 1651

如果你家里有 NAS、软路由、开发机,或者想把本地运行的服务暴露到公网访问,frp(Fast Reverse Proxy) 是目前最主流的开源内网穿透工具。它采用 服务端(frps)+ 客户端(frpc) 的架构:公网服务器负责中转流量,内网机器负责主动连接。

Gemini_Generated_Image_birxgxbirxgxbirx.jpg

本文以 Ubuntu 系统为例,手把手带你完成 frps 服务端的标准部署。教程全部采用官方最新的 TOML 配置格式,并结合 systemd 实现后台守护与开机自启,避开新手最容易踩的权限、端口和旧版配置坑。


一、 前置准备

在开始之前,你需要准备以下环境:

  1. 一台拥有公网 IP 的云服务器(如阿里云、腾讯云等),系统为 Ubuntu 22.04。
  2. SSH 连接工具(如 FinalShell、Xshell、Tabby 或系统自带终端),以 root 身份登录服务器。
  3. 文件存放目录:本文以 /www/wwwroot/frp 为例(如果你安装了宝塔面板,这个路径会非常顺手;没装宝塔也可以直接放在 /usr/local/frp)。

二、 下载并准备 frps 程序

  1. 创建存放目录并进入
mkdir -p /www/wwwroot/frp
cd /www/wwwroot/frp
  1. 下载最新版 frp

前往官方 GitHub 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
  1. 赋予可执行权限与目录归属

确认目录下已经有 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 来托管,实现后台常驻、崩溃自动重启、开机自启。

  1. 创建服务文件
vim /etc/systemd/system/frps.service
  1. 写入优化后的服务配置
[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,反而会导致服务直接退出。

  1. 重载配置并启动服务

# 让 systemd 重新读取服务配置

systemctl daemon-reload

# 设置开机自启并立即启动 frps(一条命令等价于 enable + start)

systemctl enable --now frps

五、 放行防火墙与云服务器安全组

服务跑起来后,如果外网连不上,99% 是因为端口没放行。需要同时检查两层防火墙:

  1. 云服务器安全组(必做)

登录你的云服务商控制台(阿里云 ECS / 腾讯云轻量等),找到对应服务器的安全组/防火墙规则,在入方向放行以下 TCP 端口:

  • 7000(你配置的 bindPort)
  • 7500(你配置的 webServer.port)
  • 后续客户端 frpc 打算映射出来的公网端口(例如 8080、2222 等,也可以直接放行一个端口段如 10000-20000)。
  1. 服务器内部防火墙(二选一)
  • 装了宝塔面板:进入宝塔后台 -> 左侧 安全 -> 系统防火墙 -> 添加上述端口规则。
  • 未装宝塔(使用系统 UFW):如果开启了 ufw,执行命令放行:
ufw allow 7000/tcp
ufw allow 7500/tcp

六、 验证部署是否成功

按顺序执行以下 4 步检查,全部通过即代表服务端完美运行:

  1. 检查运行状态
systemctl status frps

看到绿色的 Active: active (running) 且状态为 enabled,说明进程正常且开机自启已生效。

  1. 查看完整启动日志(确认无报错和警告)
journalctl -u frps -n 20 --no-pager

正常情况下应该能看到类似如下的干净输出:

  • frps tcp listen on 0.0.0.0:7000
  • dashboard listen on 0.0.0.0:7500
  • frps started successfully
  1. 确认端口监听状态
ss -tulpn | grep frps

确认 7000 和 7500 端口均处于 LISTEN 状态。

  1. 浏览器访问面板

在本地电脑浏览器地址栏输入 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 发布到公开网络。)

许可协议:知识共享声明

本站所有原创文章应用 CC BY-NC-SA 4.0 协议。转载请注明作者及出处,且不可用于商业目的。

免责声明

本站提供的所有资源仅供学习与学术研究参考。请于下载后 24 小时内自觉删除。如有侵权,请通过留言或反馈通道告知,我们将在收到通知后立即进行处理。

互动评论

登录后参与精彩讨论

近期推荐
暂无推荐
Admin

李瑞 (RUI)

SHUMOX FOUNDER

专注前端架构、React 生态与独立开发变现。分享最硬核的技术实战经验。

Gemini

Gemini

AI-Native
Powered byGoogle

基于 Google Gemini 模型深度协同构建,从全栈架构到交互细节,持续探索人机共创的高效开发新范式。

全栈架构人机协同持续演进
Gemini Co-Engineered · Powered by Google
Claude

Claude

Reasoning
Powered byAnthropic

由 Anthropic Claude 深度协同构建,以更强的推理与编码能力驱动站点持续迭代进化。

深度推理编码协作安全可控
Claude Co-Engineered · Powered by Anthropic

订阅周刊

每周一发布,分享最新的技术动态、设计灵感和独立开发经验。

© 2026 Shumox. All Rights Reserved.

苏ICP备2023001297号