---
title: "教學：使用 Cloudflare WARP 安全地將 Hermes Agent 暴露至私有網路"
description: "本文深入探討如何使用 Cloudflare WARP 與 Zero Trust 技術，在完全不需要開啟任何防火牆入站連接埠的情況下，安全地將您的 Hermes Agent 暴露到私有網路中，從而實現全球範圍內的安全存取。這為您構建專屬私有遠端 AI 基礎架構打下堅實基礎。"
canonical_url: "https://techvoyage.dev/tw/article/exposing-hermes-agent-to-private-network-using-cloudflare-warp"
last_updated: "2026-09-28"
---

當我們希望透過筆記型電腦、平板或手機等其他設備存取 **Hermes Agent**，同時又不想將其暴露在公共網際網路上時，這往往是一個普遍的挑戰。利用 **Cloudflare WARP** 與 **Cloudflare Zero Trust**，您可以在無需打開任何防火牆入站連接埠的情況下，將其安全地暴露並在全球範圍內進行存取。

如果您之前已經閱讀並遵循了我們的指南 '[如何在 Linux VPS 上部署 Hermes Agent](/article/how-to-setup-hermes-on-remote-server)'，那麼您應該大約擁有了一個全天候運行的 Hermes Agent。相比於設定傳統 VPN 帶來的繁瑣步驟，我們將使用 **Cloudflare WARP** 用戶端，透過網際網路將 Hermes Agent 暴露到私有網路中。

## 架構解析

此方案涉及的兩個核心組件：

1. **Cloudflare Zero Trust**：Cloudflare 的雲端儀表板，您可以在此定義路由規則和存取策略。
2. **Cloudflare WARP**：安裝在您的設備（VPS、筆記型電腦、手機）上的用戶端應用程式。它能夠攔截發往私有網路的流量，並安全地進行路由。

### 前置條件

- 一台已經運行 Hermes Agent 的 VPS（虛擬專屬伺服器）。
- 一個免費的 Cloudflare 帳號。

## 詳細步驟指南

### 第 1 步：設定 Cloudflare Zero Trust

