deciphernow/nexus

Sonatype Nexus Repository Manager Docker镜像文档

1. 镜像概述与主要用途

本镜像用于快速部署和运行Sonatype Nexus Repository Manager（以下简称Nexus）。Nexus是一款功能强大的仓库管理器，主要用于集中存储、管理和分发软件包、依赖项及构件，支持多种开发语言和包格式，是企业级开发和DevOps流程中的核心工具。

2. 核心功能与特性

• 多仓库格式支持：兼容Maven、npm、Docker、Yum、PyPI等多种主流软件包格式，满足不同开发场景需求。
• 仓库管理能力：支持 hosted（本地仓库）、proxy（代理仓库）、group（仓库组）三种类型，灵活配置构件存储与分发策略。
• 权限与访问控制：提供细粒度的用户权限管理，支持角色配置、访问策略设置，保障仓库安全。
• 缓存与代理：作为远程仓库的代理缓存，加速构件下载，减少重复请求，提升开发效率。
• 高可用性：支持集群部署，确保仓库服务稳定可靠，适应企业级高并发场景。

3. 使用场景与适用范围

适用场景

• 企业内部开发环境：统一管理团队依赖项，避免开发环境依赖不一致问题。
• CI/CD流程集成：作为构件存储中心，承接CI构建产物，供CD流程拉取部署。
• 开源项目管理：托管内部开源构件，或代理外部公共仓库（如Maven Central、npmjs）以优化访问速度。
• 跨团队协作：实现不同项目、团队间的构件共享与版本控制。

适用范围

• 开发团队、DevOps工程师、SRE团队
• 中小型企业内部仓库服务
• 大型企业级软件项目的依赖管理

4. 使用方法与配置说明

4.1 基本运行

通过以下命令启动容器，默认映射容器8081端口至主机8081端口：

bash
docker run -p 8081:8081 decipher/nexus:latest

参数说明：

• -p 8081:8081：端口映射，将主机8081端口映射到容器8081端口，用于访问Nexus Web界面及API。

4.2 数据持久化配置

Nexus的数据（如仓库内容、配置文件等）默认存储在容器内/var/lib/nexus/sonatype-work目录。为避免容器退出后数据丢失，需挂载主机目录作为数据卷持久化存储：

bash
docker run -p 8081:8081 -v ${PWD}/sonatype-work:/var/lib/nexus/sonatype-work decipher/nexus:latest

参数说明：

• -v ${PWD}/sonatype-work:/var/lib/nexus/sonatype-work：卷挂载，将主机当前目录下的sonatype-work目录挂载到容器内数据目录，实现数据持久化。

4.3 指定用户运行（推荐）

为避免容器内进程以root权限运行带来的安全风险，推荐指定非root用户运行容器（需确保主机挂载目录权限与指定用户ID匹配）：

bash
docker run -p 8081:8081 -v ${PWD}/sonatype-work:/var/lib/nexus/sonatype-work -u 1024 decipher/nexus:latest

参数说明：

• -u 1024：指定容器内运行进程的用户ID（需替换为实际环境中的有效用户ID），降低权限风险。

4.4 访问Web界面

容器启动后，通过以下地址访问Nexus Web管理界面：
http://localhost:8081

初始登录信息：

• 默认管理员用户名：admin
• 默认管理员密码：容器首次启动时生成，存储在sonatype-work/nexus3/admin.password文件中（需通过挂载的数据卷目录查看）。

4.5 Docker Compose配置示例

如需通过Docker Compose管理部署，可创建docker-compose.yml文件：

yaml
version: '3'
services:
  nexus:
    image: decipher/nexus:latest
    container_name: nexus
    ports:
      - "8081:8081"  # Web界面及API端口
    volumes:
      - ./sonatype-work:/var/lib/nexus/sonatype-work  # 数据持久化
    user: "1024"  # 指定非root用户运行（可选，需根据实际环境调整）
    restart: unless-stopped  # 容器退出后自动重启（可选）

启动命令：

bash
docker-compose up -d

5. 关键配置参数说明

6. 注意事项

• 数据备份：定期备份挂载的sonatype-work目录，避免数据丢失。
• 权限设置：挂载数据卷时，确保主机目录权限与容器内用户ID匹配（如指定-u 1024，需确保主机sonatype-work目录所有者ID为1024）。
• 初始密码修改：首次登录后，需立即修改默认管理员密码（路径：sonatype-work/nexus3/admin.password文件仅在首次启动时生成，登录后自动删除）。
• 资源配置：根据实际仓库规模调整容器内存、CPU资源（如通过-m限制内存），避免因资源不足导致服务异常。