常见问题 FAQ

服务器相关

Q: 服务器显示「离线」怎么办？

「离线」只表示面板无法通过 SSH 连上它，不代表服务器宕机。按顺序排查：

1. 确认服务器本身在线：去服务器商控制台看电源状态

2. 测试 SSH 端口可达性：从面板服务器执行 nc -zv <目标IP> <端口> 看端口通不通

3. 检查防火墙/安全组：目标服务器的云防火墙/安全组是否放行了 SSH 端口

4. NAT 服务器检查端口映射：确认 NAT 端口映射还存在、目标内网 IP 正确

5. 检查来源 IP 白名单：部分服务商对 SSH 端口做了来源 IP 限制，需把面板服务器 IP 加白

6. 核对账号密码：用户名、密码/私钥是否正确

Q: 添加服务器时连不上？

确认 SSH 端口、用户名、密码正确
确认目标服务器 sshd 正在运行
确认防火墙放行了 SSH 端口

Q: NAT 服务器（非 22 端口）连不上？

NAT 服务器的端口映射必须能从面板服务器所在网络访问。常见原因：

端口映射失效（去服务商后台检查/重建）
服务商对来源 IP 做了白名单（把面板服务器 IP 加白）
映射的目标内网 IP/端口填错

端口穿透相关

Q: 端口穿透显示「离线」？

穿透依赖 Agent 在线。Agent 离线（设备关机、网络断、Agent 停了）时穿透会中断
面板服务重启后，穿透会在 Agent 重连时自动恢复，稍等即可
确认面板服务器的云防火墙放行了监听端口

Q: 转发非 22 端口不生效？

转发非 SSH 端口（如 9117）需要穿透服务器安装的是新版 Agent（旧版只支持 22）。重新安装 Agent 即可。

端口转发相关

Q: 端口转发创建了但不生效？

传统端口转发需在有独立公网 IP 的服务器本机做。检查：

1. 目标服务器/中间防火墙是否放行了目标端口

2. 目标 IP 填的是否是真实可达地址

3. 云安全组是否拦截了监听端口

面板相关

Q: 访问不了面板（5501 端口）？

检查面板服务器的云防火墙/安全组是否放行 5501
确认面板服务在运行：systemctl status ssh-everywhere.service

Q: 忘记登录密码？

默认账号 admin / 123456。若已修改且忘记，可在面板服务器上重置数据库中的密码字段。

Q: 怎么改面板端口？

修改 systemd 服务里的 Environment=PORT=5501，然后：

systemctl daemon-reload && systemctl restart ssh-everywhere.service

Docker / 应用安装相关

Q: 应用大全/Docker 安装失败怎么办？

面板会如实显示错误信息（不会假报成功）。常见原因：

1. 过旧发行版：Fedora 32 等已 EOL 的版本，软件源已停止维护，dnf 更新/安装会超时或失败。建议升级系统。

2. 网络不可达：Docker 官方源（get.docker.com / download.docker.com）在某些网络环境（如中国大陆 NAT 服务器）可能无法访问，报 SSL reset / 连接超时。此时需配置 Docker 国内镜像源，或换用能访问官方源的环境。

3. 包名差异：个别应用（如 ufw、Node.js 的 deb.nodesource）依赖特定发行版，在非 Debian/Ubuntu 上可能装不上，错误信息会明确提示。

Q: 之前安装显示"成功"但实际没装上？

这是历史版本的"假成功"缺陷（后端未校验命令退出码），现已修复。现在安装会校验真实退出码，失败会如实报错并给出具体原因。

通用排查技巧

1. 先测端口通不通，再排查账号密码：nc -zv <IP> <端口>

2. 对比其他服务器：同类型服务器能连、就这台连不上，说明问题在这台特有（防火墙/映射/白名单）

3. 看日志：面板日志在 service.log，穿透/Agent 日志可帮助定位连接问题

文档