在CentOS 7上安装部署Harbor镜像仓库

在容器化技术日益普及的今天，Docker镜像的管理与分发成为企业IT架构中的关键环节。Harbor作为由VMware开源的企业级Docker Registry项目，不仅提供了镜像存储功能，还集成了权限控制、镜像签名、漏洞扫描等高级特性，成为构建私有镜像仓库的首选方案。本文将详细阐述如何在CentOS 7系统上安装部署Harbor镜像仓库，帮助读者快速构建安全、高效的镜像管理平台。

一、环境准备与依赖安装

1.1 系统要求与基础环境配置

Harbor对运行环境有一定要求，推荐使用CentOS 7.x系列系统，确保内核版本在3.10以上。首先，通过cat /etc/redhat-release命令确认系统版本，使用uname -r查看内核版本。接着，更新系统软件包库，执行yum update -y命令，确保所有软件包为最新版本，避免因版本不兼容导致的安装问题。

1.2 安装Docker引擎

Harbor依赖于Docker运行，因此需先安装Docker。CentOS 7默认仓库中的Docker版本可能较旧，建议添加Docker官方仓库以获取最新版本。执行以下命令：

sudo yum install -y yum-utils device-mapper-persistent-data lvm2
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install docker-ce docker-ce-cli containerd.io -y

安装完成后，启动Docker服务并设置开机自启：

sudo systemctl start docker
sudo systemctl enable docker

通过docker --version验证Docker安装成功。

1.3 安装Docker Compose

Harbor使用Docker Compose进行容器编排，因此需安装Docker Compose。从GitHub发布页下载最新版本的Docker Compose二进制文件，赋予执行权限并移动到/usr/local/bin目录：

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

执行docker-compose --version确认安装成功。

二、Harbor下载与配置

2.1 下载Harbor安装包

访问Harbor官方GitHub仓库，选择适合的版本进行下载。以v2.4.1版本为例，执行以下命令：

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

解压后进入harbor目录，其中包含安装所需的脚本和配置文件。

2.2 配置Harbor

Harbor的主要配置文件为harbor.yml（或旧版本的harbor.cfg），需根据实际环境进行修改。重点配置项包括：

hostname：设置为服务器的IP地址或域名，确保客户端可访问。
http/https：根据安全需求选择协议，生产环境建议启用HTTPS。
port：默认HTTP端口为80，HTTPS端口为443，如需更改，需在配置中指定。
certificate/private_key：启用HTTPS时，需指定证书和私钥路径。
database：配置数据库密码，确保安全性。
harbor_admin_password：设置Harbor管理员密码。

编辑harbor.yml后，保存退出。

三、Harbor安装与启动

3.1 执行安装脚本

在harbor目录下，执行安装脚本./install.sh。脚本将自动完成以下操作：

检查系统依赖是否满足。
下载并启动Harbor所需的Docker镜像。
使用Docker Compose启动Harbor服务。

安装过程中，控制台将输出详细的日志信息，包括镜像下载进度、容器启动状态等。

3.2 验证Harbor运行状态

安装完成后，通过docker-compose ps命令查看Harbor相关容器的运行状态。正常情况下，所有容器应显示为Up状态。访问Harbor的Web界面，输入配置的hostname和端口，使用管理员账号登录，验证界面是否正常显示。

四、Harbor使用与维护

4.1 镜像推送与拉取

Harbor支持标准的Docker命令进行镜像推送和拉取。首先，在客户端机器上登录Harbor：

docker login <harbor_hostname>

输入管理员账号和密码后，即可推送本地镜像到Harbor：

docker tag <local_image>:<tag> <harbor_hostname>/<project_name>/<image_name>:<tag>
docker push <harbor_hostname>/<project_name>/<image_name>:<tag>

拉取镜像时，执行：

docker pull <harbor_hostname>/<project_name>/<image_name>:<tag>

4.2 项目管理与权限控制

Harbor支持多项目管理，管理员可在Web界面创建项目，并分配不同的访问权限。通过角色管理功能，可细化用户权限，如只读、推送、管理等，满足不同场景下的安全需求。

4.3 日常维护与升级

定期备份Harbor的数据库和配置文件，以防数据丢失。升级Harbor时，先下载新版本的安装包，停止现有服务，备份数据后，执行新版本的安装脚本。升级过程中，注意查看日志，确保无错误发生。

五、总结与展望

在CentOS 7上安装部署Harbor镜像仓库，不仅提升了镜像管理的安全性和效率，还为企业提供了灵活的镜像分发解决方案。通过本文的详细步骤，读者可轻松完成Harbor的安装与配置，快速构建私有镜像仓库。未来，随着容器技术的不断发展，Harbor将持续迭代，提供更多高级功能，助力企业实现更高效的容器化部署与管理。

在CentOS 7上快速搭建Harbor私有镜像仓库指南