安装设备端 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=...

输出为示意;实际时间戳、session 值与域名因设备而异。

同时可在服务端确认:北向接口 GET /api/v1/devices 中出现该设备(状态 online、带 session_id),详见北向接口。

下一步:首次接入与远程访问