手動設定代理

代理所知道的一切都存放在一個檔案裡——app_settings.json。設定程式會替你寫好它；對於指令碼化或無介面的安裝，你也可以自己寫。本頁是欄位參考。

若你只是想連接一台裝置，並不需要這一頁：用配對碼將裝置連結到你的帳戶更短也更穩當。

檔案在哪裡

代理會從自身執行檔所在的資料夾讀取 app_settings.json。也就是說：

終端機設定程式預設使用與自己同一個資料夾的檔案，並接受 --config <path> 來編輯另一個——服務安裝正好需要這一點，因為 FilemoteCli 並不會被複製到安裝前置路徑中。這裡的相對路徑會依你目前的工作目錄解析。

欄位	意義
`ip`	代理連往的伺服器主機名稱或位址
`port`	伺服器連接埠
`EnforceHttps`	拒絕以一般 HTTP 連線。預設開啟；透過終端機用戶端配對會將其關閉，因為中繼是透過 HTTP 連線的

請讓 ip 與 port 指向你自己的伺服器。ip 留空並不表示「自己想辦法」——代理會退回到編譯進程式中的預設值，而它幾乎肯定不是你的部署。

pass 不是明文密碼。設定程式會透過平台的本機保護機制儲存它——Windows 上是 DPAPI，其他系統上是本機金鑰檔——代理也預期這種形式。把明文密碼貼進該欄位是不會生效的；請透過設定程式設定密碼，更好的做法是替裝置配對並把 pass 留空。

rootPaths 是允許瀏覽器看到的目錄清單。清單之外的一切都會被拒絕，包括用 .. 往外跳脫的嘗試。清單為空時代理會拒絕啟動，因此這個欄位並非選填。

rootPath（單數）是保留欄位，留著只是為了讓舊的設定檔仍能載入。請使用 rootPaths。

欄位	預設值	意義
`AiModelId`	`qwen2.5-1.5b-instruct`	主模型
`AiDevice`	`auto`	有 Vulkan GPU 時 `auto` 會選擇 GPU；`cpu` 與 `gpu` 為強制指定。`cuda` 仍作為保留值被接受
`AiTemperature`	0.7	取樣溫度
`AiMaxNewTokens`	512	回覆長度上限
`AiSystemPrompt`	空白	加在每次對話的開頭
`AiAutoStart`	`false`	隨代理一起啟動 AI 服務
`AiDocumentModel`、`AiVisionModel`、`AiCodeModel`、`AiSummaryModel`	空白	專用模型；留空的欄位會退回主模型
`KbEnabled`	`true`	把知識庫脈絡注入 AI 聊天
`KbPaths`	空白	要建立索引的資料夾
`KbIncludeBrowser`	`false`	為瀏覽器記錄建立索引
`KbIncludeEmail`	`false`	為 `.eml` 與 `.msg` 檔案建立索引
`KbPrivacyAccepted`	`false`	記錄同意對話方塊已顯示過
`KbScheduleEnabled`	`false`	依排程重新建立索引
`KbScheduleDays`	未設定	每週執行重新索引的日子；空清單表示從不
`KbScheduleTime`	`03:00`	排程執行的時刻，24 小時制

KbScheduleIntervalHours 仍會出現在較舊的設定檔中。讀取它只是為了讓那些檔案繼續載入，它已經不再控制任何行為——上面兩個欄位取代了它。

AI 服務連接埠不再可設定——固定為 8765。舊的設定檔中可能仍有 AiPort 欄位；它會被忽略。

這些設定實際的作用，請見讓 Filemote 保持最新。

以帳戶密碼設定的代理，會從該密碼推導出你的檔案加密金鑰。在瀏覽器裡改了密碼，兩邊就不再一致：瀏覽器會立即推導新金鑰，而正在執行的代理仍持有舊的，於是它送回的一切都會解密成亂碼。症狀與解法請見裝置顯示為離線。

配對把金鑰放在配對碼本身、以頻外方式傳遞，因而徹底避開了這個問題。手動設定是為無介面與指令碼化安裝準備的；若你有螢幕和瀏覽器，請替裝置配對。

更新於 2026-07-31