在国产化替代浪潮中，龙芯平台的应用部署成为许多开发者和运维团队必须面对的课题。最近在龙芯 3B6000 服务器上搭建私有镜像仓库 Nexus 时，发现针对该平台的完整、可落地的 Docker 化部署教程相对零散。本文将系统梳理在龙芯 3B6000 架构（LoongArch）上，从 Docker 环境准备到 Nexus 3 私有仓库完整部署、配置及日常维护的全流程实战。无论你是初次接触龙芯平台的开发者，还是需要在国产化环境中构建 CI/CD 流水线的运维工程师，都能按照本文步骤，成功搭建一个稳定、高效的私有制品仓库。

1. 背景与核心概念

在深入部署之前，我们有必要厘清几个核心概念及其在本次实践中的角色。

1.1 龙芯 3B6000 与 LoongArch 架构

龙芯 3B6000 是龙芯中科推出的新一代高性能通用处理器，采用完全自主的 LoongArch 指令集架构。与常见的 x86_64 或 ARM 架构不同，LoongArch 是独立的指令集，这意味着许多为 x86/ARM 预编译的软件无法直接运行。在软件生态上，我们需要寻找或编译适用于 LoongArch 的版本。Docker 镜像也是如此，一个标准的基于x86_64的nginx:alpine镜像无法在龙芯机器上直接运行，必须使用基于loong64架构的镜像。

1.2 Docker 与多架构支持

Docker 是一个开源的应用容器引擎，它允许开发者将应用及其依赖打包到一个可移植的容器中。Docker 本身是跨平台的，但其运行的容器镜像有严格的架构要求。幸运的是，Docker 从较新版本开始支持buildx工具，可以构建和运行多架构镜像。对于龙芯平台，我们需要关注的是linux/loong64这个平台标识。在部署时，我们必须确保拉取的镜像支持此架构，或有能力从源码构建。

1.3 Nexus Repository Manager 3

Nexus Repository Manager 3（简称 Nexus 3）是 Sonatype 公司开发的一款强大的仓库管理器。它支持管理多种格式的制品（Artifact），例如：

• Maven(Java)
• npm(JavaScript)
• Docker(容器镜像)
• PyPI(Python)
• Raw(任意文件)
• 等等

在团队开发中，使用 Nexus 可以带来诸多好处：加速构建（缓存公共仓库）、提升稳定性（隔离外网波动）、保障安全（扫描组件漏洞）以及实现制品统一管理。在龙芯环境下，由于网络和架构的特殊性，一个本地的 Nexus 仓库显得尤为重要，它可以缓存常用的 LoongArch 架构的基础镜像和依赖包，极大提升开发部署效率。

2. 环境准备与版本说明

本次实战的环境基于一台物理的龙芯 3B6000 服务器。以下版本信息基于实际测试，但软件迭代迅速，请读者在操作时以官方最新文档为准，核心思路和步骤是相通的。

• 操作系统: Kylin V10 (SP1) 或 openEuler 22.03+，内核版本 4.19 以上。
• 处理器: 龙芯 3B6000 (LoongArch 架构)。
• Docker: 社区版 Docker Engine。由于龙芯架构，无法使用 Docker Desktop，我们通过命令行安装。
• Nexus: 我们选择使用 Sonatype 官方提供的 Nexus 3 镜像。关键点在于，我们需要一个能在linux/loong64上运行的镜像。目前官方未直接提供，但社区有维护的版本或我们可以通过其他方式获取。

重要提示：以下所有操作如无特别说明，均在root用户或拥有sudo权限的用户下执行。生产环境请严格遵守最小权限原则。

3. Docker 环境安装与配置

这是所有后续步骤的基础。在龙芯架构上安装 Docker，通常需要通过操作系统自带的包管理器或从源码编译。这里我们采用相对简单的包管理器安装方式。

3.1 安装 Docker Engine

以 openEuler 22.03 (LoongArch) 为例，安装步骤如下：

