frpc 客户端升级与加固实战:定位安装路径、systemd 原理、不动配置的二进制替换、fail2ban 互不干扰

内网穿透 frpc 客户端的完整升级手册:分清 frpc 与 frps、五种方法找到安装路径、读懂 systemd 单元、收紧配置权限、只替换二进制而让配置文件一字未动、install 与 cp 的实测差别、升级后如何数代理名、以及如何保证 fail2ban 等加固完全不受影响。

内网穿透工具 frp 升级,最容易出事的不是”升不上去”,而是升完之后配置被改了、隧道断了、甚至把 fail2ban 之类的加固给碰坏。这篇把一次真实的 frpc 客户端升级从头到尾拆开讲:先分清 frpc 和 frps 各管什么,再一步步学会找到安装路径、读懂 systemd 单元、只替换程序文件而不碰配置、升级后如何验证隧道、以及如何保证服务器上原有的加固措施完全不受影响。文中每一步都配真实服务器的截图,代码带中文白话注释,可直接复制对照执行。

本文所有 IP、域名、账号、token 均已脱敏,路径中的版本号目录也做了泛化处理。

目录

  • 一、先分清 frpc 和 frps:它们是两台机器上的两个角色
  • 二、第 1 步:找到 frp 到底装在哪、跑的是哪一个文件
  • 三、第 2 步:读懂 frpc 的 systemd 单元
  • 四、第 3 步:把配置文件的属主和权限收紧
  • 五、第 4 步:删掉一个”坏了但暂时没出事”的残留服务
  • 六、第 5 步:升级前先下载并校验新版本
  • 七、第 6 步:只替换两个二进制,配置文件一个字符都不碰
  • 八、第 7 步:重启并验证——数代理要数”名字”而不是数代码块
  • 九、第 8 步:怎么保证 fail2ban 等加固完全不受影响
  • 十、第 9 步:把这套流程固化成一条命令的升级脚本
  • 十一、这次踩过的坑(QA 速查)
  • 十二、安全与隐私经验
  • 十三、命令速查表

一、先分清 frpc 和 frps:它们是两台机器上的两个角色

这是新手最容易搞混的地方,先用一张图讲清楚:

内网设备  ──frpc(客户端,装在内网机器上)──►  公网服务器  ──►  外面的人
   ▲                                        frps(服务端)        通过 公网IP:端口 访问
   │                                             │
   └── 它自己就是被转发出去的服务之一              └── 负责"对外收端口、对内转发"
       (比如这台机器的 SSH 22 → 公网 40001)

白话说:frpc 是”出去的门”,frps 是”看门的”。它们装在两台不同的机器上,各管一头。

  • 升级 frpc 只需要在内网这台上做,本文后面所有步骤都在这台机器上执行。
  • 改隧道配置(哪个内网服务对应哪个公网端口)时,客户端改完要重启 frpc,隧道才会重新连上。
  • 公网端的 frps 是另一台机器,别在内网这台上乱改——内网机器上如果残留着 frps 的服务单元,恰恰说明它不该存在(见第五节)。

服务端长什么样,一并看一眼(这是脱敏后的真实输出):

服务端 frps 的版本、TLS 与监听端口
图1:服务端 frps——版本、TLS 强制开关、两个监听端口,以及配置文件权限

从这张图能读出三个关键信息:

  • transport.tls.force = true —— 服务端只收 TLS 加密连接,明文的一律拒绝。这意味着”客户端连上了”本身就是 TLS 生效的证据。
  • 127.0.0.1:7500 —— 管理面板只监听回环地址,外网访问不到,这是对的。
  • -rw------- —— 面板口令写在配置文件里,权限必须是 600,只有 root 能读。

顺带纠正一个很常见的误判:grep 不到某一行配置,不代表这个功能没开。比如客户端的 transport.tls.enable 默认就是 true,你 grep 不到只是因为没人显式写这一行。判断 TLS 有没有开,要看服务端配没配 force=true,再看客户端日志里有没有 login to server success——明文连强制 TLS 的服务端会被直接拒绝,根本不可能登录成功。

二、第 1 步:找到 frp 到底装在哪、跑的是哪一个文件

为什么要先做这步:路径搞错,等于改了另一份配置、或者升级了根本没在跑的那一份,隧道全断你都不知道原因。而且 frp 的安装目录里通常同时躺着好几份配置、好几个备份目录,真正在用的只有 systemd 单元里指定的那一份。所以”找到它”不是找到一个叫 frpc 的文件,而是要锁定”正在运行的那个文件 + 它读的那份配置”。

2.0 先看执行路径:五种方法,按优先级从准到兜底

① 问 systemd(最准)      systemctl cat frpc         → ExecStart 那行直接给路径
        ↓ 没显式路径或想拿全
② 看 systemd 解析结果      systemctl show frpc -p ...  → 路径/用户/重启策略一次拿全
        ↓ systemd 里没有(老式 init.d)
③ 从进程反查              ps + readlink /proc/<pid>/exe → 进程真实打开的文件
        ↓ 前几招都拿不到
④ 全盘兜底                find / -xdev -name frpc       → 会翻出备份目录,要对上前面结果
        ↓ 锁定目录之后
⑤ 认清单里哪份配置在用    ls -l 目录                   → 只有 ExecStart 指定的那份在跑

