团队里的开发机和 CI 服务器如果各自从公网下载 Maven 依赖,同一个构件会被反复拉取。网络不稳定时,构建也可能卡在下载环节。用 Nexus Repository Manager 作为统一入口,并让它代理阿里云 Maven 镜像,可以把依赖缓存在内网,减少重复下载。下面以 Maven 项目为例,说明 Nexus 使用阿里云镜像的配置方法和常见排查步骤。
先理清 Nexus 与阿里云镜像的关系
Nexus 不会自动把阿里云镜像纳入自己的仓库。常见配置是先创建一个 Maven 代理仓库(Proxy),把阿里云镜像地址设为上游;再创建仓库组(Group),将代理仓库与团队自建的 Hosted 仓库组合起来。开发者使用仓库组地址即可:依赖已有缓存时由 Nexus 直接返回,没有缓存时再由 Nexus 向上游请求。
这三类仓库各有用途:Hosted 保存公司内部构件,Proxy 代理外部仓库,Group 则提供统一访问地址。如果团队还要使用 Maven Central 等其他上游,可以把相应的代理仓库也加入 Group。这样,项目通常只需配置一个仓库组地址,不必分别维护内部和外部仓库。
在 Nexus 中配置阿里云代理仓库
- 确认版本和权限。登录 Nexus 管理页面,确认账号有创建仓库的权限。不同版本的菜单名称和字段位置可能不完全相同,配置时按代理仓库的用途和字段说明核对即可。
- 新建 Maven 代理仓库。进入仓库设置页面,创建 Maven 2(proxy)类型仓库,名称可设为
maven-aliyun,方便后续识别和维护。 - 填写上游地址。在 Remote storage 一类的字段中填入
https://maven.aliyun.com/repository/public。留意不要把 Nexus 自身的访问地址填到这里;Nexus 需要连接的是上游镜像。 - 检查连接状态。保存后查看仓库状态。如果页面提供连接测试或健康检查,可以运行一次。测试失败时,先确认 Nexus 所在服务器能否解析并访问该域名,再检查 HTTPS 请求是否被网络策略拦截。
- 把代理仓库加入 Group。编辑已有的 Maven 仓库组,或新建一个 Group,将
maven-aliyun加入成员列表。需要从 Nexus 获取内部构件时,也把相应的 Hosted 仓库加入同一个组。
配置完成后,客户端应使用仓库组 URL,而不是直接访问 maven-aliyun。仓库组地址可在 Nexus 的仓库详情页查看,常见形式类似 http://nexus.example.com/repository/maven-public/。这里的域名和仓库名只是示例,实际地址以部署环境为准。
配置 Maven 客户端
在开发机和 CI 节点的 Maven settings.xml 中,可以配置镜像,让 Maven 请求统一经过 Nexus 仓库组:
<mirrors>
<mirror>
<id>company-nexus</id>
<mirrorOf>*</mirrorOf>
<url>http://nexus.example.com/repository/maven-public/</url>
</mirror>
</mirrors>
mirrorOf 设置为 * 后,Maven 对仓库的请求都会通过这个镜像入口。若 Nexus 使用 HTTPS,需将示例 URL 换成实际的 HTTPS 地址;若仓库启用了登录认证,还要在 settings.xml 的 servers 部分配置账号信息,并让其中的 ID 与镜像配置的 ID 对应。
不要把真实密码提交到项目代码仓库。个人环境可以使用受控的本地配置,CI 则应通过凭据管理配置认证信息。如果团队不打算拦截所有仓库请求,可将 mirrorOf 改为指定的仓库 ID,或按团队策略设置排除规则。
配置后运行 mvn -U clean package 验证下载过程。第一次构建仍需要由 Nexus 从上游拉取尚未缓存的依赖;后续构建请求相同版本时,通常可以直接读取 Nexus 缓存。排查时也要确认构建实际使用的是这份 settings.xml,尤其是 CI 中可能存在多个 Maven 配置文件。
让 CI 构建复用依赖缓存
例如,一个有十几名 Java 开发人员的团队,每天通过 CI 构建多个服务。过去每台机器都独立访问公网,网络波动会导致构建失败,同一版本的依赖也会被不同机器重复下载。团队部署内网 Nexus 后,创建阿里云 Maven 代理仓库,将其加入 maven-public 仓库组,再把开发机和 CI 的镜像地址统一指向这个组。
第一次构建时,Nexus 从阿里云镜像获取依赖并保存缓存;其他开发机或 CI 任务请求相同版本时,可以从 Nexus 读取。团队还可以把内部公共组件发布到 Hosted 仓库,并加入同一个 Group,项目只需通过统一入口获取两类构件。
这能减少重复下载,但不能保证上游服务始终可用。重要构建仍应锁定依赖版本,并结合缓存备份和网络监控。若构建需要长期可重复,建议检查关键依赖是否已进入 Nexus 缓存,避免在上游暂时不可访问时才发现构件尚未下载。
常见问题与排查方法
- 依赖下载仍然失败:先查看 Maven 实际请求的 URL,确认它指向 Nexus 仓库组,而不是拼错的地址或单独的代理仓库。接着检查 Nexus 日志和代理仓库状态;服务器无法访问上游、证书异常或代理配置错误,都可能让请求失败。
- 修改配置后仍拿到旧结果:Nexus 可能缓存了之前的失败响应。可以在管理界面执行失效缓存(Invalidate Cache),再重新构建。若问题只在某台机器出现,也要考虑 Maven 本地仓库缓存,并针对具体依赖清理本地缓存。
- SNAPSHOT 依赖无法获取:公共镜像的同步范围和更新策略未必符合项目需求。团队自己的快照版本应发布到 Hosted 仓库;如果必须代理远程 SNAPSHOT,先确认上游确实提供该版本,再检查 Nexus 仓库的更新策略。
- 只建了代理仓库,没有配置仓库组:客户端可能无法通过统一入口访问内部构件。将代理仓库和需要使用的 Hosted 仓库加入同一个 Group,再把 Group URL 配置到 Maven 中。
上线前检查仓库配置
Nexus 使用阿里云镜像的配置路径是:创建阿里云 Maven 代理仓库,将它加入仓库组,再让 Maven 客户端指向仓库组。上线前可以用一个普通外部依赖、一个内部构件和项目需要的 SNAPSHOT 版本分别测试,确认下载路径符合预期。
日常维护时,留意代理仓库状态、缓存和服务器到上游的网络连接。出现问题后,先区分是 Maven 客户端配置、本地缓存,还是 Nexus 到上游的连接异常,再按对应位置排查,会比反复修改项目依赖配置更直接。