第三章：安裝指南 — Docker、pip、Homebrew、預編譯二進制檔，與雲端 VPS

哈囉！經過前兩章的洗禮，相信你已經對 Hermes Agent 這位全能管家垂涎三尺了吧？🤤 今天，我們終於要把「紙上談兵」變成「真槍實彈」了！

俗話說「請神容易送神難」，但請 Hermes Agent 回家可是超級簡單！我們為不同派系的玩家準備了多種安裝方式。無論你是喜歡圖形介面的小白、一鍵搞定的懶人包愛好者，還是喜歡掌控一切的指令狂人，這裡都有適合你的方法。捲起袖子，我們開始吧！💪

📦 安裝門派，任君挑選

1. 🖥️ Desktop App 派：最親民的圖形介面

想要像裝一般軟體一樣點點滑鼠就搞定？Nous Research 官方推出了原生的 Hermes Desktop 應用程式！支援 macOS、Windows 和 Linux，這絕對是最適合新手的選擇。 適合：討厭黑漆漆終端機，喜歡美美圖形介面的視覺系玩家。

2. 🐳 Docker 派：乾淨俐落，不留痕跡

如果你有「環境潔癖」，不想讓各種套件弄亂你的電腦，Docker 絕對是你的首選！只要一行指令，把整個 Hermes Agent 打包帶走。 適合：怕麻煩、需要頻繁切換環境的玩家。

🛠️ 操作教學：把 Hermes 請回家！

接下來，我們要進行安裝實戰了！請選擇最適合你的門派，跟著下面的步驟操作。

介紹教學：安裝方法

💡 各種安裝方法

方法 1：下載並安裝 Hermes Desktop (Desktop 派)

如果你不想碰終端機，這是為你量身打造的： 1. 打開瀏覽器，前往官方下載頁面：https://hermes-agent.nousresearch.com/desktop 2. 根據你的作業系統（Mac、Windows 或 Linux）下載或依指令安裝。 3. 依指示一步一步完成安裝。

若在安裝過程中，要直接設定用通訊軟體 Telegram 來當做對話和發布命令的工具，請在手機上事先安裝好 Telegram app。

方法 2：使用 Docker 取得最新映像檔 (Docker 派)

想要最純淨、不污染本機的體驗？系統上需先安裝好 Docker。請打開終端機輸入：

docker pull hermes/agent:latest

這就像是直接把一位受過專業訓練的管家，連同他的專屬房間一起空投到你的電腦裡！完全不怕搞壞系統。

☁️ 終極加碼：在 Linux VPS 雲端部署專屬管家

如果你希望管家能 24 小時不間斷地為你工作，把 Hermes 部署在 Linux 雲端主機（VPS）上絕對是最高性價比的選擇！因為 Hermes 只是個大腦框架，繁重的推理運算都是丟給雲端 API，所以你完全不需要昂貴的 GPU 伺服器，一台便宜的 Linux 主機就能搞定。

我們推薦使用最乾淨的 Docker 方式來進行部署。以下是帶你一步步完成部署的作戰計畫：

準備你的 Linux 雲端主機與連線

在你喜歡的雲端平台建立一台 Linux 伺服器，例如德國的 Hetzner Cloud（推薦使用 Ubuntu 24.04 LTS，3 顆 vCPU 搭配 4GB RAM 即可，試用也可選擇最便宜的方案）。
如果你是第一次使用 SSH，先在自己的電腦上檢查或產生 SSH key。SSH key 就像是一把只屬於你的數位鑰匙：公鑰可以放到雲端主機上，私鑰則要乖乖留在你自己的電腦裡，不要傳給別人。

Windows 11 / Windows 10
- 打開「PowerShell」或「Windows Terminal」。
- 檢查是否已經有 SSH key：
```
dir $env:USERPROFILE\.ssh
```
- 如果看得到 id_ed25519 和 id_ed25519.pub，通常就可以直接使用。若沒有，請建立一組新的 key：
```
ssh-keygen -t ed25519 -C "david-vps"
```
- 一路按 Enter 使用預設位置即可；若你想更安全，可以設定 passphrase。
- 顯示公鑰內容，稍後可以貼到雲端平台的 SSH key 欄位：
```
type $env:USERPROFILE\.ssh\id_ed25519.pub
```
macOS
- 打開「Terminal」。
- 檢查是否已有 SSH key：
```
ls ~/.ssh
```
- 如果沒有 id_ed25519 和 id_ed25519.pub，請建立一組新的 key：
```
ssh-keygen -t ed25519 -C "david-vps"
```
- 顯示公鑰內容：
```
cat ~/.ssh/id_ed25519.pub
```
Linux
- 打開終端機。
- 檢查是否已有 SSH key：
```
ls ~/.ssh
```
- 如果沒有 id_ed25519 和 id_ed25519.pub，請建立一組新的 key：
```
ssh-keygen -t ed25519 -C "david-vps"
```
- 顯示公鑰內容：
```
cat ~/.ssh/id_ed25519.pub
```
小提醒：.pub 結尾的是公鑰，可以貼到雲端平台；沒有 .pub 的 id_ed25519 是私鑰，請不要上傳、不要截圖、不要貼給任何人。
建立 VPS 時，若雲端平台有提供「SSH key」欄位，請把剛剛的公鑰貼上去。這樣主機建立完成後，你通常就能直接用 SSH key 登入，不需要密碼。
第一次先用 root 登入主機，建立之後真正要使用的個人帳號 david：
```
ssh root@你的主機IP地址
```
⚠️ 大老闆警告：強烈建議使用你電腦上的終端機連線，盡量避免使用雲端平台網頁版的 Web Console，因為它們常常會把特殊符號（如 @、:）吃掉，導致設定檔爆炸！

