怎样在Ubuntu配Jenkins

下面给你一份在 Ubuntu 上安装和配置 Jenkins 的实用指南，从零开始，适合新手也能直接用。

一、环境准备

1. 系统要求

• Ubuntu 20.04 / 22.04（推荐）
• 已拥有 sudo 权限的用户
• 已安装 Java（Jenkins 依赖 Java）

2. 安装 Java（OpenJDK）

sudo apt update
sudo apt install -y openjdk-17-jdk

验证：

java -version

二、安装 Jenkins

方式一（推荐）：官方仓库安装

1. 导入 Jenkins GPG Key

sudo wget -O /usr/share/keyrings/jenkins-keyring.asc \
  https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key

2. 添加 Jenkins 软件源

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

3. 安装 Jenkins

sudo apt update
sudo apt install -y jenkins

三、启动 Jenkins

sudo systemctl enable jenkins
sudo systemctl start jenkins

查看状态：

sudo systemctl status jenkins

四、初始配置

1. 获取初始管理员密码

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

2. 浏览器访问

http://<服务器IP>:8080

• 输入上面的密码
• 选择 Install suggested plugins
• 创建管理员账号
• 完成初始化

五、基础配置（很重要）

1. 修改 Jenkins 运行端口（可选）

编辑：

sudo nano /etc/default/jenkins

修改：

HTTP_PORT=8080

重启：

sudo systemctl restart jenkins

2. 配置 Git

sudo apt install -y git

Jenkins → Manage Jenkins → Global Tool Configuration → Git

六、防火墙 & 远程访问

开放端口

sudo ufw allow 8080

建议使用 Nginx 反向代理（生产推荐）

sudo apt install -y nginx

示例 Nginx 配置：

server {
    listen 80;
    server_name jenkins.example.com;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

七、常见问题

Jenkins 启动失败？

journalctl -u jenkins -xe

Java 版本不对？

Jenkins 2.4+ 支持 Java 17

八、下一步你可以做什么

• 配置 Pipeline
• 接入 GitHub / GitLab
• 配置 Docker 构建
• 设置 自动部署

如果你愿意，我可以： ✅ 帮你写 Jenkinsfile ✅ 配置 Docker + Jenkins ✅ 教你 CI/CD 实战案例

直接告诉我你的使用场景即可。