debian如何离线部署jenkins

在 Debian 系统上离线部署 Jenkins，核心思路是：提前在有网络的机器上下载所需 deb 包及依赖，再拷贝到目标机器安装。下面按最常见、最稳定的方式说明。

一、准备工作（在有网络的 Debian 机器上）

1. 确认系统版本

cat /etc/os-release

常见：

• Debian 11 (bullseye)
• Debian 12 (bookworm)

2. 添加 Jenkins 官方源（仅用于下载）

sudo apt update
sudo apt install -y wget gnupg

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

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
mkdir ~/jenkins-offline
cd ~/jenkins-offline
apt-get download jenkins
apt-get install --download-only --reinstall $(apt-cache depends --recurse --no-recommends --no-suggests --no-conflicts --no-breaks --no-replaces --no-enhances jenkins | grep "^\w" | sort -u)

4. 确保 Java 也已下载（Jenkins 依赖）

Jenkins 2.4xx 需要 Java 17 或 21

apt-get download openjdk-17-jdk
# 或
apt-get download openjdk-21-jdk

如果目标机已装 Java，可跳过

5. 打包

cd ~
tar czf jenkins-offline.tar.gz jenkins-offline

将 jenkins-offline.tar.gz 拷贝到目标机器（U 盘 / 内网传输）

二、在离线 Debian 机器上安装

1. 拷贝并解压

tar xzf jenkins-offline.tar.gz
cd jenkins-offline

2. 安装所有 deb 包

sudo dpkg -i *.deb

如报错依赖问题：

sudo apt-get install -f

3. 安装 Java（如未安装）

sudo dpkg -i openjdk-17-jdk*.deb

验证：

java -version

4. 启动 Jenkins

sudo systemctl enable jenkins
sudo systemctl start jenkins

查看状态：

systemctl status jenkins

三、初始化 Jenkins

1. 获取管理员密码

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

2. 访问页面

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

四、离线安装插件（可选但常见）

Jenkins 默认会联网装插件，离线环境需手动：

方式一：手动上传 hpi 文件

1. 在有网机器访问
   https://updates.jenkins.io/download/plugins/
2. 下载 .hpi
3. Jenkins → Manage Jenkins → Plugins → Advanced → Upload

方式二：使用离线插件包

/var/lib/jenkins/plugins/

放入 .hpi 后重启：

sudo systemctl restart jenkins

五、常见问题

1. 端口冲突

修改：

sudo nano /etc/default/jenkins

JENKINS_PORT=8081

2. 时间不对导致插件失败

sudo apt install ntpdate
sudo ntpdate pool.ntp.org

六、总结流程

✅ 有网机：加源 → 下载 deb → 拷贝
✅ 离线机：dpkg 安装 → 启动 Jenkins
✅ 插件：手动上传 hpi

如果你愿意，我可以：

• 给你 Debian 11 / 12 具体版本命令
• 帮你 只下载最小依赖
• 或提供 Docker 离线方案

直接告诉我你的 Debian 版本即可。