本篇带你从零搭建一个生产可用的 Jenkins 主从架构。不是"装上就跑"的玩具版本，而是包含安全加固、多节点配置、Docker 集成的完整方案。跟着做下来，你就有了一个能支撑团队日常 CI/CD 的平台。

┌─────────────────────────────────────┐
│         Jenkins Master              │
│  - Web UI (管理界面)                │
│  - Job Scheduling (任务调度)        │
│  - Plugin Management (插件管理)     │
│  - Credential Store (凭据管理)      │
└──────────────┬──────────────────────┘
               │ JNLP/SSH 协议
    ┌──────────┼──────────────────┐
    ▼          ▼                  ▼
┌────────┐ ┌────────┐       ┌────────┐
│ Agent 1│ │ Agent 2│       │ Agent 3│
│ Java   │ │ Docker │       │ K8s    │
│ 构建节点│ │ 镜像构建│       │ 部署节点│
└────────┘ └────────┘       └────────┘

方式一：Docker 部署（推荐生产环境）

# 创建数据目录
mkdir -p /data/jenkins_home
chown -R 1000:1000 /data/jenkins_home

# 启动 Jenkins Master
docker run -d \
  --name jenkins-master \
  --restart unless-stopped \
  -p 8080:8080 \
  -p 50000:50000 \
  -v /data/jenkins_home:/var/jenkins_home \
  -v /etc/localtime:/etc/localtime:ro \
  --memory=4g \
  --cpus=4 \
  jenkins/jenkins:lts-jdk17

# 获取初始密码
docker exec jenkins-master cat /var/jenkins_home/secrets/initialAdminPassword

方式二：直接安装（适合没有 Docker 的环境）

# 安装 JDK 17
apt update && apt install -y openjdk-17-jdk

# 添加 Jenkins 源
curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | \
  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/" | \
  tee /etc/apt/sources.list.d/jenkins.list > /dev/null

# 安装
apt update
apt install -y jenkins

# 启动
systemctl enable jenkins
systemctl start jenkins

# 查看初始密码
cat /var/lib/jenkins/secrets/initialAdminPassword

Manage Jenkins → Security → Security Realms → 选择 "Jenkins' own user database" → 取消勾选 "Allow users to sign up"。

Manage Jenkins → Security → Authorization → 选择 "Matrix-based security"：

用户/组              Overall        Job
admin             ✓ 全部          ✓ 全部
developers         Read           Build, Read, Cancel
deploy-bot         Read           Build, Read, Cancel, Release

// 在 Manage Jenkins → Script Console 中执行
hudson.security.csrf.DefaultCrumbIssuer.DISABLE_CSRF_PROTECTION = false

# /data/jenkins_home/config.xml 关键配置
<useSecurity>true</useSecurity>
<csrfCrumbIssuer>
  <spec/>
</csrfCrumbIssuer>
<disableRememberMe>true</disableRememberMe>

在 Job 配置中勾选 "Enable project-based security"，限制只有特定用户/组能触发构建。

方式一：SSH 方式连接 Agent（推荐）

# 在 Master 上生成 SSH 密钥（用 jenkins 用户）
docker exec -u jenkins jenkins-master ssh-keygen -t rsa -b 4096 -f ~/.ssh/jenkins_agent_key -N ""

# 查看公钥
docker exec -u jenkins jenkins-master cat ~/.ssh/jenkins_agent_key.pub

# 在 Agent 服务器上
# 创建 jenkins 用户
useradd -m -s /bin/bash jenkins

# 配置 SSH 公钥
mkdir -p /home/jenkins/.ssh
echo "刚才复制的公钥内容" >> /home/jenkins/.ssh/authorized_keys
chmod 700 /home/jenkins/.ssh
chmod 600 /home/jenkins/.ssh/authorized_keys
chown -R jenkins:jenkins /home/jenkins/.ssh

# 安装 JDK（Agent 最低要求）
apt update && apt install -y openjdk-17-jdk

