支持
本页覆盖六类最常见的问题，每类给出典型症状、最可能原因和解决步骤。未覆盖的内容可查阅文档与相关链接页面深入了解。
连接器离线
典型症状
连接器在组织的连接器清单中显示为离线，其背后的资产无法触达。
最可能原因
连接器主机到 WingGate 的出站连通中断、连接器服务未运行，或其绑定凭据已失效。
排查步骤
- 在连接器主机上验证到 WingGate 端点的出站 HTTPS 连通性——模型是纯出站的，不涉及任何入站端口。
- 检查连接器服务状态（例如 systemctl status），并查看日志中的连接或认证失败。
- 如果凭据已轮换或重新绑定过，请重新绑定连接器；绑定会签发用于向 WingGate 认证的独立凭据。
未授权
典型症状
成员在打开会话、使用 SSH 或对资产调用 MCP 工具时遇到授权错误。
最可能原因
成员没有该项目的 active grant，资产不在项目内或未就绪，或（MCP）项目/资产 MCP 配置不允许该工具。
排查步骤
- 确认成员已绑定到包含该资产的项目。
- 检查其是否持有 active 项目访问授权。更细的 MCP 限制来自项目/资产 MCP 配置，不是 grant。
- 注意撤销的授权在下一次鉴权检查时立即生效；如果访问意外持续，重新核对实际覆盖该操作的是哪一条授权。
SSH 主机密钥不匹配
典型症状
目标重建、重装或更换地址后，连接被阻断并出现主机密钥不匹配警告。
最可能原因
目标出示的主机密钥与你此前确认的指纹不一致。这可能是正常的重装——也可能是中间人攻击的信号。
排查步骤
- 在做任何操作之前，先带外核实新指纹（控制台访问、服务商面板或重建主机的人）。
- 如果变更符合预期，重新探测主机密钥并有意识地确认新指纹。
- 对无法解释的不匹配绝不要 override——override 是一个经过审计的明确动作，而无法解释的 key 变化正是确认机制要防范的情况。
SSH 客户端无法连接
典型症状
你自己的 SSH 客户端通过 WingGate 连接资产时认证失败或无法触达。
最可能原因
账号未注册 SSH 公钥、客户端指向了错误的端点，或成员没有该资产所在项目的授权。
排查步骤
- 在账号上注册你的公钥——WingGate 在其 SSH 端点对你做公钥认证，从不持有你的私钥。
- 确认你连接的是 WingGate 的 SSH 端点，并选择了正确的组织和资产。
- 验证成员持有 active 项目访问授权，且资产支持 SSH 客户端入口；没有这些，连接是被授权层拒绝的，而不是 SSH 本身的问题。
MCP 认证或工具调用失败
典型症状
MCP 客户端收到 401、列不出工具，或其它工具正常但某个调用失败。
最可能原因
客户端的 bearer 凭据缺失或错误，或调用越过了能力边界——MCP 只发布一次性非 PTY 工具，且 file.find/file.grep 是 Runner-only。
排查步骤
- 检查客户端是否每次请求都携带项目 MCP 凭据；凭据值只在创建时展示一次，丢失后需重新创建。
- 确认客户端连接的是经 WingGate API 发现的连接器 MCP 端点——而不是 WingGate 本身。
- 不要期望在 MCP 上获得交互式 shell：MCP 只发布一次性、非 PTY 的工具（shell.exec、file 工具组，以及浏览器资产上的浏览器工具）；PTY 会话属于 Web 终端和 SSH 客户端入口。
- 如果 file.find 或 file.grep 不可用，检查该资产上的 Runner 是否已安装且可调用——这两个工具是 Runner-only，而授权、安装和可调用性是三个分开的状态。
账号恢复
典型症状
你丢失了认证器设备或 passkey，无法在登录时完成第二因子验证。
最可能原因
恢复取决于你事先做的准备：passkey 引导时签发的一次性恢复码，或 TOTP 引导时展示并保留的密钥（可重新绑定认证器），是目前唯一的自助保障。
排查步骤
- 如果你保存了恢复码，用它登录并按提示重新注册验证因子。
- 如果你保留了 TOTP 引导时展示的密钥，用它重新绑定认证器。