xfrpc_loader 概述
xfrpc_loader 是对 xfrpc 客户端非侵入式的外部辅助系统:帮助你在安全、批量的场景下,让多台 OpenWrt 设备自动接入 frps 服务器,并由云端统一管理与鉴权。
| 语言 | C(标准 C11) |
|---|---|
| 平台 | OpenWrt |
| 许可证 | Apache-2.0 |
| xfrpc 版本 | 要求 xfrpc 5.x 及以上(预编译包:monkfish-iot/xfrpc5) |
| 运行依赖 | libevent2 / libcurl / json-c / OpenSSL(不依赖 libuci / libyaml) |
它解决什么问题
当大量分散的 OpenWrt 路由器需要远程管理时,逐台手动配置 frp、分配固定地址、维护管理密码既繁琐又不安全。xfrpc_loader 以外部辅助方式(不改动 xfrpc 本身)自动完成:
- 自动接入:设备启动后自动向管理服务器发起加入请求,建立会话并自动生成
xfrpc.ini、拉起 xfrpc 子进程接入 frps。 - 批量管理:服务端集中登记设备(MAC / device_id),统一授权、禁用。
- 动态域名解析:设备域名 =
<会话ID>.frpclient.local(主机名即 xfrpc 会话 ID),凭域名访问设备 RPC 接口,无需记住 IP。 - 集中密码安全托管:配合 frps_helper 提供 HTTP/HTTPS Web 登录的集中用户鉴权。
核心特性
| 特性 | 说明 |
|---|---|
| 非侵入式 | 不改动 xfrpc 二进制与协议,仅作为外部进程生成配置并拉起 xfrpc 子进程 |
| 自动会话管理 | 加入 → 会话 → 状态上报 → 失败按指数退避重连,全程无人值守 |
| 动态域名映射 | 设备域名 = 会话ID.frpclient.local,服务器 dnsmasq 泛解析到本机 frps,随会话轮换防锁定(防探测) |
| 集中用户鉴权 | 内嵌 auth server,配合 frps_helper 为 OpenWrt 提供统一登录鉴权 |
| 安全密码轮换 | 自动生成并一次性轮换设备 root 密码,RSA-OAEP 加密落盘 |
| 设备唯一身份 | device_id = BASE62 UUID + 本机 MAC 后缀,贯穿 join / status / auth 全流程 |
| 轻量依赖 | 运行时只需 libevent2 / libcurl / json-c / OpenSSL |
| 自适应重连 | 指数退避 + 抖动,避免大量设备同时重试冲击服务器 |
系统构成
设备端进程与端口:
| 端口 | 组件 | 监听地址 | 说明 |
|---|---|---|---|
| 8888 | auth server | 127.0.0.1 | 仅本机,外部不可直连,必须经 nginx auth_request 触发 |
| 8765 | nginx(LuCI 反代) | 0.0.0.0 | 远程访问入口,auth_request 集中鉴权 |
| 8000 | LuCI(uhttpd) | 0.0.0.0 | OpenWrt Web UI |
云端端口(6999 管理与认证、7000 frps 隧道、20001 会话域名访问)见服务端 frps_helper。
相关仓库
- xfrpc_loader — C 守护进程源码
- openwrt-xfrpc_loader — OpenWrt 包(feed)定义