Gluetun WebUI

一個輕量級網頁界面，用於監控和控制 Gluetun — Docker 的 VPN 客戶端容器。

功能特色

• ✨ 多重VPN支援 — 可同時監控與控制多達20個Gluetun實例
• 即時VPN狀態橫幅（已連線 / 已暫停 / 已斷線）
• 公網出口IP、國家、地區、城市與組織
• VPN供應商、協議（WireGuard / OpenVPN）、伺服器詳細資訊
• 端口轉發與DNS狀態
• 啟動 / 停止VPN控制
• 可設定自動刷新間隔（5秒–60秒）
• 歷史條顯示最近30次輪詢狀態（顏色區分）
• 響應式設計（手機、平板、桌機）

螢幕截圖

系統需求

• Docker + Docker Compose
• 已啟用HTTP控制伺服器的Gluetun（預設端口 8000）
• Gluetun與gluetun-webui需在同一Docker網路下

快速開始

選項A1：單一實例（推薦）

在您的現有compose檔案中加入 gluetun-webui 與Gluetun併用：

gluetun-webui:
  image: scuzza/gluetun-webui:latest
  container_name: gluetun-webui
  ports:
    
"127.0.0.1:3000:3000"
  
environment:
    
GLUETUN_CONTROL_URL=http://gluetun:8000
    
# Uncomment if Gluetun auth is enabled:
    #- GLUETUN_API_KEY=yourtoken
    #- GLUETUN_USER=username
    #- GLUETUN_PASSWORD=password
  networks:
    
your_network_name
  
restart: unless-stopped
  read_only: true
  tmpfs:
    
/tmp
  
security_opt:
    
no-new-privileges:true
  
cap_drop:
    
ALL
  
healthcheck:
    test: ["CMD", "wget", "-qO-", "http://localhost:3000/api/health"]
    interval: 30s
    timeout: 5s
    start_period: 10s
    retries: 3

選項 A2：多重實例

監控 2 個以上的 Gluetun 實例，並分別設置儀表板：

gluetun-webui:
  image: scuzza/gluetun-webui:latest
  container_name: gluetun-webui
  ports:
    
"127.0.0.1:3000:3000"
  
environment:
    
GLUETUN_1_NAME=VPN - London
    
GLUETUN_1_URL=http://gluetun-1:8000
    
GLUETUN_1_API_KEY=token1
    
    
GLUETUN_2_NAME=VPN - Amsterdam  
    
GLUETUN_2_URL=http://gluetun-2:8000
    
GLUETUN_2_API_KEY=token2
    
    
GLUETUN_3_NAME=VPN - Singapore
    
GLUETUN_3_URL=http://gluetun-3:8000
    
GLUETUN_3_API_KEY=token3
  
networks:
    
your_network_name
  
restart: unless-stopped
  read_only: true
  tmpfs:
    
/tmp
  
security_opt:
    
no-new-privileges:true
  
cap_drop:
    
ALL

選項 B：在本地建置

git clone https://github.com/Sir-Scuzza/gluetun-webui.git
cd gluetun-webui
docker compose up -d --build

然後執行（任一選項）：

docker compose up -d

UI 可於 http://localhost:3000 存取

網路設定

Gluetun 和 gluetun-webui 必須在相同的 Docker 網路上，這樣 http://gluetun:8000 才能正確解析。

同一個 compose 檔案 — 只需將兩個服務加到同一個網路（最常見的做法）：

services:
  gluetun:
    networks:
      
arr-stack
  
gluetun-webui:
    networks:
      
arr-stack
networks:
  arr-stack:
    driver: bridge

單獨的 compose 檔案 — 將 Gluetun 現有的網路作為 external 引用。使用 docker network ls 查找您的網路名稱：

networks:
  ext-network:
    external: true
    name: your_gluetun_network_name

多重 VPN 支援

多個實例

gluetun-webui 支援同時監控和控制多個 Gluetun 實例。每個實例會在響應式網格中以獨立儀表板顯示。

設定：使用編號的環境變數：

gluetun-webui:
  image: scuzza/gluetun-webui:latest
  environment:
    # Instance 1
    
GLUETUN_1_NAME=VPN 1
    
GLUETUN_1_URL=http://gluetun-1:8000
    
GLUETUN_1_API_KEY=token1  # optional
    
# Instance 2
    
GLUETUN_2_NAME=VPN 2
    
GLUETUN_2_URL=http://gluetun-2:8000
    
GLUETUN_2_API_KEY=token2  # optional
    
# Instance 3
    
GLUETUN_3_NAME=VPN 3
    
