云枢路由XCPON
首页/帮助文档

云枢路由 · 配置与维护文档

这份 Wiki 只讲路由器怎么配、怎么维护、出问题先看哪里:从登录后台、WAN/LAN 接入、PPPoE 拨号,到 PPPoE Server、RADIUS、云连接、备份恢复和一体机 ISO 安装。所有日常操作都可以在浏览器里完成。

适用版本 1.0.x 16 个章节 面向管理员 / 运维 更新于 2026-11

1登录后台与首次配置#

云枢路由用一台设备同时承担出口路由和管理控制台。交付时只需要浏览器:打开设备地址、登录管理员账号,接口、路由、认证、云连接都在中文后台完成。

两种登录方式

方式地址适用场景
本地/内网访问http://<设备IP>:8080/设备与电脑在同一网段,首次上架配置
云连接访问https://<4位ID>.mget.xcpon.com/设备在异地、无公网 IP,需启用云连接后使用

默认账号

入口默认账号说明
Web 控制台admin / admin123首次登录强制修改密码
系统维护内部维护通道账号密码不对外提供,由运维人员处理

首次配置清单

  1. 登录后立即修改 admin 密码;在「账号权限」中为运维人员建立独立账号,不要共用管理员。
  2. 到「网络接口」确认第一块网卡(WAN)和第二块网卡(LAN)的用途与地址;一体机出厂 WAN 默认为 192.168.88.188/24,LAN 默认为 10.99.0.1/24。
  3. 按线路类型配置 WAN:DHCP、静态 IP 或 PPPoE;配置后确认接口状态为「正常」并拿到地址。
  4. 在「系统管理 → 主机设置」核对主机名、时区、时间源;需要远程管理时再启用「云连接」。
  5. 完成配置后在「配置管理」创建一份备份,记录变更内容。
不要直接把 8080 管理端口映射到公网。需要异地管理时请使用「云连接」,由云中继完成身份校验和 HTTPS 加密,设备本身不开放入站管理端口。

2后台功能地图#

左侧菜单共 16 个页面,按「概览 → 网络 → 服务 → 系统」组织:

分组页面主要用途
概览首页概览接口状态、流量、资源、告警与最近操作
网络网络接口WAN/LAN、DHCP/静态/PPPoE、VLAN、WireGuard、回环
路由管理静态路由、策略路由、路由表
NAT 转换源 NAT、目的 NAT、端口映射
防火墙地址组、规则链、策略顺序
服务DHCP 服务地址池、静态映射、租约
DNS 服务转发、静态解析、上游 DNS
PPPoE 接入PPPoE Server、地址池、本地账号、在线会话
RADIUS 认证RADIUS 服务器、认证/计费、CoA
流量控制 / VPN 管理限速策略、WireGuard / IPsec
系统云连接启用云端隧道、查看专属地址与 内部维护 端口
系统管理主机、时间、设备对接、镜像、日志、电源
配置管理当前配置、差异、预检、备份与回滚
日志审计操作日志、运行日志
账号权限管理员 / 运维 / 只读账号与角色
—所有写操作二次确认、可审计

3网络接口与 WAN 接入#

新建或编辑接口时,先选「接口用途」,再选接入方式。WAN 用于外网出口,LAN 用于内网网关;两块网卡职责分开,避免把管理地址暴露在 WAN。

WAN 的四种接入方式

接入方式需要填写结果
DHCP接口名(如 eth0)从上游自动获取地址、掩码与默认网关
静态 IPIPv4 CIDR、可选默认网关地址固定;填网关时自动安装默认路由
PPPoE 拨号物理接口、拨号账号、密码、MTU生成逻辑接口 pppoeN,拨号成功后自动装默认路由
不配置仅接口名先建接口,后续再补地址或接入方式

