在 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

沒有解決 —— 聯絡支援團隊