如何使用Docker容器部署Harbor私有镜像中心教程-Docker-PHP中文网

harbor私有镜像中心通过docker-compose编排registry、ui、db、nginx等多容器协同运行，需预先安装docker（≥20.10）和docker compose（≥2.20），配置hostname解析、https证书及harbor.yml，最后执行install.sh启动并验证。

如何使用docker容器部署harbor私有镜像中心教程

用Docker容器部署Harbor私有镜像中心，核心是通过docker-compose编排多个服务组件协同运行。它不是单个镜像启动，而是一整套预定义服务（如registry、ui、db、nginx等）的自动化拉起。整个过程清晰可控，重点在于环境准备、配置修改和证书处理。

基础环境与前置依赖

确保主机满足最低要求：

Docker 版本 ≥ 20.10（推荐 24.x），运行 docker --version 验证
Docker Compose 版本 ≥ 2.20（新版已集成进 Docker CLI，可直接用 docker compose 命令）
关闭防火墙或放行端口：80（HTTP）、443（HTTPS）、4443（Harbor内部通信）
禁用 SELinux（setenforce 0）或设为 permissive 模式
配置 hostname 解析：在 /etc/hosts 中添加如 192.168.50.10 harbor.example.com，避免使用 localhost 或 127.0.0.1

下载安装包并初始化配置

从 GitHub 官方 releases 页面下载最新稳定版（例如 v2.10.2）：

wget https://github.com/goharbor/harbor/releases/download/v2.10.2/harbor-offline-installer-v2.10.2.tgz
tar -xvf harbor-offline-installer-v2.10.2.tgz
cd harbor

重命名模板配置文件：

mv harbor.yml.tmpl harbor.yml

编辑 harbor.yml，关键项包括：

hostname: 必须填你规划的访问域名或 IP（如 harbor.example.com）
http.port: 默认 80；若启用 HTTPS，需取消 https 区块注释，并指定证书路径
harbor_admin_password: 设置强密码（首次登录 admin 账户用）
database.password: 数据库 root 密码（可保持默认，也可自定义）
data_volume: 指定持久化目录（如 /data/harbor），确保磁盘空间充足

启用 HTTPS（生产环境强烈建议）

不配 HTTPS 时，Docker 客户端会报 x509 certificate signed by unknown authority 错误，必须额外配置 --insecure-registry，既不安全又繁琐。

推荐生成自签名证书（测试可用）或使用企业签发/Let’s Encrypt 证书：

Docker Cli

使用 Docker CLI 构建、运行、停止、检查和管理容器与镜像的助手。用于执行容器相关任务。

下载

创建证书目录：mkdir -p /data/cert
生成私钥和证书（以域名 harbor.example.com 为例）：

openssl req -newkey rsa:4096 -nodes -sha256 -keyout /data/cert/harbor.key \
  -x509 -days 3650 -out /data/cert/harbor.crt \
  -subj "/C=CN/ST=Beijing/L=Beijing/O=example/CN=harbor.example.com"

然后在 harbor.yml 中启用 HTTPS：

https:
  port: 443
  certificate: /data/cert/harbor.crt
  private_key: /data/cert/harbor.key

启动 Harbor 并验证

执行安装脚本：

sudo ./install.sh

成功输出类似：

✔ ----Harbor has been installed and started successfully.----

查看容器状态：

docker ps -a | grep -E "(harbor|nginx|registry)"

浏览器访问 https://harbor.example.com（或 http://harbor.example.com），用 admin 和你设置的密码登录。首页显示项目列表即表示服务就绪。

在客户端机器上测试推送：

docker login harbor.example.com
docker tag nginx:alpine harbor.example.com/library/nginx:alpine
docker push harbor.example.com/library/nginx:alpine

成功后可在 Web 界面「Projects → library → Repositories」中看到该镜像。