1. 卸载旧版本（如有）：

   sudo yum remove docker \ docker-client \ docker-client-latest \ docker-common \ docker-latest \ docker-latest-logrotate \ docker-logrotate \ docker-engine

2. 安装必要的依赖包：

   sudo yum install -y yum-utils device-mapper-persistent-data lvm2

3. 配置稳定的 Docker 仓库： 对于龙芯架构，我们需要添加针对 LoongArch 的 Docker CE 仓库。openEuler 的源中通常已包含。

   sudo yum-config-manager --add-repo https://download.docker.com/linux/euler/docker-ce.repo

   注意：如果该源速度慢或不适用，可能需要替换为国内镜像源，例如华为云或清华大学的 openEuler 镜像源中的docker-ce包。

4. 安装 Docker Engine 及相关组件：

   sudo yum install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

   这个命令会安装 Docker 引擎、CLI 工具、容器运行时containerd以及 Docker Compose 插件。

5. 启动并设置开机自启：

   sudo systemctl start docker sudo systemctl enable docker

6. 验证安装：

   sudo docker run hello-world

   如果安装成功，你会看到来自 Docker 的欢迎信息。但请注意，hello-world镜像可能没有loong64版本，这个命令主要是测试 Docker 守护进程是否正常运行。你可以尝试运行一个已知支持 LoongArch 的镜像，例如：

   sudo docker run --rm -it cr.loongnix.cn/library/alpine:3.19 uname -m

   预期输出应为loongarch64，这证明 Docker 可以正确拉取和运行 LoongArch 架构的容器。

3.2 配置 Docker 镜像加速器

在国内网络环境下，从 Docker Hub 拉取镜像速度很慢，甚至可能失败。我们需要配置镜像加速器，特别是对于龙芯架构，一些加速器可能提供了loong64的镜像缓存。

1. 创建或修改 Docker 守护进程配置文件/etc/docker/daemon.json：

   sudo tee /etc/docker/daemon.json <<-'EOF' { "registry-mirrors": [ "https://docker.mirrors.ustc.edu.cn", "https://hub-mirror.c.163.com", "https://cr.loongnix.cn" ], "exec-opts": ["native.cgroupdriver=systemd"], "log-driver": "json-file", "log-opts": { "max-size": "100m" }, "storage-driver": "overlay2" } EOF

   这里我们添加了三个镜像源，其中https://cr.loongnix.cn是龙芯生态社区提供的容器镜像仓库，对于 LoongArch 架构的镜像支持最好，必须添加。

2. 重新加载配置并重启 Docker：

   sudo systemctl daemon-reload sudo systemctl restart docker

3. 验证加速器是否生效：

   sudo docker info | grep -A 5 Mirrors

   在输出中，你应该能看到刚才配置的镜像地址。

4. 获取与运行 Nexus 3 镜像

这是最关键的一步。Sonatype 官方 Docker Hub 仓库 (sonatype/nexus3) 目前不提供linux/loong64架构的镜像。因此，我们有几种选择：

1. 使用社区移植的镜像：龙芯社区或国内其他组织可能已经移植并提供了可用的镜像。
2. 自行构建镜像：从 Nexus 的发行版.tar.gz文件开始，编写Dockerfile进行构建。

经过调研，龙芯开源社区（cr.loongnix.cn）提供了移植好的 Nexus 3 镜像，这无疑是最便捷的方式。

4.1 拉取龙芯社区版 Nexus 镜像

sudo docker pull cr.loongnix.cn/sonatype/nexus3:latest

使用docker images命令查看拉取的镜像，确认其架构。

sudo docker images cr.loongnix.cn/sonatype/nexus3:latest

输出应包含该镜像的 ID、大小等信息。

4.2 创建持久化数据目录

Nexus 的数据（仓库内容、配置、日志等）需要存储在宿主机上，以便容器重建或升级时数据不丢失。

