xuchengen/nexus

sonatype/docker-nexus

Sonatype Nexus Repository Manager 2的Docker镜像，基于OpenJDK。2.14.14及以上版本使用Red Hat Universal Base Image作为基础镜像，早期版本则基于CentOS。关于Nexus Repository Manager 3，请参考https://github.com/sonatype/docker-nexus3%E3%80%82

• 注意事项
  • 持久化数据
  • 添加Nexus插件
  • 构建参数
• 获取帮助

构建镜像

bash
# 构建OSS版
docker build --rm --tag sonatype/nexus oss/
# 构建专业版
docker build --rm --tag sonatype/nexus-pro pro/

运行容器

若主机8081端口开放，可直接运行：

bash
docker run -d -p 8081:8081 --name nexus sonatype/nexus:oss

查看容器监听端口：

bash
docker ps -l

测试服务是否正常：

bash
curl http://localhost:8081/nexus/service/local/status

手动构建镜像（复制Dockerfile后执行）：

bash
docker build --rm=true --tag=sonatype/nexus .

注意事项

• UI访问地址：http://localhost:8081/nexus/

• 默认凭据：admin / admin123

• 新容器启动服务可能需要2-3分钟，可通过查看日志确认Nexus是否就绪：

bash
docker logs -f nexus

• Nexus安装路径为/opt/sonatype/nexus，其中/opt/sonatype/nexus/conf/nexus.properties为配置文件。该文件中定义的nexus-work和nexus-webapp-context-path参数会在JVM启动时被覆盖。

• /sonatype-work为持久化目录，用于存储配置、日志和数据。该目录需对Nexus进程（运行用户UID 200）可写。

• 可通过环境变量控制JVM参数：

  • CONTEXT_PATH：通过-Dnexus-webapp-context-path传递，定义Nexus访问URL路径，默认值为/nexus
  • MAX_HEAP：通过-Xmx传递，默认值为768m
  • MIN_HEAP：通过-Xms传递，默认值为256m
  • JAVA_OPTS：传递额外JVM选项，默认值为-server -XX:MaxPermSize=192m -Djava.net.preferIPv4Stack=true
  • LAUNCHER_CONF：Nexus启动器配置文件列表，默认值为./conf/jetty.xml ./conf/jetty-requestlog.xml ./conf/jetty-http.xml

  运行时可通过环境变量自定义JVM参数：

  bash
  docker run -d -p 8081:8081 --name nexus -e MAX_HEAP=768m sonatype/nexus
  

持久化数据

Docker处理持久化存储有两种常用方法（详见容器数据管理）：

1. 使用数据卷容器：数据卷在没有容器使用前会一直存在，建议使用此方法创建专用数据容器。

bash
# 创建数据卷容器
docker run -d --name nexus-data sonatype/nexus echo "Nexus数据卷容器"
# 运行Nexus并挂载数据卷
docker run -d -p 8081:8081 --name nexus --volumes-from nexus-data sonatype/nexus

2. 挂载主机目录作为卷：该方法可移植性较差，依赖主机目录存在且权限正确，但适用于需要特定底层存储的场景。

bash
# 创建主机目录并设置权限
mkdir /some/dir/nexus-data && chown -R 200 /some/dir/nexus-data
# 挂载主机目录运行容器
docker run -d -p 8081:8081 --name nexus -v /some/dir/nexus-data:/sonatype-work sonatype/nexus

添加Nexus插件

建议基于sonatype/nexus创建自定义镜像来添加插件，插件需解压至/opt/sonatype/nexus/nexus/WEB-INF/plugin-repository目录。关于Nexus P2插件的示例，可参考https://github.com/sonatype/docker-nexus/issues/9%E3%80%82

构建参数

每个Dockerfile包含两个构建参数，用于自定义Nexus版本及下载地址（主要用于测试，因Dockerfile可能依赖特定Nexus版本）：

• NEXUS_VERSION：Nexus版本号
• NEXUS_DOWNLOAD_URL：Nexus安装包下载地址

使用示例：

bash
# 构建自定义OSS版
docker build --rm --tag nexus-custom-oss --build-arg NEXUS_VERSION=2.x.y --build-arg NEXUS_DOWNLOAD_URL=http://.../nexus-2.x.y-bundle.tar.gz oss/
# 构建自定义专业版
docker build --rm --tag nexus-custom-pro --build-arg NEXUS_VERSION=2.x.y --build-arg NEXUS_DOWNLOAD_URL=http://.../nexus-professional-2.x.y-bundle.tar.gz pro/

获取帮助

如需为Docker镜像贡献代码或寻求帮助，可通过以下渠道：

• 在https://github.com/sonatype/docker-nexus/issues%E6%8F%90%E4%BA%A4%E5%85%AC%E5%BC%80issue
• 查看Stack Overflow上的Nexus标签
• 加入Nexus Repository用户列表