1. 登入您的 [Cloudflare 儀表板 (Dashboard)](https://dash.cloudflare.com/)。
2. 點擊左側選單欄中的 'Zero Trust'。
![Cloudflare 儀表板左側側邊欄導覽選單中的 Zero Trust 選項](https://inimages.techvoyage.dev/articles/Exposing%20Hermes%20Agent%20to%20Private%20Network%20Using%20Cloudflare%20WARP/cloudflare-zero-trust-left-menu.webp)
3. 如果這是您第一次使用，系統會提示您選擇方案（免費版對本教學完全足夠）並為您的團隊命名（例如，`ai-team`）。
![首次設定 Cloudflare Zero Trust 帳戶並為團隊命名](https://inimages.techvoyage.dev/articles/Exposing%20Hermes%20Agent%20to%20Private%20Network%20Using%20Cloudflare%20WARP/cloudflare-zero-trust-team-setup.webp)
4. 點擊 'Access'，然后點擊 'Policies' 來建立存取策略，以定義誰有權限存取網路。
![Cloudflare Zero Trust Access 策略頁面，顯示新設定的存取規則](https://inimages.techvoyage.dev/articles/Exposing%20Hermes%20Agent%20to%20Private%20Network%20Using%20Cloudflare%20WARP/cloudflare-access-policies-page.webp)
5. 點击 'Create new policy'。
![Cloudflare Access policies page showing no policies added and a button to create a new policy.](https://inimages.techvoyage.dev/articles/How%20to%20secure%20NodeWarden%20at%20Cloudflare/cloudflare-access-no-policies-create-button.png)
6. 選擇 'Emails' 並在 'Policy rules' 下方輸入您的電子郵件地址。
![Cloudflare Access policy rule configuration screen with an email address specified as the inclusion criteria.](https://inimages.techvoyage.dev/articles/How%20to%20secure%20NodeWarden%20at%20Cloudflare/cloudflare-access-policy-rule-email.png)

### 第 2 步：在 VPS 上設定 Cloudflare WARP 用戶端

1. 在 VPS 終端機中執行 `sudo apt update` 和 `sudo apt install cloudflare-warp`。
2. 在 VPS 終端機中執行 `warp-cli registration new <TEAM-NAME>`，該指令將輸出一個 URL。
3. 複製輸出的 URL（其格式類似於 `https://<team>.cloudflareaccess.com/warp`），並將其貼上到瀏覽器中進行認證。
4. 由於前面的策略設定中使用了電子郵件認證，請輸入您的電子郵件以進行認證。
5. 當瀏覽器中顯示 '**Success**' 頁面後，右鍵點擊藍色的 '**Open Cloudflare WARP**' 按鈕並選擇「**檢查 (Inspect)**」。
6. 複製該按鈕連結中的長 Token 字串。
7. 在 VPS 終端機中執行 `warp-cli --accept-tos registration token "https://<team>.cloudflareaccess.com/auth?token=<copied_token>"`，將您的 VPS 連接到 Cloudflare Zero Trust。<br />

如果在 Ubuntu 26 上遇到 'Error: Failed to communicate with the WARP API'，請執行以下命令：```bash
sudo systemctl restart warp-svc.service

# Check status
sudo systemctl status warp-svc.service

# Run the warp-cli registration token again
warp-cli --accept-tos registration token   "https://<team>.cloudflareaccess.com/auth?token=<copied_token>"
```
8. 回到 Cloudflare Zero Trust 儀表板，點擊 'Devices'。您現在應該能看到您的 VPS 設備。
![Zero Trust 設備儀表板，確認 Linux VPS 已成功連線](https://inimages.techvoyage.dev/articles/Exposing%20Hermes%20Agent%20to%20Private%20Network%20Using%20Cloudflare%20WARP/cloudflare-zero-trust-devices-vps-connected.webp)

### 第 3 步：設定流量路由

1. 在 Devices 儀表板中點擊您 VPS 設備的設定檔。
![存取已登冊 VPS 設備的詳細資訊與分割通道設定](https://inimages.techvoyage.dev/articles/Exposing%20Hermes%20Agent%20to%20Private%20Network%20Using%20Cloudflare%20WARP/cloudflare-zero-trust-device-profile.webp)
2. 向下捲動至 'Split Tunnels' 部分。
![VPS 設備設定檔下的 Split Tunnels 分割通道區段](https://inimages.techvoyage.dev/articles/Exposing%20Hermes%20Agent%20to%20Private%20Network%20Using%20Cloudflare%20WARP/cloudflare-zero-trust-split-tunnels-section.webp)
3. 點擊 'Manage' 按鈕，並按照下圖設定。如有需要請替換相應的 IP 位址。
![在 Cloudflare 設定中管理分割通道 IP 與主機名稱排除規則](https://inimages.techvoyage.dev/articles/Exposing%20Hermes%20Agent%20to%20Private%20Network%20Using%20Cloudflare%20WARP/cloudflare-zero-trust-manage-split-tunnels.webp)
4. 暴露 `address` 和 `host` 會將發往您服務的流量路由到該私有網路內。

### 第 4 步：設定 VPS 防火牆

啟用防火牆，僅允許 '100.96.0.0/12' 子網的流量通過，並阻擋其他所有公共入站存取。

```bash
sudo ufw enable 
sudo ufw default allow outgoing 
sudo ufw default deny incoming
sudo ufw allow in from 100.96.0.0/12
```

允許回環網路 (loopback) 的流量，避免導致本地服務異常：

```bash
sudo ufw allow in on lo
sudo ufw allow out on lo
```

重新載入防火牆規則並驗證狀態：

```bash
sudo ufw reload 
sudo ufw status verbose
```

### 第 5 步：將 Hermes Agent 暴露至私有網路

我們將把 **Hermes Agent Web Dashboard** 暴露至私有網路，並使用預設的認證提供商 **Nous Research**。

#### 設定認證提供商

1. 前往 [portal.nousresearch.com](https://portal.nousresearch.com) 註冊一個帳號。
2. 選擇 'Local Dashboards'。
![在 Nous Research 入口網站中選擇 Local Dashboards 本地儀表板選項](https://inimages.techvoyage.dev/articles/Exposing%20Hermes%20Agent%20to%20Private%20Network%20Using%20Cloudflare%20WARP/nous-portal-local-dashboards-selection.webp)
3. 點擊 'Register Dashboard'。
![點擊 Register Dashboard 按鈕以建立新的儀表板項目](https://inimages.techvoyage.dev/articles/Exposing%20Hermes%20Agent%20to%20Private%20Network%20Using%20Cloudflare%20WARP/nous-portal-register-dashboard.webp)
4. 將 VPS 在私有網路中的 IP 位址填入 'Dashboard redirect URI' 並點擊 'Save'。
![在 Nous Research 入口網站中註冊私有網路 VPS IP 位址作為重新導向 URI](https://inimages.techvoyage.dev/articles/Exposing%20Hermes%20Agent%20to%20Private%20Network%20Using%20Cloudflare%20WARP/nous-portal-register-redirect-uri.webp)
5. 複製 'OAuth client ID' 並將其貼上到您的 `config.yaml` 檔案中：

```yaml
dashboard:
  theme: default
  show_token_analytics: false
  oauth:
    client_id: agent:cmq02x7ha0002jk0ba3kfnb
    portal_url: https://portal.nousresearch.com
  basic_auth:
    username: ''
    password_hash: ''
```

#### 使用 Systemd 確保 Hermes Dashboard 開機自啟

1. 建立服務檔案：

```shell
sudo nano /etc/systemd/system/hermes-dashboard.service
```

1. 貼上以下設定，確保 `--host 0.0.0.0` 包含在指令中：

```ini
[Unit]
Description=Hermes Dashboard
After=network.target

[Service]
User=hermes
WorkingDirectory=/home/hermes
ExecStart=/home/hermes/.local/bin/hermes dashboard --host 0.0.0.0
Restart=always
RestartSec=10
Environment=PATH=/home/hermes/.local/bin:/usr/local/bin:/usr/bin:/bin

[Install]
WantedBy=multi-user.target
```

1. 啟用並啟動服务：

```shell
sudo systemctl daemon-reload
sudo systemctl enable hermes-dashboard
sudo systemctl start hermes-dashboard
sudo systemctl status hermes-dashboard
```

### 第 6 步：在桌面上安裝 Cloudflare WARP 用戶端

1. 從 [Cloudflare 官網](https://developers.cloudflare.com/warp-client/get-started/) 下載 Cloudflare WARP 用戶端。
2. 安裝完成後打開並執行 Cloudflare WARP 用戶端。
3. 依提示登入。
![桌上型電腦上的 Cloudflare WARP 用戶端登入提示](https://inimages.techvoyage.dev/articles/Exposing%20Hermes%20Agent%20to%20Private%20Network%20Using%20Cloudflare%20WARP/cloudflare-warp-desktop-login-prompt.webp)
4. 登入成功後會顯示 'Success' 頁面。
![在桌上型電腦登入 Cloudflare Zero Trust 後的驗證成功網頁](https://inimages.techvoyage.dev/articles/Exposing%20Hermes%20Agent%20to%20Private%20Network%20Using%20Cloudflare%20WARP/cloudflare-warp-desktop-login-success.webp)
5. 此時 WARP 用戶端應顯示已連接至您的 Zero Trust 团队。
![桌面版 Cloudflare WARP 用戶端確認已連線至 Zero Trust 私有網路](https://inimages.techvoyage.dev/articles/Exposing%20Hermes%20Agent%20to%20Private%20Network%20Using%20Cloudflare%20WARP/cloudflare-warp-desktop-client-connected.webp)
6. 在瀏覽器中輸入您的私有 IP 位址（例如 `100.96.0.3`），即可成功載入 Hermes Web Dashboard。
![在桌面瀏覽器中存取私有 Hermes Agent 網頁儀表板](https://inimages.techvoyage.dev/articles/Exposing%20Hermes%20Agent%20to%20Private%20Network%20Using%20Cloudflare%20WARP/hermes-agent-dashboard-desktop-view.webp)

> **macOS 用戶進階提示：** 如果您需要使用 WARP 用戶端存取多個 Cloudflare 帳號，請參閱我們的快速指南 **使用MDM設定檔在macOS上無縫切換與設定多個Cloudflare WARP零信任組織的完整教學指南**，實現帳號間的無縫切換。

### 第 7 步：在 iOS 設備上安裝 Cloudflare WARP 用戶端

1. 在 App Store 中安裝 **Cloudflare One**。
2. 打開 Cloudflare One 應用程式並在提示時輸入您的團隊名稱。
![在 iOS 上的 Cloudflare One 應用程式中輸入 Cloudflare Zero Trust 團隊名稱](https://inimages.techvoyage.dev/articles/Exposing%20Hermes%20Agent%20to%20Private%20Network%20Using%20Cloudflare%20WARP/cloudflare-one-ios-team-name-prompt.webp)
3. 使用前面在策略規則中設定的同一個電子郵件地址進行登入。
![iOS 上的 Cloudflare Zero Trust 電子郵件驗證提示](https://inimages.techvoyage.dev/articles/Exposing%20Hermes%20Agent%20to%20Private%20Network%20Using%20Cloudflare%20WARP/cloudflare-one-ios-email-login.webp)
4. 連接成功後，介面應如下所示：
![iOS 行動設備上 Cloudflare One 應用程式顯示的已連線狀態](https://inimages.techvoyage.dev/articles/Exposing%20Hermes%20Agent%20to%20Private%20Network%20Using%20Cloudflare%20WARP/cloudflare-one-ios-client-connected.webp)
5. 在手機瀏覽器中輸入私有 IP `100.96.0.3` 即可在行動設備上存取 Hermes Web Dashboard。
![在手機瀏覽器上存取 Hermes Agent 網頁儀表板介面](https://inimages.techvoyage.dev/articles/Exposing%20Hermes%20Agent%20to%20Private%20Network%20Using%20Cloudflare%20WARP/hermes-agent-dashboard-mobile-view.webp)

## 結語

藉助 **Cloudflare Zero Trust** 管理身分策略以及 **WARP** 用戶端透過加密隧道路由流量，您的 Hermes Agent 現在可以被您的設備在全球範圍內安全存取。該配置為構建並存取完全遠端、私有的 AI 基礎架構奠定了堅實而安全的根基。