Nginx 反向代理

網域名稱存取、負載平衡、WebSocket 支援

為什麼要用反向代理

OpenClaw 預設跑在 3000 連接埠上,直接用 IP:3000 訪問雖然能用,但不好看也不安全。加一層 Nginx 反向代理,就能用功能變數名稱訪問、共用 80/443 連接埠、還能做負載均衡。

而且後面要配 HTTPS 憑證,也得先有 Nginx 做前端。這一步屬於必經之路。

四步配好反代

1

安裝 Nginx

一條命令搞定安裝,Ubuntu/Debian 系統直接 apt install。裝完就會自動啟動,瀏覽器訪問伺服器 IP 能看到 Nginx 預設頁面就說明成功了。

2

設定反代規則

寫一個 Nginx 設定檔案,把網域請求轉發到 OpenClaw 的 3000 埠。重點是 WebSocket 的設定,不然實時功能用不了。

3

測試設定

改完設定一定要先測試語法,沒問題了再 reload。直接 restart 的話,設定有錯整個 Nginx 就掛了。

4

設定自動啟動

確保伺服器重啟後 Nginx 能自動拉起來,別每次重啟都得手動開。

安裝 Nginx

安裝 Nginx
# Ubuntu / Debian

Nginx 設定檔案

這是完整的反代設定,包含了 WebSocket 支援。把下面的內容保存到 /etc/nginx/sites-available/openclaw

nginx.conf — OpenClaw 反代設定
upstream openclaw_backend {

啟用設定並測試

啟用網站設定
# 建立軟連結啟用網站
⚠️ WebSocket 設定千萬別漏掉。OpenClaw 的實時對話、流式輸出都依賴 WebSocket。如果你配反代之後發現對話卡住不動、或者訊息不實時顯示,十有八九是 WebSocket 沒配對。上面設定裡 proxy_http_version 1.1UpgradeConnection 這三行缺一不可。

多服務共存

如果伺服器上還跑了別的服務,Nginx 可以根據網域名稱分別轉發:

多網域名稱多服務範例
# OpenClaw
這篇教程對你有幫助嗎?