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 本身)自动完成:

  1. 自动接入:设备启动后自动向管理服务器发起加入请求,建立会话并自动生成 xfrpc.ini、拉起 xfrpc 子进程接入 frps。
  2. 批量管理:服务端集中登记设备(MAC / device_id),统一授权、禁用。
  3. 动态域名解析:设备域名 = <会话ID>.frpclient.local(主机名即 xfrpc 会话 ID),凭域名访问设备 RPC 接口,无需记住 IP。
  4. 集中密码安全托管:配合 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
自适应重连指数退避 + 抖动,避免大量设备同时重试冲击服务器

系统构成

云端 frps_helper :6999 南向 · :8089 认证 · :7443 北向 frps :7000 dnsmasq 泛解析(本地域名) OpenWrt 设备端 xfrpc_loader join / status / 集中鉴权 xfrpc 5.x(子进程) auth server :8888 nginx :8765 LuCI :8000 join / status :6999 隧道 :7000 auth_request 经 HTTPS 向 frps_helper :6999 认证 procd 托管 · UCI 生成 /tmp/xfrpc_loader.json

设备端进程与端口:

端口组件监听地址说明
8888auth server127.0.0.1仅本机,外部不可直连,必须经 nginx auth_request 触发
8765nginx(LuCI 反代)0.0.0.0远程访问入口,auth_request 集中鉴权
8000LuCI(uhttpd)0.0.0.0OpenWrt Web UI

云端端口(6999 管理与认证、7000 frps 隧道、20001 会话域名访问)见服务端 frps_helper。

相关仓库