设备显示为离线
请按顺序逐条排查——这些原因大致是按「实际就是它」的概率排列的。
1. 代理真的在运行吗？
安装代理并不会启动它。
- Windows： 配置器窗口不是代理。请在其中按 Start，或在任务管理器中查看
FilemoteAgent.exe。 - Linux：
sudo systemctl status filemote-agent。安装脚本只启用该单元——好让它在重启后 依然生效——但从不启动它，因此全新安装会一直显示inactive (dead)，直到你运行sudo systemctl start filemote-agent。 - macOS：
launchctl list | grep com.filemote.agent。它在登录时启动，所以刚装好之后可能 只是还没启动而已。
2. 配对设置有没有落到正在运行的那份副本上？
这是 Linux 上惯常的陷阱。除非你另行指定，FilemoteCli 会把 app_settings.json 写在它自己的
可执行文件旁边，而它并不会被复制到安装前缀中。所以如果你先安装了服务，然后在解压出的压缩包
目录里完成配对，你配置的就是服务永远不会读取的文件——而且没有任何地方报错，因为在服务看来它只是
还没有凭据。
请让配置器指向服务实际使用的那个文件：
sudo ./FilemoteCli --config /opt/filemote/app_settings.json
sudo systemctl restart filemote-agent
3. 代理能连上服务器吗？
代理通过 443 端口连接 api.filemote.com。请在运行代理的那台机器上检查：
curl -sS -o /dev/null -w '%{http_code}\n' https://api.filemote.com/health
只要没有得到响应，就说明代理同样出不去——企业代理和严格的出站防火墙规则是常见原因。任何情况下都不需要做入站端口转发。如果你在代理设置里改过服务器地址，请改回 Filemote 的地址。
4. 设备是不是被解除关联了？
在文件管理器的设备列表中移除设备会吊销其令牌，它会立即停止工作。如果设备已从该列表消失， 请用新的配对码重新配对。
请注意，这与个人资料中的会话不是一回事：那里列的是浏览器登录，吊销其中之一既不会解除设备 关联，也不会修好设备。
5. 配对码过期了吗？
配对码只能使用一次，并在显示后 15 分钟过期。在聊天窗口里放了一整夜的配对码不会生效；请重新生成 一个。
设备在线，但打开文件夹时报 JSON 或「unexpected character」错误
这说明代理连接正常，你遇到的是密钥问题，而不是连接问题。浏览器会原样透传底层错误，因此确切
措辞就是你的浏览器对无效 JSON 的说法——Chrome 会表述为
Unexpected token …, "…" is not valid JSON。代理自己的日志则可能记录
Unexpected character encountered while parsing value。
你的文件是用从账户密码派生的密钥加密的（对密码和与账户绑定的盐执行 PBKDF2-SHA-256）。服务器 永远看不到这把密钥——这正是设计的要点——但这也意味着密钥同时存在于两个地方：你的浏览器和正在 运行的代理。
一旦你更改密码，浏览器会立即派生出新密钥，而已在运行的代理仍持有旧的。于是它发回的一切都会解密
成乱码，第一个在此绊倒的是 JSON.parse——这就是错误信息谈的是解析而不是解密的原因。
解决办法： 重启代理，然后在浏览器中重新登录，让两边从同一个密码派生密钥。如果你最近改过密码 并且好几台设备同时变得不正常，原因就在这里。
更新于 2026-10-16