鮟鱇鱼头像

连锁门店网络的集中接入与认证的技术本质

连锁门店网络的集中接入与认证的技术本质

连锁门店(零售、餐饮、教育等)的网络通常"小而散":每家店 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 的五级选择链决定:

  1. 查询参数 t={code}(仅预览/调试,优先级最高);
  2. rules 中 device 按 device_id 精确匹配;
  3. rules 中 prefix 按 device_id 前缀匹配;
  4. default_template 兜底;
  5. 兜底也未命中时,取磁盘上首个可用模板。

每一级都重新校验(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 应急入口
认证各店各自为政统一认证源与合规留痕
成本人工差旅高集中运维,按角色分权

六、落地建议

  1. 预登记先行:新店设备到货、首启后读取 device_id 录入预登记表(MAC 可作为可选补充字段);门店数量稳定后,再评估是否关闭自动注册、只走白名单;
  2. 前缀约定 + 基线核对:设备 ID 采用统一命名约定(区域/门店前缀),Portal 模板用 prefix 规则批量命中;无线与认证配置逐台同值配置,定期用配置项基线核对偏差,对 drift 提示的门店逐台修正;
  3. 收银与 WiFi 隔离:通过多 WAN 分流(收银走主链路、公共 WiFi 走备链路)或 VLAN,把收银流量与公共 WiFi 隔离,互不影响;
  4. Portal 模板统一:品牌页面由总部统一维护在模板库,门店不自行修改;rules 变更需要重启 portal-server,安排在低峰窗口执行;
  5. 应急通道:保留门店本地管理入口(8765),云端不可达时现场仍能处理,不影响营业。

连锁门店场景的核心是"标准化 + 远程化":把每家店的网络变成可复制的模板,把运维动作集中到总部。这正是本方案的强项。下一篇继续场景篇,看工业物联网边缘网关——对象从门店网络换成工厂里的边缘网关,集中管理的机制不变,变的是对象。

延伸阅读

  1. 使用WrtHub构建自己的云AC管理平台
  2. 让散落的 OpenWrt 盒子连起来
  3. 非入侵式 Frps 权限集中管理
  4. OpenWrt 管理界面全套上云
  5. 唤醒OpenWrt沉睡的ubus接口
  6. 拆掉重建 OpenWrt 的 WEB 管理界面
  7. WrtHub云管理控制面
  8. 高适应性云Portal认证与会话管理原理详解

转载自 CSDN-专业IT技术社区

原文链接:https://blog.csdn.net/xaOctopus/article/details/170861383

文章来源转载

评论

评论列表

微信小程序
QQ小程序

关于作者

点赞数:0
关注数:0
粉丝:0
文章:0
关注标签:0
加入于:--