常见问题

SSH 登录常见问题排查表

  1. 系统确认：确保您的目标服务器运行的是 Linux 操作系统（目前不支持 Windows 或 macOS 宿主机连接）。
  2. 三要素校验：仔细核对服务器的 公网 IP、SSH 端口（默认 22）以及 账号密码 是否输入准确。
  3. 权限要求：建议优先使用 root 用户 或具有 sudoers 权限 的账号登录
  4. 网络可达性（Web在线版）：
    • 确认服务器拥有公网 IP。
    • 确认服务器防火墙未封禁海外流量（GMSSH 在线版节点位于新加坡）。
    • 确认已在云平台安全组中放行了对应的 SSH 端口。
报错信息 / 现象可能原因快速解决方案
Process exited with status 1系统架构/位数不支持1. 检查位数：GMSSH 不支持 32 位操作系统，请确保是 64 位系统。
2. 检查架构：确认下载的版本与 CPU 架构一致（如 x86 误用 ARM 包）。
3. 执行 uname -m 确认架构，执行 getconf LONG_BIT 确认位数。
ssh: subsystem request failedSFTP 服务未启用1. GMSSH 可视化文件管理依赖 SFTP 子系统。
2. 检查 /etc/ssh/sshd_config 确保存在以下行且未被注释：
Subsystem sftp /usr/lib/openssh/sftp-server
3. 修改后执行 sudo systemctl restart ssh 重启。
Connection Refused
(连接被拒绝)		1. SSH 服务未启动
2. 端口号填写错误		1. 登录控制台执行 sudo systemctl status ssh 确认服务运行中。
2. 检查 SSH 端口是否为默认的 22。
Connection Timeout
(连接超时)		1. 防火墙/安全组未放行
2. 网络链路不通		1. 云服务器用户：务必在云平台安全组中放行 TCP 22 端口。
2. 本地防火墙：执行 sudo ufw allow 22/tcp 或相关命令放行。
Username or password is incorrect
(用户名或者密码错误)		1. 账号密码输入错误
2. Root 登录被禁用		1. 仔细核对账号密码。
2. 检查 /etc/ssh/sshd_config 中是否配置为 PermitRootLogin yes。

客户端常见问题

Q1：打开客户端时，360 安全卫士等软件提示风险，怎么办？

A：这属于安全软件的“启发式误报”，您可以放心选择“允许运行”或“添加信任”。

我们深知底层运维工具安全性对于用户的重要性，因此 GMSSH 官方在安全合规上做了以下工作：

  1. 微软官方代码签名：GMSSH 客户端已购买并集成了微软（Microsoft）官方认证的代码签名证书。这意味着软件的来源可追溯、未被篡改，且符合 Windows 系统的安全规范。
  2. 严苛病毒扫描：每一个正式版发布前，我们都会通过**卡巴斯基（Kaspersky）**等国际顶尖杀毒引擎进行全量扫描，确保分发包纯净无毒。
  3. 误报原因：由于 GMSSH 包含批量下发脚本、SSH 隧道通信等底层网络指令，部分安全软件（如 360）在初次扫描时，可能会因为这些敏感操作触发警报。

💡 建议操作：

  • 当弹出提示窗时，请选择 “允许程序所有操作” 或 “不再提醒”。
  • 建议将 GMSSH 安装目录添加到 360 的**“信任区/白名单”**，以获得更流畅的运行体验。

Q2：添加服务器报错 AxiosError: Network Error 且提示无法连接？

A：这通常是由于 Windows 系统防火墙拦截了客户端的联网权限导致的。

  • 排查建议：Windows 防火墙可能会默认限制新安装程序的网络访问，导致请求无法发往服务器。
  • 解决方案：
  1. 进入【控制面板】 > 【系统和安全】 > 【Windows Defender 防火墙】。
  2. 点击 “允许应用通过 Windows 防火墙”。
  3. 在列表中找到 GMSSH，确保勾选了 “专用” 和 “公用” 两个选框。
  4. 如果列表中没有 GMSSH，请点击“允许其他应用”手动添加 GMSSH 的安装目录执行文件。

Q3：打开本地服务网页一直卡在 Loading 界面，无法加载 UI？