GLUETUN_3_URL=http://gluetun-3:8000
    
GLUETUN_3_USER=admin
    
GLUETUN_3_PASSWORD=secret  # optional (HTTP Basic auth)

支援：最多可達 20 個實例（透過 GLUETUN_1_URL 至 GLUETUN_20_URL） 響應式：1 個全寬儀表板 → 2 個半寬 → 3 個三分之一寬 → 4 個四分之一寬 → 5 個以上可捲動顯示

向下相容性

若未設定任何編號變數，則會回退至舊版單一實例模式：

environment:
  
GLUETUN_CONTROL_URL=http://gluetun:8000  # legacy
  
GLUETUN_API_KEY=token

每個實例的驗證

每個實例都可以有不同的驗證：

# Instance with API key
GLUETUN_1_API_KEY=my-secret-token
Instance with HTTP Basic auth
GLUETUN_2_USER=admin
GLUETUN_2_PASSWORD=mysecret
Instance with no auth
GLUETUN_3_URL=http://gluetun-3:8000  # auth optional

設定

| 變數 | 預設值 | 說明 | |---|---|---| | GLUETUN_1_ 到 GLUETUN_20_ | _(空)_ | 多重實例設定（最多 20 個實例） | | GLUETUN_{N}_URL | – | 實例 N 的 Gluetun HTTP 控制伺服器 URL | | GLUETUN_{N}_NAME | Instance {N} | 實例 N 的顯示名稱 | | GLUETUN_{N}_API_KEY | _(空)_ | 實例 N 的 Bearer token（若啟用驗證） | | GLUETUN_{N}_USER | _(空)_ | HTTP Basic 驗證的使用者名稱（實例 N） | | GLUETUN_{N}_PASSWORD | _(空)_ | HTTP Basic 驗證的密碼（實例 N） | | GLUETUN_CONTROL_URL | http://gluetun:8000 | 舊版 — 僅限單一實例（若無 GLUETUN_1_* 變數則作為後備） | | GLUETUN_API_KEY | _(空)_ | 舊版 — 單一實例的 Bearer token | | GLUETUN_USER | _(空)_ | 舊版 — HTTP Basic 驗證的使用者名稱 | | GLUETUN_PASSWORD | _(空)_ | 舊版 — HTTP Basic 驗證的密碼 | | PORT | 3000 | 網頁 UI 監聽的埠號 | | TRUST_PROXY | false | 如果在反向代理（nginx、Traefik 等）後運行請設為 true |

安全性

• 埠口綁定於 127.0.0.1 — 不對外網路開放
• 容器以非 root 身份運行，且檔案系統為唯讀並移除部分權限
• 所有 API 路徑均有速率限制
• 上游錯誤詳細資訊僅記錄於伺服器端 — 瀏覽器僅收到通用訊息

反向代理設定

如果你在反向代理（nginx、Traefik、Caddy 等）後運行 gluetun-webui，請在環境變數中設為 TRUST_PROXY=true：

gluetun-webui:
  image: scuzza/gluetun-webui:latest
  environment:
    
GLUETUN_CONTROL_URL=http://gluetun:8000
    
TRUST_PROXY=true  # Required for reverse proxies

這讓應用程式能夠正確解析 X-Forwarded-For 及相關標頭，以進行準確的流量限制和 IP 偵測。注意：只有在你確實位於反向代理之後才啟用此功能，因為它會信任來自反向代理的標頭。

反向代理驗證

VPN 啟動/停止控制沒有內建認證功能。如果你將 UI 曝露在 localhost 之外，請將其置於帶有 HTTP 基本驗證的反向代理後方。

Caddy (Caddyfile):

your.domain.com {
  basicauth {
    user $2a$14$
  }
  reverse_proxy localhost:3000
}

Nginx（nginx.conf）：

location / {
  auth_basic "Restricted";
  auth_basic_user_file /etc/nginx/.htpasswd;
  proxy_pass http://localhost:3000;
}

Traefik（Docker 標籤）：

labels:
  
"traefik.enable=true"
  
"traefik.http.routers.gluetun-webui.rule=Host(your.domain.com)"
  
"traefik.http.routers.gluetun-webui.middlewares=auth"
  
"traefik.http.middlewares.auth.basicauth.users=user:$$apr1$$"

致謝

• Gluetun — 本 webui 所建立的 VPN 用戶端容器
• gluetun-monitor — 與本 webui 搭配使用的優秀監控工具
• AI 協助開發 — 本專案在 AI 協助下建構

授權

MIT

--- Tranlated By Open Ai Tx | Last indexed: 2026-05-29 ---