内网环境下的Jenkins自动化部署：从零搞定Windows服务器（含离线插件包与SSH避坑指南）

内网环境下的Jenkins自动化部署：从零搞定Windows服务器（含离线插件包与SSH避坑指南）

在企业级开发环境中，内网隔离是常见的安全策略，但这也给持续集成与部署带来了独特挑战。本文将手把手带你解决无外网环境下Jenkins自动化部署Windows服务器的全套方案，包含离线插件包制作、SSH连接深度优化以及计划任务稳定触发等实战技巧。

1. 离线环境下的Jenkins部署准备

1.1 基础环境搭建

内网部署的首要任务是准备全离线安装包。建议采用以下组合：

• Jenkins 2.346.1 LTS版本（长期支持版稳定性最佳）
• Eclipse Temurin JDK 11（与Jenkins版本完美兼容）
• Apache Maven 3.8.6（经测试无依赖冲突）

关键操作：

# 检查Java环境 java -version # 后台启动Jenkins（指定端口避免冲突） nohup java -jar jenkins_2.346.1.war --httpPort=8888 > jenkins.log 2>&1 &

1.2 离线插件包制作技巧

通过外网机制作插件包的进阶方法：

1. 在外网机器安装相同版本Jenkins
2. 通过Web界面安装所需插件（推荐基础套装）：
   • Publish Over SSH（核心）
   • Git Parameter（动态标签）
   • Pipeline（流程控制）
3. 复制$JENKINS_HOME/plugins目录下所有.jpi文件
4. 在内网Jenkins的plugins目录执行：

# Windows服务器操作示例 robocopy \\外网共享\jenkins_plugins %JENKINS_HOME%\plugins /MIR

注意：插件间存在依赖关系，建议先安装基础功能插件再逐步扩展

2. Windows服务器SSH深度配置

2.1 OpenSSH服务优化

Windows自带的OpenSSH服务常出现连接超时问题，需进行三项关键调整：

修改后需重启服务：

Restart-Service sshd -Force

2.2 路径映射的实战方案

Windows与Linux路径差异会导致部署失败，推荐两种解决方案：

方案A：符号链接创建

# 创建目录软链接（管理员权限运行） mklink /D C:\deploy_target D:\actual_storage

方案B：注册表映射（永久生效）

1. 打开regedit
2. 定位到HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\DOS Devices
3. 新建字符串值：\??\C:\deploy_target=D:\actual_storage

3. 自动化部署全流程设计

3.1 Jenkins任务配置要点

构建触发器推荐组合使用：

• 轮询SCM（适合代码库变更频繁场景）
• 定时构建（适合每日固定时间发布）
• 手动触发（关键版本控制）

典型Pipeline脚本示例：

pipeline { agent any stages { stage('Checkout') { steps { git branch: '${BRANCH}', url: 'file:///git_repo/project.git' } } stage('Build') { steps { bat 'mvn clean package -DskipTests' } } stage('Deploy') { steps { sshPublisher( publishers: [ sshPublisherDesc( configName: 'windows_server', transfers: [ sshTransfer( sourceFiles: 'target/*.war', removePrefix: 'target', remoteDirectory: 'deploy', execCommand: ''' schtasks /run /tn "restart_tomcat" ''' ) ] ) ] ) } } } }

3.2 计划任务可靠触发

Windows计划任务常见问题及解决方案：

1. 权限不足：

   • 创建任务时选择"最高权限运行"
   • 在安全选项中指定具体用户

2. 环境变量丢失：

   # 在bat脚本开头添加环境变量 @echo off set PATH=%PATH%;C:\Program Files\Java\jdk-11\bin

3. 日志记录增强：

   schtasks /run /tn "deploy_task" >> C:\logs\deploy_%date:~0,4%%date:~5,2%%date:~8,2%.log 2>&1

4. 内网环境专属调优策略

4.1 资源隔离方案

推荐采用Docker容器化部署Jenkins master：

FROM jenkins/jenkins:2.346.1-lts COPY plugins/ /usr/share/jenkins/ref/plugins/ ENV JAVA_OPTS="-Djenkins.install.runSetupWizard=false"

优势对比：

4.2 高可用设计

内网环境需特别注意单点故障问题：

1. 配置备份方案：

   # 定期打包Jenkins Home目录 tar -czf /backups/jenkins_$(date +%Y%m%d).tar.gz ~/.jenkins

2. 快速恢复流程：

   • 解压备份文件到新实例
   • 启动时添加--restore参数
   • 验证关键插件兼容性

4.3 性能监控指标

通过JMX暴露关键指标：

# 在Jenkins启动参数添加 -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=9010 -Dcom.sun.management.jmxremote.authenticate=false

推荐监控阈值：