# 安装 Docker（如果是 Docker 构建节点）
curl -fsSL https://get.docker.com | sh
usermod -aG docker jenkins

# 安装 Git
apt install -y git

# 创建工作目录
mkdir -p /home/jenkins/workspace
chown -R jenkins:jenkins /home/jenkins/workspace

Node name: agent-docker
Type: Permanent Agent

| Remote root directory | /home/jenkins | Agent 工作目录 |

| Labels | docker build | 标签，Pipeline 中用 |

| Usage | Use this node as much as possible | 尽量使用此节点 |

| Launch method | Launch agents via SSH | SSH 连接 |

| Credentials | jenkins-ssh-key | SSH 密钥凭据 |

| Host Key Verification | Non verifying Verification | 测试环境可关闭 |

方式二：JNLP 方式（Agent 在防火墙后）

# 在 Agent 上执行
# 从 Jenkins UI 获取 agent.jar 和 secret
wget http://jenkins-master:8080/jnlpJars/agent.jar

java -jar agent.jar -jnlpUrl http://jenkins-master:8080/computer/agent-1/slave-agent.jnlp \
  -secret YOUR_SECRET -workDir /home/jenkins/workspace

# /etc/systemd/system/jenkins-agent.service
[Unit]
Description=Jenkins Agent
After=network.target

[Service]
Type=simple
User=jenkins
ExecStart=/usr/bin/java -jar /home/jenkins/agent.jar -jnlpUrl http://jenkins-master:8080/computer/agent-1/slave-agent.jnlp -secret YOUR_SECRET -workDir /home/jenkins/workspace
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

# 启动
systemctl daemon-reload
systemctl enable jenkins-agent
systemctl start jenkins-agent

// Jenkinsfile - 测试主从架构
pipeline {
    agent {
        label 'docker-build'  // 使用 docker 构建节点的标签
    }
    
    stages {
        stage('环境检查') {
            steps {
                sh 'java -version'
                sh 'docker --version'
                sh 'git --version'
                sh 'hostname'
                echo "当前节点: ${env.NODE_NAME}"
                echo "工作目录: ${env.WORKSPACE}"
            }
        }
        
        stage('测试构建') {
            steps {
                // 简单的测试项目
                sh '''
                    echo "public class Hello { public static void main(String[] a) { System.out.println(\"Hello from Jenkins Agent\"); } }" > Hello.java
                    javac Hello.java
                    java Hello
                '''
            }
        }
        
        stage('测试 Docker') {
            steps {
                sh 'docker run --rm alpine echo "Docker works on agent"'
            }
        }
    }
}

：《Pipeline 基础：Declarative 与 Scripted 语法详解》——环境搭好了，接下来学习 Jenkins 最核心的流水线编写技能。

前言 本篇带你从零搭建一个生产可用的 Jenkins 主从架构。不是"装上就跑"的玩具版本，而是包含安全加固、多节点配置、Docker 集成的完整方案。跟着做下来，你就有了一个能支撑团队日常 CI/CD 的平台。 一、架构规划 目标架构 ┌─────────────────────────────────────┐ │ Jenkins Master │ │ Web UI 管理界面 │ │ Job ...

【CI/CD·Jenkins篇】环境搭建：从零部署 Jenkins 主从架构

研发部经理

人工智能

从零搭建生产级Jenkins主从架构，涵盖Master节点Docker部署、安全加固四件套（禁注册、矩阵授权、CSRF防护、Job权限限制）、SSH方式连接Agent节点及多环境配置。通过Label标签区分构建用途，提供完整踩坑指南与连通性验证方案，助你快速构建可支撑团队CI/CD的稳定平台。

防火墙

Docker

Ubuntu

Agent

Java

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

【CI/CD·Jenkins篇】环境搭建：从零部署 Jenkins 主从架构

【CI/CD·Jenkins篇】环境搭建：从零部署 Jenkins 主从架构

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