手动配置代理

代理知道的一切都保存在一个文件里——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