# 创建一个目录用于存放所有数据，这里以 /opt/nexus-data 为例 sudo mkdir -p /opt/nexus-data # 为了容器内进程能正常读写，需要修改目录权限（Nexus 默认以 UID 200 运行） sudo chown -R 200:200 /opt/nexus-data

权限说明：Nexus 容器内的进程默认以用户 ID (UID) 200 运行。将宿主机目录的所有者改为200:200，可以避免容器因权限问题启动失败。

4.3 首次运行 Nexus 容器

现在，我们使用docker run命令启动一个 Nexus 容器。

sudo docker run -d \ --name nexus \ --restart unless-stopped \ -p 8081:8081 \ -p 8082:8082 \ -v /opt/nexus-data:/nexus-data \ -e INSTALL4J_ADD_VM_PARAMS="-Xms2g -Xmx2g -XX:MaxDirectMemorySize=2g" \ cr.loongnix.cn/sonatype/nexus3:latest

参数详解：

• -d: 后台运行容器。
• --name nexus: 为容器指定一个名称，便于管理。
• --restart unless-stopped: 设置容器自动重启策略（除非手动停止，否则总是重启）。
• -p 8081:8081: 将容器内的 8081 端口映射到宿主机的 8081 端口。这是 Nexus 的 Web 管理界面端口。
• -p 8082:8082: 映射 8082 端口。这是 Nexus 用于 Docker 私有仓库服务的端口（如果需要的话，我们后续会配置）。
• -v /opt/nexus-data:/nexus-data: 将宿主机目录挂载到容器内的数据目录，实现数据持久化。
• -e INSTALL4J_ADD_VM_PARAMS: 设置 Nexus 的 JVM 参数。-Xms和-Xmx设置了堆内存的初始和最大值，-XX:MaxDirectMemorySize设置了直接内存大小。根据你的服务器内存情况调整（例如，4G内存的机器可以设为-Xms1g -Xmx1g）。
• cr.loongnix.cn/sonatype/nexus3:latest: 指定使用的镜像。

4.4 检查容器状态与初始化

1. 查看容器是否正常运行：

   sudo docker ps | grep nexus

   如果看到nexus容器状态为Up，则表示启动成功。

2. 查看容器日志，等待初始化完成： Nexus 第一次启动时会解压文件、初始化数据库等，需要一些时间（1-3分钟）。

   sudo docker logs -f nexus

   在日志中搜索关键字Started Sonatype Nexus，当看到类似下面的输出时，表示 Nexus 已启动就绪：

   2024-05-10 10:00:00,000+0000 INFO [jetty-main-1] *SYSTEM org.sonatype.nexus.bootstrap.jetty.JettyServer - Started Sonatype Nexus OSS 3.xx.x-xx

   此时，按Ctrl+C退出日志跟踪。

3. 访问 Web 管理界面： 打开浏览器，访问http://<你的服务器IP地址>:8081。

   • 默认管理员用户名：admin
   • 初始密码：在容器日志中查找。通常日志里会有一行显示：

     admin password: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

     你也可以在挂载的数据目录中找到密码文件：

     sudo cat /opt/nexus-data/admin.password

   使用获取的密码登录，系统会强制你修改密码并完成一些初始设置。

5. Nexus 基础配置与使用

成功登录后，我们进行一些必要的配置，使其能更好地为我们服务。

5.1 配置 Docker 私有仓库（Hosted）

Nexus 支持多种仓库类型，我们首先创建一个 Docker 私有仓库，用于存放我们自己构建的镜像。

1. 点击顶部导航栏的齿轮图标⚙ (设置)。
2. 在左侧菜单栏，进入Repository > Repositories。
3. 点击Create repository。
4. 在仓库类型列表中，选择docker (hosted)。
   • Name:docker-hosted(可自定义)
   • HTTP: 保持8082端口（这是我们之前映射的端口）。注意：如果你希望使用 HTTPS，需要配置 SSL 证书，本文暂不涉及。
   • Allow anonymous docker pull: 根据安全需求勾选。如果勾选，则拉取此仓库镜像无需认证。
   • Deployment Policy: 选择Allow redeploy，允许覆盖推送同一标签的镜像。
   • Storage: 使用默认的defaultBlob Store 即可。
