如何更改 Jenkins 的埠？

---

簡介

Jenkins 是一個開源的自動化伺服器，可幫助開發人員構建、測試和部署其軟體。由於其靈活性、易用性和廣泛的外掛生態系統，它是 DevOps 領域最流行的工具之一。安裝 Jenkins 時，它使用預設埠號 (8080) 偵聽傳入的 HTTP 請求。

但是，有時此埠可能會與系統上的其他應用程式發生衝突，或者可能不適合您環境的安全需求。在這種情況下，需要更改埠號。

瞭解埠

在深入瞭解更改 Jenkins 埠的步驟之前，瞭解埠到底是什麼以及它是如何工作的非常重要。簡單來說，埠是應用程式或裝置在網路連線上進行通訊的虛擬點。它允許不同的程式彼此建立連線並交換資料。

埠由 0 到 65535 的數字標識，其中一些數字指定用於特定目的。例如，埠 80 和 443 分別常用於 HTTP 和 HTTPS 流量。

Jenkins 使用的常用埠及其用途

Jenkins 使用多個埠執行不同的功能。在更改 Jenkins 埠時，瞭解這些埠非常重要：

• HTTP 埠（預設：8080） - Jenkins 用於在您的機器上提供網頁的主要埠。預設情況下，此埠設定為 8080，但可以根據您的需求進行更改。

• AJP 埠（預設 - 已停用）：Apache JServ 協議埠用於實現 Apache JServ 協議。此協議允許像 Apache HTTP Server 這樣的 Web 伺服器透過代理與像 Tomcat 這樣的 servlet 引擎通訊。

• JNLP 埠（預設 - 固定隨機）：java 網路啟動協議 (jnlp) 用於 Jenkins 代理透過 tcp/ip 網路在主節點和代理節點之間建立連線。

除了這些埠之外，還可以根據您的需求配置其他幾個埠，例如 SSH 埠（用於遠端訪問）、JMX 埠（用於監控）等。瞭解您的 Jenkins 安裝使用哪些埠將幫助您更改正確的埠，而不會導致任何服務中斷。

更改 Jenkins 埠的步驟

有關如何在 Windows、Mac 或 Linux 作業系統上更改 Jenkins 埠的分步指南

要更改 Jenkins 的埠，您需要修改 Jenkins 的配置檔案。以下是更改埠的步驟：

找到 Jenkins 安裝目錄：確切位置可能因您的作業系統和 Jenkins 的安裝方式而異。常見位置包括：

Linux：/var/lib/jenkins

Windows：C:\Program Files (x86)\Jenkins

轉到 Jenkins 安裝目錄並找到 jenkins.xml 檔案。此檔案包含 Jenkins 配置。

$cd /var/lib/Jenkins
$ ls

使用文字編輯器開啟 jenkins.xml 檔案。

$ sudo vim Jenkins.xml

在 <service> 元素內查詢 <arguments> 部分。它應包含傳遞給 Jenkins 服務的引數。

找到指定埠號的引數。預設情況下，它應該是 --httpPort=8080。

--httpPort=8080

將埠號更改為您想要的值。例如，如果您想將其更改為埠 9090，請將引數修改為 --httpPort=9090。

--httpPort=9090

完成更改後儲存 jenkins.xml 檔案。

重新啟動 Jenkins 服務以應用配置更改。重新啟動 Jenkins 的步驟取決於您的作業系統：

Linux 

使用以下命令：

sudo service jenkins restart

Windows

轉到“服務”（services.msc）並重新啟動“Jenkins”服務。

重新啟動後，您可以在指定的新的埠上訪問 Jenkins。開啟 Web 瀏覽器並輸入新的 URL（包括埠號）以訪問 Jenkins Web 介面。

請注意，更改 Jenkins 埠可能需要其他配置調整，例如更新防火牆規則或反向代理設定（如果適用）。

故障排除過程中可能出現的常見問題

雖然更改埠號是一個簡單的過程，但在過程中您可能會遇到一些常見問題。一個潛在的問題是您的新埠號已被系統上的另一個應用程式使用。

為避免此問題，務必選擇一個唯一且未使用的埠號。您可能面臨的另一個問題是，更改埠號後，您無法再訪問 Jenkins。

這可能是由於防火牆設定或其他安全措施阻止了對新埠號的訪問。要解決此問題，請確保系統上的任何防火牆或安全設定都允許透過新埠進行流量。

更改預設 Jenkins 埠可能會導致其他應用程式或外掛無法正常工作。如果您在更改埠後注意到任何問題，請嘗試恢復為預設設定或諮詢 Jenkins 社群論壇和文件提供的技術支援資源。

更改 Jenkins 埠的最佳實踐

選擇不會與系統上其他應用程式衝突的新埠號的技巧

更改 Jenkins 的預設埠時，務必選擇一個不會與系統上任何現有埠或服務衝突的新埠。您可以在網上找到常用埠的列表，並避免在 Jenkins 設定中使用這些數字。

或者，您可以使用“netstat”等工具檢查當前正在使用的埠，然後選擇一個可用的埠。請記住記錄新埠號以備將來參考。

防止未經授權訪問的安全新埠號建議

更改 Jenkins 的預設埠並不能保證安全。如果您不採取預防措施，仍然可能發生未經授權的訪問。

建議實施諸如防火牆規則或 IP 地址限制之類的措施，以將訪問許可權限制為僅授權使用者或機器。此外，您可以考慮透過從信譽良好的提供商處獲取 SSL 證書來啟用 SSL 加密。

這將確保客戶端和伺服器之間所有通訊都安全加密，從而保護敏感資訊不被惡意方攔截。透過遵循這些最佳實踐，您可以更改 Jenkins 的預設埠而不會影響系統上的其他應用程式，同時還能確保您的設定免受未經授權的訪問。

結論

更改 Jenkins 的埠是最佳化工作流程的相對簡單但重要的步驟。瞭解埠是什麼以及它是如何工作的可以幫助您選擇一個不會與系統上其他應用程式衝突的新埠號。

透過遵循本文中概述的分步指南，您可以輕鬆地在 Windows、Mac 或 Linux 作業系統上更改 Jenkins 的埠。此外，保護您的新埠號可以防止未經授權的訪問並增強 Jenkins 設定的安全性。