デバイスがオフラインと表示される
このリストを上から順に確認してください。原因はおおむね、実際にそれである頻度の高い順に並べて あります。
1. エージェントは本当に動いていますか？
エージェントはインストールしただけでは起動しません。
- Windows： 設定ツールのウィンドウはエージェントではありません。その中の Start を押すか、
タスクマネージャーで
FilemoteAgent.exeを確認してください。 - Linux：
sudo systemctl status filemote-agent。インストールスクリプトはユニットを 有効化するだけで——再起動をまたいで生き残るように——起動は決してしません。そのため入れたばかり の状態ではsudo systemctl start filemote-agentを実行するまでinactive (dead)のままです。 - 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. デバイスの接続が解除されていませんか？
ファイルマネージャーのデバイス一覧からデバイスを削除するとトークンが取り消され、そのデバイス は直ちに動かなくなります。一覧から消えている場合は、新しいコードで改めてペアリングしてください。
これはプロフィールのセッションとは別物である点に注意してください。あちらはブラウザーの サインインであり、そこで 1 つ取り消してもデバイスの接続は解除されませんし、直りもしません。
5. ペアリングコードの期限が切れていませんか？
コードは 1 回限りで、表示から 15 分で期限切れになります。チャットのウィンドウに一晩置いたコードは 使えません。新しいものを生成してください。
デバイスはオンラインなのに、フォルダーが JSON や「unexpected character」エラーで開けない
これはエージェントの接続自体は問題なく、鍵の問題だという意味です。ブラウザーは元のエラーを
そのまま通すため、正確な文言はあなたのブラウザーが無効な JSON について言うことになります——Chrome
なら Unexpected token …, "…" is not valid JSON。エージェント自身のログには代わりに
Unexpected character encountered while parsing value と出ることがあります。
あなたのファイルは、アカウントのパスワードから導かれた鍵で暗号化されています（パスワードと アカウントに紐づくソルトに対する PBKDF2-SHA-256）。サーバーはその鍵を決して見ません——それが要点 です——が、同時にそれは鍵が 2 か所、つまりブラウザーと動作中のエージェントに存在することも意味 します。
パスワードを変更するとブラウザーは直ちに新しい鍵を導く一方、すでに動いているエージェントは古い鍵
を持ち続けます。返ってくるものはすべてゴミに復号され、最初につまずくのが JSON.parse です。
エラーが復号ではなく解析について語るのはそのためです。
対処： エージェントを再起動し、それからブラウザーでサインインし直して、両側が同じパスワード から鍵を導くようにしてください。最近パスワードを変更していて、複数のデバイスが同時におかしく なったのなら、理由はこれです。
2026-10-16 に更新