Troubleshooting

故障排查

shoes 无法启动

sudo systemctl status shoes.service --no-pager
sudo journalctl -u shoes.service -n 100 --no-pager
sudo shoes --dry-run /etc/shoes/config.yaml

ping-rust 正常情况下会在写入前 dry-run，并在激活失败时回滚。如果配置被手工修改，先备份再检查 /etc/shoes/config.yaml 与 /etc/shoes/state.json 是否一致。

端口已被占用

sudo ss -lntup

通过菜单更改端口，或添加新配置时直接回车让 ping-rust 选择随机高位端口。

客户端无法连接

依次检查：

1. VPS 防火墙和云平台安全组是否放行端口；
2. shoes.service 是否为 active；
3. 分享链接中的公网地址是否正确；
4. 自签名 TLS 协议是否在客户端开启“允许不安全连接”；
5. Reality 的 SNI、public key 与 short ID 是否完整。

链式代理启用后 UDP 失败

HTTP 和 SOCKS5 链式出口在当前 shoes 内核中只支持 TCP。需要 UDP 时请选择 Shadowsocks、VLESS 或 Trojan 等 shoes 已实现 UDP-over-TCP 的出口。

低内存编译时间过长

低于 1 GiB 内存的 VPS 不建议从源码编译，优先使用 GitHub Release 的 musl 静态二进制。一键安装脚本不要求预装 Rust。

GitHub 无法访问

安装器会重试下载，但无法绕过网络封锁。可以在可访问 GitHub 的设备下载 Release 资产和 SHA256SUMS，验证后再传到 VPS。