从零开始：云服务器上安装Harbor私有镜像仓库全指南

在云原生时代，Harbor作为企业级Docker镜像仓库解决方案越来越受到开发者青睐。本文将详细介绍如何在主流云服务器上搭建Harbor私有仓库，涵盖从环境准备到安全配置的全过程。

一、准备工作

1.1 云服务器选择

建议选择配置至少2核4G的云服务器实例：

阿里云ECS/腾讯云CVM/AWS EC2等主流云平台
操作系统推荐Ubuntu 20.04 LTS或CentOS 7+
确保80/443端口开放

1.2 基础环境配置

# 更新系统
sudo apt-get update && sudo apt-get upgrade -y

# 安装必要工具
sudo apt-get install -y curl wget vim

二、安装Docker环境

Harbor依赖Docker环境，安装步骤如下：

# 安装Docker
curl -fsSL https://get.docker.com | sh

# 启动Docker服务
sudo systemctl start docker
sudo systemctl enable docker

# 验证安装
docker --version

三、安装Docker Compose

Harbor使用Docker Compose编排服务：

# 下载最新版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

# 验证安装
docker-compose --version

四、下载并安装Harbor

4.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

4.2 配置Harbor

编辑harbor.yml配置文件：

cd harbor
cp harbor.yml.tmpl harbor.yml
vim harbor.yml

关键配置项：

hostname: 服务器IP或域名
http.port: 80
https.port: 443 (如需启用HTTPS)
harbor_admin_password: 设置管理员密码

4.3 执行安装脚本

sudo ./install.sh

五、验证安装

安装完成后，访问配置的IP或域名：

默认用户名：admin
密码：harbor.yml中配置的密码

检查服务状态：

docker-compose ps

六、安全配置建议

启用HTTPS加密通信
配置防火墙规则限制访问IP
定期备份数据库和镜像数据
设置镜像扫描策略
启用审计日志功能

七、常见问题解决

7.1 端口冲突问题

解决方案：修改harbor.yml中的端口配置或停止占用端口的服务

7.2 磁盘空间不足

建议：挂载数据盘到/var/lib/docker目录

7.3 忘记管理员密码

重置方法：进入PostgreSQL容器执行密码重置命令

通过以上步骤，您已在云服务器上成功搭建了企业级Harbor镜像仓库。后续可结合CI/CD工具实现自动化镜像构建和部署，为DevOps流程提供稳定可靠的镜像管理服务。