你需要什么，以及该选哪种安装方式
Filemote 由两部分组成。代理运行在你想访问其文件的那台电脑上；网页应用是你从任何地方 访问这些文件的入口。本页讲的是安装代理——网页应用不需要安装任何东西。
开始之前
- 一个 Filemote 账户，以及你想访问的那台电脑处于开机并联网状态。
- 可用磁盘空间：代理本身约 500 MB，如果使用 AI 模型还需要额外空间。在 Windows 上，安装程序 还会下载一份私有的 Python 运行环境，再多几百 MB，因此请预留约 1 GB。
- 仅代理需要 512 MB 空闲内存；若要使用 AI 功能，则需要 8 GB 或更多。
- 从那台电脑到
api.filemote.com的出站 HTTPS（443 端口）。能正常浏览网页的网络几乎都允许。
你不需要开放任何入站端口，也不需要架设 VPN：代理建立的是出站连接，因此在家用路由器后面 无需任何设置即可工作。
Windows
| 方式 | 何时选择 |
|---|---|
安装程序 .exe | 常规情况。会替你装好 .NET 8 和 Python，并添加开始菜单项。仅为你的 Windows 用户安装。 |
便携版 .zip | 这台机器不允许安装软件，或你想从 U 盘运行 Filemote。不写入注册表；删除文件夹即可卸载。 |
| ClickOnce | 你希望配置器自动更新。首次运行需要联网，若机器上没有 .NET 8，它会借此安装。 |
Windows 会警告发布者未知——Filemote 尚未使用商业证书签名。请选择更多信息 → 仍要运行。 如果某个版本发布了摘要，下载页会在按钮旁显示该文件的 SHA-256，方便你先行校验。
Linux
每种架构一个压缩包：x64 用于普通 PC 和服务器，arm64 用于 Raspberry Pi 4/5 以及
AWS Graviton、Oracle Ampere 这类 ARM 服务器。
- 使用安装脚本（需要 root）：安装到
/opt/filemote，通过你的包管理器准备好 .NET 8 和 Python，并注册filemote-agentsystemd 单元，使代理能在重启后继续运行。脚本会启用该单元 但不会启动它——配置好代理之后由你自己启动。 - 原地运行（不需要 root）：给
FilemoteCli和FilemoteAgent添加可执行权限，直接在解压 出的文件夹里运行。重启后不会自动启动，也不会准备 AI 服务。这些二进制文件是自包含的，因此 这条路径完全不需要 .NET——在受限的机器上很有用，因为安装脚本把 .NET 8 视为必需，一旦无法 安装就会停止。
压缩包是在 Windows 上打包的，不带 Unix 可执行位，因此在运行其中任何文件之前都必须先执行
chmod +x。
macOS
Apple Silicon（arm64）和 Intel（x64）各一个压缩包。如果不确定自己的 Mac 属于哪种，打开
苹果菜单 → 关于本机：显示「芯片：Apple M…」是 Apple Silicon，显示「处理器：Intel」则是
Intel。装错的那个会得到一个根本无法运行的二进制文件。
安装脚本会准备 Homebrew、.NET 8 和 Python，安装到 ~/Applications/Filemote，并注册一个在
登录时启动的 launchd 代理。由于它以你的用户身份运行，代理只能访问你的账户可以读取的文件。
如果你用访达解压压缩包，macOS 会把下载时的隔离标记复制到这些文件上，随后拒绝运行它们。在
终端里用 tar 解压则不会。无论哪种情况，清除该标记都是无害的：
xattr -dr com.apple.quarantine .
AI 功能是可选的
你完全可以不使用 AI 功能，而它们的沉重部分——模型文件和运行模型的 Python 包——只有在你首次 开启 AI 时才会下载。
能在多大程度上完全不装，取决于平台：
- Linux 和 macOS： 给安装脚本传
--no-ai，与 AI 相关的东西一概不会安装。 - Windows： 无论你今后是否启用 AI，安装程序总会准备一份私有的 Python 运行环境。这就是 上面磁盘空间估算里的那几百 MB。被推迟的只有 AI 依赖包和模型。
在内存小于 8 GB 的 Raspberry Pi 上，请使用 --no-ai 安装。
下一步
无论使用哪种方式安装，代理仍需与你的账户关联。这只需要一个配对码，用时不到一分钟——参见下载 页的最后一节。
更新于 2026-10-16