这五招不是都要跑一遍,按顺序,够用就停:能用第 ① 招拿准,就不用往下;systemd 单元是标准部署,绝大多数情况第 ① 招就结束了。

2.1 第 1 招:问 systemd 它跑的是哪个文件

# 只挑出 ExecStart 和 WorkingDirectory 两行——路径就在这两行里
systemctl cat frpc | grep -E "ExecStart|WorkingDirectory"

frpc 的 systemd 单元原文
图2:systemctl cat frpc 的原文——ExecStart 那一行直接告诉你程序和配置的真实路径

白话:ExecStart=/root/frp_0.65.0_linux_amd64/frpc -c /root/frp_0.65.0_linux_amd64/frpc.toml 这一行是”开机时执行这条命令”。它等于把答案直接念给你听:程序在 /root/frp_0.65.0_linux_amd64/frpc,配置在 -c 后面、/root/frp_0.65.0_linux_amd64/frpc.toml。

2.2 第 2 招:想看”解析后的最终结果”就用 systemd show

什么时候用:第 ① 招给了路径,但你还想知道”以什么用户跑、崩溃会不会自动重启、单元文件本体在哪”。systemctl show 把这些一次吐出来。

# -p 只显示指定属性,各属性名用空格分隔
systemctl show frpc -p ExecStart -p FragmentPath -p WorkingDirectory -p User -p Restart --no-pager

systemd show 解析后的属性

图3:show 一次拿全——程序路径、单元文件位置、工作目录、运行用户、重启策略

白话解读这张图:FragmentPath 是”单元文件本体在哪”(/etc/systemd/system/frpc.service),User=root 是”以谁的身份跑”,Restart=on-failure 是”崩溃自动重启”。这三样在”读懂 systemd 单元”那节还会再展开。

2.3 第 3 招:systemd 里没有?从运行中的进程反查

什么时候用:老式 init.d 脚本(systemctl cat 查不到单元)时,进程还好好跑着,就从进程反推它在执行哪个文件。

# ps 里 [f]rpc 的方括号是 grep 的小技巧:grep 自己那行不会匹配到自己
ps -eo pid,cmd | grep '[f]rpc'

# readlink /proc/<pid>/exe = "这个进程真实打开的是哪个文件",比 ps 命令行更准
readlink -f /proc/$(pgrep -x frpc | head -1)/exe

从进程反查路径

图4:ps 列出 frpc 进程与命令行,readlink 进一步确认进程真实打开的二进制路径

白话:ps -eo pid,cmd 是”列出所有进程的 PID 和命令行”;grep '[f]rpc' 从里面挑出含 frpc 的行。为什么是 [f]rpc 而不是 frpc?因为 grep 这条命令本身的命令行里也含”frpc”三个字,不加方括号就会把自己也匹配出来,输出里多一行干扰项。

2.4 第 4 招:全盘兜底 find(会翻出备份目录)

# -xdev 不跨文件系统(不然会跑到挂载盘上卡半天);2>/dev/null 丢弃"无权限"报错
find / -xdev -type f -name 'frpc' 2>/dev/null

find 全盘搜出多个 frpc

图5:find 一次翻出 4 个 frpc——1 份现役 + 3 份历史备份,这正是不建议拿 find 当第一招的原因

白话:-xdev 是”别跨文件系统”(否则会去扫描挂载的盘,慢又容易卡死),2>/dev/null 是把”权限不够”这类报错丢到黑洞、只留结果。注意这张图:find 翻出 4 个 frpc,只有第一份是现役,其余三个是 -bak- 备份目录里的旧版本。所以 find 的结果必须和前面 systemd/进程的结果对上号,不能看到第一个就当真。

2.5 第 5 招:认清单里哪份配置才是”正在用的”

# 列出目录全部文件,看清有几份配置、各是什么格式、权限如何
ls -l --time-style=+%Y-%m-%d\ %H:%M /root/frp_0.65.0_linux_amd64/

frp 目录里的文件清单与配置指纹

图6:同一个目录里塞着 5 份配置,只有单元指定的那一份在用;md5 升级前后必须一致

白话:目录里躺着 frpc.toml、frpc.ini、带日期的 20260426frpc.toml、frpc-副本.toml、几个 .bak——真正在用的只有第 ① 招里 -c 指定的那一份(这里是 frpc.toml,权限 600)。其余是历史遗留,千万别升级时把它们当配置文件覆盖回去。

怎么确认成功:三个条件同时成立才算找对了——① 单元/进程指向的路径能 ls 到;② 那个文件 --version 能打印出版本号;③ ps 里运行中的确实是这个路径。三条对上,才允许进入下一步。

三、第 2 步:读懂 frpc 的 systemd 单元

白话说:systemd 是 Linux 的”开机自启 + 崩溃自动拉起”管家;而一个 .service 文件,就是交给管家的那张”怎么把这个程序跑起来”的说明书。它的位置是 /etc/systemd/system/frpc.service:

# /etc/systemd/system/frpc.service
[Unit]
Description=frp Client Service
After=network.target

[Service]
Type=simple
User=root
ExecStart=/root/frp_0.65.0_linux_amd64/frpc -c /root/frp_0.65.0_linux_amd64/frpc.toml
WorkingDirectory=/root/frp_0.65.0_linux_amd64
Restart=on-failure
RestartSec=5s

