Linux服务器如何部署Harbor镜像仓库?存储与访问入口怎么配置

发布人:A5数据发布时间:2026-11-06 11:25阅读量:102

Harbor 首次部署的关键,不只是把容器启动起来,还要让镜像数据落在可持久化磁盘上,并让客户端通过正确的域名和 HTTPS 访问。下面以一台运行 Linux、已安装 Docker Engine 和 Docker Compose 插件的服务器为例,部署 Harbor 在线安装包;示例版本使用 v2.10.0,实际操作时应按环境要求选择并固定版本,不要直接依赖浮动的“最新版”。

根据全文核心主题形成自然、专业、克制的技术文章主题场景

A5idc数据提供中国香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器资源,可为Harbor镜像仓库提供稳定的容器运行基础。不同产品覆盖NVMe、SSD及大容量HDD存储,并提供多种CPU、内存、带宽和IP配置,能够结合镜像规模、持久化数据与访问区域,承载企业内部镜像管理、跨地区协作及业务发布所需的仓库环境。

准备服务器与访问条件

部署前先确认服务器架构、磁盘空间、网络入口和域名解析。Harbor 会运行多个容器,在线安装时还需要从镜像仓库下载组件镜像;服务器需能访问对应下载地址。生产环境建议为 Harbor 单独准备数据盘,并使用可由客户端信任的 TLS 证书。

示例假定:

  • Harbor 域名为 reg.example.com,DNS 已解析到服务器地址。
  • 客户端通过 TCP 443 访问;如启用其他端口,应同步调整防火墙和客户端命令。
  • 数据目录为 /srv/harbor,该目录所在磁盘有足够空间,且不会随系统临时目录清理。
  • 服务器为常见的 x86_64 Linux。若使用 ARM 等其他架构,先确认所选 Harbor 安装包和组件镜像支持该架构。
  • 已准备证书和私钥,证书的 SAN(主题备用名称)包含 reg.example.com。

先检查系统资源、磁盘和容器工具:

uname -m
df -h
docker version
docker compose version
systemctl is-active docker

应确认 Docker 客户端和服务端均能正常返回版本信息,Compose 插件可运行,Docker 服务状态为 active。Harbor 所需 CPU、内存和磁盘空间会随并发访问、镜像数量及扫描任务变化;小规模试用可先预留数十 GB 数据空间,生产环境应根据镜像保留策略估算,并为增长留出余量。

确认域名解析结果和证书文件:

getent hosts reg.example.com
openssl x509 -in /path/to/server.crt -noout -subject -ext subjectAltName

解析结果应指向 Harbor 服务器;证书 SAN 中应包含 DNS:reg.example.com。如果证书由内部 CA 签发,还要确认 Docker 客户端所在主机信任该 CA。不要把证书校验错误当作长期可接受的访问方式。

下载并配置 Harbor

获取固定版本安装包

在服务器上创建安装工作目录,下载与所选版本对应的在线安装包并解压。示例 URL 使用固定版本号;如更换版本,需一并替换文件名和下载地址,并先核实该版本的发行包及兼容要求。

mkdir -p /opt/harbor-install
cd /opt/harbor-install

VERSION=2.10.0
curl -fLO "https://github.com/goharbor/harbor/releases/download/v${VERSION}/harbor-online-installer-v${VERSION}.tgz"
tar -xzf "harbor-online-installer-v${VERSION}.tgz"
cd harbor

如果下载失败,先检查服务器 DNS、出站网络和下载地址是否可达;不要通过关闭证书校验来绕过问题。正式环境可按组织的软件供应链要求校验发行包校验和或签名,并保存安装包及所用版本记录。

解压后检查安装目录:

ls -l

通常可看到 harbor.yml.tmpl、install.sh 等文件。后续配置会生成 Harbor 的 Compose 配置和运行所需文件。

配置域名、HTTPS 与持久化目录

先备份模板,再复制为实际配置文件:

cp harbor.yml.tmpl harbor.yml

编辑 harbor.yml,至少修改域名、HTTPS 证书路径、管理员密码和数据目录。以下是关键配置示例,实际文件中可能还有其他默认项,应保留与当前版本匹配的配置:

hostname: reg.example.com

https:
  port: 443
  certificate: /etc/harbor/cert/server.crt
  private_key: /etc/harbor/cert/server.key

harbor_admin_password: "替换为单独生成的强密码"

data_volume: /srv/harbor

hostname 只填写域名,不要带 https://、路径或末尾斜杠。证书和私钥路径必须与服务器上的真实路径一致。安装脚本通常需要读取私钥,因此应限制私钥权限,并以具备相应读取权限的账号执行安装。管理员密码不要沿用示例文字,也不要直接写入公开脚本或版本库。

创建证书目录和数据目录,并核实磁盘挂载位置:

install -d -m 0750 /etc/harbor/cert
install -d -m 0750 /srv/harbor
df -h /srv/harbor
ls -l /etc/harbor/cert/server.crt /etc/harbor/cert/server.key

如果证书目前在其他位置,可先复制到上述目录,再根据安全要求设置属主和权限。数据目录若尚未挂载到预期数据盘,应先处理磁盘挂载;不要在根分区空间不足时直接开始安装。

此处的 /srv/harbor 是镜像和 Harbor 相关数据的持久化位置。容器重建不应被理解为数据备份,重要环境仍需制定数据备份与恢复方案。

