Jenkins 安装与部署完整指南

Jenkins 是一款开源的自动化服务器，常用于持续集成（CI）和持续交付（CD）。本文将介绍在 Linux、Windows、macOS 三大平台上的安装与部署步骤，并补充运维、安全和常见问题解决方案。

1. 系统要求

• Java：Jenkins 需要 Java 运行环境（推荐 JDK 11 或 17）。
• 检查 Java 版本：

java -version

• 如果未安装，可通过以下命令安装（Ubuntu/Debian）：

sudo apt update sudo apt install openjdk-17-jdk

2. 安装 Jenkins

Linux (Ubuntu/Debian/CentOS)

方法一：通过官方仓库安装（推荐）

curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee \
  /usr/share/keyrings/jenkins-keyring.asc > /dev/null
echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] \
  https://pkg.jenkins.io/debian-stable binary/ | sudo tee \
  /etc/apt/sources.list.d/jenkins.list > /dev/null
sudo apt update
sudo apt install jenkins

方法二：通过 WAR 包（通用方式）

wget https://get.jenkins.io/war-stable/latest/jenkins.war
java -jar jenkins.war --httpPort=8080

Windows

1. 从 Jenkins 官网 下载 .msi 安装包。
2. 双击安装，按向导完成配置（会自动注册 Jenkins 服务并安装 Java）。

macOS

brew install jenkins
brew services start jenkins

3. 启动 Jenkins

• Linux (Systemd)：

sudo systemctl start jenkins
sudo systemctl enable jenkins # 开机自启
sudo systemctl status jenkins # 查看状态

• 手动运行 WAR 包：

java -jar jenkins.war --httpPort=8080

4. 初始配置

1. 打开浏览器访问：

http://<服务器IP或域名>:8080

2. 获取初始密码：

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

（Windows/macOS 密码在安装日志或控制台输出中）

3. 安装推荐插件（Install suggested plugins）。
4. 创建管理员账号，完成初始配置。

5. 安全配置（推荐）

1. 配置防火墙（Linux 示例）：

sudo ufw allow 8080
sudo ufw enable

2. 启用 HTTPS：通过 Nginx/Apache 反向代理 + SSL 证书。
3. 限制访问权限：

• 进入 Manage Jenkins > Configure Global Security 配置用户权限和矩阵授权。

6. 常用操作

• 重启 Jenkins：

sudo systemctl restart jenkins

• 查看日志：

sudo journalctl -u jenkins -f 
# 或
tail -f /var/log/jenkins/jenkins.log

• 卸载 Jenkins：

sudo apt remove --purge jenkins # Ubuntu/Debian
sudo rpm -e jenkins # CentOS

7. 插件管理

1. 进入 Manage Jenkins > Plugins > Available plugins。
2. 搜索并安装常用插件：

• Git
• Pipeline
• Docker
• Kubernetes

8. 备份与恢复

• 备份 Jenkins 数据目录：

tar -czvf jenkins_backup.tar.gz /var/lib/jenkins

• 恢复：解压至原路径即可。

9. 常见问题

1. 端口冲突：编辑 /etc/default/jenkins，修改 HTTP_PORT。
2. 插件安装失败：换国内镜像源（Manage Jenkins > Plugin Manager > Advanced）。
3. 内存不足：增加 JVM 内存：

echo "JAVA_OPTS=\"-Xmx1024m\"" | sudo tee -a /etc/default/jenkins
sudo systemctl restart jenkins

10. 后续扩展方向

• 配置 CI/CD 流水线（Maven/Node.js/Go 项目）。
• 配合 Docker/Kubernetes 做分布式构建。
• 集成 GitHub/GitLab Webhook 实现自动化触发。
• 部署 多节点 Jenkins Agent 提升构建效率。

到这里，你就可以在不同平台顺利安装和运行 Jenkins，并且具备基础运维能力。