1登录后台与首次配置#
云枢路由用一台设备同时承担出口路由和管理控制台。交付时只需要浏览器:打开设备地址、登录管理员账号,接口、路由、认证、云连接都在中文后台完成。
两种登录方式
| 方式 | 地址 | 适用场景 |
|---|---|---|
| 本地/内网访问 | http://<设备IP>:8080/ | 设备与电脑在同一网段,首次上架配置 |
| 云连接访问 | https://<4位ID>.mget.xcpon.com/ | 设备在异地、无公网 IP,需启用云连接后使用 |
默认账号
| 入口 | 默认账号 | 说明 |
|---|---|---|
| Web 控制台 | admin / admin123 | 首次登录强制修改密码 |
| 系统维护 | 内部维护通道 | 账号密码不对外提供,由运维人员处理 |
首次配置清单
- 登录后立即修改
admin密码;在「账号权限」中为运维人员建立独立账号,不要共用管理员。 - 到「网络接口」确认第一块网卡(WAN)和第二块网卡(LAN)的用途与地址;一体机出厂 WAN 默认为
192.168.88.188/24,LAN 默认为10.99.0.1/24。 - 按线路类型配置 WAN:DHCP、静态 IP 或 PPPoE;配置后确认接口状态为「正常」并拿到地址。
- 在「系统管理 → 主机设置」核对主机名、时区、时间源;需要远程管理时再启用「云连接」。
- 完成配置后在「配置管理」创建一份备份,记录变更内容。
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) | 从上游自动获取地址、掩码与默认网关 |
| 静态 IP | IPv4 CIDR、可选默认网关 | 地址固定;填网关时自动安装默认路由 |
| PPPoE 拨号 | 物理接口、拨号账号、密码、MTU | 生成逻辑接口 pppoeN,拨号成功后自动装默认路由 |
| 不配置 | 仅接口名 | 先建接口,后续再补地址或接入方式 |
新建 WAN 静态 IP 的步骤
- 「网络接口 → 新建接口」→ 用途选 WAN → 接入方式选 静态 IP。
- 填写接口名与 CIDR,例如
eth1/203.0.113.10/24;需要默认上网时填写网关203.0.113.1。 - 保存后查看列表:用途列显示 WAN、接入方式显示「静态 IP」,状态为「正常」。
PPPoE 拨号
- 用途选 WAN,接入方式选 PPPoE 拨号。
- 选择承载的物理接口(例如 eth1),填写运营商账号、密码;MTU 通常为 1492。
- 接口名称自动生成
pppoeN,不要手动把名称改成 eth1。拨号成功后设备自动安装默认路由。 - 在接口详情中可查看拨号状态;长时间「未连接」时检查账号、VLAN(部分小区宽带需要 VLAN)、物理链路。
LAN 地址
LAN 默认使用静态网关,例如 eth2 / 192.168.1.1/24;如要做二级网络从上游取地址,也可选择 DHCP。局域网内电脑的网关指向该地址,再配合 DHCP 服务下发地址。
4路由、NAT 与防火墙#
静态路由与策略路由
「路由管理」可以查看默认路由、直连路由和静态明细;新增静态路由需要目标网段、下一跳或出接口。策略路由按源地址、目的地址、协议、端口把流量导向指定路由表,适合多 WAN 分流。
| 场景 | 建议做法 |
|---|---|
| 双线主备 | 只给主用线路设置默认网关;备用线路不填网关,用策略路由按源地址切换 |
| 专线访问内网 | 为专线目的网段添加静态路由,下一跳为对端地址 |
| 访客网络 | 访客 VLAN 通过策略路由走独立出口,并配置防火墙隔离 |
NAT
源 NAT 用于内网访问外网(配置出接口与源地址段);目的 NAT(端口映射)把公网端口映射到内网服务器。添加规则后确认接口选择正确,并检查防火墙是否放行。
防火墙
- 先建立地址组(内网、服务器、访客等),后续规则引用地址组,修改时不用重复改规则。
- 按「先放行必要服务、最后默认拒绝」的顺序组织规则;不要把管理端口直接开放给 WAN。
- 修改后在「配置管理」预览并下发,出现误拦截时回滚上一条备份。
5DHCP 与 DNS#
DHCP 服务
- 为每个 LAN 网段建立地址池,填写起始/结束地址、网关、DNS、租期。
- 服务器、打印机、AP 等固定设备建议用静态映射绑定 MAC。
- 「在线租约」可以看当前分配情况;改地址池前先确认不会与现有静态地址冲突。
DNS 服务
- 可配置上游 DNS 与本地静态解析;内网域名建议在路由器上做静态记录,客户端统一指向路由器。
- 修改 DNS 后,客户端需要重新获取 DHCP 租约或手动刷新 DNS 缓存。
6PPPoE Server#
PPPoE Server 让路由器直接承担宽带拨号接入,适合小区、园区、公寓和酒店。可在本地认证,也可对接标准 RADIUS。
配置顺序
- 接入接口:在「PPPoE 接入 → 服务配置」选择承载拨号的 LAN 接口,设置 AC 名称、服务名、网关地址、MTU、最大会话数。
- 地址池:新建地址池(名称 + 起始/结束地址);需要时可配置 next-pool 做地址池级联。
- 本地账号:添加用户名、密码、静态 IP(可选)、上下行限速、禁用状态;启用 RADIUS 模式时本地账号不生效。
- 在线会话:查看拨号用户名、IP、速率、在线时长;可强制下线单个用户或全部用户(全部下线需管理员权限)。
认证模式怎么选
| 模式 | 适用 | 说明 |
|---|---|---|
| 本地账号 | 用户少、无 RADIUS 服务器 | 账号密码直接保存在路由器,管理简单 |
| RADIUS | 运营级、多设备统一认证 | 认证/计费在外部 RADIUS 服务器,支持 CoA 强制下线 |
| 免认证 | 临时接入/测试 | 不建议在生产环境长期使用 |
7RADIUS 认证与计费#
「RADIUS 认证」页配置标准 RADIUS 服务器,供 PPPoE Server、VPN 等场景使用。
| 字段 | 说明 |
|---|---|
| 服务器地址 / 端口 | RADIUS 服务器 IP 与认证/计费端口(通常 1812/1813) |
| 共享密钥 | 与 RADIUS 服务器一致;只写不读,留空表示保持原值 |
| 超时 / 重试 | 网络质量差时可适当加大 |
| NAS 标识 | nas-identifier / nas-ip-address,用于服务器识别接入设备 |
| CoA | 启用后可在 RADIUS 侧强制用户下线或改速 |
联调步骤
- 在 RADIUS 服务器上添加路由器的 NAS 客户端(地址 + 共享密钥)。
- 路由器侧填写服务器信息,使用页面「测试」按钮验证连通性与认证。
- 将 PPPoE 认证模式切到 RADIUS,确认在线用户能在 RADIUS 计费日志中看到 Start/Interim/Stop。
- 需要强制下线时,从 RADIUS 服务器发 CoA,或在路由器会话页手动断开。
8流量控制与 VPN#
流量控制(QoS)
可按接口或用户配置上下行限速、优先级与队列;PPPoE 本地账号里也可以直接给单个用户设置速率。上线前先用小流量验证,避免把管理流量或语音流量误限速。
VPN
支持 WireGuard / IPsec 等隧道配置:填写对端地址、密钥/预共享密钥、允许的网段,并在「路由管理」把对端子网指向隧道接口。VPN 连通后先测路由,再测业务端口。
9云连接#
云连接让设备在任意网络下都能被远程管理:设备主动连接云端中继,不需要公网 IP,也不需要开放入站管理端口。
启用步骤
- 登录云管理后台,在「设备注册码」处复制注册码。
- 路由器进入「系统 → 云连接」,填写云端控制器(默认
https://admin.mget.xcpon.com)、设备名称与注册码。 - 点击「启用云连接」;几秒后页面显示「云端在线」,并分配专属地址与 内部维护 转发端口。
- 云管理后台会显示该设备的 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 密钥,保存后页面会热切换。
- 系统镜像:查看已安装镜像与运行状态;升级或回退前先备份配置。
- 日志:查看运行日志、接口状态与最近操作;导出日志前先确认不含敏感信息。
- 电源操作:重启设备需管理员权限,执行前确认配置已保存。
11配置备份、回滚与恢复#
任何批量修改前都先做备份。云枢路由的配置管理会保存配置快照、显示差异,并支持回滚。
- 进入「配置管理」,先点「备份」创建当前配置快照,填写用途说明(例如“上线前基线”)。
- 修改接口、NAT、防火墙等配置时,页面会显示变更预览;确认差异后再下发。
- 出现异常时,在备份列表选择变更前的快照,执行回滚;回滚是一次新的配置下发,同样写入审计。
- 重要节点(上线、扩容、换线)至少保留一份离线备份,命名包含日期和变更内容。
12账号权限与日志审计#
| 角色 | 权限 | 适用 |
|---|---|---|
| 管理员 admin | 全部权限:账号、备份恢复、重启、镜像、云连接 | 系统负责人 |
| 运维 operator | 可读写网络配置,不能管理账号/恢复备份/重启 | 日常运维 |
| 只读 viewer | 只能查看页面,所有写操作被拒绝 | 审计、值班查看 |
- 为每个人建立独立账号,便于审计;离职或换岗时立即停用。
- 「日志审计」记录操作人、时间、动作与配置命令;异常排查先看这里。
- 管理员密码建议使用 12 位以上、包含大小写/数字/符号的独立密码,不要与其它系统共用。
13一体机 ISO 安装与初始化#
云枢路由一体机基于 Debian 13 精简系统,镜像约 293 MB,支持 BIOS/UEFI。默认菜单会把系统安装到空白磁盘,安装完成后自动关机。
安装步骤
- 制作启动 U 盘或把 ISO 挂载到虚拟机,设置从光盘/U 盘启动。
- 默认菜单「安装 / 启动」倒计时 10 秒后自动安装到空白磁盘;已有系统的磁盘会跳过自动安装,避免误删数据。
- 安装完成后设备关机;移除 ISO,从硬盘启动。
- 第一块网卡作为 WAN,默认
192.168.88.188/24;第二块网卡作为 LAN,默认10.99.0.1/24。浏览器打开http://192.168.88.188:8080/登录。
磁盘布局
| 分区 | 大小 | 用途 |
|---|---|---|
| BIOS boot | 2 MB | BIOS 启动 |
| EFI | 512 MB | UEFI 启动 |
| 根分区 | 剩余空间 | 系统、控制台与配置 |
14日常维护与巡检#
线路检测(两组心跳服务器)
在「网络 → 线路检测」中配置两组心跳服务器,用于判断路由器出口是否联通。每组可以填写多个 HTTPS URL 或 host:port,组内任意一个服务器响应即视为该组在线;全部已配置组都在线时总体显示正常,只有部分组在线时显示部分线路可用。
- 填写两组名称(例如主线路 / 备用线路)和心跳服务器,每行一个,最多 8 个;建议选择不同运营商或不同地域的地址。
- 设置检测周期(5–300 秒)和单次超时(1–30 秒),保存后立即检测一次;也可以随时点「立即检测」。
- 查看每组的状态、最低延迟和每个心跳服务器的结果;两组都失败时整体显示线路全部离线。
每日/每周检查
- 首页看接口状态、在线用户数、资源使用率与告警;异常接口优先处理。
- 「配置管理」确认最近变更都是计划内操作;「日志审计」查看失败操作。
- 云连接页确认设备在线;云端管理后台核对地址与端口未被误改。
维护窗口建议
- 先备份配置,并记录本次变更点。
- 涉及 PPPoE 服务、接口地址、管理端口的变更会中断连接,提前通知使用人。
- 变更后验证:接口地址、默认路由、PPPoE/VPN 会话、云连接在线、管理后台可登录。
- 如异常,立即用备份回滚,再排查日志。
命令行巡检(高级)
由运维人员通过内部维护通道登录后可执行:
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安全建议与术语#
上线安全清单
- 修改所有默认密码;管理员、内部维护、控制台密码分开管理。
- 管理后台不要直接映射公网;异地管理走「云连接」,并定期检查云端设备列表。
- 内部维护 仅对运维网段开放,优先使用密钥;不再需要时停用密码登录。
- 防火墙默认拒绝入站,仅放行必要业务端口;NAT 映射遵循最小化原则。
- 定期备份配置并导出审计日志;关注设备与云端证书有效期。
术语表
| 术语 | 说明 |
|---|---|
| WAN / LAN | 外网出口 / 内网网关接口,本系统在接口页用「用途」区分 |
| PPPoE | 拨号接入协议;WAN 侧为客户端拨号,PPPoE Server 侧为接入服务器 |
| RADIUS | 标准认证、授权、计费协议,支持 CoA 强制下线 |
| NAT | 网络地址转换,含源 NAT(上网)与目的 NAT(端口映射) |
| 四层/七层 | 按 IP/端口或按应用协议匹配流量,用于防火墙与策略路由 |
| 云连接 | 设备主动连接云端中继,实现无公网 IP 的远程管理 |
| 配置快照 | 某个时间点的完整配置备份,可用于对比和回滚 |
文档没有覆盖的问题,请把「首页截图 + 出错提示 + 最近变更」一起发给我们,定位会快很多。
提交问题 / 获取支持