論壇

同问，这个变量很奇怪：

它是自动生成的——暗示着：

1. WEB_PORT 是一个系统自动生成的值
2. 不应该修改它

但：

1. 所有 auto generated 变量中根本找不到 WEB_PORT 的身影
2. 它明明可以手动修改

结论：100% 全方位矛盾

希望官方给出解答！谢谢

您好，這個疑問很好，我說明一下 WEB_PORT 的實際機制：

WEB_PORT 是「系統變數」，不是「自動生成值」—— 這兩者是不同概念：

所以您看到「WEB_PORT 不在自動生成變數列表」是正確的 — 它本來就不屬於那個分類，它屬於「系統變數」，對應關係是這樣：

${WEB_PORT} = 您服務 Networking 頁面中 web port 的實際 port 號

例如您在 Networking 頁面設定了一個 port ID 為 web、port number 為 8080，那麼 ${WEB_PORT} 就會被展開成 8080。如果您改成 3000，${WEB_PORT} 就會變成 3000。

為什麼提示說「自動生成，不應修改」？

這個提示語描述得確實有點模糊，它想表達的是：「這個值是從您的 Networking 設定衍生來的，請去 Networking 頁面改 port number，不要直接改這個變數的值」。您直接在變數欄位裡改 WEB_PORT=xxxx 雖然 UI 允許，但：

• ✅ 它會覆蓋系統衍生值（確實可以修改）
• ❌ 但 Zeabur 的 ingress 路由仍然會走您 Networking 設定的那個 port，所以如果您的應用真的 listen 在您手動改的那個 port，但 ingress 還是轉到 Networking 設定的 port，就會連不上

正確做法：

1. 應用程式程式碼裡用 process.env.PORT（或對應語言的 env 讀法），並用 PORT=${WEB_PORT} 把系統的 WEB_PORT 灌進去（很多官方範本就是這樣寫的）。
2. 如果要改 port 號，請到 Networking 頁面改 port 設定，而不是直接改 WEB_PORT 變數本身。

更多系統變數可以參考官方文件：環境變數 — 特殊變數

希望這有釐清矛盾感！如果還有疑問歡迎繼續回覆。

您好！不用手動設定，那個您看到的「系統自動生成的 port」就是 web port — ${WEB_PORT} 會自動對應到它。我來說明一下為什麼：

Zeabur 的自動 port 命名規則

根據 Zeabur 的官方文件：

For services deployed from Git repositories, the PORTNAME is always web.

也就是說，從 GitHub / GitLab 等 Git 部署的服務，自動生成的那個 port，內部 ID 固定就是 web。即使 UI 上沒有顯式標示「ID: web」這個字樣，它底層就叫 web。

所以：

• ${WEB_PORT} → 展開成「那個自動生成 port 的 port number」（例如 8080、3000 等）
• ${ZEABUR_WEB_URL} → 對應到這個 port 的公開 URL
• ${ZEABUR_WEB_DOMAIN} → 對應到這個 port 的網域

您完全不需要在 Networking 頁面再額外新增一個「ID=web」的 port — 它已經存在了，只是 UI 沒有把 ID 欄位顯式秀出來而已。

什麼情況下會有不同 ID 的 port？

只有當您手動新增了多個 port（例如除了 web 之外還要開放 TCP 的 PostgreSQL 5432、Redis 6379 等），或是用 Marketplace 模板（例如 PostgreSQL 模板內建多個 port）時，UI 才會出現多個項目，每個項目各自有自己的 ID：

對於您這種 Git 單一 web 服務的情境，系統只會產生一個 port，ID 就是 web，不會有命名模糊的問題。

驗證方式

如果您想 100% 確認，可以在服務的 Variables 頁面新增一個測試變數：

TEST_WEB_PORT=${WEB_PORT}

然後重啟服務，進容器看 echo $TEST_WEB_PORT，會看到它展開成具體的 port 數字（例如 8080），就證實 ${WEB_PORT} 確實有正確對應到 Networking 那個自動 port。

小結

• ✅ 不用手動設定 — 系統自動產生的那個 port 就是 web
• ✅ ${WEB_PORT} 會自動展開成那個 port 的 number
• ✅ UI 沒標 ID 只是呈現問題，不代表沒有 ID

希望這樣有解開您的疑慮！如果您實際上遇到 ${WEB_PORT} 沒被展開成預期的值（例如實際連不上），請回覆告訴我具體狀況，我們可以進一步排查。

This post has been inactive for a while. We will be closing it in 2 days if there is no new activity.