本文记录在 Hi3798MV100 机顶盒上部署 frpc 客户端的过程，供类似环境的用户参考。

2026/8/14

环境信息

项目	值
设备	Hi3798MV100 ARMv7 盒子
系统	Linux 4.4.35
架构	armv7l
内存	969MB
SSH	192.168.31.82:10022

一、最终方案概述

• frpc 版本：v0.51.0（fatedier/frp 原版）

• 下载地址：https://github.com/fatedier/frp/releases/download/v0.51.0/frp_0.51.0_linux_arm.tar.gz

• 安装路径：/usr/local/bin/frpc

• 配置文件：/etc/frp/frpc.ini

二、安装步骤

1. 下载 frpc

盒子直接 curl GitHub 经常超时，建议先在本地电脑下载，再 scp 传上去：

bash

# 本地下载
curl -L -o frp_0.51.0_linux_arm.tar.gz \
  https://github.com/fatedier/frp/releases/download/v0.51.0/frp_0.51.0_linux_arm.tar.gz

# 传到盒子
scp -P 10022 frp_0.51.0_linux_arm.tar.gz root@192.168.31.82:/tmp/

2. 解压并安装

bash

ssh -p 10022 root@192.168.31.82
cd /tmp
tar -xzf frp_0.51.0_linux_arm.tar.gz
cp frp_0.51.0_linux_arm/frpc /usr/local/bin/
chmod +x /usr/local/bin/frpc

3. 创建配置目录

bash

mkdir -p /etc/frp

三、配置文件

/etc/frp/frpc.ini：

ini

[common]
user = s-01ogflx98b77n6
token = x98bh84xjgvq492tsphxzpkn3nq777n6

tls_enable = false
disable_custom_tls_first_byte = false

server_addr = frp-oil.com
server_port = 8088

[mcserver]
type = tcp
local_ip = 127.0.0.1
local_port = 25565
remote_port = 13027

配置说明：

字段	说明
user	客户端标识
token	认证令牌
server_addr	服务端域名
server_port	服务端端口
remote_port	服务端分配的远程端口

四、系统服务配置

/etc/systemd/system/frpc.service：

ini

[Unit]
Description=frpc client
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/frpc -c /etc/frp/frpc.ini
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

启用服务：

bash

systemctl daemon-reload
systemctl enable frpc
systemctl start frpc

五、踩坑记录

坑 1：服务端协议兼容性

之前以为 frp-oil.com 使用的是自定义协议，标准 frpc 无法连接。实际该服务端基于原版 frp v0.51.0 修改，保留了兼容性，标准 frpc 可以正常连接。

坑 2：认证字段名

配置文件中的认证字段必须使用 token，而非 auth.token 或 authentication_token。后者是 frp 后续版本引入的字段名，服务端不识别。

错误写法	正确写法
auth.token = xxx	token = xxx
authentication_token = xxx	token = xxx

坑 3：定制版 frpc 无法运行

该服务商提供的定制版 frpc（v0.51.0-sakura-14）在盒子上无法运行，原因与 Go runtime 加载方式有关，表现为进程崩溃。改用原版 frpc v0.51.0 后运行正常，且能正常连接服务端。

坑 4：下载超时

盒子的网络环境访问 GitHub 较慢，直接 curl 容易超时。建议在本地电脑下载后通过 scp 传输，或使用代理下载。

六、验证方法

bash

# 查看版本
frpc -v
# 预期输出：0.51.0

# 检查服务状态
systemctl status frpc
# 预期状态：active (running)

# 查看日志
journalctl -u frpc -f

七、适用场景

本配置适用于需要在内网设备上暴露 TCP 服务（如游戏服务器、SSH、Web 服务等）的场景。frpc 通过公网服务器转发流量，实现外网访问内网设备。

相关资源

• frp 官方仓库：GitHub - fatedier/frp: A fast reverse proxy to help you expose a local server behind a NAT or firewall to the internet. · GitHub

• frp 文档：https://gofrp.org/docs/