在 Linux 上安装

在 Linux 上运行代理有两种方式：作为随机器启动的系统服务，或作为你自己启动的普通进程。同一个压缩包两种方式都能用。

选择压缩包

压缩包	适用于
`filemote-<版本>-linux-x64.tar.gz`	普通 PC 和服务器
`filemote-<版本>-linux-arm64.tar.gz`	Raspberry Pi 4/5、AWS Graviton、Oracle Ampere

两者都会解压出一个文件夹，其中包含 FilemoteAgent、FilemoteCli、install.sh、 apply-update.sh、一个空的 app_settings.json 以及 AiService 目录。

压缩包是在 Windows 上打包的，不带 Unix 可执行位，因此 chmod +x 永远是第一步。二进制文件本身是自包含的，所以代理并不需要安装 .NET——安装脚本仍会准备 .NET，因为它要搭建一套包含 AI 的完整环境。

作为服务安装（需要 root）

tar xzf filemote-<版本>-linux-x64.tar.gz
cd filemote-<版本>-linux-x64
chmod +x install.sh
sudo ./install.sh

该脚本会：

检测你的包管理器（apt、dnf、yum、zypper 或 pacman），若一个都认不出来则给出警告而非中止；
安装 .NET 8 运行时，在 Debian 和 Ubuntu 上添加 Microsoft 的软件源，若通过包安装失败则回退到 Microsoft 的 dotnet-install.sh；
如果系统中没有高于 3.10 的版本，就安装一个较新的 Python——在 apt、dnf 和 zypper 上明确安装 3.12，在 yum 和 pacman 上安装该发行版认为的当前版本——若这一步也失败，它会禁用 AI 服务并继续，而不是放弃整个安装；
把代理连同 AI 服务和更新辅助脚本一起复制到 /opt/filemote；
创建 filemote-agent systemd 单元。

该单元以你的用户身份运行，而非 root；失败后五秒重启；内存上限 8 GB、CPU 上限 80%；日志写入 journald。

单元已启用，但未启动。 启用意味着重启后会自动拉起；全新安装会一直处于 inactive (dead)，直到你启动它——而这应当在下一步完成配置之后再做。

配置服务真正读取的那个文件

大多数首次安装都栽在这里。FilemoteCli 不会被复制到 /opt/filemote，并且默认把 app_settings.json 写在它自己的二进制文件旁边。直接在解压出的目录里运行它，你配置的就是服务永远不会读取的文件——而且哪里都不会报错，因为在服务看来它只是还没有凭据而已。

请让它指向服务自己的文件：

sudo ./FilemoteCli --config /opt/filemote/app_settings.json

选择 [2] Pair with a code，粘贴网站上的配对码，然后选择 [7] Save and exit ——完整流程见将设备关联到你的账户。随后启动服务：

sudo systemctl start filemote-agent
sudo systemctl status filemote-agent

免 root 安装

在共享主机或容器中，可以完全跳过脚本：

tar xzf filemote-<版本>-linux-x64.tar.gz
cd filemote-<版本>-linux-x64
chmod +x FilemoteCli FilemoteAgent
./FilemoteCli      # 配置并配对
./FilemoteAgent    # 运行

重启后不会自动启动，AI 依赖也不会安装，但文件访问功能完全一样。如果希望代理在你退出会话后继续运行，可以把它放到 tmux、screen 或用户级 systemd 单元中运行。

脚本参数

参数	作用
`--no-ai`	完全跳过 AI 服务——不装 Python，也不装依赖
`--no-autostart`	只安装文件，不创建 systemd 单元
`--prefix /path`	安装到 `/opt/filemote` 以外的位置
`--model <id>`	预先选定主 AI 模型
`--device cpu\|gpu\|auto`	AI 计算设备
`--gpu`	编译带 GPU 支持的 AI 引擎
`--hf-token <token>`	Hugging Face 令牌，用于访问受限模型

模型、设备和令牌这几个参数会合并进 app_settings.json，不会破坏其中已有的设置，因此重新运行脚本不会撤销你的配置。无法识别的参数会给出警告并被忽略。

Linux 上的 AI

不加 --gpu 时，AI 引擎以预编译的 CPU 包形式安装。加上 --gpu 则会从源码编译——有 nvidia-smi 时用 CUDA，否则用 Vulkan——这意味着会先安装编译器和 CMake，该步骤需要几分钟。

在内存小于 8 GB 的 Raspberry Pi 上，请使用 --no-ai 安装。

日志与服务命令

sudo systemctl start filemote-agent      # 立即启动
sudo systemctl status filemote-agent     # 是否在运行
sudo journalctl -u filemote-agent -f     # 跟踪日志

如果设备始终不上线，请按设备显示为离线逐条排查。

从改名前的安装升级

如果机器上还留有旧的 rfm-agent 服务，脚本会停止它、禁用它并删除其单元文件——两个代理争夺同一个账户对谁都没好处——同时把你的设置和已下载的 AI 模型从 /opt/rfm 迁移到新的安装前缀。旧目录会保留下来，等你确认无误后自行删除。

更新于 2026-07-31

没有解决 —— 联系支持团队