⚡ 核心功能手册

跨节点远程访问 Web 控制台配置指南

为什么默认只能本机 127.0.0.1 访问?如何安全开启从其他设备或 VIP 远程打开控制台?

在 Yeeid Mesh 网络中,管理员常需通过某台机器直接打开其他节点的 Web 控制台(端口 16699,如 http://10.10.0.1:16699)。为什么默认会提示连接被拒绝?如何正确配置?

一、 底层两道安全防线(Fail-Closed 设计)

  • 第一道防线:默认严格绑定本地回环(127.0.0.1)
    出于安全考虑,任何节点启动内嵌 Web 管理服务时,默认仅监听 127.0.0.1:16699,外部网络包直接被内核丢弃。
  • 第二道防线:防空口令暴露降级机制
    如果开启了外部访问(-web-lan-access 或 HUBVPN_WEB_LAN_ACCESS=1),但未显式设置 Web 控制台密码,系统判定当前处于高危未授权状态,会自动强制收敛回 127.0.0.1 杜绝裸奔!
⚠️ 铁律

要让远程机器打开目标节点的 16699 控制台,“开启外部监听 (-web-lan-access)” 与 “设置独立访问口令 (-webpass)” 二者缺一不可!

二、 各平台配置方法

运行环境 配置步骤
OpenWrt / iStoreOS 在路由器后台「服务」->「Yeeid」->「基础设置」中:勾选「允许局域网访问 Web 控制台」,并填写「Web 控制台访问密码」(自定义安全密码),点击「保存并应用」自动重启生效。
Windows 图形客户端 本机打开 http://127.0.0.1:16699 -> 点击「设置」-> 勾选「允许局域网访问 Web 控制台」-> 填写独立访问口令 -> 点击保存。
Linux systemd 服务 在 ExecStart 启动参数末尾追加 -web-lan-access -webpass 你的密码,并执行 systemctl restart yeeid。