[Install]
WantedBy=multi-user.target

逐行翻译成人话:

  • [Unit] 元信息与依赖:Description 是描述;After=network.target 表示”等网络就绪再启动”——frpc 要连公网服务端,网络没起来就启动等于白启动还白刷日志。
  • [Service] 怎么跑:Type=simple = 前台直接跑,systemd 认为进程起来就算就绪;User=root = 以 root 身份跑(因为配置是 600 权限、还要监听高位端口);ExecStart= = 启动命令,-c 后面是配置文件;WorkingDirectory= = 工作目录(程序里用到相对路径就以它为准);Restart=on-failure + RestartSec=5s = 异常退出就自动重启,间隔 5 秒(防止疯狂重启刷屏)。
  • [Install] 开机自启:WantedBy=multi-user.target = 开机进多用户阶段就把它拉起。执行 systemctl enable frpc 时,systemd 就是在 /etc/systemd/system/multi-user.target.wants/ 里建一个软链接指向这个文件。

日常最常用的几条:

systemctl cat frpc              # 看单元文件原文
systemctl status frpc           # 看运行状态、启动时间、PID、最近几行日志
systemctl start/stop frpc       # 启停
systemctl restart frpc          # 重启(升级完就是这条)
systemctl is-active frpc        # active / inactive,一行就能判断
systemctl is-enabled frpc       # enabled / disabled,判断有没有开机自启
systemctl enable/disable frpc   # 开关开机自启
systemctl daemon-reload         # 改过单元文件后必须执行,让 systemd 重新读

为什么升级 frpc 根本不用改这个文件?因为我们只把同一个目录下、同名的二进制文件换掉了,路径没变,单元不用动。只有当你把 frp 换到新目录时,才必须同步改 ExecStart 和 WorkingDirectory,然后 systemctl daemon-reload && systemctl restart frpc——否则 systemd 还会去拉老路径,轻则服务起不来,重则你以为升级了、其实跑的还是旧版本。

四、第 3 步:把配置文件的属主和权限收紧

为什么要做:frpc.toml 里写着 auth.token——这是内网机器连公网服务端的”通行证”。如果这个文件属主是普通用户、权限是 644,那么这台机器上任何以该用户身份运行的进程都能读到它。而这类机器往往同时跑着 filebrowser、uptime-kuma 之类的 Web 应用,一旦其中一个被拿下,攻击者就能拿到 token 自己连上你的 frps,占用你的公网端口。

# 改之前先看清楚(属主和权限都要看)
ls -l /root/frp_0.65.0_linux_amd64/frpc.toml
# -rw-r--r-- 1 www www 2223 frpc.toml     ← 太松了

# 收紧:属主改回 root,权限改 600(只有 root 能读)
chown root:root /root/frp_0.65.0_linux_amd64/frpc.toml
chmod 600 /root/frp_0.65.0_linux_amd64/frpc.toml

# 复核
ls -l /root/frp_0.65.0_linux_amd64/frpc.toml
# -rw------- 1 root root 2223 frpc.toml     ← 正确

frp 配置权限收紧与残留单元删除

图7:frpc.toml 收紧为 root:root 600,损坏的 frps.service 已删除

顺带一提:这个目录里还堆着好几份配置备份和 tar 包。根目录越干净越好,旧版本备份建议挪到专门的备份目录去,别和正在运行的程序混在一起。

五、第 4 步:删掉一个”坏了但暂时没出事”的残留服务

这台机器上有个 /etc/systemd/system/frps.service,但它本来就是不该存在的(这台只跑 frpc),而且还是坏的:

[Unit]
Description=frps
[Service]
ExecStart=/frp_0.65.0_linux_amd64/frpc -c ...    ← 路径少了 /root
Restart=always  # 服务异常时自动重启      ← 注释混进了配置值
[Install]
WantedBy=multi-user.target

systemd 会直接报错:Failed to parse service restart specifier。它现在是 disabled/inactive,所以暂时不影响运行,但只要哪天有人(或某个自动化脚本)误 enable 它,就会立刻启动失败、还可能占用端口跟真正的服务打架。

# 先备份再删,别直接 rm
cp /etc/systemd/system/frps.service \
   /root/audit-backup-20261110/frps.service.broken.bak
rm /etc/systemd/system/frps.service
systemctl daemon-reload

# 复核:应该提示找不到这个单元
systemctl cat frps
# No files found for frps.service.

怎么确认成功:systemctl cat frps 提示”No files found”,并且 systemctl --failed 里没有新增失败单元。

六、第 5 步:升级前先下载并校验新版本

为什么要先下载校验、再谈替换:国内机器直连 GitHub 经常卡死;就算下下来了,也可能只下了一半。没校验过的包直接装,等于赌。这一步做完,你要拿到的是一个”版本对得上、又能认旧配置”的新程序,后面才敢动手换。

6.0 先看执行路径:四小步,环环相扣

目标:拿到一个"验过版本、认旧配置"的新 frpc 程序
                          ↑
   ┌──────────────────────┴───────────────────────────┐
   │ ① 测镜像源  →  ② 单进程下载  →  ③ tar 校验  →  ④ 解压+验版本+验配置
   │ (选最快的)     (14M 的包)     (防半包)        (三重确认)
   └──────────────────────────────────────────────────┘