新建 WAN 静态 IP 的步骤

  1. 「网络接口 → 新建接口」→ 用途选 WAN → 接入方式选 静态 IP。
  2. 填写接口名与 CIDR,例如 eth1 / 203.0.113.10/24;需要默认上网时填写网关 203.0.113.1。
  3. 保存后查看列表:用途列显示 WAN、接入方式显示「静态 IP」,状态为「正常」。

PPPoE 拨号

  1. 用途选 WAN,接入方式选 PPPoE 拨号。
  2. 选择承载的物理接口(例如 eth1),填写运营商账号、密码;MTU 通常为 1492。
  3. 接口名称自动生成 pppoeN,不要手动把名称改成 eth1。拨号成功后设备自动安装默认路由。
  4. 在接口详情中可查看拨号状态;长时间「未连接」时检查账号、VLAN(部分小区宽带需要 VLAN)、物理链路。

LAN 地址

LAN 默认使用静态网关,例如 eth2 / 192.168.1.1/24;如要做二级网络从上游取地址,也可选择 DHCP。局域网内电脑的网关指向该地址,再配合 DHCP 服务下发地址。

双 WAN 注意:PPPoE 和 DHCP 都会自动安装默认路由;多条 WAN 同时启用时,建议只给主用线路填默认网关,或在「路由管理」中用策略路由做分流/主备,避免多条同优先级默认路由。

4路由、NAT 与防火墙#

静态路由与策略路由

「路由管理」可以查看默认路由、直连路由和静态明细;新增静态路由需要目标网段、下一跳或出接口。策略路由按源地址、目的地址、协议、端口把流量导向指定路由表,适合多 WAN 分流。

场景建议做法
双线主备只给主用线路设置默认网关;备用线路不填网关,用策略路由按源地址切换
专线访问内网为专线目的网段添加静态路由,下一跳为对端地址
访客网络访客 VLAN 通过策略路由走独立出口,并配置防火墙隔离

NAT

源 NAT 用于内网访问外网(配置出接口与源地址段);目的 NAT(端口映射)把公网端口映射到内网服务器。添加规则后确认接口选择正确,并检查防火墙是否放行。

防火墙

  1. 先建立地址组(内网、服务器、访客等),后续规则引用地址组,修改时不用重复改规则。
  2. 按「先放行必要服务、最后默认拒绝」的顺序组织规则;不要把管理端口直接开放给 WAN。
  3. 修改后在「配置管理」预览并下发,出现误拦截时回滚上一条备份。

5DHCP 与 DNS#

DHCP 服务

  • 为每个 LAN 网段建立地址池,填写起始/结束地址、网关、DNS、租期。
  • 服务器、打印机、AP 等固定设备建议用静态映射绑定 MAC。
  • 「在线租约」可以看当前分配情况;改地址池前先确认不会与现有静态地址冲突。

DNS 服务

  • 可配置上游 DNS 与本地静态解析;内网域名建议在路由器上做静态记录,客户端统一指向路由器。
  • 修改 DNS 后,客户端需要重新获取 DHCP 租约或手动刷新 DNS 缓存。
建议:LAN 网关、DHCP 网关和 DNS 指向保持同一台设备;跨网段访问先在路由器上确认路由可达,再排查终端。

6PPPoE Server#

PPPoE Server 让路由器直接承担宽带拨号接入,适合小区、园区、公寓和酒店。可在本地认证,也可对接标准 RADIUS。

配置顺序

  1. 接入接口:在「PPPoE 接入 → 服务配置」选择承载拨号的 LAN 接口,设置 AC 名称、服务名、网关地址、MTU、最大会话数。
  2. 地址池:新建地址池(名称 + 起始/结束地址);需要时可配置 next-pool 做地址池级联。
  3. 本地账号:添加用户名、密码、静态 IP(可选)、上下行限速、禁用状态;启用 RADIUS 模式时本地账号不生效。
  4. 在线会话:查看拨号用户名、IP、速率、在线时长;可强制下线单个用户或全部用户(全部下线需管理员权限)。

