常见问题 FAQ

本文汇总了使用面板过程中最常遇到的问题及排查方法。

安装与登录

Q: 安装面板需要什么条件？

一台有公网 IP 的 Linux 服务器（推荐 Debian / Ubuntu / CentOS 等主流发行版），内存 512MB 以上即可流畅运行。被管理的服务器不需要安装任何东西，只需能 SSH 连接。

Q: 默认账号密码是什么？

默认账号 admin，密码 123456。首次登录后请立即修改（面板右上角用户图标 → 用户设置）。

Q: 忘记登录密码怎么办？

若已修改且忘记，可在面板服务器上重置。执行以下命令重置为默认密码（或指定新密码）：

# 进入面板安装目录，用内置脚本重置密码
cd /opt/ssh-everywhere
python3 -c "from app import reset_password; reset_password('新密码')"

> 具体脚本名可能随版本调整，也可直接编辑数据库 data/ssheverywhere.db 的 users 表。

Q: 怎么修改面板端口（5501）？

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

systemctl edit ssh-everywhere.service
# 添加或修改：Environment=PORT=你的端口
systemctl daemon-reload && systemctl restart ssh-everywhere.service

改完记得在云防火墙/安全组放行新端口。

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

按顺序排查：

1. 确认面板服务在运行：systemctl status ssh-everywhere.service

2. 检查面板服务器的云防火墙/安全组是否放行了 5501（这是最常见的原因）

3. 确认访问地址是 http://服务器公网IP:5501（不是 https，除非你配了反向代理）

服务器相关

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

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

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

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

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

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

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

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

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

确认 SSH 端口、用户名、密码正确
确认目标服务器 sshd 正在运行
确认防火墙放行了 SSH 端口
大厂云（腾讯云/阿里云）默认禁用 root，请用普通用户（如 ubuntu）登录

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: 端口穿透和端口转发有什么区别？

端口穿透：给没有公网 IP 的设备用，走反向隧道，在面板服务器上开公网端口。
端口转发：给有公网 IP 的服务器用，走系统防火墙 DNAT，在目标服务器本机做。

详见端口穿透和端口转发。

Docker / 应用安装相关

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

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

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

2. 网络不可达：Docker 官方源（get.docker.com / download.docker.com）在某些网络环境（如中国大陆 NAT 服务器）可能无法访问。此时需配置 Docker 国内镜像源，或用「镜像源」功能切换到阿里云源。

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

Q: 中国境内服务器拉 Docker 镜像很慢/超时？

这是网络问题，不是面板问题。建议配置 Docker 镜像加速器（公共加速器如 docker.1ms.run / docker.m.daocloud.io），或在服务器上先执行：

# 参考：配置阿里云个人加速器（需替换为你的加速器地址）
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<'EOF'
{ "registry-mirrors": ["https://你的加速器地址"] }
EOF
sudo systemctl restart docker

通用排查技巧

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

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

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

文档