安装设备端 xfrpc_loader
xfrpc_loader 以 OpenWrt 包(ipk)的形式安装。xfrpc 本体要求 5.x 及以上版本,可从 monkfish-iot/xfrpc5 获取预编译包。
OpenWrt 官方源里的 xfrpc 版本较低,请勿直接使用,务必安装 xfrpc 5.x(见需求说明:默认版本太低需升级到最新版本)。
前置条件
- OpenWrt 设备上已部署 xfrpc 5.x(
/usr/bin/xfrpc)。 - 云端 frps_helper 已运行(见部署服务端)。
- 设备可访问管理服务器地址(默认 HTTPS 6999 端口)。
构建 ipk
将 openwrt-xfrpc_loader 包放入 OpenWrt 源码树并编译:
cp -r openwrt-xfrpc_loader openwrt/package/xfrpc_loader/
cd openwrt
make menuconfig # Network 下启用 xfrpc_loader
make -j$(nproc) V=s package/xfrpc_loader/compile
可选构建参数:
LOCAL_SKEY=1 # 默认:使用本地 OpenSSL 密钥(device_id 存 /etc/config/skey/)
LOCAL_SKEY=0 # 使用厂商 libskey
INSTALL_PASSWD_SH=0 # 不安装 show_luci_passwd.sh
GIT=0 # 离线构建:不下载源码,使用本地 src/
安装到设备
scp packages/*/xfrpc_loader_*.ipk root@<设备IP>:/tmp/
opkg install /tmp/xfrpc_loader_*.ipk
opkg install libevent2 libcurl libjson-c libopenssl
若启用集中鉴权链路,还需安装 nginx 与 luci-mod-rpc。
最小配置
指定管理服务器(server_name 与 server_ip 至少填一个):
uci set xfrpc_loader.main.server_name='dm.example.com'
uci set xfrpc_loader.main.server_port='6999'
uci set xfrpc_loader.main.protocol='https'
uci commit xfrpc_loader
/etc/init.d/xfrpc_loader enable
/etc/init.d/xfrpc_loader start
验证接入
logread | grep xfrpc_loader | tail -30
# 期望看到:join ok, session=... ; xfrpc started, pid=...
root@OpenWrt:~# logread | grep xfrpc_loader | tail -5
daemon.info xfrpc_loader: join ok, session=b62c9f8a7d1e
daemon.info xfrpc_loader: dynamic domain: b62c9f8a7d1e.frpclient.local
daemon.info xfrpc_loader: config generated: /tmp/xfrpc.ini
daemon.info xfrpc_loader: xfrpc started, pid=1234
daemon.info xfrpc_loader: status report ok (keepalive)
输出为示意;实际时间戳、session 值与域名因设备而异。
同时可在服务端确认:北向接口 GET /api/v1/devices 中出现该设备(状态 online、带 session_id),详见北向接口。
下一步:首次接入与远程访问