Harbor + Docker Compose 实操全流程（详细版）

一、环境准备

• 操作系统：CentOS / Rocky / RHEL / Ubuntu（Linux）

• 内核要求：≥ 3.10

• 已安装 Docker

• 工作目录：/compose

---

二、Docker Compose 安装

安装方式（示例）

bash

bash

cp docker-compose /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

版本验证

bash

bash

docker-compose --version

输出示例：

纯文本

纯文本

docker-compose version 1.21.1, build 5a3f1a3

---

三、Harbor 安装包处理

解压 Harbor 离线安装包

bash

bash

tar -zxvf harbor-offline-installer-v*.tgz
cd harbor

解压后包含：

• harbor.yml.tmpl

• install.sh

• docker-compose.yml

• harbor.v*.tar.gz（离线镜像）

---

四、Harbor 配置文件修改（核心）

复制模板配置文件

bash

bash

cp harbor.yml.tmpl harbor.yml

修改 harbor.yml

yaml

yaml

hostname: 192.168.222.141

http:
  port: 80

https:
  # 未启用 HTTPS

说明

• hostname必须为宿主机 IP 或域名

• localhost、127.0.0.1不可用

• HTTP 模式适用于内网测试环境

---

五、Harbor 安装执行

执行安装脚本

bash

bash

./install.sh

安装过程行为

• 导入 Harbor 镜像

• 生成容器

• 启动 Harbor 服务

查看容器状态

bash

bash

docker-compose ps

预期状态：

纯文本

纯文本

Up (healthy)

---

六、Harbor Web 访问

访问地址

纯文本

纯文本

http://192.168.222.141

默认登录凭证

纯文本

纯文本

用户名：admin
密码：Harbor12345

---

七、创建 ruoyi 仓库

Web 控制台操作步骤

1. 登录 Harbor

2. 点击「项目」

3. 新建项目

4. 项目名称：ruoyi

5. 访问级别：公开 / 私有（可选）

结果

• 生成镜像仓库地址：

纯文本

纯文本

192.168.222.141/ruoyi

---

八、Docker 客户端配置（HTTP 必做）

编辑 Docker 配置

bash

bash

vim /etc/docker/daemon.json

添加内容

json

json

{
  "insecure-registries": ["192.168.222.141"]
}

重启 Docker

bash

bash

systemctl restart docker

---

九、镜像推送示例（ruoyi）

登录 Harbor

bash

bash

docker login 192.168.222.141

打标签

bash

bash

docker tag ruoyi-admin:latest 192.168.222.141/ruoyi/ruoyi-admin:v1

推送镜像

bash

bash

docker push 192.168.222.141/ruoyi/ruoyi-admin:v1

---

十、关键参数速记表

项目	值
Harbor 端口	80
Harbor 数据目录	/data
默认账号	admin
默认密码	Harbor12345
项目仓库	ruoyi
HTTP 仓库地址	192.168.222.141/ruoyi

---

十一、常见问题点

• HTTP 未配置 insecure-registries→ 镜像推送失败

• hostname 错误 → Web 无法访问

• 端口冲突 → Harbor 启动失败

• Docker 未重启 → 配置不生效