四小步每一环都卡在前一环之后:源不通就先别下载,下载没验过就先别解压,解压出来版本不对或配置不认就到此为止,旧版本原样不动。下面逐步拆,每一步配一张真实截图。

6.1 第 1 小步:先测镜像源通不通,选最快的

为什么要先测:GitHub 官方直连经常被重定向到很慢的域名、curl 空转 0 CPU。与其下载到一半才发现卡住,不如先花十几秒把几个常用镜像都测一遍,哪个通、哪个快,一目了然。

# 逐个镜像测连通性与耗时:%{http_code} 打印状态码、%{time_total}s 打印耗时
for u in ghfast.top gh-proxy.com ghproxy.net; do
  curl -s -o /dev/null -w "$u -> %{http_code} %{time_total}s\\n" \\
    --max-time 15 https://$u/
done

逐个镜像测试连通性与耗时

图8:三个镜像都通(200),ghfast 最快 0.777s,选它下载

命令白话:-s 安静模式不打印进度条,-o /dev/null 把内容丢掉(我们只要状态码和耗时),-w 里的 %{http_code} 是 HTTP 状态码、%{time_total}s 是总耗时。--max-time 15 防止某个源死活不响应把整条命令拖死。

6.2 第 2 小步:单进程下载,别开多个 curl 抢同一个文件

# ② 通过镜像下载 13.8M 的包(ghfast 前缀 + GitHub 原始路径)
V=0.72.0
curl -fL -o /tmp/frp_$V.tar.gz \\
  https://ghfast.top/https://github.com/fatedier/frp/releases/download/v$V/frp_$V"_linux_amd64.tar.gz"

单进程下载 13.8M 的包

图9:单进程下载 13.8M,31 秒完成,curl_exit=0,落盘 14M

命令白话:-f 是遇到 HTTP 错误就失败退出(否则 curl 会把 404 错误页也存成文件),-L 是跟随重定向(镜像站会再跳一次),-o 指定保存到的文件名。

必须记住的坑:千万别开多个 curl 同时下同一个文件。它们会互相覆盖,最后拿到的是个残缺的包(大小看着正常、实际解不开)。下载这类大文件永远单进程。

6.3 第 3 小步:用 tar 实测包完整性,再解压

# ③ 用 tar 实际列一次目录来校验完整性(光看文件大小不算数,半包大小看着正常)
tar -tzf /tmp/frp_$V.tar.gz >/dev/null && echo TARBALL_OK

# 解压到独立目录
mkdir -p /tmp/frp_new && tar -xzf /tmp/frp_$V.tar.gz -C /tmp/frp_new

tar 校验包完整性与解压

图10:tar -tzf 列目录成功(TARBALL_OK),包里就是 frpc/frps 两个二进制 + 配置 + LICENSE

命令白话:tar -tzf 的 -t 是”列出内容”、-z 是”这是 gzip 压缩”、-f 是”读这个文件”。它能成功把包里的文件名一个个读出来,才说明这个 tar 包是完整的;下到一半的包,tar 会报”unexpected end of file”。

6.4 第 4 小步:新程序验版本、再验旧配置它认不认

# ④ 新程序先自报版本,再用它检查"旧配置它认不认"
NEW=/tmp/frp_new/frp_$V"_linux_amd64"
$NEW/frpc --version                 # 期望打印 0.72.0
$NEW/frpc verify -c /root/frp_0.65.0_linux_amd64/frpc.toml
# 期望:syntax is ok —— 不认就到此为止,旧版本一点没动

新程序验版本与验旧配置

图11:新程序打印 0.72.0,verify 报 syntax is ok —— 版本与配置双重确认通过

verify -c 是 frp 自带的配置检查命令,用新版本检查旧配置:新程序说”认”,才说明升级后能正常启动。这一步过了再动文件,等于给自己上了一道保险。frpc verify --help 会看到它的全局参数里就有 -c/--config 和 --strict-config(默认 true,未知字段会报错)。

一个高频坑:第 ①④ 步里那个 "$V"_linux_amd64 的写法——bash 里 frp_$V_linux_amd64 会被解析成变量名 V_linux_amd64(下划线也算变量名的一部分),拼出来的地址是错的。用双引号把变量单独括起来再拼接:frp_"$V"_linux_amd64。

这一步做完,怎么确认成功?四张图里每张对应一条:① 至少一个镜像 200;② 包落盘约 14M、curl_exit=0;③ tar 列目录能出 TARBALL_OK;④ --version 打新版本号、verify -c 报 syntax is ok。四条全中,才能进入下一步”只替换两个二进制”。

七、第 6 步:只替换两个二进制,配置文件一个字符都不碰

这是整篇文章最关键的一步,它决定了”升级会不会把配置搞坏”。

7.1 先看执行路径:全程只有两个文件被动

# 新文件(刚从压缩包解压出来)
/tmp/frp_new/frp_0.72.0_linux_amd64/frpc        frpc   ← 要替换的目标
/tmp/frp_new/frp_0.72.0_linux_amd64/frps        frps   ← 要替换的目标
        │
        │  install -m 755  源文件  目标文件
        ↓
