文档首页> 常见问题> 云服务器如何搭建Harbor镜像仓库？

云服务器如何搭建Harbor镜像仓库？

发布时间：2025-04-15 03:55       

手把手教你用云服务器搭建Harbor私有镜像仓库

在云原生时代，Docker镜像的管理与分发成为DevOps流程中的重要环节。本文将详细介绍如何在主流云服务器上搭建企业级Harbor镜像仓库，从环境准备到配置调优，助您快速构建安全的私有镜像托管平台。

一、准备工作

1.1 云服务器选型

推荐配置：

  • CPU：至少2核（生产环境建议4核以上）
  • 内存：4GB起步（大规模使用建议8GB+）
  • 存储：100GB SSD（根据镜像数量可扩展）
  • 操作系统：Ubuntu 20.04/CentOS 7+

主流云平台创建实例后，请确保开放以下端口：

80（HTTP）、443（HTTPS）、4443（Harbor管理端口）

二、安装Docker与Docker Compose

2.1 Docker安装（以Ubuntu为例）

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io
sudo systemctl enable docker
sudo systemctl start docker

2.2 安装Docker Compose

sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

三、Harbor安装与配置

3.1 下载Harbor离线安装包

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

3.2 修改配置文件（harbor.yml）

关键配置示例：

hostname: your.domain.com
http:
  port: 80
https:
  port: 443
  certificate: /your/cert/path
  private_key: /your/key/path
harbor_admin_password: YourStrongPassword
database:
  password: db_password
data_volume: /data/harbor

3.3 执行安装脚本

sudo ./install.sh

安装完成后访问 https://your-server-ip 即可看到登录界面

四、高级配置与优化

4.1 启用HTTPS（Let's Encrypt示例）

sudo apt install certbot
sudo certbot certonly --standalone -d your.domain.com
# 然后将生成的证书路径配置到harbor.yml

4.2 配置外部存储

修改harbor.yml使用云存储：

storage_service:
  s3:
    accesskey: your_aws_key
    secretkey: your_aws_secret
    region: us-west-1
    bucket: your-bucket-name

五、日常运维指南

5.1 备份与恢复

# 备份
docker-compose down
tar czvf harbor-backup-$(date +"%Y%m%d").tar.gz /data/harbor

# 恢复
tar xzvf harbor-backup-20220501.tar.gz -C /
docker-compose up -d

5.2 版本升级

建议通过官方迁移工具进行：

./migration/upgrade --from v1.10.0 --to v2.4.1

通过本文的详细指导，您已经成功在云服务器上部署了企业级的Harbor镜像仓库。建议进一步配置：

  • 集成LDAP/AD认证
  • 设置镜像扫描策略
  • 配置Webhook通知

私有镜像仓库的建立将显著提升您的CI/CD流程安全性和效率，是云原生架构的重要基石。