故障排查

按你看到的报错找。每条都说明发生了什么和你该做什么。

门户和客户端的措辞略有不同

同一个原因在门户和客户端里的提示文字可能不完全一样。下面按原因归类。

设备授权相关

签发服务暂不可用

意思: 你的操作已经记录, 但负责签发的后端组件这次没能完成投递。这是服务端侧的暂时状态, 不是你操作错了。系统是失败即拒绝的 — 不会伪造成功。

你该做的, 分两种情况:

• 批准时遇到 — 批准已经记录但尚未签发。稍后到门户「设备授权」页的**「已授权」列表对该设备点「重试签发」**。重试沿用同一个授权序号, 不会重复占用配额。
• 撤销时遇到 — 撤销没送达, 授权和配额都没变化。稍后用新的动态码重试即可 — 撤销可以安全地重复提交。

提示里通常会附带一个原因说明, 反馈问题时请一并提供。

不要反复点批准

每次尝试都可能留下记录, 反而更容易撞上配额上限。用「重试签发」, 不要重新走一遍申请。

配额已满

意思: 你 (或整棵账号树) 的额度用满了。先确认是哪个维度:

额度	什么时候撞上
设备授权数	申请或批准设备授权时
注册设备数	新设备登录账号时
并发会话数	同时开的远程会话太多时
子账号数	管理员创建新成员账号时

你该做的:

1. 先看待批准的申请。 待批准状态已经占用名额, 而拒绝会立即释放它 — 这通常是最快的解法。到门户「设备授权」页把不该继续的申请拒掉。
2. 撤销不再需要的授权 — 撤销确认后释放名额。
3. 并发会话满了就关掉不用的会话标签。
4. 清理完仍然不够, 说明实际规模超出了当前套餐, 联系管理员或销售扩容。

已过期的不占名额

30 天到期的授权会自动释放名额, 不需要手动清理。占名额的是待批准和已授权这两类。

「仍占配额」的记录

如果某条记录显示签名服务拒绝过、但仍占配额, 对它执行撤销即可释放名额。

动态码无效

三种不同的原因, 解法不一样:

提示	原因	怎么办
账号动态码不正确	码输错了, 或用错了凭据	重新从验证器读一次; 确认用的是账号动态码, 不是密钥机操作员码
该动态码刚用过	同一个码不能用两次	等下一个 30 秒的新码
动态码需要重新绑定	绑定失效	到门户 /account/profile「我的账户」→「安全」里重新绑定验证器
尝试次数过多, 已暂时锁定	连续失败触发保护	等锁定解除后再试

先看手机时间

输错以外最常见的原因是设备时钟漂移 — 验证器靠时间生成验证码, 手机时间不准就必然对不上。把手机设为自动同步时间。

需要账号所有者或管理员批准

意思: 当前登录的账号不是本租户的所有者或管理员。设备授权的批准、拒绝、撤销都只有所有者/管理员能做, 其他角色只能查看。

这不是动态码的问题 — 换一个码重输没有用。

你该做的: 请账号所有者或管理员登录后操作。

设备授权尚未启用

意思: 你所在服务尚未启用设备授权签发链 — 服务端还没配置好签发通道。这不是你的账号或设备的问题。

这种状态下, 门户「设备授权」页会常驻这条提示, 列表为空, 所有操作按钮不可用, 只保留「重新检查」。

你该做的: 联系管理员或服务方启用。 用户侧没有可操作的补救办法 — 这是刻意的失败即拒绝设计。

此设备已授权

意思: 不是错误。这台设备已经有生效中的授权了, 重复申请会被幂等地忽略, 不消耗配额。

你该做的: 什么都不用做, 直接连接。

该申请已过期 / 申请状态已变化

你该做的: 刷新列表。如果确实还需要访问, 让控制端重新发起一次申请。

签名服务拒绝了本次请求

意思: 申请已按拒绝处理。

你该做的: 刷新列表; 需要的话让控制端重新申请。持续出现请联系管理员。

操作过于频繁 / 签发通道忙

你该做的: 等一会儿再试。

连接相关

批准了但一直连不上

授权批准后需要签发下发, 被控端每约 30 秒同步一次, 最迟约 60 秒生效。明显超过时:

1. 确认门户里这条授权已经是已授权, 而不是停在等待签发;
2. 确认目标机器在线 — 看「我的设备」里的最近在线时间;
3. 确认目标机器的「控制权限」列显示已启用 v4 (见启用被控端);
4. 都对却仍然不行, 见上面的签发服务暂不可用。

连上了但画面全黑 (macOS 被控端)

几乎一定是屏幕录制权限。

1. 在被控机器上: 系统设置 → 隐私与安全性 → 屏幕录制, 确认 FortSwift 已勾选;
2. 完全退出 FortSwift 并重新打开 — macOS 只在进程启动时读这个权限, 勾了不重启等于没勾;
3. 确认那台机器没有处于会关闭显示输出的状态。

TIP

Apple 不允许 App 自行授予这类权限, 只能引导你到系统设置手动开。客户端里的被控端控制台可以逐项检查当前状态。

画面正常但鼠标键盘没反应 (macOS 被控端)

这是辅助功能权限没给。屏幕录制管「看得见」, 辅助功能管「动得了」, 两个是分开的。

系统设置 → 隐私与安全性 → 辅助功能 里勾上 FortSwift, 然后重启 App。

Windows 被控端连不上

Windows 的采集与输入注入需要一个已登录的交互会话。确认那台机器上有用户处于登录状态。

开不出新的会话标签

同时最多 8 路会话。关掉不用的标签再试。若提示配额相关, 见配额已满。

会话卡顿或掉画质

先看网络 — 上行带宽和抖动比绝对带宽更关键。参考远程会话。

登录相关

提示该账号已关闭密码登录

这个账号已经启用了通行密钥, 密码登录被自动关闭。用通行密钥登录。

浏览器不支持通行密钥

换用最新版的 Safari / Chrome / Edge。

通行密钥丢了

用绑定时保存的一次性恢复码重新添加。恢复码只显示一次, 共 10 个。都用完或都丢了, 联系管理员。

升级后所有设备都要求重新登录

这是预期行为 — 某些安全升级会使所有既有登录态失效。重新登录即可。

安装相关

macOS 提示无法打开

安装包经 Developer ID 签名并由 Apple 公证。若系统仍拦截, 先核对 SHA-256 校验和, 确认下载到的确实是官方包。

Windows SmartScreen 警告

先核对校验和再决定是否继续。

还是没解决

联系团队管理员, 或发邮件到 support@fortswift.com。请附上:

• 客户端版本和平台;
• 报错原文 (包括括号里的原因说明);
• 发生的大致时间(带时区);
• 目标机器的设备名。

不要在邮件里附上任何验证码

账号动态码、密钥机操作员码、恢复码都不要发给任何人, 包括我们。