# 现役目录(systemd 的 ExecStart 指着这里)
/root/frp_0.65.0_linux_amd64/frpc          ← 被换成新程序
/root/frp_0.65.0_linux_amd64/frps          ← 被换成新程序
/root/frp_0.65.0_linux_amd64/frpc.toml     ← 全程没人碰它

7.2 命令白话:把 install -m 755 那一行逐段拆开

这一行是整个升级里最关键、也最容易被写错的一行。我们把它逐段拆开看:

install -m 755 $NEW/frpc /root/frp_0.65.0_linux_amd64/frpc

  • install —— 不是”移动”,是“复制一份过去,并按你指定的权限和属主安顿好”的专用命令。它比 cp 多干一件事:按 -m / -o / -g 调整权限与属主。
  • -m 755 —— m 是 mode(权限位)。755 展开就是 rwxr-xr-x:属主可读可写可执行,其他人可读可执行。效果等价于 chmod 755,但和复制是一步完成的。
  • $NEW/frpc —— 源:刚解压出来的新版本程序。$NEW 是个变量,指向 /tmp/frp_new/frp_0.72.0_linux_amd64 这个解压目录。
  • /root/frp_0.65.0_linux_amd64/frpc —— 目标:systemd 的 ExecStart 正指着、正在被运行的那个现役程序。这个路径一个字符都不能错,写错了就等于把新程序装到了没人用的地方,systemd 照样跑旧版本,你还以为升成功了。

顺序不能反。install 的语法是 install [选项...] 源 目标(install --help 第一行就写着 Usage: install [OPTION]... [-T] SOURCE DEST)。写反了不会报错,而是悄悄装错地方。另外如果源和目标其实是同一个文件,它会明确拒绝:

# 源和目标是同一个文件时,install 会明确告诉你,不会闷头干
$ install -m 755 s s
install: 's' and 's' are the same file

常用的三种写法,记住区别就不会用错:

# ① 装成一个指定名字的文件(我们用的就是这种)
install -m 755 源程序 /目标目录/目标文件名

# ② 装进目录里、沿用源文件的名字
install -m 755 源程序 /目标目录/

# ③ 只建目录(-d = create directory),常用于放程序的目录
install -d -m 755 /root/frp_0.65.0_linux_amd64

白话比喻:这行命令等于说 —— “把 /tmp 里那份崭新的 frpc 程序,复印一份贴到 /root/frp_0.65.0_linux_amd64/ 目录下、仍然叫 frpc 这个名字,贴的时候顺手把它的权限标签换成 755″。注意是”复印”,原来的那份还在(那是备份),所以随时能贴回去。

它和 cp 到底差在哪(现场实测,不是背书)

差别一,权限。同样覆盖一个原本是 600(只有属主能读)的目标文件:

# 目标文件原本是 600(很常见:有人手工把配置或程序收紧了)
$ install -m 755 源 t1   && stat -c '%a %U:%G %n' t1
755 root:root t1          # install 照你说的把权限摆成 755

$ cp 源 t2 && stat -c '%a %U:%G %n' t2
600 root:root t2          # cp 保持目标原来的 600 不动!

install 覆盖普通文件的实测过程

图12:install 覆盖一个普通文件的完整过程——静默成功、权限精确落到 755、属主 root:root

这就是为什么不能用 cp 代替 install 的第一个理由:万一目标文件原本是 600,cp 拷完还是 600,新程序没有执行权限,服务起不来,而你会以为是文件坏了。

差别二,目标正被运行时。frpc 正在跑着,它那个文件被内核”锁住”了:

install 与 cp 覆盖运行中程序的实测对比

图13:实测——cp 覆盖运行中的程序被内核拒绝(Text file busy),install 则成功且旧 inode 仍被运行进程持有

install 覆盖运行中程序时的完整过程

图14:同一次实测的完整过程——cp 报 Text file busy 被拒,install 换新 inode 顶替,旧 inode 被进程攥着继续跑老代码

白话讲这个差别:cp 是”打开旧文件往里写”,而内核规定”正在执行的程序文件不许改写”,所以直接报错 Text file busy;install 遇到这种情况会换个做法——它把新内容写到一个新 inode 上再顶替旧路径,于是运行中的进程仍然攥着老 inode(/proc/<pid>/exe 里显示 (deleted)),老程序能继续跑完,不会崩。

顺便纠正一个流传很广的说法:网上常说”install 是放新文件、把旧路径摘掉”。实测下来这只在目标是”正在运行的程序”时成立;覆盖普通文件时,install 是原地覆盖,inode 不变(上面图里前后都是同一个 inode)。两种情况都能正确工作,但原因不同——遇到运行中程序时,install 是被内核逼着才换的新 inode。

这也顺带解释了”为什么替换完必须 restart”:磁盘上已经是新程序了,但正在跑的那个 frpc 进程执行的仍然是旧文件里的老代码(它攥着的是老 inode)。只有 systemctl restart frpc 让 systemd 重新拉起进程,新代码才会被加载——所以”install 成功”不等于”升级生效”,差一个 restart。

怎么确认这一步真的成了:

# ① 权限和属主是不是按 -m 落的(期望 755 root:root)
stat -c '%a %U:%G %n' /root/frp_0.65.0_linux_amd64/frpc

