fgbulsoni/nexus3

Nexus3 Root Access 镜像文档

镜像概述

本镜像为Sonatype官方Nexus3镜像的分支版本，在保留Nexus Repository Manager 3核心功能的基础上，特别提供了root用户访问权限。与官方镜像默认的非root运行模式不同，本镜像允许用户以root身份操作容器内部系统，适用于需要进行高级系统配置、依赖安装或深度定制的场景。

核心功能和特性

• 基于官方镜像构建：保留Nexus3的全部核心功能，包括Maven、npm、Docker、NuGet等多种仓库类型的管理能力
• Root用户访问：提供容器内root用户权限，支持系统级配置修改和操作
• 功能兼容性：与官方Nexus3镜像的API、数据结构和操作方式保持兼容
• 数据持久化：支持通过卷挂载实现Nexus数据的持久化存储，与官方镜像一致
• 灵活定制：可通过root权限安装额外系统依赖、调整系统配置或集成第三方工具

使用场景和适用范围

• 高级系统配置：需要修改容器内部系统参数、网络配置或文件权限的场景
• 依赖安装：需在容器内安装额外系统工具或库（如wget、curl、vim等）的场景
• 开发测试环境：在开发或测试阶段需要灵活调整容器配置的场景
• 定制化部署：需要对Nexus3进行深度定制，如集成自定义监控或日志收集工具的场景

注意：生产环境中应谨慎使用root权限，建议仅在必要时使用本镜像，并采取适当的安全措施。

使用方法和配置说明

基本运行命令

bash
docker run -d \
  --name nexus3-root \
  -p 8081:8081 \
  -v nexus-data:/nexus-data \
  [镜像名称]:[标签]

参数说明：

• -d：后台运行容器
• --name nexus3-root：指定容器名称
• -p 8081:8081：映射Nexus Web界面端口
• -v nexus-data:/nexus-data：挂载数据卷以持久化Nexus数据

以Root身份进入容器

bash
docker exec -u root -it nexus3-root /bin/bash

数据持久化

与官方镜像相同，Nexus的数据存储在容器内的/nexus-data目录，建议通过卷挂载实现持久化：

bash
# 创建数据卷
docker volume create nexus-data

# 运行容器时挂载数据卷
docker run -d -p 8081:8081 -v nexus-data:/nexus-data [镜像名称]:[标签]

高级配置示例

安装额外系统工具

bash
# 进入容器（root身份）
docker exec -u root -it nexus3-root /bin/bash

# 更新apt源并安装工具
apt-get update && apt-get install -y wget curl vim

修改系统配置文件

bash
# 编辑系统配置文件（如limits.conf）
docker exec -u root -it nexus3-root vim /etc/security/limits.conf

Docker Compose配置示例

yaml
version: '3'
services:
  nexus3:
    image: [镜像名称]:[标签]
    container_name: nexus3-root
    restart: always
    ports:
      - "8081:8081"
      - "8082:8082"  # 如需Docker仓库，映射额外端口
    volumes:
      - nexus-data:/nexus-data
    environment:
      - NEXUS_CONTEXT=nexus  # 可选，设置上下文路径
    ulimits:
      nofile:
        soft: 65536
        hard: 65536

volumes:
  nexus-data:

注意事项

• 本镜像提供的root权限可能带来安全风险，生产环境使用前需评估安全需求
• 数据卷挂载路径与官方镜像一致，可直接迁移官方镜像的数据卷
• 升级镜像时建议先备份/nexus-data目录数据
• 容器内Nexus服务默认仍以nexus用户运行，root权限主要用于系统级操作