安装、启动与逐步验证

安装 Harbor 组件

在 Harbor 解压目录执行安装脚本:

cd /opt/harbor-install/harbor
sudo ./install.sh

在线安装会拉取所需镜像并生成运行配置,耗时取决于服务器网络和镜像大小。执行期间关注终端是否出现镜像下载失败、配置解析错误或证书文件不可读等提示。脚本成功结束后,检查容器状态:

sudo docker compose ps

主要服务应处于运行状态。若容器持续重启或状态为 exited,不要反复执行安装脚本覆盖排查线索,先查看对应容器日志:

sudo docker compose logs --tail=100

如果当前目录不是 Harbor 安装目录,Compose 命令可能找不到项目配置;应先切回生成了 docker-compose.yml 的目录。

检查端口与 HTTPS 入口

确认服务器正在监听 443 端口,并从服务器本机访问域名:

sudo ss -lntp | grep ':443'
curl -I https://reg.example.com

curl 应能完成 TLS 握手并获得 HTTP 响应。返回登录页相关的重定向或页面响应通常表示入口已通;具体状态码会因版本和访问路径而异。若出现证书名称不匹配、证书不受信任或连接超时,应分别检查证书 SAN、客户端信任链、DNS 解析、防火墙及 Harbor 容器状态。

防火墙仅开放实际需要的入口。若使用系统防火墙,应先确认规则管理工具和现有策略,再按该发行版的规则管理方式开放 TCP 443;不要直接清空防火墙规则。若服务器前方还有云平台安全组或上游防火墙,也要在对应位置放行客户端来源到 443 的流量。

客户端登录并验证镜像读写

在测试客户端上确认域名可解析、证书可信,然后登录 Harbor:

docker login reg.example.com

按提示输入 Harbor 账号和密码。Harbor 默认管理员账号通常为 admin,密码使用配置文件中设置的值。首次登录后应按管理要求修改或轮换密码,并创建用于日常推送的独立账号,避免长期共用管理员账号。

推送前,在 Harbor 界面创建一个测试项目,例如 demo。然后选取客户端已有镜像进行标记、推送和拉取:

docker tag alpine:3.20 reg.example.com/demo/alpine:3.20
docker push reg.example.com/demo/alpine:3.20
docker pull reg.example.com/demo/alpine:3.20

如果本地没有该测试镜像,需先从客户端可访问的镜像来源获取,或换用已有镜像。成功标准是推送完成、Harbor 项目中能看到对应仓库和标签,并且客户端可以再次拉取。

常见异常及处理顺序

排查时先从网络和配置入手,再检查容器与存储,避免一开始就删除数据或重装。

现象优先检查项处理方向
域名无法访问或连接超时DNS、服务器监听端口、安全组、防火墙确认域名指向正确地址,且客户端到服务器 TCP 443 可达
TLS 证书报错SAN、证书链、证书与私钥是否匹配、客户端 CA 信任更换为匹配域名的证书;内部 CA 场景在客户端正确安装 CA
安装脚本拉取镜像失败出站网络、DNS、下载服务可达性修复网络或按组织批准的离线流程准备镜像,不要跳过来源校验
容器反复退出docker compose ps、容器日志、配置路径根据日志修正配置、权限或端口冲突后再启动
docker push 被拒绝是否登录、项目是否存在、账号权限创建项目并核对账号是否具有该项目的推送权限
推送或启动时提示磁盘不足df -h、df -i、Docker 数据目录空间清理前先确认数据归属和备份状态;扩容或调整存储后再恢复服务

若配置改动后需要重新生成配置,可在 Harbor 安装目录运行对应版本支持的准备脚本;执行前备份 harbor.yml,并确认配置内容无误。不要通过随意修改生成的 Compose 文件来替代 Harbor 主配置,否则后续重新生成时可能被覆盖。

如果 Docker 客户端提示仓库不安全,优先修复证书链和客户端 CA 信任。将仓库加入 Docker 的不安全仓库列表会降低传输安全性,不适合作为常规生产配置。

结果检查与回滚

部署完成后,逐项验收:

  • docker compose ps 显示 Harbor 相关服务正常运行,没有持续重启的容器。
  • 域名解析到预期服务器,客户端可通过 HTTPS 访问,证书名称和信任链检查通过。
  • 管理员可登录,测试项目和测试账号权限符合预期。
  • 测试镜像可以推送并重新拉取,镜像数据落在配置的持久化目录所在磁盘。
  • 服务器防火墙和上游访问控制只开放所需端口;安装版本、配置文件和证书部署位置有记录。

若安装失败或决定撤回,先从 Harbor 安装目录停止服务:

cd /opt/harbor-install/harbor
sudo docker compose down

该操作用于停止并移除 Compose 管理的容器和网络,不等同于删除持久化数据。回滚前应保存 harbor.yml、安装包、日志及必要的数据备份;不要执行 docker compose down -v,也不要直接删除 /srv/harbor。需要恢复时,优先使用原版本安装包和已备份配置,确认数据目录及备份可用后再启动。若确需彻底清理数据,应先明确影响范围、完成备份并取得维护授权,再单独执行清理;删除后通常无法靠重新运行安装脚本恢复原镜像。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7876.html

相关推荐