# ② 目标位置确实是新程序(期望打印新版本号)
/root/frp_0.65.0_linux_amd64/frpc --version

# ③ 配置一个字没动(md5 与升级前完全一致)
md5sum /root/frp_0.65.0_linux_amd64/frpc.toml

7.3 执行替换,并三重证明配置没被改动

# 保险① 只动这两个文件,其它一律不碰
install -m 755 $NEW/frpc /root/frp_0.65.0_linux_amd64/frpc
install -m 755 $NEW/frps /root/frp_0.65.0_linux_amd64/frps

# 绝对不要做的三件事:
#   cp -r 新解压目录/* 旧目录/          ← 压缩包里的示例配置会覆盖你的真配置
#   cp 新解压目录/frpc.toml 旧目录/      ← 同上,等于把隧道表整个换掉
#   unzip 后直接 cp 整个目录              ← 同上

# 保险② 先备份整个安装目录(回滚靠它)
cp -a /root/frp_0.65.0_linux_amd64 \
      /root/frp_0.65.0_linux_amd64-bak-$(date +%Y%m%d-%H%M%S)

# 保险③ 配置文件指纹前后对比(一样 = 一个字符都没变)
md5sum /root/frp_0.65.0_linux_amd64/frpc.toml
# 升级前后两次输出必须完全相同

# 保险④ 用 diff 再逐字节复核一次
diff 备份目录/frpc.toml 现役目录/frpc.toml && echo CONFIG_IDENTICAL_NO_DIFF

替换前备份目录里的三个文件

图15:替换前——备份目录里的旧 frpc/frps 与配置文件指纹

替换后现役目录的三个文件与 diff 结果

图16:替换后——两个程序文件的大小/md5/时间戳全变,配置文件三者一模一样,diff 无输出

文件 替换前 替换后 结论
frpc 16,912,546 字节
md5 e30feafc…
2026-10-23 14:49
17,461,410 字节
md5 504fc1ea…
2026-11-10 18:10
已换成新版
frps 20,676,770 字节
md5 9054d298…
2026-10-23 14:49
21,319,842 字节
md5 13520e85…
2026-11-10 18:10
已换成新版
frpc.toml 2,223 字节
md5 690f0dd6…
2026-11-07 13:37
2,223 字节
md5 690f0dd6…
2026-11-07 13:37
完全没动

看这张表最关键的一行是 frpc.toml:大小、md5、修改时间戳三个全都没变,连”被打开过”都没留下痕迹。再加上 diff 逐字节比较返回空(CONFIG_IDENTICAL_NO_DIFF),等于用三种独立方式(md5 / diff / mtime)交叉证明了同一件事:配置文件一个字符都没被碰过。

所以整条升级链路的”安全网”其实是四道:① 备份整目录(出事能一键回滚)、② 只 install 两个二进制(配置文件不参与)、③ md5 + diff + mtime 三重复核(证明没动)、④ 新程序先 verify -c 验配置(不认就中止、旧版本原样不动)。

八、第 7 步:重启并验证——数代理要数”名字”而不是数代码块

# ① 重启 frpc,让新代码真正跑起来
systemctl restart frpc
sleep 3

# ② 服务还活着吗、版本换了吗、自启状态变了吗
systemctl is-active frpc            # 期望 active
systemctl is-enabled frpc           # 期望 enabled(开机自启不能变)
/root/frp_0.65.0_linux_amd64/frpc --version

# ③ 数"实际连成功的代理名",去重后计数
journalctl -u frpc -n 600 --no-pager \
  | grep 'start proxy success' \
  | grep -oE '\[[^]]+\] start proxy success' \
  | sort -u | wc -l
# 期望:16(等于配置里声明的代理数)

# ④ 日志里有几个错误
journalctl -u frpc -n 600 --no-pager | grep -ci error
# 期望:0

为什么第 ③ 步要数”名字”而不是数代码块?我一开始用 grep -c '[[proxies]]' 数配置里的代理块,结果数出来 15,日志里成功的却有 16 个名字,一度以为漏了一条。真正的原因是:配置里有被注释掉的块、还有缩进的块,grep 数块数根本不准。正确做法是抓日志里实际连成功的代理名去重计数,再和配置里声明的名字数量对比。

另一个要留意的点:配置里声明的代理数,如果用 grep -c 'name = "' 也会把注释里的行算进去(这台机器实测配置里 18 行 name,实际活跃 16 个)。所以对比时要看日志侧的”真实成功名单”,而不是配置侧的粗略计数。

frpc 升级后验证

图17:升级到 0.72.0,服务 active 且开机自启,16 个代理全部连上、0 个错误

怎么确认成功:① is-active 是 active;② is-enabled 与升级前一致(还是 enabled);③ 版本号是新版本;④ 代理数与升级前一致;⑤ 错误数为 0。五条全中才算升级完成。

九、第 8 步:怎么保证 fail2ban 等加固完全不受影响

先说原理,你就明白为什么它天然安全:

  • 升级只替换安装目录下的两个可执行文件。fail2ban 的规则在 /etc/fail2ban/、ufw 的规则在 /etc/ufw/、sshd 的配置在 /etc/ssh/,这三个目录一个字节都不会被碰到。
  • systemctl restart frpc 只重启 frpc 这一个单元,systemd 不会”顺带”重启 nginx、fail2ban、docker——它们互不相干。
  • fail2ban 的 sshd jail 统计的是 sshd 的认证日志,frpc 重启不会产生任何 ssh 失败记录,封禁名单不受影响。