A：这通常是由于 Windows 注册表中的 MIME 类型设置错误，导致浏览器拒绝加载 JS/CSS 文件。

  • 故障原理： 由于安全策略，现代浏览器要求脚本和样式的 Content-Type 必须准确。如果您的系统注册表将 .js 返回为 text/plain 或将 .css 返回为非标准格式，浏览器将拦截加载。

  • 检查项： 确保注册表返回的 Content-Type 严格为：

  • JS 文件：text/javascript; charset=utf-8

  • CSS 文件：text/css; charset=utf-8

  • 修复步骤 (手动)：

  1. 按下 Win + R，输入 regedit 打开注册表编辑器。
  2. 定位到：HKEY_CLASSES_ROOT\.js，确认 Content Type 值为 text/javascript。
  3. 定位到：HKEY_CLASSES_ROOT\.css，确认 Content Type 值为 text/css。
#### 🛠️ 一键修复脚本 (保存为 fix_mime.reg 并运行)
```regedit
Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\.js]
"Content Type"="text/javascript"

[HKEY_CLASSES_ROOT\.css]
"Content Type"="text/css"

Q5：终端（黑窗口）能连上，但桌面布局/文件管理进不去？

A：这通常与系统兼容性或账号权限有关，请按以下顺序排查：

  • 系统架构确认：请确认您的服务器是否为 64 位 Linux 系统。GMSSH 的图形化管理组件不支持 32 位操作系统及内核过旧（低于 3.10）的系统。

  • 高权限账号登录：如果您管理的是 NAS（如群晖、威联通）、受限云环境 或 嵌入式设备，请务必使用 root 或 admin 账号登录。

  • 原因：非管理账号由于权限隔离，无法启动图形化所需的后端进程，导致“只能看黑窗口，进不去桌面”。

  • SFTP 状态：请参考前文，检查服务器是否开启了 SFTP 子系统，这是图形化文件管理的基础。

Q6：报错无法连接，如何判断是 GMSSH 问题还是我的网络问题？

A：最简单的办法是使用系统自带的 SSH 命令进行“对照实验”。

  • 验证步骤：
  1. 在您的电脑上打开终端（Windows 用 CMD/PowerShell，Mac 用 Terminal）。
  2. 输入指令：ssh -p [端口号] [用户名]@[服务器IP]。
  • 结果判定：
  • 如果 SSH 命令也连不上：说明是您的服务器 IP 填错、防火墙没开、账号密码不对或网络不通（例如内网无法直连公网）。请先解决网络连通性问题，这超出了软件的功能范畴。
  • 如果 SSH 命令能连上，但 GMSSH 连不上：请检查 Windows 防火墙是否拦截了 GMSSH 进程（参考 Q2），或联系我们的技术支持。

私有部署常见问题

Q1：Docker 部署后无法访问 Web 界面？

A：请按以下步骤排查：

  1. 检查容器状态： 执行 docker ps，确保 gm-service 容器正在运行（Up）。

  2. 检查端口映射：

    • 确认宿主机防火墙已放行 TCP 【映射的端口】 端口。
    • 确认 Docker 映射正确：PORTS 列应显示 0.0.0.0:映射的端口->80/tcp。

  3. 检查容器日志： 执行 docker logs gm-service，查看是否有报错信息。

Q2：Shell 脚本部署后无法访问？

A：请按以下步骤排查：

  1. 检查端口占用： 执行 netstat -tulnp | grep :80，确认 80 端口未被其他程序占用。

  2. 检查服务状态： 执行 ps aux | grep gm，确认 GMSSH 进程正在运行。

  3. 检查防火墙： 执行 sudo ufw status 或 sudo firewall-cmd --list-all，确保 80 端口已放行。

Q3：如何修改映射的端口？

A1：Docker 部署：请按以下步骤操作：

  1. 停止容器： 执行 docker stop gm-service，停止正在运行的容器。

  2. 删除容器： 执行 docker rm gm-service，删除旧容器。

  3. 重新创建容器： 执行以下命令，将端口映射改为 8091：

    docker run -d --name gm-service -p 8091:80 --restart always gm-service:latest

A2：Shell 脚本部署：请按以下步骤操作：

  1. 找到部署脚本的目录： 执行 ./depoly.sh setport [端口号] 即可完成

如何获取技术支持？

  • 访问 官网 获取最新信息
  • 提交 Issue 到 GitHub 仓库
  • 加入社区交流群
最近更新:
Contributors: guanxi