5. 点击Create repository完成创建。

5.2 配置 Docker 代理仓库（Proxy）

代理仓库用于缓存 Docker Hub 等公共仓库的镜像。当客户端请求一个镜像时，Nexus 会先去代理仓库查找，如果没有则从远程仓库拉取并缓存到本地，下次请求时直接使用缓存，极大加速拉取速度，并减少对外网依赖。

1. 同样在Repository > Repositories页面，点击Create repository。
2. 选择docker (proxy)。
   • Name:docker-proxy(可自定义)
   • HTTP: 端口留空或填8083（需要确保此端口在容器启动时已映射，我们之前只映射了8081和8082，这里可以先不填或使用8082，后面通过路由规则区分）。
   • Remote storage: 填写远程仓库地址，例如 Docker Hub 官方地址https://registry-1.docker.io。对于 LoongArch 镜像，更推荐使用龙芯社区镜像源https://cr.loongnix.cn。
   • Docker Index: 选择Use Docker Hub（如果远程仓库是 Docker Hub）或Registry。
3. 点击Create repository。

5.3 配置 Docker 仓库组（Group）

仓库组可以将多个仓库（如 hosted, proxy）聚合起来，对外提供一个统一的访问地址。客户端只需要配置这个组的地址，就可以从组内所有仓库拉取镜像。

1. 在Repository > Repositories页面，点击Create repository。
2. 选择docker (group)。
   • Name:docker-group(可自定义)
   • HTTP: 端口填8082。这意味着我们将使用 8082 端口作为所有 Docker 仓库服务的统一入口。
   • Member repositories: 在左侧列表中选择刚才创建的docker-hosted和docker-proxy，点击>箭头添加到右侧。
   • 顺序很重要：Nexus 会按从上到下的顺序在成员仓库中查找镜像。通常把docker-hosted（私有镜像）放在上面，docker-proxy（公共缓存）放在下面。
3. 点击Create repository。

至此，我们创建了三个仓库：一个用于存放私有镜像（hosted），一个用于代理公共仓库（proxy），一个将两者组合起来对外提供服务（group）。我们的客户端（Docker 命令）将主要与docker-group交互。

5.4 配置 Nexus 的 Docker 仓库认证（可选但推荐）

为了安全，我们通常禁止匿名访问 hosted 仓库。需要配置认证。

1. 在Security > Realms中，将Docker Bearer Token Realm从Available移动到Active。这允许 Docker 客户端通过令牌认证。
2. 在Security > Users中，可以创建一个专门用于 Docker 操作的用户（例如docker-user），并为其分配相应的角色权限。最简单的方式是直接使用admin账户，但不推荐在生产环境这样做。

6. 配置 Docker 客户端使用 Nexus 私有仓库

现在，我们需要在需要使用这个私有仓库的机器上（可以是同一台龙芯服务器，也可以是其他机器）配置 Docker 客户端。

6.1 配置 Docker Daemon 的 Insecure Registry

因为我们的 Nexus 默认使用 HTTP（非 HTTPS），需要告知 Docker 守护进程信任这个仓库地址。

在需要拉取/推送镜像的机器上（假设是同一台龙芯服务器），编辑/etc/docker/daemon.json文件，在之前配置的基础上，添加insecure-registries字段：

{ "registry-mirrors": [ "https://docker.mirrors.ustc.edu.cn", "https://hub-mirror.c.163.com", "https://cr.loongnix.cn" ], "insecure-registries": [ "你的服务器IP:8082" ], "exec-opts": ["native.cgroupdriver=systemd"], "log-driver": "json-file", "log-opts": { "max-size": "100m" }, "storage-driver": "overlay2" }

