裝置顯示為離線
請依序逐項排查——這些原因大致是按「實際上就是它」的機率排列的。
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
只要沒有得到回應，就表示代理同樣出不去——企業 Proxy 與嚴格的對外防火牆規則是常見原因。任何情況下都不需要做對內連接埠轉送。如果你在代理設定裡改過伺服器位址，請改回 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