Harbor镜像仓库搭建全流程指南

2025年11月1日 互联网

Harbor镜像仓库搭建全流程指南

一、引言

在容器化技术日益普及的今天，如何高效、安全地管理容器镜像成为开发者和企业关注的焦点。Harbor作为一款开源的企业级Registry服务器，提供了镜像存储、访问控制、镜像签名、漏洞扫描等强大功能，极大地提升了容器镜像管理的效率和安全性。本文将详细介绍Harbor镜像仓库的搭建过程，帮助开发者快速上手。

二、环境准备

1. 硬件要求

  • 服务器配置：建议至少4核CPU、8GB内存、50GB以上磁盘空间（根据实际镜像存储需求调整）。
  • 操作系统：推荐使用CentOS 7/8或Ubuntu 18.04/20.04 LTS等Linux发行版。
  • 网络环境：确保服务器有稳定的网络连接，以便下载Harbor安装包及依赖。

2. 软件依赖

  • Docker：Harbor运行在Docker容器中，需提前安装Docker。

    1. # CentOS安装Docker示例
    2. sudo yum install -y yum-utils
    3. sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
    4. sudo yum install docker-ce docker-ce-cli containerd.io
    5. sudo systemctl start docker
    6. sudo systemctl enable docker

  • Docker Compose：Harbor使用Docker Compose进行编排。

    1. # 安装Docker Compose
    2. 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
    3. sudo chmod +x /usr/local/bin/docker-compose

三、Harbor安装部署

1. 下载Harbor安装包

访问Harbor官方GitHub仓库（https://github.com/goharbor/harbor/releases），下载最新稳定版安装包。

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

2. 配置Harbor

编辑harbor.yml文件，根据实际需求修改配置项，如主机名、HTTP/HTTPS端口、管理员密码、数据库配置等。

  1. # 示例配置片段
  2. hostname: your.domain.com
  3. http:
  4.   port: 80
  5. https:
  6.   port: 443
  7.   certificate: /path/to/your/certificate.pem
  8.   private_key: /path/to/your/private_key.pem
  9. harbor_admin_password: Harbor12345
  10. database:
  11.   password: root123
  12.   # 其他数据库配置...

3. 安装Harbor

执行安装脚本，Harbor将自动下载所需镜像并启动服务。

  1. sudo ./install.sh

安装完成后，访问http://your.domain.com（或配置的HTTPS地址），使用默认管理员账号（admin/Harbor12345）登录Harbor Web界面。

四、Harbor配置优化

1. 访问控制

  • 用户与角色管理：在Harbor Web界面中创建用户，分配不同角色（如项目管理员、开发者、访客等），控制其对镜像的访问权限。
  • LDAP集成：支持与LDAP服务器集成，实现单点登录和用户同步。

2. 镜像签名与验证

启用Notary服务进行镜像签名，确保镜像来源可信。在harbor.yml中配置Notary相关参数，并重启Harbor服务。

3. 漏洞扫描

集成Clair或Trivy等漏洞扫描工具，定期扫描镜像中的安全漏洞。在Harbor Web界面中配置扫描策略，设置自动或手动触发扫描。

4. 存储优化

  • 对象存储集成：支持与AWS S3、MinIO等对象存储服务集成，扩展镜像存储能力。
  • 镜像清理：定期清理未使用的镜像，释放磁盘空间。

五、Harbor使用示例

1. 推送镜像到Harbor

  1. # 登录Harbor
  2. docker login your.domain.com
  4. # 标记镜像
  5. docker tag nginx:latest your.domain.com/library/nginx:latest
  7. # 推送镜像
  8. docker push your.domain.com/library/nginx:latest

2. 从Harbor拉取镜像

  1. # 拉取镜像
  2. docker pull your.domain.com/library/nginx:latest

3. 使用项目与仓库

  • 创建项目：在Harbor Web界面中创建项目，设置项目公开或私有。
  • 管理仓库：在项目下创建仓库，用于存储特定类型的镜像。

六、结语

Harbor镜像仓库的搭建不仅提升了容器镜像管理的效率，还通过访问控制、镜像签名、漏洞扫描等功能增强了安全性。本文详细介绍了Harbor的安装部署、配置优化及使用示例，希望能够帮助开发者快速上手Harbor，实现高效的容器镜像管理。在实际应用中，还需根据具体需求不断调整和优化Harbor的配置，以满足不断变化的业务需求。

最新文章