将你的服务器IP替换为 Nexus 服务器的实际 IP 地址，例如192.168.1.100:8082。如果 Nexus 就在本机，也可以用localhost:8082或127.0.0.1:8082。

重要警告：insecure-registries仅用于测试或内部受信网络。在生产环境中，强烈建议为 Nexus 配置 SSL/TLS 证书，使用 HTTPS 通信，从而避免此不安全配置。

保存文件后，重启 Docker 守护进程使配置生效：

sudo systemctl daemon-reload sudo systemctl restart docker

6.2 登录到 Nexus Docker 仓库

在推送或拉取私有镜像前，需要先登录。

sudo docker login 你的服务器IP:8082

根据提示输入用户名和密码（即 Nexus 的管理员账号或你创建的具有相应权限的账号）。

6.3 测试镜像推送与拉取

1. 拉取一个测试镜像并重新打标签： 我们先从公共仓库拉取一个小的、支持 LoongArch 的镜像，例如alpine。

   sudo docker pull cr.loongnix.cn/library/alpine:3.19

   为它打上指向我们私有仓库的标签。

   sudo docker tag cr.loongnix.cn/library/alpine:3.19 你的服务器IP:8082/my-alpine:3.19

   这里my-alpine是你在私有仓库中的项目名，可以自定义。

2. 推送镜像到私有仓库：

   sudo docker push 你的服务器IP:8082/my-alpine:3.19

   如果推送成功，你会在命令行看到上传进度，最终显示pushed和镜像摘要。

3. 从私有仓库拉取镜像： 为了验证，我们先删除本地的这两个镜像，然后从私有仓库拉取。

   sudo docker rmi 你的服务器IP:8082/my-alpine:3.19 sudo docker rmi cr.loongnix.cn/library/alpine:3.19 sudo docker pull 你的服务器IP:8082/my-alpine:3.19

   拉取成功后，使用docker images查看，应该能看到来自你私有仓库的镜像。

4. 通过代理仓库拉取公共镜像： 现在测试代理仓库。尝试拉取一个 Docker Hub 上的镜像，比如nginx。由于我们配置了docker-proxy代理到cr.loongnix.cn，Nexus 会尝试从那里拉取并缓存。

   sudo docker pull 你的服务器IP:8082/nginx:alpine

   注意：这里拉取的地址是你的服务器IP:8082，后面直接跟镜像名nginx:alpine。Nexus 的仓库组docker-group会处理这个请求，先在docker-hosted找，找不到就去docker-proxy找，docker-proxy会从远程仓库拉取。 拉取成功后，你可以去 Nexus 的 Web 界面，在Browse中查看docker-proxy仓库，应该能看到缓存的nginx镜像层。

7. 使用 Docker Compose 管理 Nexus（推荐）

使用docker run命令管理容器虽然直接，但参数多，不易维护和重现。更推荐使用docker-compose（或 Docker 自带的compose插件）通过一个 YAML 文件来定义和运行服务。

1. 创建docker-compose.yml文件： 在服务器上选择一个目录，例如/opt/nexus-docker，创建该文件。

   sudo mkdir -p /opt/nexus-docker cd /opt/nexus-docker sudo vim docker-compose.yml

2. 编写 Compose 文件内容：

   version: '3.8' services: nexus: image: cr.loongnix.cn/sonatype/nexus3:latest container_name: nexus restart: unless-stopped ports: - "8081:8081" # Web UI - "8082:8082" # Docker 仓库端口 environment: - INSTALL4J_ADD_VM_PARAMS=-Xms2g -Xmx2g -XX:MaxDirectMemorySize=2g volumes: - nexus-data:/nexus-data volumes: nexus-data: driver: local driver_opts: type: none device: /opt/nexus-data o: bind

   说明：

   • 我们定义了一个名为nexus的服务。
   • 使用volumes定义了名为nexus-data的卷，并通过driver_opts将其绑定到宿主机的/opt/nexus-data目录。这是一种更清晰的持久化数据管理方式。
   • 环境变量、端口映射与之前的docker run命令一致。

