实践篇: 06-部署镜像仓库 (Harbor)

于 2025-06-28 08:16:11 发布
阅读量692 收藏 16
点赞数 16
CC 4.0 BY-SA版权
分类专栏： Dockerfile企业实战指南 文章标签： docker harbor dockerfile
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/unbuntu_luo/article/details/148872527

在企业内部，拥有一个私有的 Docker 镜像仓库至关重要。它用于存储我们构建的标准化基础镜像和应用程序镜像，实现镜像的安全管理、版本控制和快速分发。Harbor 是一个流行的、开源的企业级 Docker Registry 解决方案，提供了用户管理、访问控制、安全扫描 (集成 Trivy)、镜像复制等丰富功能。

本篇将指导你如何部署 Harbor。

环境说明:

  • 如果你选择了准备篇的"路径二：模拟企业环境": 请确保已在服务器和本地机器的 hosts 文件中添加了 harbor.leops.local 指向你的服务器 IP。
  • 如果你选择了准备篇的"路径一：本地学习环境": 你可以使用 localhost 或你的 Docker 主机 IP 地址来访问 Harbor。下文配置中需要将 harbor.leops.local 替换为相应的值。同时，你可能需要在 Docker 客户端配置 insecure-registries 来允许通过 HTTP 访问你的 Harbor 实例（或者配置 HTTPS，但这更复杂）。
## 下载并解压 Harbor 安装包
Harbor 提供在线和离线两种安装方式。这里我们使用离线安装包，它包含了运行 Harbor 所需的所有 Docker 镜像。

1. 访问 Harbor Releases 页面: https://github.com/goharbor/harbor/releases
2. 选择版本: 找到最新的稳定版本（例如 v2.11.2 或更新版本），下载对应的 harbor-offline-installer-vx.y.z.tgz 文件。
# 切换到合适的安装目录，例如 /data
cd /data

# 下载 (请替换为最新稳定版本链接)
wget https://github.com/goharbor/harbor/releases/download/v2.13.0/harbor-offline-installer-v2.13.0.tgz

# 解压
tar zxvf harbor-offline-installer-v2.13.0.tgz

# 进入解压后的目录 (目录名可能与版本号相关)
cd harbor

注意: 如果你在中国大陆，下载速度可能较慢，可以考虑使用 https://ghfast.top 代理下载。

配置 Harbor

Harbor 的配置通过修改 harbor.yml 文件完成。

  1. 备份配置文件模板:
cp harbor.yml.tmpl harbor.yml
  1. 修改 harbor.yml: 使用文本编辑器打开 harbor.yml，至少修改以下关键配置：
http:
  port:8080

# 注意，这里不需要HTTPS，所以要注释掉 HTTPS 部分。
# https:
#   port: 443
#   certificate: /your/certificate/path
#   private_key: /your/private/key/path

# Harbor 的访问地址 (域名或 IP)
hostname: harbor.leops.local# 路径二用户使用域名; 路径一用户使用 localhost 或 IP

# Harbor 的外部访问 URL (协议 + 主机名)
# 如果不打算配置 HTTPS，保持 http。路径一用户同样修改域名部分。
external_url: http://harbor.leops.local

# Harbor 管理员 (admin) 的初始密码 (!!务必修改为强密码!!)
harbor_admin_password: Harbor12345

# 数据库内部使用的密码 (!!建议修改为强密码!!)
database:
  password: root123

# Harbor 存储镜像等数据的路径 (确保存储空间足够)
data_volume: /data/harbor/harbor_data# 确保 /data/harbor 目录存在或有权限创建

# 其他配置可以暂时保持默认