认证模式怎么选

模式适用说明
本地账号用户少、无 RADIUS 服务器账号密码直接保存在路由器,管理简单
RADIUS运营级、多设备统一认证认证/计费在外部 RADIUS 服务器,支持 CoA 强制下线
免认证临时接入/测试不建议在生产环境长期使用
修改接入接口、地址池、认证模式会重启 PPPoE 服务并断开在线用户,建议在维护窗口操作,页面会二次确认。

7RADIUS 认证与计费#

「RADIUS 认证」页配置标准 RADIUS 服务器,供 PPPoE Server、VPN 等场景使用。

字段说明
服务器地址 / 端口RADIUS 服务器 IP 与认证/计费端口(通常 1812/1813)
共享密钥与 RADIUS 服务器一致;只写不读,留空表示保持原值
超时 / 重试网络质量差时可适当加大
NAS 标识nas-identifier / nas-ip-address,用于服务器识别接入设备
CoA启用后可在 RADIUS 侧强制用户下线或改速

联调步骤

  1. 在 RADIUS 服务器上添加路由器的 NAS 客户端(地址 + 共享密钥)。
  2. 路由器侧填写服务器信息,使用页面「测试」按钮验证连通性与认证。
  3. 将 PPPoE 认证模式切到 RADIUS,确认在线用户能在 RADIUS 计费日志中看到 Start/Interim/Stop。
  4. 需要强制下线时,从 RADIUS 服务器发 CoA,或在路由器会话页手动断开。

8流量控制与 VPN#

流量控制(QoS)

可按接口或用户配置上下行限速、优先级与队列;PPPoE 本地账号里也可以直接给单个用户设置速率。上线前先用小流量验证,避免把管理流量或语音流量误限速。

VPN

支持 WireGuard / IPsec 等隧道配置:填写对端地址、密钥/预共享密钥、允许的网段,并在「路由管理」把对端子网指向隧道接口。VPN 连通后先测路由,再测业务端口。

9云连接#

云连接让设备在任意网络下都能被远程管理:设备主动连接云端中继,不需要公网 IP,也不需要开放入站管理端口。