第一次連線時，SSH 可能會問你：
```
Are you sure you want to continue connecting (yes/no/[fingerprint])?
```
如果 IP 位址確定是你剛建立的主機，輸入 yes 即可。這是在把主機的指紋記錄到你的電腦，之後就不會每次都問。
在主機上建立 david 帳號，並給他 sudo 權限：
```
adduser david
usermod -aG sudo david
```
adduser david 會要求你設定密碼，也可能會詢問姓名、電話等資訊；那些欄位可以直接按 Enter 略過。
把 root 的 SSH key 登入權限複製給 david，讓你可以直接用 SSH 登入 david：
```
rsync --archive --chown=david:david ~/.ssh /home/david
```
如果你的 root 一開始是用密碼登入，主機上可能還沒有 ~/.ssh 資料夾。這時可以手動替 david 建立 SSH 登入設定：
```
mkdir -p /home/david/.ssh
nano /home/david/.ssh/authorized_keys
```
把你自己電腦上的 id_ed25519.pub 公鑰內容貼進去，存檔後再修正權限：
```
chown -R david:david /home/david/.ssh
chmod 700 /home/david/.ssh
chmod 600 /home/david/.ssh/authorized_keys
```
確認 david 可以使用 sudo：
```
su - david
sudo whoami
exit
```
如果看到 root，代表 david 已經可以在需要時使用管理員權限。
離開 root 連線，改用 david 登入。從這一步開始，我們都用 david 來安裝 Hermes，不再直接用 root 做日常操作：
```
exit
ssh david@你的主機IP地址
```
如果你的私鑰不是預設檔名，可以用 -i 指定，例如：
```
ssh -i ~/.ssh/id_ed25519 david@你的主機IP地址
```
在 Windows PowerShell 裡，若要指定私鑰路徑，可以這樣寫：
```
ssh -i $env:USERPROFILE\.ssh\id_ed25519 david@你的主機IP地址
```

方法一：官方安裝方法：使用 Hermes Agent 官方安裝腳本（最正統）

如果你要用 Hermes Agent 說明文件原始安裝，那麼很簡單，只要輸入以下指令，就可以直接從官網下載程式，自動安裝 Hermes Agent：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

安裝好後，可以用以下指令設定：

hermes setup

方法二：Docker 安裝方法：在 VPS 上架設專屬管家（較安全）

步驟 1：安裝 Docker 引擎

在主機上安裝 Docker，讓它成為管家的家：

# 更新系統並安裝必要套件
sudo apt update && sudo apt upgrade -y
sudo apt install -y ca-certificates curl gnupg

# 加入 Docker 官方密鑰與套件庫並安裝
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME" || echo "noble") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

步驟 2：初始化設定 (Setup Wizard)

在讓管家進入背景默默工作前，我們需要先跟它「面試」一次，設定好所有的 API 金鑰。

# 建立一個專屬資料夾來儲存管家的記憶與設定
mkdir -p ~/.hermes

# 啟動互動式設定精靈
sudo docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent setup

跟著畫面上的提示填寫你的 API 金鑰和喜好設定，這些機密都會安全地存放在 ~/.hermes 資料夾中。

步驟 3：啟動 24 小時全天候背景服務

設定完成後，我們讓管家轉入地下（背景）模式，成為你的全年無休專屬伺服器（Gateway）：

sudo docker run -d \
  --name hermes-agent \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  nousresearch/hermes-agent gateway run

幽默小提示：--restart unless-stopped 這個參數就像是給了管家不死之身，就算主機重新開機，它也會自動爬起來繼續工作！

可以在終端機輸入以下指令，進入聊天模式：

sudo docker exec -it hermes-agent hermes

或進入文字模式的使用者介面（TUI）來下指令或問問題：

sudo docker exec -it hermes-agent hermes --tui

之後若想暫時關閉 Hermes Agent 服務，可以輸入：

sudo docker stop hermes-agent

開啟 hermes-agent 服務：

sudo docker start hermes-agent

🎉 恭喜你！ 無論你選擇了哪一種方式，甚至是在雲端架設了私人伺服器，只要安裝過程沒有讓你的電腦冒煙，你就算是成功邁出第一步了！

現在，你的環境裡已經住進了一位強大的 AI 管家。在下一章《快速啟動》中，我們將教你如何喚醒它，並在 5 分鐘內跑起你們的第一次對話。準備好跟管家說第一聲早安了嗎？我們第四章見！👋