Appearance
常见问题
按现象查找。每项按顺序排查，解决不了带上截图或终端输出到 Telegram 群反馈。
面板无法访问
- 在面板服务器执行
docker ps，确认dstatus容器在运行；没有运行，进入安装目录执行docker compose up -d。 - 容器反复重启时，执行
docker logs dstatus查看报错。 - 确认安全组和防火墙放行了面板端口（默认 5555）。
- 用了反向代理时，先用
http://服务器IP:端口直连，排除代理配置问题。
节点显示离线
- 服务器列表该节点「更多」→「探针检测」，看检测结果和原因。
- 主动模式：被控要能访问上报地址。在被控上用
curl访问该地址测试；地址在节点编辑页「主动上报」里查看。 - 被动模式：面板要能访问被控的 Agent 端口（默认 9999），检查被控的防火墙和安全组。
- 在被控上执行
systemctl status dstatus-agent查看进程；未运行时执行systemctl restart dstatus-agent。
流量统计不符
- 节点编辑页 →「账单与流量」，核对周期：月付看「流量重置日（月付）」；打开「跟随账单周期」时，周期由账单周期和到期日决定。
- 核对「流量统计方向」：双向、仅入站、仅出站或单向最大，与商家计费方式一致。
- 单位差异：面板的 GB 按 1024 进位；商家按 1000 进位时，面板数字会小约 7%。
- 已用量对不上时，在「校准时已用流量 (GB)」填入商家后台的已用量。校准只影响展示。
收不到通知
- 通知管理 → 通知渠道，打开对应渠道的「配置」，点「测试」确认能收到。
- 「类型开关」里确认该渠道勾选了要接收的事件。
- 告警规则已启用；可在规则菜单里点「测试发送」。
- 「投递追踪」查看最近的发送结果和失败原因。
- 离线通知要等节点异常持续一段时间才发，时长在「全局策略」里调整。
提示 Telegram 机器人被同时使用
测试 Telegram 时提示「该 Telegram 机器人正被其他程序同时使用」或「检测到外部同 Token 实例」，投递记录显示「通道未就绪」或「机器人被其他程序同时使用，已暂停」：同一个机器人只能由一处接收消息，另一套面板或其他程序也在用它时，面板会暂停 Telegram 通知。
停用另一处，或在 BotFather 新建一个机器人并换上新的 Token，然后在 Telegram 渠道点「保存设置」恢复。
忘记密码或登录入口
见 进不去后台怎么办。
网络质量无数据
- 网络监控 → 监控目标里至少有一个目标，并且有在线的执行节点。
- 页面提示升级套餐时，当前授权不包含网络质量功能，见 获取与激活授权。
- Ping 一直失败时，目标可能屏蔽 ICMP，改用 TCP 并填端口。
- 节点在线但没有数据，先 升级 Agent。
安装命令报错
- 提示下载失败：确认服务器能访问
down.vps.mom；安装 Agent 时还要能访问 GitHub，或在 设置中心 → Agent 安装源 选下载代理。 - 其他报错：保留完整终端输出，到 Telegram 群反馈。
切换到 PostgreSQL 失败
切换失败不影响原有数据，面板会继续使用 SQLite。处理后在 设置中心 → 数据与维护 → 数据库 重新点「切换到 PostgreSQL」，无需重启面板。
提示 permission denied for schema public
PostgreSQL 15 及以上版本，普通用户默认不能在其他用户所有的库里建表。把数据库的所有者改为面板填写的用户名：在数据库服务器上用 PostgreSQL 管理员账号执行（库名、用户名按实际填写）：
bash
sudo -u postgres psql -c "ALTER DATABASE dstatus OWNER TO dstatus;"PostgreSQL 运行在 Docker 中时，把 postgres 换成容器的管理员用户名：
bash
docker exec -it PostgreSQL容器名 psql -U postgres -c "ALTER DATABASE dstatus OWNER TO dstatus;"新建数据库时直接指定所有者，可避免该问题：
sql
CREATE USER dstatus WITH PASSWORD '你的密码';
CREATE DATABASE dstatus OWNER dstatus;每次切换前面板都会在 data 目录生成一份 switch-backup-sqlite-时间.db 备份。切换成功后，失败时留下的备份可以删除。