一、前言Jenkins是一款免费开源的自动化工具能帮我们自动完成代码构建、测试、部署等流程广泛用于软件开发和测试工作。本文以CentOS/RHEL系统为例用通俗的语言和 step-by-step 操作带大家从零完成Jenkins安装全程避开专业术语陷阱新手也能轻松上手二、准备工作一台Linux服务器云服务器或本地虚拟机均可系统版本建议CentOS 7/8、RHEL 7/8服务器已连接网络用于下载安装包无外网可参考后续离线方案电脑安装Xshell或Putty、SecureCRT等SSH工具本文以Xshell为例具备服务器的用户名和密码需有sudo权限能执行管理员命令。三、第一步连接Linux服务器3.1 用Xshell连接服务器最常用方式打开Xshell软件点击左上角「文件」→「新建」或直接点工具栏“新建”图标在弹出的“新建会话属性”窗口中按以下要求填写名称随便起个好记的名字比如“我的Jenkins服务器”不影响使用协议默认选择「SSH」不用改远程连接Linux的标准协议主机输入你的Linux服务器IP地址比如192.168.1.100由服务器管理员提供端口号默认填22如果服务器管理员修改过SSH端口就填修改后的端口填写完成后点击「确定」会在左侧会话列表看到新建的连接双击该连接弹出“用户身份验证”窗口输入服务器的用户名比如root、admin和密码点击「确定」若出现“是否接受主机密钥”提示点击「接受并保存」稍等几秒就会连接成功看到类似“Welcome to Alibaba Cloud Elastic Compute Service”的欢迎信息说明已经登录到服务器了。3.2 查看服务器基本信息可选了解即可查看服务器名称在终端输入命令hostname输入后按回车会显示服务器的名称比如ecs-xxx查看服务器IP地址输入命令ip addr按回车找到包含“inet”的一行后面的IP就是服务器地址比如inet 192.168.1.100/24IP就是192.168.1.100后续访问Jenkins会用到。小提示如果连接失败大概率是这3个原因服务器IP地址、端口号填错了用户名或密码输入错误注意密码区分大小写输入时不会显示正常输入后回车即可服务器防火墙禁止了22端口联系管理员开放即可。四、第二步安装Jenkins核心步骤按顺序执行4.1 提前说明以下所有命令都需要在Xshell的终端窗口中输入输入完一条按回车执行等待执行完成后再输入下一条。命令中的sudo表示“以管理员身份执行”输入后可能会提示输入服务器密码输入正确密码即可输入时不显示字符正常输入回车就行。4.2 步骤1添加Jenkins的软件仓库告诉系统从哪下载Jenkins输入以下命令按回车sudowget-O/etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo作用从Jenkins官方下载软件源配置文件存到系统指定目录后续安装时系统能找到Jenkins安装包若提示“wget: 未找到命令”先输入sudo dnf install wget -y安装wget工具再重新执行上面的命令无外网情况如果服务器不能连外网先在能上网的电脑上打开链接 https://pkg.jenkins.io/redhat-stable/jenkins.repo下载该文件再通过Xshell的「文件传输」功能或scp工具上传到服务器的/etc/yum.repos.d/目录下。4.3 步骤2导入Jenkins的验证密钥确保下载的软件是官方正版输入以下命令按回车sudorpm--importhttps://pkg.jenkins.io/redhat-stable/jenkins.io-2023.key作用导入Jenkins官方的GPG密钥系统会用该密钥验证安装包的完整性避免下载到篡改的文件若导入失败大概率是网络不稳定可先在能上网的电脑上下载密钥文件打开链接 https://pkg.jenkins.io/redhat-stable/jenkins.io-2023.key保存为文件上传到服务器后输入sudo rpm --import /path/密钥文件名称将/path替换为文件上传的路径比如/root/jenkins.io-2023.key。4.4 步骤3更新系统软件包可选但建议执行输入以下命令按回车sudodnf upgrade-y作用更新系统中已安装的软件包到最新版本避免因依赖包版本过旧导致Jenkins安装失败说明该命令执行时间可能较长视服务器网络和软件数量而定耐心等待即可不想更新也可以直接跳过这一步。4.5 步骤4安装Jenkins必需的依赖Java环境Jenkins是基于Java开发的必须安装Java才能运行输入以下命令安装sudodnfinstallfontconfig java-17-openjdk-y作用安装Java 17Jenkins要求Java 11及以上版本Java 17是稳定推荐版和字体配置依赖验证Java是否安装成功输入java -version按回车若显示类似“openjdk version “17.0.9” 2023-10-17”的信息说明安装成功若系统已有其他Java版本输入sudo alternatives --config java按回车后会列出所有Java版本输入想要切换的版本编号比如2按回车即可切换默认Java版本。4.6 步骤5正式安装Jenkins输入以下命令按回车sudodnfinstalljenkins-y作用通过系统软件包管理器安装Jenkins安装过程会自动处理相关依赖安装完成提示当终端显示“Complete!”或回到命令输入状态时说明安装完成。4.7 步骤6重新加载系统服务配置让系统识别Jenkins服务输入以下命令按回车sudosystemctl daemon-reload作用Jenkins安装后会添加为系统服务执行该命令让systemd系统服务管理器识别新安装的Jenkins服务避免启动失败。4.8 步骤7启动Jenkins服务输入以下命令按回车sudosystemctl start jenkins作用启动Jenkins服务若启动失败输入sudo journalctl -u jenkins查看日志日志中会显示失败原因比如Java版本不兼容、端口被占用等根据日志排查后再重新启动。4.9 步骤8设置Jenkins开机自启避免服务器重启后需要手动启动输入以下命令按回车sudosystemctlenablejenkins作用设置Jenkins服务在服务器开机时自动启动无需每次重启服务器后手动执行启动命令执行成功后终端会显示“Created symlink /etc/systemd/system/multi-user.target.wants/jenkins.service → /usr/lib/systemd/system/jenkins.service.”。4.10 步骤9检查Jenkins服务状态确认是否正常运行输入以下命令按回车sudosystemctl status jenkins正常运行的判断终端会显示“active (running)”绿色说明Jenkins服务正在运行若显示“inactive (dead)”说明服务未启动重新执行sudo systemctl start jenkins启动查看状态后退出按键盘上的「q」键即可回到命令输入界面。4.11 步骤10获取Jenkins初始管理员密码首次登录必需输入以下命令按回车sudocat/var/lib/jenkins/secrets/initialAdminPassword作用Jenkins首次登录需要输入初始密码该命令用于查看该密码操作执行后终端会显示一串随机字符串比如“a1b2c3d4e5f6g7h8i9j0”这就是初始密码务必复制保存好可以记在记事本上后续登录要用。4.12 步骤11开放8080端口允许外部访问JenkinsJenkins默认使用8080端口提供Web服务需要开放该端口才能通过浏览器访问# 开放8080端口永久生效sudofirewall-cmd--permanent--add-port8080/tcp# 重新加载防火墙配置使端口开放生效sudofirewall-cmd--reload若服务器未启用firewalld防火墙比如已关闭或使用其他防火墙执行命令后可能提示“FirewallD is not running”无需理会直接跳过即可验证端口是否开放输入sudo firewall-cmd --query-port8080/tcp若显示“yes”说明开放成功。4.13 步骤12通过浏览器访问Jenkins Web界面打开电脑上的浏览器Chrome、Edge、Firefox均可在地址栏输入http://服务器IP地址:8080比如http://192.168.1.100:8080按回车此时会进入Jenkins首次登录界面提示输入“管理员初始密码”将之前复制的密码粘贴进去点击「继续」后续步骤可选按引导操作选择“安装推荐的插件”适合新手Jenkins会自动安装常用插件耐心等待安装完成插件安装时间取决于网络速度创建管理员用户插件安装完成后会提示创建管理员账号用户名、密码、邮箱等按要求填写即可实例配置默认显示Jenkins的访问地址无需修改点击「保存并完成」完成配置点击「开始使用Jenkins」即可进入Jenkins主界面此时安装配置全部完成五、常见问题及解决方法新手必看5.1 问题1浏览器访问http://服务器IP:8080 无法打开可能原因1Jenkins服务未启动解决回到Xshell终端执行sudo systemctl start jenkins启动服务再执行sudo systemctl status jenkins确认服务处于“active (running)”状态。可能原因28080端口未开放解决重新执行步骤4.12的端口开放命令确保端口开放成功。可能原因3服务器IP地址或端口号输入错误解决重新执行ip addr确认服务器IP确保浏览器地址栏的IP和端口正确端口是8080不是22。可能原因4服务器网络不通解决检查服务器是否能正常上网输入ping www.baidu.com测试同时确认本地电脑能ping通服务器IP。5.2 问题2输入初始密码后插件安装失败可能原因网络不稳定无法下载插件解决点击“重试”按钮重新尝试安装若多次重试失败选择“跳过插件安装”进入Jenkins后后续可通过「系统管理」→「插件管理」手动安装需要的插件手动安装插件时可在「插件管理」→「高级」中将“升级站点”的URL改为国内镜像比如https://mirrors.tuna.tsinghua.edu.cn/jenkins/plugins/update-center.json点击「提交」后再安装插件速度会更快。5.3 问题3启动Jenkins服务提示“Java版本不兼容”可能原因系统Java版本低于11解决执行java -version查看当前Java版本若低于11重新执行步骤4.5安装Java 17或切换到Java 11及以上版本。5.4 问题4GPG密钥导入失败可能原因网络不稳定无法下载密钥解决按步骤4.3的“无外网情况”处理手动下载密钥文件并导入。5.5 问题5Jenkins服务启动后很快停止可能原因端口被占用8080端口已被其他服务使用解决查找占用8080端口的服务输入sudo lsof -i :8080若提示lsof未找到先执行sudo dnf install lsof -y安装停止占用端口的服务输入sudo kill -9 进程ID进程ID通过上一步命令查看重新启动Jenkinssudo systemctl start jenkins若不想停止其他服务可修改Jenkins默认端口编辑Jenkins配置文件sudo vi /etc/sysconfig/jenkins找到“JENKINS_PORT“8080””将8080改为其他未被占用的端口比如8081保存后执行sudo systemctl restart jenkins再开放新端口即可。5.6 问题6忘记Jenkins管理员密码解决方法回到Xshell终端输入sudo vi /var/lib/jenkins/users/admin/_config.xmladmin是管理员用户名若已修改过用户名替换为实际用户名找到passwordHash标签删除标签内的内容替换为#jbcrypt:$2a$10$MiIVR0rr/UhQBqT.bBq0QehTiQVqgNpUGyWW2nJObaVAM/2xSQdSq该密码对应的明文是“123456”保存文件并退出按「Esc」键输入「:wq」按回车重启Jenkins服务sudo systemctl restart jenkins重新访问Jenkins使用用户名admin和密码123456登录登录后及时修改密码。六、后续使用建议首次登录后先修改管理员密码「用户」→「admin」→「设置」→「密码」避免使用初始密码或默认密码提高安全性根据需求安装插件常用插件包括“Git”拉取代码、“Pipeline”构建流水线、“Allure”测试报告、“Docker”容器化部署等定期备份Jenkins配置重要配置可通过「系统管理」→「备份Jenkins」插件备份避免配置丢失若需要多人使用可在「系统管理」→「管理用户」中创建多个账号分配不同权限比如开发者、测试人员、管理员。七、总结本文详细讲解了从“连接Linux服务器”到“Jenkins安装配置”的全流程步骤清晰且包含大量新手避坑指南。只要按照步骤一步步执行就能顺利完成Jenkins部署后续可用于构建自动化测试流水线、代码部署等工作。如果在操作过程中遇到其他问题可查看Jenkins日志sudo journalctl -u jenkins或搜索相关报错信息也可以留言咨询