我刚接手一套 Jenkins 环境的时候第一件事永远是先看插件列表。不为别的插件装不上、升级失败、构建任务跑不起来十有八九都跟插件源有关系。而所有 Jenkins 使用者都遇到过同一个噩梦新建任务时提示某个插件缺失点进“可选插件”页面进度条半天不动等十分钟后弹出一串红色报错。说实话绝大多数情况下根本不是 Jenkins 本身的问题就是默认插件源在国外网络链路太差罢了。这篇文章就专门说清楚一件事如何用国内镜像加速 Jenkins 插件下载并且把华为云、腾讯云、清华 TUNA 这三个主流镜像源放在一起对比讲清楚它们的差异、选型逻辑和实操细节。无论你是刚装好 Jenkins 的新手还是已经在生产环境维护了很久的老手照着下面的步骤操作基本都能在 3 分钟内把插件源切换成国内镜像之后再也不用盯着进度条发呆。1. Jenkins 插件下载慢的根源先搞懂请求链路再动手很多教程上来就让你改 URL但改完还会踩各种坑原因就是没搞懂 Jenkins 插件下载到底走了哪条路径。我先把这个链路拆开后面的操作你才能理解为什么那样改。1.1 一条完整的插件下载请求要经过哪些环节Jenkins 在“插件管理”页面展示的所有插件列表并不是它自己脑子里的而是来自一个叫update-center.json升级站点 / 更新中心的索引文件。这个文件里包含了几千个插件的名称、版本号、下载地址、依赖关系等元数据。Jenkins 拿到这个文件才能在界面上渲染出五花八门的插件列表。当你点击某个插件的“下载”按钮时Jenkins 会根据 update-center.json 里记录的这个插件的下载 URL去对应的服务器拉取.hpi文件。所以整个插件下载其实分成两步下载并解析update-center.json索引文件。根据索引里的地址下载实际的插件.hpi包。如果 Jenkins 使用默认配置它访问的是https://updates.jenkins.io/update-center.json。这个地址的服务器在海外从国内访问时DNS 解析、TLS 握手、传输速度都容易出问题。更坑的是即便索引文件下载成功了里面记录的插件.hpi下载地址通常也指向updates.jenkins.io的 CDN下载依然慢得让人崩溃。1.2 慢在哪几个环节镜像源又是怎么解决的说得直白一点慢主要慢在三个环节DNS 解析阶段国内访问海外域名时DNS 解析经常被污染或超时解析出来的 IP 可能不是最优路径。TLS 握手阶段跨海的 HTTPS 连接需要多轮往返延迟高得吓人有时候光握手就要好几秒。数据传输阶段这是大头。插件包动辄几 MB 到几十 MB如果走的是拥堵的国际出口带宽速度能掉到几十 KB/s。国内镜像源做的事情其实很简单粗暴它们定期从 Jenkins 官方源同步update-center.json和插件文件到国内服务器然后提供一个国内用户可以高速访问的 URL。你只需要把 Jenkins 的升级站点地址换成国内镜像请求链路就变成了“国内服务器 → 国内服务器”速度和稳定性自然完全不一样。1.3 为什么我推荐直接改升级站点而不是用代理插件网上还有一种说法是利用 Jenkins 的 HTTP 代理设置或者用 nginx 反代updates.jenkins.io。这些办法理论上可行但都引入了额外的中间组件维护成本高而且代理本身也可能成为瓶颈。改国内镜像源则是一次性配置不依赖任何额外服务所有 Jenkins 节点都能直接生效。所以我的观点很明确能用镜像源解决的事不要绕弯子。注意mirrors.huaweicloud.com、mirrors.cloud.tencent.com、mirrors.tuna.tsinghua.edu.cn 这些镜像域名本身在国内不需要也不应该加任何代理直连即可。2. 三大国内镜像源横向对比华为云、腾讯云、清华 TUNA目前国内能用的 Jenkins 插件镜像源其实不少但用得最多、维护最稳定的就是华为云、腾讯云和清华 TUNA 这三家。有些人可能还听说过中科大源、阿里源但阿里源已经很久没有更新 Jenkins 插件目录了中科大的 Jenkins 镜像也时好时坏我不推荐生产环境去赌运气。下面重点对比这三家。2.1 华为云镜像源速度稳回源及时华为云的开源镜像站地址是https://mirrors.huaweicloud.com/对应的 Jenkins 插件更新中心地址是https://mirrors.huaweicloud.com/jenkins/updates/update-center.json华为云镜像源的特点我在实际使用中最直观的感受是下载速度非常稳定尤其是晚高峰时段其他源可能有波动华为云依然能维持较高的传输速率。它的同步频率很及时插件发布新版本后通常一两天内就能在镜像源里看到。从目录结构上看华为云把 Jenkins 相关的文件放在jenkins/updates/路径下里面不仅有update-center.json还有一个latest/目录存放各个插件的最新版.hpi文件。这也意味着你不光能通过 Jenkins 界面下载还能直接在浏览器里访问镜像目录手动下载任意插件。2.2 腾讯云镜像源大厂背书连接友好腾讯云的镜像站地址是https://mirrors.cloud.tencent.com/Jenkins 插件更新中心地址是https://mirrors.cloud.tencent.com/jenkins/updates/update-center.json腾讯云镜像源和华为云类似也是定期从官方源同步数据。它的优势在于腾讯云服务器在国内占有率很高如果你的 Jenkins 正好部署在腾讯云 CVM 上内网访问这个域名会非常快。我用腾讯云源的一个体会是它解析出来的 IP 和 CDN 节点覆盖面比较广即使 Jenkins 部署的是本地机房或家庭网络速度也不会差。不过腾讯云镜像源偶尔会有更新延迟的情况大版本发布后可能比华为云慢个半天到一天。对于绝大多数生产环境来说这个延迟完全不影响使用除非你急等着某个安全修复插件。2.3 清华 TUNA 镜像源老牌镜像站适合教育网和学术场景清华 TUNA清华大学开源软件镜像站的地址是https://mirrors.tuna.tsinghua.edu.cn/Jenkins 插件更新中心地址是https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json清华源是国内高校圈子里非常有口碑的镜像站历史悠久数据完整性做得好。它的最大优势是教育网内访问速度极快如果你的 Jenkins 部署在高校或科研机构清华源几乎是最佳选择。另外TUNA 团队的技术能力强目录结构规范出问题的概率很低。但清华源的更新频率相对另外两家稍保守一些插件版本偶尔会滞后几天。另外在某些运营商网络下清华源的连接速度不如华为云和腾讯云稳定这个和各家 CDN 节点部署策略有关具体情况要自己实测。2.4 三源对比我该选哪一个我整理了一个对比表方便你直接决策对比维度华为云腾讯云清华 TUNA更新中心 URLmirrors.huaweicloud.com/jenkins/updates/update-center.jsonmirrors.cloud.tencent.com/jenkins/updates/update-center.jsonmirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json同步时效快一两天内中等偶有延迟稍慢可能滞后几天速度稳定性很稳定晚高峰抗压稳定腾讯云 CVM 内网友好教育网极快公网视运营商而定目录结构清晰含 latest/ 目录清晰含 latest/ 目录规范历史数据全适用范围生产环境、公网服务器腾讯云用户、公网服务器高校、科研机构、教育网我给新手的建议很简单公网服务器或生产环境首选华为云腾讯云机器用腾讯云源教育网环境选清华源。这三个源没有必要反复横跳选一个稳定的用着就行。如果你实在拿不定主意先按本文第三章的方法把华为云源配上实测一段时间再考虑切换。3. 实操环节3 分钟切换国内镜像三种方式任选接下来进入正题。我把切换镜像源的方法分成三种场景图形界面操作、配置文件操作、离线环境操作。你只需要看自己属于哪种场景按对应步骤做就行。3.1 最直接的方式从 Jenkins 网页界面修改升级站点这是适合绝大多数人的方式全程鼠标操作不需要碰服务器文件。第一步进入 Jenkins 管理后台点击左侧菜单的“Manage Jenkins”系统管理。第二步在系统管理页面找到“Plugins”插件管理进入后点击顶部的“Advanced settings”高级设置。第三步在页面滚动到“Update Site”升级站点区域你会看到一个 URL 输入框默认是https://updates.jenkins.io/update-center.json。第四步把这个 URL 替换成你要用的国内镜像地址比如华为云的https://mirrors.huaweicloud.com/jenkins/updates/update-center.json第五步点击页面底部的“Submit”提交。然后回到“插件管理”的“可选插件”标签页点击“Check now”立即检查正常情况下你会看到插件列表快速加载出来速度和之前天差地别。这里面最容易失败的一个隐蔽点是有些旧版本 Jenkins 的“高级设置”页不在“插件管理”里而是在“系统管理 → 管理插件 → 高级”里面。不同版本的菜单名称可能有点差异但核心路径就是“插件管理 → 高级设置 → 升级站点”。找不到就多点点看别死磕一个入口。3.2 适合批量交付和自动化直接改 Jenkins 配置文件如果你要管理多台 Jenkins或者想通过配置管理工具比如 Ansible统一部署那么在界面上一个个点就太慢了。直接改配置文件更高效。Jenkins 的升级站点配置存放在/var/lib/jenkins/hudson.model.UpdateCenter.xml具体路径取决于你的 JENKINS_HOME 位置这个文件里。默认内容大概是这样的?xml version1.1 encodingUTF-8? sites site iddefault/id urlhttps://updates.jenkins.io/update-center.json/url /site /sites你只需要把url标签里的内容替换成国内镜像地址保存文件然后重启 Jenkins或者直接去界面上点击“Check now”配置就会生效。?xml version1.1 encodingUTF-8? sites site iddefault/id urlhttps://mirrors.huaweicloud.com/jenkins/updates/update-center.json/url /site /sites这里有一个经验要分享如果 Jenkins 正在运行你直接改这个文件后再去界面点“立即检查”有时候不会立刻生效因为它可能已经把旧配置读取到内存里了。最稳妥的做法是改完文件后重启 Jenkins 服务或者至少通过“Manage Jenkins → Reload configuration from disk”重载一下配置。另外有些 Jenkins 是通过 Docker 容器运行的JENKINS_HOME 往往挂载在宿主机的一个 volume 里。你需要先找到宿主机上的对应目录再去修改文件。可以用docker inspect查看挂载路径别进容器里改了因为容器重建后文件又没了。3.3 离线环境怎么办手动下载插件包再上传有些情况连国内镜像都访问不了比如内网隔离环境或者公司防火墙限制严格。这时候唯一的方案是先在一台能上网的机器上下载好插件.hpi文件然后通过 Jenkins 的“高级上传”功能安装。具体操作是先访问镜像站的插件目录比如华为云的https://mirrors.huaweicloud.com/jenkins/updates/latest/这个页面会列出所有插件的最新版.hpi文件很大的一串列表。你可以用浏览器搜索功能找到需要的插件比如git.hpi、pipeline-stage-view.hpi下载到本地。然后到 Jenkins 的“插件管理 → 高级设置”页面找到“Deploy Plugin”部署插件区域点击“Browse”选择本地的.hpi文件再点击“Deploy”上传。上传成功后Jenkins 会自动安装该插件并提示重启。离线安装的一个坑是插件依赖。比如你要装pipeline-stage-view它可能依赖pipeline-rest-api如果只上传一个文件安装会报错提示缺依赖。解决思路是在镜像目录中把相关依赖一并下载。怎么看依赖可以打开 JSON 文件搜索插件名或者直接用“可选插件”页面查看依赖关系。最省事的做法是下载插件时把名字相近的插件也顺手拉下来缺什么补什么。3.4 验证镜像源生效如何确认真的切换成功改完配置后强烈建议做一次验证确保万无一失。验证方法是在浏览器直接访问配置的镜像 URL看返回的内容是不是 JSON。比如访问华为云的地址你会看到一大段 JSON开头长这样{ connectionCheckUrl: http://www.google.com/, ... }注意connectionCheckUrl是指向 Google 的这个字段在镜像源里一般也是从官方源原样同步过来的。由于 Jenkins 启动时会尝试访问这个地址做连通性检查在国内网络环境下访问 Google 会超时于是有些版本的 Jenkins 日志里会报一个警告。这属于正常现象不影响插件下载功能不需要过度纠结。另外一个验证方式更简单去“插件管理 → 可选插件”页面点“Check now”观察加载速度和列表内容。如果之前加载要等三五分钟现在几秒钟就出来了说明镜像源已经生效。4. 常见问题与排查技巧实录前面把配置步骤讲完了但实际运维中你还会遇到各种奇奇怪怪的问题。我把这些年被问得最多的几个问题整理成一份排查清单值回票价的部分就在这一节。4.1 升级站点地址明明改了为什么日志里还在连官方源这个问题非常经典。出现这种情况九成是因为 Jenkins 的 UpdateCenter 配置除了hudson.model.UpdateCenter.xml之外还有一个jenkins.model.UpdateCenter.xml或类似的历史配置残留。有些插件比如 Configuration as Code 插件也会在启动时注入自己的更新中心配置覆盖你手动设置的地址。排查思路是进入$JENKINS_HOME目录搜索所有包含updates.jenkins.io的文件grep -r updates.jenkins.io /var/lib/jenkins/把搜到的文件逐一查看特别是 XML、YAML、JSON 文件确认是否存在多处配置。另外如果你用了 Jenkins CasCConfiguration as Code插件那更新中心地址很可能是在 YAML 配置里写死的此时要修改 YAML 文件而不是改界面配置。4.2 点击“立即检查”后报错证书验证失败Jenkins 在下载 update-center.json 时是走 HTTPS 的如果 Jenkins 所在机器的 Java 环境没有信任镜像站的 SSL 证书或者 Java 版本太老导致 TLS 协议不兼容就会报 SSL 错误。解决办法有三个方向更新 Java 版本Jenkins 长期支持版本对 Java 有明确要求太老的 Java 8 版本对现代 TLS 协议支持不佳。先把 Java 升级到官方推荐的版本。导入证书到 Java 信任库在浏览器里导出镜像站证书然后用keytool导入到 JDK 的cacerts信任库。临时绕过 SSL 验证说实话我不太推荐但在内网测试环境可以临时用 HTTP 地址访问镜像站的 update-center.json。比如某些镜像站确实提供 HTTP 访问入口改一下 URL 协议就能绕过证书问题。生产环境别这么干明文传输有安全风险。4.3 插件列表加载出来了但下载某个插件时还是失败这种情况往往是插件的.hpi文件路径在镜像源上不存在导致的。可能的原因有两个一是镜像源同步不完整某些冷门插件没有被同步过来。遇到这种情况只能等镜像源下一次同步或者手动去官方源下载插件文件通过“Deploy Plugin”上传。二是 Jenkins 版本和插件版本不兼容。镜像源同步的是最新版插件如果你的 Jenkins 版本较老新版插件要求的 Jenkins 核心版本高于你当前版本安装就会失败。常见解决方法是去镜像目录的latest/下面找旧一点的插件版本或者先升级 Jenkins 到较新版本再装插件。4.4 修改配置后界面仍然显示默认地址刷新也没用这个问题的原因通常是浏览器缓存或 Jenkins 前端缓存。遇到这种情况先不要怀疑配置没生效试试强制刷新页面CtrlF5 或 CmdShiftR或者退出重新登录 Jenkins。如果还不行检查是否有反向代理nginx把页面做了缓存清除代理缓存再看。4.5 update-center.json 文件返回内容异常有时候浏览器访问镜像地址返回的不是 JSON 而是 XML 错误或者 404。这种情况大概率是镜像站临时故障或路径拼写错误。务必检查 URL 是否多打了/或者少打了某个单词。华为云的路径是/jenkins/updates/update-center.json腾讯云是/jenkins/updates/update-center.json清华是/jenkins/updates/update-center.json三者路径结构一样不要和官方源的路径搞混。4.6 镜像源配置正确但下载速度还是上不去如果镜像源配置正确但下载插件依然慢需要排查本地网络和 Jenkins 服务器所在网络。我用过一个客户的环境Jenkins 部署在阿里云但镜像源选了清华结果速度反而不理想。后来换成华为云速度瞬间就上来了。这说明镜像源和服务器之间也存在网络路径差异选源不能只看名气实测速度才是硬道理。另一个常见原因是服务器上配置了全局 HTTP 代理导致所有 Jenkins 的 HTTP 请求都走了代理通道反而绕远路了。检查系统环境变量HTTP_PROXY、HTTPS_PROXY以及 Jenkins 启动参数中是否配置了-Dhttp.proxyHost有的话先清掉再测速。4.7 插件安装成功但构建时报找不到类或版本冲突这个问题表面上和镜像源无关但实际上是插件版本升级后引入的破坏性变更导致的。镜像源会同步最新插件版本你从镜像源装到的插件可能是几天前刚发的新版本而新版本往往和旧插件存在兼容性问题。我之前接手的一个项目就遇到过用镜像源升级了git插件后原来的构建任务报NoSuchMethodError最后排查是插件 API 变了某些依赖插件没跟上。解决方法是在测试环境先升级插件验证没问题再上生产或者把插件版本锁定在某个已知稳定的版本不要一味追求最新。5. 再多说一点镜像加速后的日常维护心得配置好镜像源只是第一步后续的日常维护同样需要注意。把我这几年积累的一些心得写在这里希望对你有帮助。5.1 定期检查插件更新但别盲目更新很多人配好插件源之后就把插件更新这件事抛到脑后直到某天构建突然报错才发现插件有问题。我个人的做法是每两周到一个月检查一次插件更新重点关注安全更新类插件比如 Credentials Binding、Pipeline 相关插件和当前项目正在用的核心插件。检查更新的时候利用镜像源提供的“可选插件”页面可以快速看到哪些插件有新版本。不过更新之前一定看一下更新日志去插件官网或 GitHub 页面确认新版本没有破坏性变更。5.2 多 Jenkins 节点时统一版本很重要如果你的环境里有多个 Jenkins 实例比如开发环境、测试环境、生产环境建议统一使用同一个镜像源并且尽量保持插件版本一致。否则你在开发环境验证通过的任务到生产环境可能因为插件版本不同而行为不一致。网上有很多配置管理工具如 Ansible可以实现 Jenkins 配置和插件版本管理有机会可以研究一下。5.3 镜像源也是会挂的保留回退方案没有任何镜像源能保证 100% 可用。华为云、腾讯云、清华源虽然整体非常稳定但历史上也有过同步延迟或偶发故障的情况。所以我的建议是把三个源的 URL 记下来一旦当前源出现问题能迅速切换到另一个源。另外离线安装所需的.hpi文件最好在本地也留一份备份关键时刻能救命。5.4 从下载到安装再到构建形成一套完整的验证流程切换镜像源后我一般会跑一个完整的“冒烟测试”检查镜像源 URL 访问是否正常。在插件管理页面点“立即检查”看列表加载时长。安装一个项目必需的插件确认无报错。跑一个最简单的构建任务确认 Jenkins 整体功能正常。这套流程做完基本可以确定镜像源配置没有影响 Jenkins 的正常使用。如果是生产环境建议在低峰期进行操作避免影响线上任务。我个人在实际操作中最大的感受是Jenkins 插件源的问题说到底就是一个网络可达性的问题不是什么高深技术。找对了国内镜像三分钟就能解决找错了方向时间都浪费在等待和排错上。希望这篇分享能帮你少走一些弯路也欢迎在实际操作中遇到了问题回来评论区交流。 Jenkins插件下载慢？三大国内镜像源对比与切换实战指南
我刚接手一套 Jenkins 环境的时候第一件事永远是先看插件列表。不为别的插件装不上、升级失败、构建任务跑不起来十有八九都跟插件源有关系。而所有 Jenkins 使用者都遇到过同一个噩梦新建任务时提示某个插件缺失点进“可选插件”页面进度条半天不动等十分钟后弹出一串红色报错。说实话绝大多数情况下根本不是 Jenkins 本身的问题就是默认插件源在国外网络链路太差罢了。这篇文章就专门说清楚一件事如何用国内镜像加速 Jenkins 插件下载并且把华为云、腾讯云、清华 TUNA 这三个主流镜像源放在一起对比讲清楚它们的差异、选型逻辑和实操细节。无论你是刚装好 Jenkins 的新手还是已经在生产环境维护了很久的老手照着下面的步骤操作基本都能在 3 分钟内把插件源切换成国内镜像之后再也不用盯着进度条发呆。1. Jenkins 插件下载慢的根源先搞懂请求链路再动手很多教程上来就让你改 URL但改完还会踩各种坑原因就是没搞懂 Jenkins 插件下载到底走了哪条路径。我先把这个链路拆开后面的操作你才能理解为什么那样改。1.1 一条完整的插件下载请求要经过哪些环节Jenkins 在“插件管理”页面展示的所有插件列表并不是它自己脑子里的而是来自一个叫update-center.json升级站点 / 更新中心的索引文件。这个文件里包含了几千个插件的名称、版本号、下载地址、依赖关系等元数据。Jenkins 拿到这个文件才能在界面上渲染出五花八门的插件列表。当你点击某个插件的“下载”按钮时Jenkins 会根据 update-center.json 里记录的这个插件的下载 URL去对应的服务器拉取.hpi文件。所以整个插件下载其实分成两步下载并解析update-center.json索引文件。根据索引里的地址下载实际的插件.hpi包。如果 Jenkins 使用默认配置它访问的是https://updates.jenkins.io/update-center.json。这个地址的服务器在海外从国内访问时DNS 解析、TLS 握手、传输速度都容易出问题。更坑的是即便索引文件下载成功了里面记录的插件.hpi下载地址通常也指向updates.jenkins.io的 CDN下载依然慢得让人崩溃。1.2 慢在哪几个环节镜像源又是怎么解决的说得直白一点慢主要慢在三个环节DNS 解析阶段国内访问海外域名时DNS 解析经常被污染或超时解析出来的 IP 可能不是最优路径。TLS 握手阶段跨海的 HTTPS 连接需要多轮往返延迟高得吓人有时候光握手就要好几秒。数据传输阶段这是大头。插件包动辄几 MB 到几十 MB如果走的是拥堵的国际出口带宽速度能掉到几十 KB/s。国内镜像源做的事情其实很简单粗暴它们定期从 Jenkins 官方源同步update-center.json和插件文件到国内服务器然后提供一个国内用户可以高速访问的 URL。你只需要把 Jenkins 的升级站点地址换成国内镜像请求链路就变成了“国内服务器 → 国内服务器”速度和稳定性自然完全不一样。1.3 为什么我推荐直接改升级站点而不是用代理插件网上还有一种说法是利用 Jenkins 的 HTTP 代理设置或者用 nginx 反代updates.jenkins.io。这些办法理论上可行但都引入了额外的中间组件维护成本高而且代理本身也可能成为瓶颈。改国内镜像源则是一次性配置不依赖任何额外服务所有 Jenkins 节点都能直接生效。所以我的观点很明确能用镜像源解决的事不要绕弯子。注意mirrors.huaweicloud.com、mirrors.cloud.tencent.com、mirrors.tuna.tsinghua.edu.cn 这些镜像域名本身在国内不需要也不应该加任何代理直连即可。2. 三大国内镜像源横向对比华为云、腾讯云、清华 TUNA目前国内能用的 Jenkins 插件镜像源其实不少但用得最多、维护最稳定的就是华为云、腾讯云和清华 TUNA 这三家。有些人可能还听说过中科大源、阿里源但阿里源已经很久没有更新 Jenkins 插件目录了中科大的 Jenkins 镜像也时好时坏我不推荐生产环境去赌运气。下面重点对比这三家。2.1 华为云镜像源速度稳回源及时华为云的开源镜像站地址是https://mirrors.huaweicloud.com/对应的 Jenkins 插件更新中心地址是https://mirrors.huaweicloud.com/jenkins/updates/update-center.json华为云镜像源的特点我在实际使用中最直观的感受是下载速度非常稳定尤其是晚高峰时段其他源可能有波动华为云依然能维持较高的传输速率。它的同步频率很及时插件发布新版本后通常一两天内就能在镜像源里看到。从目录结构上看华为云把 Jenkins 相关的文件放在jenkins/updates/路径下里面不仅有update-center.json还有一个latest/目录存放各个插件的最新版.hpi文件。这也意味着你不光能通过 Jenkins 界面下载还能直接在浏览器里访问镜像目录手动下载任意插件。2.2 腾讯云镜像源大厂背书连接友好腾讯云的镜像站地址是https://mirrors.cloud.tencent.com/Jenkins 插件更新中心地址是https://mirrors.cloud.tencent.com/jenkins/updates/update-center.json腾讯云镜像源和华为云类似也是定期从官方源同步数据。它的优势在于腾讯云服务器在国内占有率很高如果你的 Jenkins 正好部署在腾讯云 CVM 上内网访问这个域名会非常快。我用腾讯云源的一个体会是它解析出来的 IP 和 CDN 节点覆盖面比较广即使 Jenkins 部署的是本地机房或家庭网络速度也不会差。不过腾讯云镜像源偶尔会有更新延迟的情况大版本发布后可能比华为云慢个半天到一天。对于绝大多数生产环境来说这个延迟完全不影响使用除非你急等着某个安全修复插件。2.3 清华 TUNA 镜像源老牌镜像站适合教育网和学术场景清华 TUNA清华大学开源软件镜像站的地址是https://mirrors.tuna.tsinghua.edu.cn/Jenkins 插件更新中心地址是https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json清华源是国内高校圈子里非常有口碑的镜像站历史悠久数据完整性做得好。它的最大优势是教育网内访问速度极快如果你的 Jenkins 部署在高校或科研机构清华源几乎是最佳选择。另外TUNA 团队的技术能力强目录结构规范出问题的概率很低。但清华源的更新频率相对另外两家稍保守一些插件版本偶尔会滞后几天。另外在某些运营商网络下清华源的连接速度不如华为云和腾讯云稳定这个和各家 CDN 节点部署策略有关具体情况要自己实测。2.4 三源对比我该选哪一个我整理了一个对比表方便你直接决策对比维度华为云腾讯云清华 TUNA更新中心 URLmirrors.huaweicloud.com/jenkins/updates/update-center.jsonmirrors.cloud.tencent.com/jenkins/updates/update-center.jsonmirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json同步时效快一两天内中等偶有延迟稍慢可能滞后几天速度稳定性很稳定晚高峰抗压稳定腾讯云 CVM 内网友好教育网极快公网视运营商而定目录结构清晰含 latest/ 目录清晰含 latest/ 目录规范历史数据全适用范围生产环境、公网服务器腾讯云用户、公网服务器高校、科研机构、教育网我给新手的建议很简单公网服务器或生产环境首选华为云腾讯云机器用腾讯云源教育网环境选清华源。这三个源没有必要反复横跳选一个稳定的用着就行。如果你实在拿不定主意先按本文第三章的方法把华为云源配上实测一段时间再考虑切换。3. 实操环节3 分钟切换国内镜像三种方式任选接下来进入正题。我把切换镜像源的方法分成三种场景图形界面操作、配置文件操作、离线环境操作。你只需要看自己属于哪种场景按对应步骤做就行。3.1 最直接的方式从 Jenkins 网页界面修改升级站点这是适合绝大多数人的方式全程鼠标操作不需要碰服务器文件。第一步进入 Jenkins 管理后台点击左侧菜单的“Manage Jenkins”系统管理。第二步在系统管理页面找到“Plugins”插件管理进入后点击顶部的“Advanced settings”高级设置。第三步在页面滚动到“Update Site”升级站点区域你会看到一个 URL 输入框默认是https://updates.jenkins.io/update-center.json。第四步把这个 URL 替换成你要用的国内镜像地址比如华为云的https://mirrors.huaweicloud.com/jenkins/updates/update-center.json第五步点击页面底部的“Submit”提交。然后回到“插件管理”的“可选插件”标签页点击“Check now”立即检查正常情况下你会看到插件列表快速加载出来速度和之前天差地别。这里面最容易失败的一个隐蔽点是有些旧版本 Jenkins 的“高级设置”页不在“插件管理”里而是在“系统管理 → 管理插件 → 高级”里面。不同版本的菜单名称可能有点差异但核心路径就是“插件管理 → 高级设置 → 升级站点”。找不到就多点点看别死磕一个入口。3.2 适合批量交付和自动化直接改 Jenkins 配置文件如果你要管理多台 Jenkins或者想通过配置管理工具比如 Ansible统一部署那么在界面上一个个点就太慢了。直接改配置文件更高效。Jenkins 的升级站点配置存放在/var/lib/jenkins/hudson.model.UpdateCenter.xml具体路径取决于你的 JENKINS_HOME 位置这个文件里。默认内容大概是这样的?xml version1.1 encodingUTF-8? sites site iddefault/id urlhttps://updates.jenkins.io/update-center.json/url /site /sites你只需要把url标签里的内容替换成国内镜像地址保存文件然后重启 Jenkins或者直接去界面上点击“Check now”配置就会生效。?xml version1.1 encodingUTF-8? sites site iddefault/id urlhttps://mirrors.huaweicloud.com/jenkins/updates/update-center.json/url /site /sites这里有一个经验要分享如果 Jenkins 正在运行你直接改这个文件后再去界面点“立即检查”有时候不会立刻生效因为它可能已经把旧配置读取到内存里了。最稳妥的做法是改完文件后重启 Jenkins 服务或者至少通过“Manage Jenkins → Reload configuration from disk”重载一下配置。另外有些 Jenkins 是通过 Docker 容器运行的JENKINS_HOME 往往挂载在宿主机的一个 volume 里。你需要先找到宿主机上的对应目录再去修改文件。可以用docker inspect查看挂载路径别进容器里改了因为容器重建后文件又没了。3.3 离线环境怎么办手动下载插件包再上传有些情况连国内镜像都访问不了比如内网隔离环境或者公司防火墙限制严格。这时候唯一的方案是先在一台能上网的机器上下载好插件.hpi文件然后通过 Jenkins 的“高级上传”功能安装。具体操作是先访问镜像站的插件目录比如华为云的https://mirrors.huaweicloud.com/jenkins/updates/latest/这个页面会列出所有插件的最新版.hpi文件很大的一串列表。你可以用浏览器搜索功能找到需要的插件比如git.hpi、pipeline-stage-view.hpi下载到本地。然后到 Jenkins 的“插件管理 → 高级设置”页面找到“Deploy Plugin”部署插件区域点击“Browse”选择本地的.hpi文件再点击“Deploy”上传。上传成功后Jenkins 会自动安装该插件并提示重启。离线安装的一个坑是插件依赖。比如你要装pipeline-stage-view它可能依赖pipeline-rest-api如果只上传一个文件安装会报错提示缺依赖。解决思路是在镜像目录中把相关依赖一并下载。怎么看依赖可以打开 JSON 文件搜索插件名或者直接用“可选插件”页面查看依赖关系。最省事的做法是下载插件时把名字相近的插件也顺手拉下来缺什么补什么。3.4 验证镜像源生效如何确认真的切换成功改完配置后强烈建议做一次验证确保万无一失。验证方法是在浏览器直接访问配置的镜像 URL看返回的内容是不是 JSON。比如访问华为云的地址你会看到一大段 JSON开头长这样{ connectionCheckUrl: http://www.google.com/, ... }注意connectionCheckUrl是指向 Google 的这个字段在镜像源里一般也是从官方源原样同步过来的。由于 Jenkins 启动时会尝试访问这个地址做连通性检查在国内网络环境下访问 Google 会超时于是有些版本的 Jenkins 日志里会报一个警告。这属于正常现象不影响插件下载功能不需要过度纠结。另外一个验证方式更简单去“插件管理 → 可选插件”页面点“Check now”观察加载速度和列表内容。如果之前加载要等三五分钟现在几秒钟就出来了说明镜像源已经生效。4. 常见问题与排查技巧实录前面把配置步骤讲完了但实际运维中你还会遇到各种奇奇怪怪的问题。我把这些年被问得最多的几个问题整理成一份排查清单值回票价的部分就在这一节。4.1 升级站点地址明明改了为什么日志里还在连官方源这个问题非常经典。出现这种情况九成是因为 Jenkins 的 UpdateCenter 配置除了hudson.model.UpdateCenter.xml之外还有一个jenkins.model.UpdateCenter.xml或类似的历史配置残留。有些插件比如 Configuration as Code 插件也会在启动时注入自己的更新中心配置覆盖你手动设置的地址。排查思路是进入$JENKINS_HOME目录搜索所有包含updates.jenkins.io的文件grep -r updates.jenkins.io /var/lib/jenkins/把搜到的文件逐一查看特别是 XML、YAML、JSON 文件确认是否存在多处配置。另外如果你用了 Jenkins CasCConfiguration as Code插件那更新中心地址很可能是在 YAML 配置里写死的此时要修改 YAML 文件而不是改界面配置。4.2 点击“立即检查”后报错证书验证失败Jenkins 在下载 update-center.json 时是走 HTTPS 的如果 Jenkins 所在机器的 Java 环境没有信任镜像站的 SSL 证书或者 Java 版本太老导致 TLS 协议不兼容就会报 SSL 错误。解决办法有三个方向更新 Java 版本Jenkins 长期支持版本对 Java 有明确要求太老的 Java 8 版本对现代 TLS 协议支持不佳。先把 Java 升级到官方推荐的版本。导入证书到 Java 信任库在浏览器里导出镜像站证书然后用keytool导入到 JDK 的cacerts信任库。临时绕过 SSL 验证说实话我不太推荐但在内网测试环境可以临时用 HTTP 地址访问镜像站的 update-center.json。比如某些镜像站确实提供 HTTP 访问入口改一下 URL 协议就能绕过证书问题。生产环境别这么干明文传输有安全风险。4.3 插件列表加载出来了但下载某个插件时还是失败这种情况往往是插件的.hpi文件路径在镜像源上不存在导致的。可能的原因有两个一是镜像源同步不完整某些冷门插件没有被同步过来。遇到这种情况只能等镜像源下一次同步或者手动去官方源下载插件文件通过“Deploy Plugin”上传。二是 Jenkins 版本和插件版本不兼容。镜像源同步的是最新版插件如果你的 Jenkins 版本较老新版插件要求的 Jenkins 核心版本高于你当前版本安装就会失败。常见解决方法是去镜像目录的latest/下面找旧一点的插件版本或者先升级 Jenkins 到较新版本再装插件。4.4 修改配置后界面仍然显示默认地址刷新也没用这个问题的原因通常是浏览器缓存或 Jenkins 前端缓存。遇到这种情况先不要怀疑配置没生效试试强制刷新页面CtrlF5 或 CmdShiftR或者退出重新登录 Jenkins。如果还不行检查是否有反向代理nginx把页面做了缓存清除代理缓存再看。4.5 update-center.json 文件返回内容异常有时候浏览器访问镜像地址返回的不是 JSON 而是 XML 错误或者 404。这种情况大概率是镜像站临时故障或路径拼写错误。务必检查 URL 是否多打了/或者少打了某个单词。华为云的路径是/jenkins/updates/update-center.json腾讯云是/jenkins/updates/update-center.json清华是/jenkins/updates/update-center.json三者路径结构一样不要和官方源的路径搞混。4.6 镜像源配置正确但下载速度还是上不去如果镜像源配置正确但下载插件依然慢需要排查本地网络和 Jenkins 服务器所在网络。我用过一个客户的环境Jenkins 部署在阿里云但镜像源选了清华结果速度反而不理想。后来换成华为云速度瞬间就上来了。这说明镜像源和服务器之间也存在网络路径差异选源不能只看名气实测速度才是硬道理。另一个常见原因是服务器上配置了全局 HTTP 代理导致所有 Jenkins 的 HTTP 请求都走了代理通道反而绕远路了。检查系统环境变量HTTP_PROXY、HTTPS_PROXY以及 Jenkins 启动参数中是否配置了-Dhttp.proxyHost有的话先清掉再测速。4.7 插件安装成功但构建时报找不到类或版本冲突这个问题表面上和镜像源无关但实际上是插件版本升级后引入的破坏性变更导致的。镜像源会同步最新插件版本你从镜像源装到的插件可能是几天前刚发的新版本而新版本往往和旧插件存在兼容性问题。我之前接手的一个项目就遇到过用镜像源升级了git插件后原来的构建任务报NoSuchMethodError最后排查是插件 API 变了某些依赖插件没跟上。解决方法是在测试环境先升级插件验证没问题再上生产或者把插件版本锁定在某个已知稳定的版本不要一味追求最新。5. 再多说一点镜像加速后的日常维护心得配置好镜像源只是第一步后续的日常维护同样需要注意。把我这几年积累的一些心得写在这里希望对你有帮助。5.1 定期检查插件更新但别盲目更新很多人配好插件源之后就把插件更新这件事抛到脑后直到某天构建突然报错才发现插件有问题。我个人的做法是每两周到一个月检查一次插件更新重点关注安全更新类插件比如 Credentials Binding、Pipeline 相关插件和当前项目正在用的核心插件。检查更新的时候利用镜像源提供的“可选插件”页面可以快速看到哪些插件有新版本。不过更新之前一定看一下更新日志去插件官网或 GitHub 页面确认新版本没有破坏性变更。5.2 多 Jenkins 节点时统一版本很重要如果你的环境里有多个 Jenkins 实例比如开发环境、测试环境、生产环境建议统一使用同一个镜像源并且尽量保持插件版本一致。否则你在开发环境验证通过的任务到生产环境可能因为插件版本不同而行为不一致。网上有很多配置管理工具如 Ansible可以实现 Jenkins 配置和插件版本管理有机会可以研究一下。5.3 镜像源也是会挂的保留回退方案没有任何镜像源能保证 100% 可用。华为云、腾讯云、清华源虽然整体非常稳定但历史上也有过同步延迟或偶发故障的情况。所以我的建议是把三个源的 URL 记下来一旦当前源出现问题能迅速切换到另一个源。另外离线安装所需的.hpi文件最好在本地也留一份备份关键时刻能救命。5.4 从下载到安装再到构建形成一套完整的验证流程切换镜像源后我一般会跑一个完整的“冒烟测试”检查镜像源 URL 访问是否正常。在插件管理页面点“立即检查”看列表加载时长。安装一个项目必需的插件确认无报错。跑一个最简单的构建任务确认 Jenkins 整体功能正常。这套流程做完基本可以确定镜像源配置没有影响 Jenkins 的正常使用。如果是生产环境建议在低峰期进行操作避免影响线上任务。我个人在实际操作中最大的感受是Jenkins 插件源的问题说到底就是一个网络可达性的问题不是什么高深技术。找对了国内镜像三分钟就能解决找错了方向时间都浪费在等待和排错上。希望这篇分享能帮你少走一些弯路也欢迎在实际操作中遇到了问题回来评论区交流。