Jenkins 安装教程

目录

[Jenkins 安装教程（新手友好版）](#Jenkins 安装教程（新手友好版）)

一、安装前准备（必做）

[1️⃣ 安装 Java（Jenkins 必须）](#1️⃣ 安装 Java（Jenkins 必须）)

[检查是否已安装 Java](#检查是否已安装 Java)

[二、Windows 安装 Jenkins（最常见）](#二、Windows 安装 Jenkins（最常见）)

[✅ 方式 1：MSI 安装包（推荐）](#✅ 方式 1：MSI 安装包（推荐）)

[1️⃣ 下载 Jenkins](#1️⃣ 下载 Jenkins)

[2️⃣ 双击安装](#2️⃣ 双击安装)

[3️⃣ 启动 Jenkins](#3️⃣ 启动 Jenkins)

[4️⃣ 解锁 Jenkins（第一次必做）](#4️⃣ 解锁 Jenkins（第一次必做）)

[5️⃣ 安装插件](#5️⃣ 安装插件)

[6️⃣ 创建管理员账号](#6️⃣ 创建管理员账号)

[三、Linux（Ubuntu / CentOS）](#三、Linux（Ubuntu / CentOS）)

[Ubuntu / Debian](#Ubuntu / Debian)

[四、Docker 安装（推荐给测试 / CI 环境）](#四、Docker 安装（推荐给测试 / CI 环境）)

[五、安装完成后必做的 5 件事（重点）](#五、安装完成后必做的 5 件事（重点）)

[✅ 1️⃣ 安装常用插件](#✅ 1️⃣ 安装常用插件)

[✅ 2️⃣ 配置 JDK / Node（重要）](#✅ 2️⃣ 配置 JDK / Node（重要）)

[✅ 3️⃣ 配置 Git 凭证](#✅ 3️⃣ 配置 Git 凭证)

[✅ 4️⃣ 新建 Job（Pipeline 推荐）](#✅ 4️⃣ 新建 Job（Pipeline 推荐）)

[✅ 5️⃣ 修改端口（可选）](#✅ 5️⃣ 修改端口（可选）)

六、常见问题（你很可能会遇到）

[❌ 8080 端口被占用](#❌ 8080 端口被占用)

[❌ Jenkins 启动失败](#❌ Jenkins 启动失败)

[❌ Playwright / Node 在 Jenkins 跑不了](#❌ Playwright / Node 在 Jenkins 跑不了)

七、我的实战建议（重要）

总结一句话

---

---

Jenkins 安装教程（新手友好版）

一、安装前准备（必做）

1️⃣ 安装 Java（Jenkins 必须）

Jenkins 要求 Java（推荐 LTS）：

• ✅ Java 17（官方推荐）

• 或 Java 11

检查是否已安装 Java

java -version

如果没装，推荐：

• Windows / Mac：下载 JDK 17

• Linux：用包管理器

---

二、Windows 安装 Jenkins（最常见）

✅ 方式 1：MSI 安装包（推荐）

1️⃣ 下载 Jenkins

官网（LTS）：

👉 https://www.jenkins.io/download/

选择：

• Windows

• Jenkins LTS (MSI)

2️⃣ 双击安装

一路 Next，注意这几个点：

• Service 运行（默认即可）

• 端口 ：默认 8080（除非被占用）

• Java 路径：自动识别 JDK 17（如果装过）

3️⃣ 启动 Jenkins

浏览器打开：

http://localhost:8080

---

4️⃣ 解锁 Jenkins（第一次必做）

根据页面提示，找到密码文件：

C:\Program Files\Jenkins\secrets\initialAdminPassword

复制内容 → 粘贴 → Continue

---

5️⃣ 安装插件

选择：

✅ Install suggested plugins（推荐）

等 1～3 分钟 ⏳

---

6️⃣ 创建管理员账号

填：

• username

• password

• email（可随意）

🎉 Jenkins 安装完成！

---

三、Linux（Ubuntu / CentOS）

Ubuntu / Debian

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

curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io.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 -y jenkins

启动：

sudo systemctl start jenkins
sudo systemctl enable jenkins

访问：

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

---

四、Docker 安装（推荐给测试 / CI 环境）

如果你用 Docker，这是最干净、最好回滚的方式。

docker run -d \
  -p 8080:8080 \
  -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  --name jenkins \
  jenkins/jenkins:lts

查看初始密码：

docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword

---

五、安装完成后必做的 5 件事（重点）

✅ 1️⃣ 安装常用插件

进入：

Manage Jenkins → Plugins

推荐：

• Git

• GitHub Integration

• Pipeline

• NodeJS

• Workspace Cleanup

• Credentials Binding

---

✅ 2️⃣ 配置 JDK / Node（重要）

Manage Jenkins → Global Tool Configuration

配置：

• JDK 17

• NodeJS（如果跑前端 / Playwright）

---

✅ 3️⃣ 配置 Git 凭证

Manage Jenkins → Credentials

• Username / Password

• 或 SSH Key（推荐）

---

✅ 4️⃣ 新建 Job（Pipeline 推荐）

选择：

New Item → Pipeline

Pipeline Script 示例：

pipeline {
  agent any
  stages {
    stage('Install') {
      steps {
        sh 'npm install'
      }
    }
    stage('Test') {
      steps {
        sh 'npm test'
      }
    }
  }
}

---

✅ 5️⃣ 修改端口（可选）

jenkins.xml：

--httpPort=8081

---

六、常见问题（你很可能会遇到）

❌ 8080 端口被占用

netstat -ano | findstr 8080

解决：改端口 or 杀进程

---

❌ Jenkins 启动失败

通常原因：

• Java 版本不对

• 内存不够

查看日志：

C:\Program Files\Jenkins\jenkins.err.log

---

❌ Playwright / Node 在 Jenkins 跑不了

需要：

• NodeJS tool 配置

• npx playwright install

---

七、我的实战建议（重要）

如果你是做：

• 自动化测试

• Playwright / BDD

• CI/CD

👉 强烈建议：Docker + Pipeline

优点：

• 环境一致

• 好迁移

• 不污染宿主机

---

总结一句话

Jenkins 安装 ≠ Jenkins 能用
插件 + 工具配置 + Pipeline 才是核心