[Linux操作系统]VPS搭建Harbor镜像仓库，从零开始的全指南|harbor docker镜像,VPS搭建Harbor镜像仓库,Linux操作系统,云主机博士

本文提供了一份详尽的指南，指导用户如何在Linux操作系统的VPS上搭建Harbor镜像仓库。从零起步，涵盖环境准备、Harbor镜像下载、配置及安装等步骤。通过Docker技术实现Harbor的部署，确保镜像安全存储与分发。该指南适用于希望自主管理Docker镜像的用户，助力提升项目开发效率和镜像管理能力。

本文目录导读：

准备工作
下载并配置Harbor
安装Harbor
配置Docker客户端使用Harbor
高级配置
常见问题及解决方案

在现代软件开发中，容器技术已经成为不可或缺的一部分，Docker作为容器技术的代表，极大地简化了应用的部署和管理，随着项目规模的扩大，私有镜像仓库的需求也日益凸显，Harbor作为一个开源的镜像仓库管理工具，提供了丰富的功能和高度的安全性，成为了许多开发者的首选，本文将详细介绍如何在VPS上搭建Harbor镜像仓库，帮助读者从零开始掌握这一技能。

准备工作

1、选择VPS服务商

选择一个可靠的VPS服务商是第一步，常见的VPS服务商有阿里云、腾讯云、华为云等，根据项目需求和预算选择合适的配置。

2、安装操作系统

推荐使用Ubuntu 20.04 LTS或CentOS 7作为操作系统，本文以Ubuntu 20.04为例进行讲解。

3、基础环境配置

- 更新系统包：

```bash

sudo apt update && sudo apt upgrade -y

```

- 安装必要的工具：

```bash

sudo apt install -y docker.io docker-compose

```

二、安装Docker和Docker Compose

1、安装Docker

```bash

sudo apt install -y apt-transport-https ca-certificates curl software-properties-common

curl -fsSL https://downlOAd.docker.com/linux/ubuntu/gpg | sudo apt-key add

sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

sudo apt update

sudo apt install -y docker-ce

```

2、安装Docker Compose

```bash

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

1、下载Harbor离线安装包

访问Harbor官方GitHub仓库，下载最新的离线安装包。

```bash

wget https://github.com/goharbor/harbor/releases/download/v2.3.3/harbor-offline-installer-v2.3.3.tgz

tar -xvzf harbor-offline-installer-v2.3.3.tgz

cd harbor

```

2、配置Harbor

- 复制配置文件模板：

```bash

cp harbor.yml.tmpl harbor.yml

```

- 编辑harbor.yml文件，配置以下关键参数：

```yaml

hostname: your-vps-ip

harbor_admin_password: Harbor12345

data_volume: /data/harbor

```

安装Harbor

1、创建数据目录

```bash

sudo mkdir -p /data/harbor

sudo chown -R 10000:10000 /data/harbor

```

2、执行安装脚本

```bash

sudo ./install.sh

```

安装过程中，脚本会自动拉取所需的Docker镜像并启动相关容器，安装完成后，可以通过浏览器访问http://your-vps-ip来验证Harbor是否成功运行。

配置Docker客户端使用Harbor

1、登录Harbor

```bash

docker login your-vps-ip

Username: admin

Password: Harbor12345

```

2、推送镜像到Harbor

- 标记镜像：

```bash

docker tag nginx your-vps-ip/library/nginx

```

- 推送镜像：

```bash

docker push your-vps-ip/library/nginx

```

3、拉取镜像

```bash

docker pull your-vps-ip/library/nginx

```

高级配置

1、配置HTTPS

- 生成自签名证书：

```bash

openssl req -newkey rsa:4096 -x509 -sha256 -days 365 -nodes -out cert.pem -keyout key.pem -subj "/C=CN/ST=Beijing/L=Beijing/O=example/OU=example/CN=your-vps-ip"