3. 使用 Compose 启动服务： 确保在docker-compose.yml文件所在目录执行。

   # 使用 Docker 自带的 compose 插件 sudo docker compose up -d # 或者，如果你安装的是独立的 docker-compose 命令 # sudo docker-compose up -d

   -d参数表示后台运行。

4. 管理服务：

   • 查看日志：sudo docker compose logs -f nexus
   • 停止服务：sudo docker compose stop
   • 启动服务：sudo docker compose start
   • 停止并删除容器（数据卷会保留）：sudo docker compose down
   • 停止并删除容器及数据卷（危险！会删除所有数据）：sudo docker compose down -v

使用 Docker Compose 使得服务的部署、更新和迁移变得极其简单，只需维护一个 YAML 文件即可。

8. 常见问题与排查思路

在龙芯平台部署 Nexus 过程中，你可能会遇到一些特有的问题。

9. 最佳实践与工程建议

将 Nexus 投入生产环境使用时，以下建议能帮助你构建更健壮、易维护的服务。

1. 使用 HTTPS 替代 HTTP：insecure-registries是安全漏洞。为 Nexus 域名申请 SSL 证书（可以是内部 CA 颁发的），并在 Nexus 和所有 Docker 客户端配置 HTTPS。这涉及修改 Nexus 的jetty.xml配置和 Docker 客户端的daemon.json（使用registry配置而非insecure-registries）。

2. 规划存储与备份：

   • Nexus 的数据目录 (/nexus-data) 会持续增长，务必将其挂载到有足够空间和 IOPS 的磁盘上（如 SSD）。
   • 建立定期的备份流程。最简单的方法是停止 Nexus 容器，然后打包备份整个/opt/nexus-data目录。也可以使用 Nexus 的Administration > System > Backup功能创建在线备份。

3. 权限与角色精细化： 不要所有人都用admin账户。根据团队职责创建不同的用户和角色。例如：

   • ci-user: 拥有向docker-hosted仓库推送构建产物的权限。
   • dev-user: 拥有从所有仓库拉取的权限，但无推送权限。
   • deploy-user: 拥有从特定仓库拉取生产镜像的权限。

4. 监控与日志：

   • 监控 Nexus 服务器的系统资源（CPU、内存、磁盘）。
   • 定期查看 Nexus 的访问日志和系统日志，了解使用情况并排查问题。日志文件位于数据目录的log子文件夹下。
   • 可以配置 Nexus 的日志级别，在Administration > Logging中调整。

5. 高可用考虑（进阶）： 对于关键生产环境，单点 Nexus 存在风险。可以考虑 Nexus Repository Manager OSS 的高可用方案，但这通常需要企业版许可。社区版可以尝试通过定期备份和快速恢复来降低风险，或者使用负载均衡器后面部署多个 Nexus 实例，并共享后端存储（此配置复杂，需谨慎评估）。

6. 龙芯平台特定优化：

   • 镜像来源：优先将cr.loongnix.cn作为代理仓库的远程源，确保能获取到 LoongArch 架构的镜像。
   • 构建镜像：对于无法直接获取的 LoongArch 镜像，需要在龙芯机器上编写Dockerfile，使用docker buildx build --platform linux/loong64进行构建，然后推送到自己的docker-hosted仓库，形成团队内部的基础镜像库。

通过本文的步骤，你已经在龙芯 3B6000 服务器上成功搭建了一个功能完整的 Nexus 3 私有制品仓库，并配置了 Docker 仓库服务。这套系统不仅解决了龙芯架构下镜像获取难、速度慢的问题，还为团队提供了统一的制品管理能力，是构建国产化平台 CI/CD 流水线的重要基石。后续，你可以进一步探索 Nexus 对 Maven、npm、PyPI 等其他类型仓库的支持，将其打造成团队全方位的开发基础设施。如果在实践中遇到新的问题，多查看官方文档和社区讨论，结合日志进行排查，问题大多都能迎刃而解。