外观
排查指南 / 常见问题
约 1023 字大约 3 分钟
排查流程
配置完成后如果无法正常访问外网,请按以下步骤排查:
第一步:检查 DNS 解析
在需要代理的设备上 ping google.com,正常情况会返回 FakeIP(198.18.x.x 段)。
如果返回的不是 FakeIP 段:
- 检查设备的 DNS 是否设置为路由器的 IP,且没有 IPv6 的 DNS
- 检查该设备是否已加入
proxy_deviceIP 组 - 检查 NAT/DNS 劫持规则是否配置正确
第二步:DNS 正常但无法访问
- 重启浏览器,避免 DNS 缓存干扰
- Chrome、Edge 浏览器要关闭安全DNS(设置 → 隐私和安全 → 安全 → 使用安全DNS → 关闭)
- 对照所使用路由器的教程,再次检查分流配置是否有遗漏
第三步:检查 Singbox 状态
在 SMbox 仪表盘确认 Singbox 是否正常运行。如果未运行,可以手动运行查看错误日志:
直接安装:
./sbdir/singbox run -D ./sbdirDocker 安装:
docker logs smbox查看输出的错误日志来定位问题。
常见问题
Singbox 启动失败
报错:FATAL[0000] create service: parse outbound[0]: missing tags
说明所有过滤器都没有匹配到任何节点。检查:
- 订阅是否已更新并包含节点
- 过滤器的正则表达式是否正确
- 手动添加的节点是否有效
订阅请求返回 400
订阅链接可能被墙了。解决方案:
- 先用浏览器(或通过可用代理)打开订阅链接
- 复制里面的 base64 内容
- 在 SMbox 中手动添加节点
- 等 Singbox 运行起来后再换回订阅 URL
CPU 占用过高
排查思路:
- 关闭路由器上所有代理相关的配置
- 重启 SMbox 设备
- 如果 CPU 占用恢复正常,基本可以确定是环回导致的
常见环回原因:
- SMbox 的 IP 被加入了
proxy_device - 路由器的 DNS 设置为了 SMbox 的 IP
环回警告
任何时候都不要把 SMbox 的 IP 加入到 proxy_device 中,否则会引起环回导致系统崩溃。
首次运行规则下载失败
首次运行时,默认香港规则不要改为「自动」模式。因为 Singbox 的自动测速组不能作为规则下载的代理。
正确做法:
- 先保持默认配置启动
- 在 Zashboard 中手动选择一个可用节点
- 确认节点可用后再调整规则
Docker 容器内无法联网
确认以下几点:
- macvlan 网络配置的网段和网关是否正确
- 分配给 SMbox 的 IP 是否不在 DHCP 范围内
- 容器是否以 privileged 模式运行
- 宿主机网卡名称是否与 docker-compose.yml 中的
parent一致
IPv6 导致的问题
如果配置了 IPv6,可能会导致 DNS 泄漏。解决方案:
| 路由器 | 操作 |
|---|---|
| ROS | IPv6 → ND → bridge,取消勾选 Advertise DNS |
| 爱快 | 不要下发 V6 的 DNS |
| Opnsense | 勾选「不要向客户端发送任何DNS配置」 |
升级后出现问题
- 如果升级后 Singbox 无法启动,先更新全部订阅再尝试启动
- 如果升级后授权丢失,重新输入授权码即可
- 建议升级前做好数据备份或虚拟机快照
手机订阅无法使用
- 确保手机 Singbox 客户端版本与 SMbox 兼容(建议使用最新正式版)
- 如果使用端口映射访问,确认订阅链接中包含正确的端口
- 修改过回家或订阅配置后,需要在手机端手动更新订阅
规则文件下载很慢或失败
在高级配置中调整规则下载代理模式:
- final:使用默认出站下载
- CF代理:通过 Cloudflare Worker 代理下载
- 自定义URL:使用自定义的代理 URL 下载
如何重置 SMbox
删除 config 目录下的 smbox.db 文件,重启 SMbox 即可恢复出厂设置。
注意
重置后所有配置(节点、规则、订阅等)都会丢失,请提前做好备份。
