Nexus3最佳实践系列:搭建Docker私有仓库

Nexus3最佳实践系列:搭建Docker私有仓库

💡 原文中文,约6800字,阅读约需17分钟。
📝

内容提要

文章介绍用Docker部署Nexus3搭建私有仓库,支持Maven、yum、npm、Docker等多种仓库类型。部署后配置Blob存储,创建Docker代理、本地和聚合三类仓库。针对聚合仓库无法推送镜像的问题,用Nginx按GET/PUT请求分流至拉取和推送端口,并配置自签名SSL证书及客户端证书导入脚本。免费版仅支持单点,作者采用备份节点加Nginx backup实现折中高可用。

🔎

延伸解读

Nginx按请求方法分流解决聚合仓库推送限制

Nexus3的group仓库只支持拉取,推送镜像必须使用hosted仓库的独立端口。作者通过Nginx判断请求方法:GET请求转发到group仓库端口(8082),其他请求(如PUT推送)转发到hosted仓库端口(8083),从而统一了拉取和推送的入口。同时将/search请求也指向hosted仓库,避免搜索报错。这一方案无需修改Nexus配置,仅靠反向代理就解决了端口分离带来的使用不便。

自签名证书与客户端一键初始化脚本

由于内部OA域名无法申请公网证书,作者使用自签名SSL证书,并将根证书ca.crt分发到客户端。为避免手动操作,编写了初始化脚本:自动绑定hosts解析、检测443端口连通性、创建/etc/docker/certs.d/域名目录并下载ca.crt。用户只需执行一条curl命令即可完成证书部署,之后通过docker login登录即可推送镜像。该脚本降低了使用门槛,适合团队内部推广。

免费版单点限制下的折中高可用方案

Nexus3免费版仅支持单点部署,集群模式需付费。作者尝试将数据存到Ceph分布式存储,但推送小文件时速度极慢,体验不佳。最终采用折中方案:额外部署一个备份节点,定期同步主节点数据并重启以刷新缓存,同时将数据再备份到Ceph确保安全。在Nginx中将备份节点配置为backup,主节点宕机时可自动切换。该方案虽非真正集群,但以较低成本提升了可用性。

代理缓存机制对拉取速度的影响

文章使用group仓库聚合本地和代理仓库,当本地不存在所需镜像时,会通过代理仓库从外网拉取并缓存到本地。因此首次拉取外网镜像速度较慢,取决于代理源(如DaoCloud加速器)和网络状况;而第二次拉取则直接使用本地缓存,速度与本地仓库基本一致。这一机制适合频繁使用公共镜像的团队,但需注意缓存占用存储空间,且代理源的选择会影响首次拉取效率。

❓

Q&A

Nexus3 除了 Docker 仓库,还能创建哪些类型的私有仓库?

Nexus3 支持创建 Maven、yum、pypi、npm、nuget、rubygems 等多种私有仓库,从 3.0 版本开始也支持 Docker 镜像仓库。

如何用 Docker 快速部署 Nexus3?

在一台有外网的机器上安装 Docker 后,执行提供的启动脚本即可,脚本使用 sonatype/nexus3:latest 镜像,映射 8081 端口,挂载 /data/nexus 到 /nexus-data,并设置 Java 内存参数。大约 2 分钟启动后,通过 http://IP:8081 访问 Web 界面。

Nexus3 中 Docker 仓库的 hosted、proxy、group 三种类型分别是什么作用?

hosted 是本地存储仓库,提供本地私服功能;proxy 是代理仓库,代理其他仓库(如 Docker Hub);group 是聚合仓库,将多个仓库组合成一个统一地址。

Nexus3 的 group 仓库不能推送镜像,有什么解决办法?

可以通过 Nginx 根据请求方法分流:GET 请求(拉取镜像)代理到 group 仓库端口(如 8082),其他请求(推送镜像)代理到 hosted 仓库端口(如 8083),从而统一拉取和推送的地址。

如何让 Docker 客户端信任自签名证书的私有仓库?

将自签名根证书 ca.crt 上传到客户端服务器的 /etc/docker/certs.d/仓库域名 目录下(目录需创建,域名与仓库域名一致),即可避免证书不信任错误。

Nexus3 免费版如何实现高可用?

免费版仅支持单点,可采用折中方案:部署备份节点,定期同步主节点数据并重启备份节点使数据生效,同时将数据备份到 ceph;在 Nginx 中将备份节点设为 backup,主节点宕机时自动切换。

🏷️

标签

➡️

继续阅读