不过有三件事必须提前想清楚,否则照样会翻车:

  • ① 隧道会断几秒,先留好第二条路。如果你是通过 frp 隧道 SSH 进来的,systemctl restart frpc 期间连接会断。操作前先开一个直连窗口(本地控制台,或另一条不依赖这条隧道的链路),别把自己关在门外。
  • ② 自己写的 jail 别误伤。如果你的 fail2ban 里有针对 frp 日志的自定义 jail,正则千万别写成匹配 start proxy success——升级重启会刷一批这种日志,容易把自己封了。
  • ③ 隧道内流量的源 IP 会”变成本机”。经 frp 隧道进来的 SSH/网页请求,在被访问那台机器看来源 IP 都是 frpc 主机自己,fail2ban 的封禁判断会失真。所以 /etc/fail2ban/jail.local 里要写 ignoreip 把内网段放行——这台机器上就写着:”永不封禁本机与内网,避免把 frp 隧道/管理终端关在门外”。

fail2ban 白名单与 frpc 配置自检

图18:fail2ban 的 ignoreip 白名单(避免把 frp 隧道关在门外)、jail 状态、frpc verify 结果与登录成功日志

怎么确认加固确实没受影响(升级前后各跑一遍,逐条对比):

# ① 关键服务是不是都还活着
for s in fail2ban cups docker frpc; do
  printf "%-9s %s\n" "$s" "$(systemctl is-active $s)"
done

# ② fail2ban 的 jail 和封禁数有没有变
fail2ban-client status

# ③ 防火墙规则条数(升级前后应完全一致)
ufw status numbered | wc -l

# ④ 开机自启状态有没有变
systemctl is-enabled frpc fail2ban

# ⑤ 隧道数量(应与升级前一致)
journalctl -u frpc -n 600 --no-pager | grep -c 'start proxy success'

升级前后安全加固基线对比

图19:升级后的加固基线——fail2ban/cups/docker/frpc 全部 active、ufw 规则数不变、开机自启不变、16 条隧道在位

这台机器实测:升级前后 fail2ban 都是 active、jail 列表不变(sshd)、ufw 规则数不变、frpc 仍是 enabled、16 条隧道一条不少。如果你的机器上还跑着 nginx、apache 这类反代服务,把它们也加进第 ① 步的检查列表(这台机器没装 nginx,所以不在列表里)。

十、第 9 步:把这套流程固化成一条命令的升级脚本

手工升级一次不难,难的是半年后还要再升一次,那时候你已经忘了当初踩过哪些坑。所以最后把全过程写成了脚本 /root/upgrade_frpc.sh(权限 700),白话中文注释,随时可读。

10.1 脚本干的事(五步)

  • 下载:依次试多个国内镜像,每个地址再依次试「HTTP 代理 → SOCKS 代理 → 直连」,哪个通用哪个;全程单进程下载,最后用 tar -tzf 实测包完整。
  • 检查:版本号对不对得上;再用新程序 frpc verify -c 检查你的配置它认不认,不认就直接中止,旧版本原样不动。
  • 备份:整个安装目录复制成带日期时间的 -bak- 目录。
  • 换文件:只替换 frpc / frps 两个二进制,配置文件原封不动。
  • 重启并数代理:重启后数”日志里连成功的代理名”,和配置里声明的代理数对比,对不上或报错会列出详情并提示用备份恢复;重启失败会自动回滚旧版本。

10.2 加上”临时代理”这一步

实际用起来还有个小麻烦:GitHub 在国内经常连不上,如果手上有台临时代理机就能救场。但代理机的 IP 可能会变,写死在脚本里就不灵了。于是脚本开头加了交互询问:

read -r -p "代理 IP(回车=默认 192.0.2.100;输入 0/skip=不用代理):" PROXY_IP
[ -z "$PROXY_IP" ] && PROXY_IP="192.0.2.100"     # 直接回车 = 用默认 IP

if [ -n "$PROXY_IP" ] && [ "$PROXY_IP" != "0" ] && [ "$PROXY_IP" != "skip" ]; then
  echo "本次使用代理:HTTP http://$PROXY_IP:1082 ,SOCKS socks5h://$PROXY_IP:7894"
else
  echo "本次不用代理,走直连 + 国内镜像"
  PROXY_IP=""
fi

端口是写死的(HTTP 1082、SOCKS 7894),IP 每次运行时手动确认:回车用默认、输入别的 IP用你输入的、输入 0 或 skip完全不用代理。这样代理机换 IP 也不用改脚本。

10.3 怎么用

# 升到默认版本(脚本里写的当前版本)
bash /root/upgrade_frpc.sh

# 升到指定版本
bash /root/upgrade_frpc.sh 0.73.0

# 不想交互、直接用默认代理:把回车喂给它
printf '\n' | bash /root/upgrade_frpc.sh

# 明确不用代理(走直连 + 国内镜像)
printf '0\n' | bash /root/upgrade_frpc.sh

升级脚本运行结果

