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 控制台操作步骤
-
登录 Harbor
-
点击「项目」
-
新建项目
-
项目名称:
ruoyi -
访问级别:公开 / 私有(可选)
结果
- 生成镜像仓库地址:
纯文本
纯文本
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 未重启 → 配置不生效