常见问题

页面能打开，终端为什么 403？

普通页面和终端不是同一连接。终端需要 WebSocket、有效登录会话、2FA 和在线 Agent。检查反向代理的 Upgrade 头、Origin、Cloudflare Access 和浏览器访问域名。

为什么换证书后 Agent 403？

证书不会修改 Agent Token。更常见的是 Agent endpoint 改到了另一端口或实例、旧 Token 已轮换，或代理把请求送到错误后端。

Agent 进程仍在运行，为什么面板显示离线？

先按版本与功能范围核对 Lite 与 Lite-agent 是否为兼容组合。两端需要同时更新：服务端负责维持在线判定，Agent 通过心跳、读超时和快速重连恢复中断连接。

版本已经正确仍反复离线时，继续检查反向代理 WebSocket 超时、Cloudflare Access、DNS 和 IPv4/IPv6 路径。状态与日志命令见 Agent 安装与维护。

Agent 的状态、日志和卸载命令在哪里？

Agent 安装与维护 按 systemd、Docker、OpenRC、OpenWrt、Windows 和 macOS 分别列出了状态检查、日志、重启、更新和卸载命令；默认 systemd 安装还提供一键完全卸载。完整卸载前先确认是否需要保留 auto-discovery.json 和 net_static.json。

数据库一小时增加很多，是否代表一天线性增长？

不一定。新部署的原始层、分钟层和五分钟层会依次填充，早期增长不能直接乘以 24 或保留天数。稳定占用还取决于服务器上报间隔、探测间隔、任务数和数据波动。

为什么回收空间前后变化不大？

数据库可能仍有有效数据、WAL 或迁移临时页；空闲页也可能已被后续写入复用。先看主库、监控库、WAL 和 SHM 的总占用，再判断是否异常。

为什么 WAL 不变但主数据库变大？

检查点会把 WAL 页写回主文件。WAL 维持在一个工作大小、主文件增长是正常过程，应观察总占用和保留周期是否趋于稳定。

为什么关闭内置 HTTPS 后 HTTP 仍无法访问？

确认 HTTP 端口仍被容器映射并被防火墙允许。浏览器可能记住 HSTS，端口也可能仍写成 HTTPS 端口。直接检查 http://主机:27777 和后端启动日志。

为什么容器映射了 HTTPS 端口仍访问不了？

后台启用端口、容器内部监听端口和宿主机发布端口必须一致。127.0.0.1:端口:端口 只允许宿主机本地访问；VPN 客户端直连应绑定 VPN 地址或所有地址并配合防火墙。

旗帜没有显示为对应地区

输入 ISO 3166-1 两位代码，例如 HK、US、JP。主题需要支持该代码的旗帜映射；缺少 emoji 字体时应使用图标资源而不是依赖系统字符。

为什么新服务器没有套用离线或流量默认配置？

默认配置只作用于保存之后新加入的服务器，不会改写已有规则。延迟监测告警还要求该服务器已经被分配到延迟任务。保存默认配置前已经存在的节点需要手动补规则。

负载告警静默后，仪表盘为什么还在显示告警？

静默只暂停通知渠道消息。告警检测、当前告警、仪表盘、实时负载和监控图表继续显示真实状态。到期后自动恢复通知；永久静默需要手动解除。

启用内置 HTTPS 后，Linux 在线更新失败？

当前版本已包含本机证书名称校验处理。如果仍失败，确认当前是由官方脚本安装并由 lite.service 管理的 Linux 直装环境，数据目录和数据库也满足原子回退条件。Docker、Windows 和外置指标数据库不走这条一键更新通道。

如何提交有效问题？

请同时提供：

• 版本号和七位构建码。
• Docker、脚本或二进制部署方式。
• CPU 架构、内存和数据库大小。
• 相关时间段的日志。
• 可复现步骤与浏览器控制台错误。

提交到 nuomiiiii/lite Issues。公开内容前先删除域名、IP、Token、Tunnel 凭据和备份文件。