图20:升级脚本运行全过程——代理询问、下载校验、备份、替换、重启、代理数核对一次到位

脚本另外在 Windows 桌面放了一份存档(upgrade_frpc.sh),方便以后给别的机器用。注意这是 Linux 的 bash 脚本,不能在 Windows 上双击运行,要传到服务器上执行。

十一、这次踩过的坑(QA 速查)

  • Q:frp 到底有没有开 TLS?要不要两端同步改?
    A:服务端 transport.tls.force = true,客户端默认启用,两端都不用改。判断依据是日志里有没有 login to server success——明文连强制 TLS 的服务端会被直接拒绝。
  • Q:升级前怎么找程序装在哪?
    A:systemctl cat frpc 看 ExecStart 最准;systemd 里没有就 ps 或 readlink /proc/<pid>/exe 反查;再不行 find / -xdev -name frpc。
  • Q:为什么不能用 cp 覆盖程序文件?
    A:cp 覆盖正在运行的程序会被内核拒绝,报 Text file busy。用 install -m 755,它是”放新文件 + 摘旧路径”,运行中的老进程能安全跑完。
  • Q:install 成功了,为什么隧道还没生效?
    A:磁盘上是新程序,但跑着的进程执行的是旧 inode 里的老代码。必须 systemctl restart frpc。
  • Q:日志说 15 个代理成功,配置里却有 16 个,是不是漏了一条?
    A:是 grep 数块数不准(注释块、缩进块都会干扰)。要数”日志里成功出现的代理名去重后”的数量,正确答案是 16。
  • Q:下载 frp 的包卡在 GitHub 重定向,CPU 占用 0%。
    A:典型的连不上。改用国内镜像(ghfast.top 等)。另外千万别开多个 curl 同时下同一个文件,它们会互相覆盖,tar 包看着有大小、实际是残的,必须用 tar -tzf 验一遍。
  • Q:升级会不会中断正在跑的隧道?
    A:会重启 frpc,隧道会断几秒。所以升级前要确认这台机器还有别的进入方式(比如直连 SSH),别在”隧道断了就回不来”的情况下操作。
  • Q:脚本为什么每次都要问代理 IP?
    A:临时代理机的 IP 会变,写死就废。端口固定、IP 手输,兼顾两种情况。

十二、安全与隐私经验

  • 含 token 的配置,权限必须 root:root + 600:frpc.toml 属主是 www、权限 644,等于把隧道通行证挂在墙上。
  • 别把内网管理端口直接挂公网:这台机器的 SSH 22 和 FTP 21 都通过 frp 映射到了公网端口。SSH 本身禁了密码登录还算安全,但明文 FTP 直接暴露在公网是不行的。
  • 隧道里的源 IP 会失真:fail2ban 判断攻击来源时看到的是 frpc 主机自己,ignoreip 一定要包含内网段,否则你会把自己关在门外。
  • 管理面板只监听回环地址:frps 的 webServer 绑 127.0.0.1 是对的;面板口令写在配置文件里,配置文件权限 600。
  • 配置文件权限改了要记下来:升级脚本用 install 换二进制不会动 frpc.toml 的权限;但如果你以后手工 cp 过配置,权限可能被打回 644。
  • 升级前确认这台机器还有第二条进入路径:直连 SSH 或本地控制台。frp 隧道是”出去的门”,别在关门时把钥匙留在门里。

十三、命令速查表

场景 命令
找 frpc 装在哪 systemctl cat frpc | grep ExecStart
从进程反查路径 readlink -f /proc/$(pgrep -x frpc | head -1)/exe
看单元原文 systemctl cat frpc
看解析后的属性 systemctl show frpc -p ExecStart -p WorkingDirectory -p User --no-pager
状态 / 自启 systemctl is-active frpc、systemctl is-enabled frpc
收紧配置权限 chown root:root frpc.toml && chmod 600 frpc.toml
校验配置语法 frpc verify -c /root/frp_xxx/frpc.toml
数连成功的代理 journalctl -u frpc -n 600 | grep 'start proxy success' | grep -oE '\[[^]]+\]' | sort -u | wc -l
数日志错误 journalctl -u frpc -n 600 | grep -ci error
只看登录成功 journalctl -u frpc -n 600 | grep 'login to server success'
替换二进制(不碰配置) install -m 755 新目录/frpc 旧目录/frpc
备份整目录 cp -a /root/frp_xxx /root/frp_xxx-bak-$(date +%Y%m%d-%H%M%S)
证明配置没动 md5sum frpc.toml + diff 备份/frpc.toml 现役/frpc.toml
升级并验证 bash /root/upgrade_frpc.sh
回滚 cp -a 备份/frpc 现役/frpc && systemctl restart frpc
看 fail2ban jail fail2ban-client status
看防火墙规则数 ufw status numbered | wc -l

最后再强调一遍流程:找到路径 → 读懂单元 → 收紧权限 → 清掉残留单元 → 下载并校验 → 备份整目录 → 只换二进制 → 重启并数代理名 → 逐条核对加固基线 → 留下脚本。每一步都有对应的”怎么确认成功”,做到最后一条命令之前,你已经知道每一步有没有生效。

FRP Windows10/11客户端+Nssm配置重启自动运行:https://www.hao0564.com/6194.html

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注