| 故障表现 | 真实原因 | 标准修复方案 |
|---|---|---|
| 浏览器提示 ERR_CONNECTION_REFUSED（连接被拒绝） | 1. 目标服务未添加 -web-lan-access 参数；2. 虽然开启了外网访问但密码为空，系统防裸奔机制强制回退到了仅监听 127.0.0.1。 |
检查启动参数，确保同时具备 -web-lan-access 与 -webpass <密码>；在 OpenWrt 插件中勾选允许局域网访问并填入口令保存。 |
| 页面能打开，输入密码后提示 Invalid password | 后台旧进程未重启，仍运行在旧的口令哈希上。 | 执行 systemctl restart yeeid 或在路由器后台重新点击「保存并应用」，等待服务完整重启。 |
| 在 OpenWrt 后台内嵌控制台提示“拒绝了连接请求” | 浏览器的跨端口 iframe 安全策略阻断（X-Frame-Options 拦截）。 | 请确认已升级至 v1.0.422+ 版本。新版内核已针对内嵌环境放宽 frame-ancestors 并移除跨源拦截头。 |
❓
常见问题与排查
控制台打不开、拒绝连接或报 Invalid password
针对 16699 控制台访问报错的快速排查与解决办法。