连锁门店网络的集中接入与认证的技术本质
连锁门店(零售、餐饮、教育等)的网络通常"小而散":每家店 1–3 台路由设备,总部需要统一管理。已发布的连锁店WiFi认证系统解决的是"平台怎么搭起来、单店的公共 WiFi 认证怎么跑";这篇回答下一个问题——平台跑起来之后,怎么复制到几十家、上百家甚至上千家门店:新店怎么上线、全部门店的配置怎么保持一致、单店怎么差异化、出了问题怎么远程处理。本文把门店场景的需求对应到项目中的模块,并说明落地时的关键点。
本篇是场景篇的第一篇:实操系列九篇从系统视角讲"怎么搭、怎么运维",场景篇从具体业务视角回答"怎么用"。本篇与已发布的连锁店搭建篇做区分定位:那篇是搭建指南,本篇是多店推广与集中运营视角。全文机制(上线与预登记、模板匹配、配置项与快照、认证源与会话、多 WAN)均与仓库文档与源码(WrtHub-UI、frps_helper、portal-server、xfrpc_loader)逐项核对,草稿与源码不一致处以源码为准,详见发布信息文件。零散 OpenWrt 设备如何统一管理,见管理零散OpenWrt设备。
目录
一、场景特征
| 特征 | 具体表现 | 挑战 |
|---|---|---|
| 门店数量多 | 几十到上千家 | 逐店维护成本极高 |
| 设备少 | 每家 1–3 台 | 单店不值当派工程师 |
| 网络要求稳 | 收银、扫码不能断 | 故障要能远程恢复 |
| 认证合规 | 公共 WiFi 需实名认证 | 认证源要统一 |
| 配置统一 | 所有门店 SSID、策略一致 | 逐台同值配置 + 偏差可查 |
| 总部可视 | 总部要看到全部门店状态 | 集中监控 + 操作留痕 |
相比单店搭建,连锁场景多出来的变量只有两个:数量(一店跑通的流程要能复制到 N 店)与权责(谁能做什么、哪些操作要留痕)。设备上线、页面服务、认证、多 WAN,这些机制本身与单店完全相同。
二、需求与模块匹配
| 门店诉求 | 解决方式 | 对应模块 |
|---|---|---|
| 门店设备免配置上线 | 通电即 join;自动注册默认开启,关闭时走预登记白名单 | xfrpc_loader + frps_helper |
| 总部远程运维 | 接入通道 + 集中鉴权,从云端登录门店设备 | frps_helper + WrtHub-UI |
| 公共 WiFi 认证 | 页面在云端、认证在设备,短信/账号等认证方式 | webauthd + portal-server |
| 认证合规对接 | 本地账号 / RADIUS / HTTP / LDAP 多认证源,云端集中管理 | webauthd + WrtHub-UI |
| 配置统一 | 逐台同值配置;配置项基线核对偏差,快照可回滚 | WrtHub-UI 无线管理 + 配置项与快照 |
| 单店差异化 | 逐台配置覆盖;Portal 模板按设备 ID 精确/前缀命中 | WrtHub-UI + portal-server |
| 多 WAN 与备份 | 主备链路自动切换,保障收银不断 | mkmwan3 |
| 桥接模式 | 门店作为上层网络的 AP 扩展 | bridge-mode |
| 故障自愈 | 健康检测上报 + 远程重启、回滚快照 | device_healthd + WrtHub-UI |
| 操作审计 | 全量写操作留痕、敏感字段脱敏,角色按权限分岗 | WrtHub-UI RBAC + 审计 |
先说清两件事。其一,这套系统里的"配置统一"不是靠"批量下发"动作实现的:无线与网络配置全部按设备进行,统一性由"逐台配同值 + 基线核对偏差"来保证。其二,当前 WrtHub-UI 没有"设备分组"概念,单店差异化与批量模板匹配都在 Portal 模板层用 device_id 的精确/前缀命中完成。这两点直接决定下面流程与做法的写法。
三、典型流程
3.1 新店开通
总部预登记新设备(或保持自动注册开启)
│
├─ 门店设备到货通电,xfrpc_loader 发起 join
├─ 云端放行:预登记命中或 auto_register 允许
├─ 自动补齐 MAC、型号,生成设备专属凭证
├─ 总部在 WrtHub-UI 按店配置无线、认证源与 RADIUS
└─ 门店 WiFi 可用,Portal 页面按模板规则命中
上线路径有两种形态。默认是自动注册:云端 config.yaml 的 frpc.auto_register 缺省为 true,运行时可切换(重启后恢复为配置文件值)。任何通过证书信任链的设备都能 join,云端在 join 时为它生成设备专属凭证(root + CA 公钥加密的随机密码),设备状态置为在线、归属状态为未分配。
如果门店设备流转严格——设备由第三方采购、只有清单内的设备允许上线——就关闭自动注册,改走预登记白名单。入口是 WrtHub-UI 设备列表页的"预注册设备"按钮(自动注册开启时该按钮隐藏,两者互斥),对应管理面(7443)的 API POST /api/v1/devices/pre-register:必填字段只有 device_id,mac(12 位小写十六进制)、device_name、model 都是可选补充:
{
"device_id": "Vq3nK8tR2mWx5bY7dL1cgTa3f4",
"mac": "001122334455",
"device_name": "SH-001",
"model": "x86-2.4G"
}
注意两点。第一,device_id 是设备固有的唯一标识(BASE62 UUID + 本机 MAC 后缀,贯穿 join/status/auth 全流程),可以从设备首启日志中读到,再登记进白名单,不是自己随手填的。第二,预登记只是"放行这台设备加入",不会自动推送任何配置:无线与认证配置仍要在设备上线后逐店配置。auto_register 关闭时若有未授权设备尝试 join,会被拒绝,且该次请求落库为 pending,方便确认是哪台设备被挡在门外。
与已发布的搭建指南有一处差异需要说明:那篇的推荐走法是"预登记设备 MAC 并指定分组,join 后自动下发分组配置"。当前版本系统中预登记的主键是 device_id(MAC 仅为可选补充字段),控制台暂无设备分组功能,join 也不会自动下发配置。本篇按现版本实际机制撰写,与已发布篇的流程描述不一致处,以本篇及源码为准。
3.2 统一策略变更
总部运营调整 WiFi 品牌页面
│
├─ 在 WrtHub-UI 模板库更新模板文件(上传 / 可视化编辑 / 预览)
├─ 同一模板 code 下所有设备,下次弹页面即为新页面
├─ 需要按店/按区域区分:调整 portal-server 的 rules 并重启
└─ 改 rules 只影响"谁看到哪个页面",不影响认证链路
"变更"分两层。模板文件本身由 portal-server 按请求从磁盘读取,同一 code 下更新文件立即生效、无需重启;而 config.yaml 里的 rules / default_template 映射只在启动时读一次,任何修改都要重启 portal-server。这个区分直接影响运维排期:改页面是低风险操作,改"谁用哪个页面"的规则是有小窗口的操作。
WrtHub-UI 里另有一张策略表 portal_policies,为更细的匹配预留了 SSID / AC 地址 / AC 名称 / APID / IP 前缀 / 时段 / 星期等匹配键。它的现状与"统一性"的维护机制,见 4.1。
3.3 远程故障恢复
门店断网或配置异常
│
├─ device_healthd 检测设备异常并上报云端
├─ 总部在 WrtHub-UI 确认设备离线或服务异常
├─ 经接入通道远程登录门店设备(LuCI / UBUS)
├─ 检查配置、重启服务或回滚到快照
└─ 无需派工程师到现场
极端情况下云端不可达(云服务器宕机、公网链路中断),门店还有一条本地兜底:设备的 8765 端口是本地管理入口(反代 LuCI 与 /ubus,集中鉴权)。默认接入通道模式(join 响应 frpc_mode=1)下它只绑定回环,管理流量走云端;frpc_mode=0(直连模式)时设备不启动 frp 客户端,8765 监听所有接口——门店店长现场用 http://192.168.1.1:8765 直接处理应急,不影响营业。
四、关键设计点
4.1 策略匹配与统一性维护
"每家店的客人看到哪个页面"由 portal-server 的五级选择链决定:
- 查询参数
t={code}(仅预览/调试,优先级最高); rules中device按device_id精确匹配;rules中prefix按device_id前缀匹配;default_template兜底;- 兜底也未命中时,取磁盘上首个可用模板。
每一级都重新校验(code 白名单 + 模板入口页存在),规则指向不存在的模板不会报错,而是静默落到下一级。连锁门店的典型配置:
default_template: shop-blue
rules:
- device: "Vq3nK8tR2mWx5bY7dL1cgTa3f4" # 旗舰店精确指定
template: shop-blue-vip
- prefix: "SH-" # 上海区域批量命中
template: shop-blue
- prefix: "BJ-" # 北京区域批量命中
template: shop-blue-bj
prefix 要能批量命中,device_id 需要遵循统一命名约定(区域/门店前缀);某家店设备的 ID 没有业务前缀时,退化为逐店 device 精确匹配——代价只是多一行规则。
策略表现状。 portal_policies 表预留了 SSID、AC 地址、AC 名称、APID、IP 前缀、时段、星期等匹配键,外加优先级(数值越小越优先,范围 0–10000,缺省 100)与默认策略标记。当前版本中它只承担管理面存储与模板引用保护(被策略引用的模板不可删除),"按策略自动选模板"的生产链路尚未打通,portal-server 仍用自身 rules 选模板。
统一性机制。 在策略表打通之前,"全门店一致"靠两个机制兜住:
- 配置项基线核对:WrtHub-UI 内置关键项清单(
webauthd.*/network.lan.*/wireless.radio0.*),逐设备核对,结果分 ok / drift / missing / na / error 五态。"drift"即与基线存在偏差——哪家店的无线参数被本地改过,一目了然; - 快照留痕:配置快照可抓取、查看、下载,并限制保留份数;逐设备的配置管理策略(检查间隔、自动修复、快照保留)经北向接口设置。出故障后可回滚到变更前的快照。
会话与强登。 访客会话集中可视(5 秒自动刷新),某门店的访客会话若被滥用(例如占满带宽),可经 webauthd.session/drop_user 强制下线;配合本地账号的带宽策略与在线时长配额,也能在账号层做逐店差异化的使用规则。
4.2 多 WAN 保障
门店网络最怕收银断网。mkmwan3 提供:
- 主备链路(有线 + 4G/5G);
- 按目的地址或权重分流;
- 故障自动切换,恢复自动回切。
关键是把收银台、POS 机的流量走主链路,公共 WiFi 走备链路,互不影响。配置细节与验证步骤见多WAN负载均衡。如果门店本身是上层网络的分支扩展,还可以用桥接模式把门店 LAN 与上层网络纳入同一二层域,门店在上层网络内保持透明,公共 WiFi 则独立认证。
4.3 认证合规
公共 WiFi 的实名认证通过 webauthd 的多认证源实现:
- 对接运营商 RADIUS(合规要求高的地区);
- 对接自建 HTTP 认证接口(自有会员体系);
- 本地账号(小规模门店),逐账号可设带宽策略与在线时长配额;
- LDAP(企业目录体系)。
认证源在 WrtHub-UI 集中配置:本地账号云端全局管理,RADIUS 参数按设备在设备详情页下发(端口与密钥两端对齐,云管模式以控制台值为准),门店侧无需单独设置。登录日志与会话记录同样集中在云端,合规留痕完整。Portal 认证体系原理见基于webauthd的运营级Portal认证系统。
五、与传统方式对比
| 维度 | 传统门店方式 | 本方案 |
|---|---|---|
| 上线 | 工程师上门配置 | 通电即用,预登记/自动注册二选一 |
| 改配置 | 电话指导或上门 | 总部云端逐台配置,基线核对偏差 |
| 故障 | 上门排查 | 远程处理 + 本地 8765 应急入口 |
| 认证 | 各店各自为政 | 统一认证源与合规留痕 |
| 成本 | 人工差旅高 | 集中运维,按角色分权 |
六、落地建议
- 预登记先行:新店设备到货、首启后读取
device_id录入预登记表(MAC 可作为可选补充字段);门店数量稳定后,再评估是否关闭自动注册、只走白名单; - 前缀约定 + 基线核对:设备 ID 采用统一命名约定(区域/门店前缀),Portal 模板用
prefix规则批量命中;无线与认证配置逐台同值配置,定期用配置项基线核对偏差,对drift提示的门店逐台修正; - 收银与 WiFi 隔离:通过多 WAN 分流(收银走主链路、公共 WiFi 走备链路)或 VLAN,把收银流量与公共 WiFi 隔离,互不影响;
- Portal 模板统一:品牌页面由总部统一维护在模板库,门店不自行修改;
rules变更需要重启portal-server,安排在低峰窗口执行; - 应急通道:保留门店本地管理入口(8765),云端不可达时现场仍能处理,不影响营业。
连锁门店场景的核心是"标准化 + 远程化":把每家店的网络变成可复制的模板,把运维动作集中到总部。这正是本方案的强项。下一篇继续场景篇,看工业物联网边缘网关——对象从门店网络换成工厂里的边缘网关,集中管理的机制不变,变的是对象。
延伸阅读
- 使用WrtHub构建自己的云AC管理平台
- 让散落的 OpenWrt 盒子连起来
- 非入侵式 Frps 权限集中管理
- OpenWrt 管理界面全套上云
- 唤醒OpenWrt沉睡的ubus接口
- 拆掉重建 OpenWrt 的 WEB 管理界面
- WrtHub云管理控制面
- 高适应性云Portal认证与会话管理原理详解
转载自 CSDN-专业IT技术社区
原文链接:https://blog.csdn.net/xaOctopus/article/details/170861383



