如何更改 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 设置的安全性。