```

- 配置Harbor使用HTTPS：

编辑harbor.yml文件，添加以下配置：

```yaml

https:

enabled: true

certificate: /path/to/cert.pem

private_key: /path/to/key.pem

```

- 重新安装Harbor：

```bash

sudo ./install.sh

```

2、配置用户和权限

- 登录Harbor管理界面，添加新用户并分配项目权限。

- 可以通过角色-Based访问控制（RBAC）来管理不同用户的权限。

3、配置镜像复制

- 在Harbor管理界面中，配置镜像复制规则，可以将私有镜像复制到其他Harbor实例或公共镜像仓库。

常见问题及解决方案

1、Docker服务启动失败

- 检查Docker服务状态：

```bash

sudo systemctl status docker

```

- 重启Docker服务：

```bash

sudo systemctl restart docker

```

2、Harbor安装失败

- 检查install.sh脚本输出日志，定位错误原因。

- 确保所有配置文件路径和权限正确。

3、镜像推送失败

- 检查Docker客户端是否正确登录Harbor。

- 确保网络连接正常，防火墙规则允许Docker服务端口。

通过本文的详细步骤，读者应该能够成功在VPS上搭建Harbor镜像仓库，Harbor不仅提供了基本的镜像存储和分发功能，还支持高级的安全和权限管理，极大地提升了容器化应用的部署效率，希望本文能为您的项目带来帮助。

关键词

VPS, Harbor, 镜像仓库, Docker, Docker Compose, Ubuntu, 安装, 配置, HTTPS, 自签名证书, 用户权限, 镜像复制, 离线安装包, 数据目录, 日志, 防火墙, 网络连接, 脚本, 角色-Based访问控制, RBAC, 安全性, 高级配置, 容器化, 应用部署, 系统更新, 必要工具, 下载, 推送镜像, 拉取镜像, 标记镜像, 管理界面, 服务状态, 重启服务, 错误日志, 路径权限, VPS服务商, 操作系统, 基础环境, 脚本输出, 端口, 配置文件, 安装脚本, 数据卷, 管理工具, 开源, 项目规模, 部署管理, 现代软件开发, 容器技术, 私有镜像, 功能丰富, 可靠性, 预算, 配置参数, 数据存储, 分发功能, 效率提升, 项目帮助, 详细步骤, 成功搭建, 高级功能, 安全管理, 权限管理, 容器应用, 部署效率, 实例配置, 公共仓库, 网络问题, 服务端口, 系统包, 必要安装, 环境配置, 官方仓库, 最新版本, 离线包, 解压, 目录创建, 目录权限, 安装过程, 镜像拉取, 镜像推送, 客户端登录, 管理用户, 权限分配, 访问控制, 复制规则, 错误原因, 状态检查, 服务重启, 日志检查, 网络连接检查, 防火墙规则, 路径检查, 权限检查, 安装日志, 配置路径, 配置权限, 安装错误, 错误定位, 网络问题排查, 服务端口检查, 系统包更新, 必要工具安装, 官方下载, 最新安装包, 配置文件编辑, 数据目录创建, 数据目录权限, 安装脚本执行, 镜像标记, 镜像推送操作, 镜像拉取操作, 客户端登录操作, 管理界面配置, 用户添加, 权限分配操作, 访问控制配置, 镜像复制配置, 错误日志检查, 服务状态检查, 服务重启操作, 网络连接确认, 防火墙规则配置, 路径确认, 权限确认, 安装日志查看, 配置路径确认, 配置权限确认, 安装错误排查, 错误原因分析, 网络问题解决, 服务端口确认, 系统包确认, 必要工具确认, 官方仓库确认, 最新版本确认, 离线包确认, 解压确认, 目录创建确认, 目录权限确认, 安装过程确认, 镜像拉取确认, 镜像推送确认, 客户端登录确认, 管理用户确认, 权

本文标签属性：

VPS搭建Harbor镜像仓库：harbor 镜像仓库

云主机博士