重要提示 (路径一用户): 如果你使用 localhost 或 IP，并且没有配置 HTTPS，你需要告诉你的 Docker 客户端信任这个 HTTP Registry。编辑 Docker 的 daemon.json 文件 (Linux: /etc/docker/daemon.json, Docker Desktransform: translateY( Settings -> Docker Engine)，添加 insecure-registries 配置，然后重启 Docker 服务：

{
  "insecure-registries": ["harbor.leops.local"]
  // ... 其他配置，如 registry-mirrors ...
}
  1. 安装 Harbor: install.sh 脚本会根据 harbor.yml 生成部署所需的 docker-compose.yml 等文件。
# --with-trivy 表示同时启用内置的 Trivy 镜像扫描功能
bash ./install.sh --with-trivy

只有首次安装时需要执行 install.sh，后续升级或修改配置只需执行 ./prepare --with-trivy && docker compose up -d 即可。

启动 Harbor

使用 docker compose (或旧版的 docker-compose) 启动 Harbor 服务。

sudo docker compose up -d

等待所有容器启动完成。你可以使用 docker compose ps 查看状态。

配置 Trivy 镜像扫描 (可选优化)

Trivy 用于扫描镜像中的安全漏洞。默认情况下，它会从 GitHub 等源更新漏洞数据库。如果你的服务器访问这些源速度慢，可以配置国内镜像源。

  1. 修改 Trivy 环境变量: 编辑 common/config/trivy-adapter/env 文件 (注意：这个文件是在执行 ./prepare 后生成的)。
# 在文件末尾追加以下内容 (如果已有则修改)
vim common/config/trivy-adapter/env

添加或修改以下行：

SCANNER_TRIVY_DB_REPOSITORY=ghcr.nju.edu.cn/ghcr.io/aquasecurity/trivy-db,m.daocloud.io/ghcr.io/aquasecurity/trivy-db,ghcr.io/aquasecurity/trivy-db
SCANNER_TRIVY_JAVA_DB_REPOSITORY=ghcr.nju.edu.cn/ghcr.io/aquasecurity/trivy-java-db,m.daocloud.io/ghcr.io/aquasecurity/trivy-java-db,ghcr.io/aquasecurity/trivy-java-db
  1. 重启 Trivy 相关服务使配置生效:
sudo docker compose restart trivy-adapter core

注意: Harbor 版本不同，需要重启的服务可能略有差异，通常重启 trivy-adapter 和 core 服务即可。
(进阶) Trivy 离线扫描配置:
如果你的 Harbor 完全无法访问外网，可以配置 Trivy 进行离线扫描。

  1. 修改 harbor.yml: 添加或修改 trivy 配置部分：
trivy:
  skip_update: true # 关闭在线更新缺陷数据库
  skip_java_db_update: true # 关闭在线更新java缺陷数据库
  # offline_scan: true # 在较新版本中，此选项可能不再需要，skip_update 已足够
  1. 重新执行 ./prepare: sudo ./prepare --with-trivy
  2. 手动下载数据库: 在一台可以访问网络的机器上下载数据库文件，然后传输到 Harbor 服务器。或者在 Harbor 服务器上临时配置网络代理下载：
# 确保 Harbor 容器已启动
# 下载主数据库
sudo docker exec trivy-adapter trivy image --download-db-only --db-repository ghcr.nju.edu.cn/ghcr.io/aquasecurity/trivy-db
# 下载 Java 数据库
sudo docker exec trivy-adapter trivy image --download-java-db-only --java-db-repository ghcr.nju.edu.cn/ghcr.io/aquasecurity/trivy-java-db
  1. 重启服务: sudo docker compose up -d (或重启 trivy-adapter 和 core)。

配置 Nginx 代理

在 /data/nginx/nginx_data/conf.d 目录下创建一个 harbor.conf 文件：

server {
    listen 80;
    server_name harbor.leops.local;

    access_log /var/log/nginx/harbor_access.log;
    error_log /var/log/nginx/harbor_error.log;

    location / {
        proxy_pass http://192.168.77.140:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $x_forwarded_proto;

        proxy_buffering off;
        proxy_request_buffering off;

        proxy_send_timeout 900;
        proxy_read_timeout 900;
    }
}

重载 Nginx 配置：

docker exec nginx-proxy sh -c "nginx -t && nginx -s reload"

访问和使用 Harbor

  1. 登录 Harbor UI:
  • 在浏览器中访问你在 harbor.yml 中配置的 external_url (例如 http://harbor.leops.local 或 http://localhost)。
  • 使用用户名 admin 和你设置的 harbor_admin_password 登录。
  1. 创建项目 (Project):
  • 登录后，点击"项目" -> “新建项目”。
  • 根据我们在设计篇的规划，创建以下项目：
  • common: 用于存放通用的基础镜像 (系统层、工具层、运行层)。设置为公开项目，方便拉取。
  • dev: 用于存放开发环境的应用镜像。可以设置为私有。
  • test: 用于存放测试环境的应用镜像。可以设置为私有。
  • prod: 用于存放生产环境的应用镜像。可以设置为私有。
  1. 从 Docker CLI 登录 Harbor:
# 使用你在 harbor.yml 中配置的 hostname
docker login harbor.leops.local
# 或者 (路径一用户)
# docker login localhost
# docker login <你的IP>

# 输入用户名: admin
# 输入密码: <你设置的 harbor_admin_password>
  1. 推送镜像示例:
# 1. 给镜像打上 Harbor 的标签 (格式: <harbor_hostname>/<项目名>/<镜像名>:<标签>)
docker tag nginx:1.27-alpine harbor.leops.local/library/nginx:1.27-alpine

# 2. 推送镜像到 Harbor 的 library 项目
docker push harbor.leops.local/library/nginx:1.27-alpine
  1. 从 Harbor 拉取镜像:
docker pull harbor.leops.local/library/nginx:1.27-alpine

Harbor 日常维护 (简介)

  • 项目保留策略 (Image Retention): 在项目设置中配置，可以按时间、数量保留镜像，自动清理旧镜像，节省空间。可以配置排除特定标签（如 latest）或保留无 Tag 的镜像。
  • 系统清理服务 (Garbage Collection): 在系统管理中配置，定期运行 GC 可以回收项目保留策略删除的镜像层所占用的磁盘空间。

更多关于 Harbor 的使用和管理，请参考 Harbor 官方文档。

现在，你已经拥有了一个功能强大的私有镜像仓库，可以开始存储和管理你的 Docker 镜像了！

【云原生】第十二篇--docker容器镜像仓库Harbor部署
检哥说IT的博客
07-12 3328
由于国内访问国外的容器镜像仓库速度比较慢，因此国内企业创建了容器镜像加速器，以方便国内用户使用容器镜像。Harbor是VMware公司开源的企业级DockerRegistry项目，其目标是帮助用户迅速搭建一个企业级的Dockerregistry服务。它以Docker公司开源的registry为基础，提供了管理UI，基于角色的访问控制(Role Based Access Control)，AD/LDAP集成、以及审计日志(Auditlogging) 等企业用户需求的功能，同时还原生支持中文。...
【K8S 六】Harbor镜像仓库高可用方案（更新：2022-06-21）
刘元林的博客
06-14 3829
主备方案一：Push镜像到主节点，每次通过vip登录即可（无需判断节点角色），备节点设置“Pull-based”复制模式和“定时”触发模式高频拉取镜像：每小时甚至每分钟拉取一次；（资源浪费） 主备方案二：Push镜像到备节点，每次登录需要先判断哪个是备节点（因为vip会浮动），备节点设置“Push-based”复制模式和“事件驱动”触发模式推送镜像；（较完美：Push镜像到备节点，需要在操作台设置备节点IP到reg.harbor.4a的映射） ............
Harbor镜像仓库部署
^_^TaeYang-Jade^_^
11-24 769
一、简介 Harbor是VMware中国研发团队开发并开源的企业级Docker Registry项目，对中文支持很友好。 Harbor是一个用于存储和分发Docker镜像的企业级Registry服务器。 Harbor具有如下特点： 基于角色的访问控制 - 用户与Docker镜像仓库通过“项目”进行组织管理，一个用户可以对多个镜像仓库在同一命名空间（project）里有不同的权限 ...
私有镜像仓库Harbor部署
weixin_30550271的博客
07-12 130
概述 Harbor使用了基于角色的访问控制策略，当从Harbor中拉去镜像的时候，首先要进行身份认证，认证通过后才可以拉取镜像。在命令行模式下，需要先执行docker login，登陆成功后，才可以docker pull。通常情况下，在私有云环境中使用kubernetes时，我们要从docker registry拉取镜像的时候，都会给docker daemo配置–insecure-re...
搭建harbor镜像仓库
regret_的博客
10-01 292
6.把harbor.yml.tmpl复制一份为harbor.yml，然后修改其中的内容。10.输入用户密码都是admin后进入harbor web项目。8.做好域名解析，不然hostname使用ip地址也可以。9.访问harbor.linux.cn。2.安装docker-compose。5.进入安装包，进入harbor目录。1.安装Docker Engine。3.下载对应的harbor版本，如。11.harbor项目可以使用了。
harbor镜像仓库的部署
魏志标的博客
05-07 1292
前面介绍了harbor镜像仓库的基本概念，接下进行harbor的部署 一、harbor仓库的搭建（http模式） 准备条件： 系统要安装docker，有docker-compose命令 下载离线包： wget https://github.com/goharbor/harbor/releases/download/v2.1.1/harbor-offline-installer-v2.1.3.tgz 上传至系统进行解压： tar -zxvf harbor-offline-installer-v2.1.1.t
部署Harbor镜像仓库
weixin_60092693的博客
11-27 566
学习笔记
apiVersion: v1 kind: Pod metadata: name: my-pod spec: containers: - name: my-container image: harbor:443/项目名/镜像名:标签 # 例如：harbor:443/library/nginx:latest imagePullSecrets: - name: harbor-secret # 引用刚创建的 Secret 那个secret怎么设置的
最新发布
07-11
我们正在处理用户关于Kubernetes中为Pod设置imagePullSecrets以从私有Harbor仓库拉取镜像的问题。 根据提供的引用，我们可以总结出以下步骤： 1. 创建一个Docker注册表类型的Secret（docker-registry），用于存储...
anapsix/alpine-java:8-server-jre-unlimited
02-05
Docker是一个开源的应用容器引擎，允许开发者打包他们的应用以及应用的依赖包到一个可移植的容器中，...开发者和运维工程师可以使用这个镜像来创建Java应用的容器化服务，特别是需要在生产环境中部署Java应用的场景。
运维第二篇：Docker--Harbor私有镜像仓库搭建
u012817905的博客
03-08 590
运维第二篇：Docker--Harbor私有镜像仓库搭建 先说个我认为比较重要的事情：自从Docker技术出现以后，linux运维的技术门槛大大第降低了。有了Docker以后，linux的程序部署基本已经和Windows一致了。先初始化一台linux服务器，然后安装上Docker。然后再想部署任何系统都直接下载一个官方镜像进行安装部署，可以说是特别的简单。 可以说比windows还简单，原先的管理员还需要源码包安装、调试什么的，下载就运行一个镜像完事，而且服务器需要部署的应用也相当有限，和浩如烟海的wi
Harbor镜像仓库安装配置及使用
zxz547388910的博客
10-10 3349
是一个开源的企业级Docker 镜像仓库，提供了许多功能，包括用户管理、访问控制、镜像复制和安全扫描。
Harbor企业镜像仓库部署
z2050025507的博客
08-07 702
最近公司将项目全部打包成镜像有部署私有仓库服务的需求，经过几轮商讨，最终选择 Docker Harbor，Docker Harbor 有可视化的 Web 管理界面可以方便管理Docker 镜像操作也很方便简单，又提供了多个项目的镜像权限管理控制功能等。出现这问题的原因是 Docker 自从 1.3.X 之后 Docker Registry 交互默认使用的是 HTTPS，但是搭建私有镜像默认使用的是 HTTP 服务，所以与私有镜像交互时出现以下错误。另外，默认情况下Harbor 将镜像存储在本地文件系统上。
Harbor镜像仓库
qq_42211536的博客
08-22 2947
在前面文章中使用docker安装软件，例如：MySQL、Nacos等，都是从官方的镜像仓库中拉取镜像后，然后创建并启动MySQL容器、Nacos容器等，后来又使用 docker 来制作自己的镜像，若是制作自己镜像后，也想像官方制作的MySQL镜像一样，供给别人使用，并且作为镜像的拥有者，还能对镜像进行更新迭代，别人随时想使用，直接拉取镜像，运行成容器即可。之前教程中是将微服务的每个模块制作成一个个的镜像文件，然后通过docker 运行成容器就能完成项目的部署。
HarBor镜像仓库
wangweh的博客
07-31 338
这里写自定义目录标题欢迎使用Markdown编辑器新的改变功能快捷键合理的创建标题，有助于目录的生成如何改变文本的样式插入链接与图片如何插入一段漂亮的代码片生成一个适合你的列表创建一个表格设定内容居中、居左、居右SmartyPants创建一个自定义列表如何创建一个注脚注释也是必不可少的KaTeX数学公式新的甘特图功能，丰富你的文章UML 图表FLowchart流程图导出与导入导出导入 欢迎使用Ma...
Harbor—镜像仓库
热门推荐
m0_63674789的博客
06-05 1万+
Harbor是由VMware公司开源的企业级的Docker Registry管理项目，它包括权限管理(RBAC)、LDAP、日志审核、管理界面、自我注册、镜像复制和中文支持等功能。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

企鹅侠客

您的打赏是我创作旅程中的关键燃

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值