启用步骤

  1. 登录云管理后台,在「设备注册码」处复制注册码。
  2. 路由器进入「系统 → 云连接」,填写云端控制器(默认 https://admin.mget.xcpon.com)、设备名称与注册码。
  3. 点击「启用云连接」;几秒后页面显示「云端在线」,并分配专属地址与 内部维护 转发端口。
  4. 云管理后台会显示该设备的 Web 地址、内部维护 端口与在线状态。

访问地址

用途地址 / 命令
Web 控制台https://<4位ID>.mget.xcpon.com/(HTTPS 自动证书)
内部运维端口<8101+>(账号密码不对外提供)

排障

  • 一直显示注册中:检查设备是否能访问互联网与云端域名,确认注册码没有输错;注册码失效时在云后台重新复制。
  • 云端离线:设备重启或换网后 frpc 会自动重连;等待 1 分钟,仍离线时检查「系统管理 → 运行日志」与 /var/lib/routerd/cloud/frpc.log。
  • 地址打不开:确认设备在线;云端证书按子域自动签发,首次访问可能需要几秒。
  • 内部维护 连不上:确认端口与设备分配一致,云服务器安全组放行 8101–8999。
停用与重新注册:停用会关闭隧道,本地管理不受影响;重新注册会分配新的子域和端口,旧地址立即失效。请把新地址同步给使用人。

10系统管理与主机设置#

  • 主机设置:核对主机名、时区、NTP 时间源;修改主机名会同步到设备侧配置。
  • 设备对接:默认演示模式;接真实设备时切换为 HTTP API,填写设备地址、端口、API 密钥,保存后页面会热切换。
  • 系统镜像:查看已安装镜像与运行状态;升级或回退前先备份配置。
  • 日志:查看运行日志、接口状态与最近操作;导出日志前先确认不含敏感信息。
  • 电源操作:重启设备需管理员权限,执行前确认配置已保存。
修改管理地址、内部维护 端口或 API 端口前,先确认新地址可达;远程操作时避免把自己锁在设备外。

11配置备份、回滚与恢复#

任何批量修改前都先做备份。云枢路由的配置管理会保存配置快照、显示差异,并支持回滚。

  1. 进入「配置管理」,先点「备份」创建当前配置快照,填写用途说明(例如“上线前基线”)。
  2. 修改接口、NAT、防火墙等配置时,页面会显示变更预览;确认差异后再下发。
  3. 出现异常时,在备份列表选择变更前的快照,执行回滚;回滚是一次新的配置下发,同样写入审计。
  4. 重要节点(上线、扩容、换线)至少保留一份离线备份,命名包含日期和变更内容。
恢复注意:回滚会覆盖当前配置。执行前确认备份内容与目标设备匹配,避免把测试配置恢复到生产环境。

12账号权限与日志审计#

角色权限适用
管理员 admin全部权限:账号、备份恢复、重启、镜像、云连接系统负责人
运维 operator可读写网络配置,不能管理账号/恢复备份/重启日常运维
只读 viewer只能查看页面,所有写操作被拒绝审计、值班查看
  • 为每个人建立独立账号,便于审计;离职或换岗时立即停用。
  • 「日志审计」记录操作人、时间、动作与配置命令;异常排查先看这里。
  • 管理员密码建议使用 12 位以上、包含大小写/数字/符号的独立密码,不要与其它系统共用。

13一体机 ISO 安装与初始化#

云枢路由一体机基于 Debian 13 精简系统,镜像约 293 MB,支持 BIOS/UEFI。默认菜单会把系统安装到空白磁盘,安装完成后自动关机。

安装步骤

  1. 制作启动 U 盘或把 ISO 挂载到虚拟机,设置从光盘/U 盘启动。
  2. 默认菜单「安装 / 启动」倒计时 10 秒后自动安装到空白磁盘;已有系统的磁盘会跳过自动安装,避免误删数据。
  3. 安装完成后设备关机;移除 ISO,从硬盘启动。
  4. 第一块网卡作为 WAN,默认 192.168.88.188/24;第二块网卡作为 LAN,默认 10.99.0.1/24。浏览器打开 http://192.168.88.188:8080/ 登录。

磁盘布局

分区大小用途
BIOS boot2 MBBIOS 启动
EFI512 MBUEFI 启动
根分区剩余空间系统、控制台与配置
自动安装会清空目标磁盘。生产设备安装前确认磁盘无数据,并记录原设备配置。

14日常维护与巡检#

线路检测(两组心跳服务器)

在「网络 → 线路检测」中配置两组心跳服务器,用于判断路由器出口是否联通。每组可以填写多个 HTTPS URL 或 host:port,组内任意一个服务器响应即视为该组在线;全部已配置组都在线时总体显示正常,只有部分组在线时显示部分线路可用。

  1. 填写两组名称(例如主线路 / 备用线路)和心跳服务器,每行一个,最多 8 个;建议选择不同运营商或不同地域的地址。
  2. 设置检测周期(5–300 秒)和单次超时(1–30 秒),保存后立即检测一次;也可以随时点「立即检测」。
  3. 查看每组的状态、最低延迟和每个心跳服务器的结果;两组都失败时整体显示线路全部离线。

每日/每周检查

  • 首页看接口状态、在线用户数、资源使用率与告警;异常接口优先处理。
  • 「配置管理」确认最近变更都是计划内操作;「日志审计」查看失败操作。
  • 云连接页确认设备在线;云端管理后台核对地址与端口未被误改。

维护窗口建议

  1. 先备份配置,并记录本次变更点。
  2. 涉及 PPPoE 服务、接口地址、管理端口的变更会中断连接,提前通知使用人。
  3. 变更后验证:接口地址、默认路由、PPPoE/VPN 会话、云连接在线、管理后台可登录。
  4. 如异常,立即用备份回滚,再排查日志。

命令行巡检(高级)

由运维人员通过内部维护通道登录后可执行:

ip -br a                 # 查看接口与地址
ip route                 # 查看默认路由/静态路由
systemctl status routerd # 控制台服务状态
journalctl -u routerd -n 100 --no-pager
tail -n 100 /var/lib/routerd/cloud/frpc.log  # 云连接日志

15常见问题排查#

打不开管理后台

现象排查
浏览器一直转圈确认地址为 http://设备IP:8080/;检查电脑与设备是否同网段、是否被防火墙拦截
云地址打不开看云连接页是否在线;等待重连;检查云端安全组是否放行 443/7000/8101-8999
登录后跳回登录页清理浏览器缓存或换无痕窗口;确认密码未被修改
页面 502/超时通过内部维护通道确认 systemctl status routerd 与端口 8080 监听

WAN 不获取地址 / PPPoE 拨不上

  • 看接口列表状态与地址:DHCP 是否拿到地址,PPPoE 是否显示已连接。
  • 核对账号密码、VLAN、物理链路与上游端口;PPPoE 可能需要运营商绑定 MAC/VLAN。
  • 确认没有把同一物理口同时配置成 WAN 静态和 PPPoE 承载;PPPoE 只需选承载口。
  • 检查默认路由是否指向正确的 WAN;多 WAN 时注意策略路由优先级。

PPPoE 用户连不上

  • 确认服务已启用、接入接口正确、地址池有可用地址。
  • 本地认证时检查账号是否禁用、密码是否正确;RADIUS 模式时检查服务器与共享密钥。
  • 查看在线会话与 RADIUS 计费日志;必要时临时切回本地账号验证链路。

云连接离线

  • 设备能上网吗?DNS 是否正常解析 admin.mget.xcpon.com。
  • 「系统 → 云连接」查看状态与错误;重新注册会分配新地址。
  • 内部维护 查看 /var/lib/routerd/cloud/frpc.log,常见原因是注册码失效、云端不可达或 frpc 未运行。

忘记管理员密码

先尝试其他管理员账号或控制台 root 登录进行恢复;无法恢复时联系技术支持,并提供设备型号/序列号与变更记录。不要直接删除数据目录,避免丢失配置与审计。

提交问题时请附上:首页截图、出错页面的提示文字、最近一次变更内容、内部维护 下 journalctl -u routerd -n 100 的输出(注意脱敏公网 IP 与密码)。

16安全建议与术语#

上线安全清单

  1. 修改所有默认密码;管理员、内部维护、控制台密码分开管理。
  2. 管理后台不要直接映射公网;异地管理走「云连接」,并定期检查云端设备列表。
  3. 内部维护 仅对运维网段开放,优先使用密钥;不再需要时停用密码登录。
  4. 防火墙默认拒绝入站,仅放行必要业务端口;NAT 映射遵循最小化原则。
  5. 定期备份配置并导出审计日志;关注设备与云端证书有效期。

术语表

术语说明
WAN / LAN外网出口 / 内网网关接口,本系统在接口页用「用途」区分
PPPoE拨号接入协议;WAN 侧为客户端拨号,PPPoE Server 侧为接入服务器
RADIUS标准认证、授权、计费协议,支持 CoA 强制下线
NAT网络地址转换,含源 NAT(上网)与目的 NAT(端口映射)
四层/七层按 IP/端口或按应用协议匹配流量,用于防火墙与策略路由
云连接设备主动连接云端中继,实现无公网 IP 的远程管理
配置快照某个时间点的完整配置备份,可用于对比和回滚

文档没有覆盖的问题,请把「首页截图 + 出错提示 + 最近变更」一起发给我们,定位会快很多。

提交问题 / 获取支持