美国服务器部署Harbor镜像仓库前,要核对哪些端口、存储与证书条件
美国服务器交付后再发现 Harbor 的 443 端口无法从构建机访问、镜像数据落在系统盘,或证书只被浏览器信任却不被 Docker 节点信任,往往意味着仓库虽然能打开页面,却不能投入使用。实施前应分别核对访问路径与端口、持久化存储、域名与证书,并用实际会执行推送和拉取的客户端作为验收对象。
判断“条件已具备”不能只看美国服务器本机是否能启动容器。Harbor 对外服务涉及开发者、CI 构建机、Kubernetes 节点等不同来源;镜像层、数据库等数据需要在重启后保留;TLS 证书还必须与客户端使用的仓库地址一致。以下核对项以单台美国服务器部署 Harbor 为主要场景,若前面还有负载均衡或使用对象存储,应按实际链路增加对应检查。
A5数据提供美国物理服务器资源,覆盖常规Xeon、AMD EPYC及多种内存、NVMe存储配置,可为Harbor镜像仓库及其数据库、容器任务提供独立的计算与持久化资源。美国系列还提供CN2 GIA等线路方案,适合承载面向美国用户的制品分发、构建节点访问和企业内部研发协作场景,并可结合不同数据规模匹配相应硬件组合。
先固定访问地址与部署边界
关键对象:仓库对外地址。先确定客户端最终使用的完整地址,例如 harbor.example.com,以及是否使用标准 HTTPS 端口。DNS 解析、Harbor 对外地址配置、证书名称、docker login 所填地址和镜像标签中的仓库地址,都应指向同一个对外入口。
如果前面有负载均衡,应区分“客户端访问负载均衡”和“负载均衡访问 Harbor”两段链路。客户端不需要直接访问后端容器端口;反过来,仅在美国服务器上测试 localhost 成功,也不能证明远端节点可以拉取镜像。采用非标准 HTTPS 端口时,还要确认客户端命令、镜像标签、负载均衡监听和安全组规则都包含该端口,不能只在浏览器访问时手动补上端口。
关键对象:运行环境。实施前核对服务器的 CPU 架构、操作系统、容器运行环境及 Compose 工具,是否符合拟使用的 Harbor 版本要求;同时确认安装包版本、部署方式和配置文件属于同一套方案。不同版本的组件、默认配置和兼容条件可能变化,不宜拿另一版本的端口或目录清单直接验收。
服务器时间也应保持准确。时间明显偏差可能影响证书有效期判断、登录令牌及跨节点排查。部署人员需要具备安装和管理容器、写入选定数据目录及读取证书私钥的授权;不应为了通过检查,直接把数据目录改成所有人可写,或将私钥放入公开目录。
端口:按访问方向核对,不把内部组件全部放行
端口验收的依据是实际访问路径,不是 Harbor 启动后出现了多少监听端口。下表中的 80、443 是常见对外方案;最终仍以拟部署配置和入口监听为准。
| 关键对象 | 对应核对项 | 判断依据 |
|---|---|---|
| HTTPS 入口 | 客户端到仓库域名的 443/TCP,或明确选定的非标准端口 | 开发者、CI 构建机及需要拉取镜像的节点,均能经 DNS 到达该入口;服务器防火墙、云平台安全组及上游负载均衡规则一致 |
| HTTP 入口 | 是否确实需要 80/TCP | 仅在使用 HTTP 跳转、特定证书申请验证方式等明确场景时开放;若没有用途,不把开放 80 当作 Harbor 必需条件 |
| 运维入口 | SSH 的实际监听端口及允许来源 | 管理员可从授权地址维护服务器,普通镜像客户端无需访问该端口;不能因部署 Harbor 而将运维端口扩大为全网可访问 |
| Harbor 内部服务 | 数据库、缓存、Registry 等组件间连接 | 按部署方案在容器网络或受控内网中连通;不因为组件需要通信,就把其内部端口加入公网入站规则 |
| 前置负载均衡 | 客户端到负载均衡、负载均衡到 Harbor 两段连接 | 监听端口、后端端口及健康检查路径与实际配置一致;检查直连后端是否会形成不必要的旁路入口 |
在美国服务器上开放了 443/TCP,不等于所有客户端都能访问。还需核对域名在客户端所在地的解析结果、上游网络策略,以及来源侧的出站规则。若业务主要在其他地区构建和部署镜像,验收至少应覆盖一台真实构建机和一台真实拉取节点,而不是仅从美国服务器本机测试。

未部署 Harbor 前,可以用服务器现有工具检查拟使用的端口是否已被占用;该命令只查看监听状态,不更改防火墙:
ss -lntp
如果 443 已由其他服务占用,应先决定复用现有入口、调整监听规划,还是使用独立地址;不要直接停止未知服务。部署后的端口验收则应从客户端发起 HTTPS 请求,并结合入口日志判断请求是否真正到达 Harbor。
存储:确认数据落点、容量口径与恢复条件
关键对象:持久化数据目录。Harbor 的镜像层不是唯一需要保留的数据。项目与制品元数据、数据库数据、任务相关数据,以及启用漏洞扫描等功能后产生的附加数据,都应纳入存储规划。实施前要确认拟使用版本的持久化目录配置,以及实际挂载点;不能只看到服务器挂有一块大容量数据盘,就认定 Harbor 会自动使用它。
验收时应分别核对以下条件:

- 落点:镜像及其他需持久化的数据实际写入哪块盘;重启容器或服务器后,挂载能否按预期恢复。尤其要避免数据目录名称看似位于数据盘,实际却写进系统盘。
- 可用量:按预计保留的镜像层数据、增长量、附加数据和安全余量估算,而不是用代码仓库大小或镜像标签数量直接代替磁盘需求。相同镜像层可能复用,但删除标签也不代表空间立即全部释放。
- 磁盘能力:确认可用空间之外,还要关注写入性能和 inode 等资源。大量并发推送、扫描任务与备份可能同时占用 I/O;容量足够但长期写入受阻,同样不满足交付条件。
- 权限与恢复:部署进程是否可按方案读写数据目录;备份是否覆盖需要共同恢复的镜像数据与元数据,以及是否明确恢复到什么时间点。
容量可以先用业务保留策略做保守估算。例如,预计已有和首批导入的镜像层占 30 GB,之后平均每天新增且未被复用的镜像层为 8 GB,保留 30 天,数据库、日志及其他数据暂按 30 GB 预留,再留出 20% 的空闲比例。按十进制 GB 计算,需容纳的数据约为 30 + 8 × 30 + 30 = 300 GB;要让这 300 GB 不超过可用空间的 80%,规划容量约为 300 ÷ 0.8 = 375 GB。这只是估算方法:实际增长取决于镜像层复用、清理策略和功能使用情况,不能把 375 GB 当作所有 Harbor 环境的固定规格。
若采用兼容的对象存储保存镜像数据,检查对象就从“本地镜像盘是否足够”转为“桶、区域、访问凭据、网络连通性及权限是否匹配配置”;数据库等其他持久化数据仍需单独安排。不要把对象存储可用,误判成整套 Harbor 数据已经具备备份和恢复能力。
在确定目录前,可检查候选路径所属文件系统及剩余空间。若目录尚不存在,应先由管理员按部署方案创建,再核对其真实挂载点;不要为运行下面的只读检查临时修改生产目录权限。
findmnt -T /data
df -hT /data
这里的 /data 只是候选路径示例,应替换为实际规划的持久化目录。如果它仍落在系统盘,或重启后的挂载没有保障,应先处理存储方案,再导入镜像。
证书:验收对象是客户端使用的仓库域名
关键对象:域名与服务端证书。证书应覆盖客户端实际访问的仓库域名,处于有效期内,服务端能提供所需的证书链,私钥与证书匹配。DNS 解析到负载均衡时,证书应按客户端连接的入口检查;不能仅凭 Harbor 后端持有证书,就认定外部 TLS 已正确配置。
关键对象:TLS 终止位置。由 Harbor 直接提供 HTTPS,和由前置负载均衡终止 HTTPS、再转发到 Harbor,是两种不同的核对路径。后者需确认对外地址及转发配置不会让登录或镜像请求跳转到内部主机名、错误端口或 HTTP 地址;后端链路采用何种保护方式,也应符合业务对内网传输的要求。不要只以首页出现锁形图标作为验收依据,镜像客户端还会访问 Registry API。
关键对象:客户端信任。公有受信任证书与企业内部 CA 证书的交付工作不同。若使用内部 CA,开发者终端、CI 运行环境及每台需要拉取镜像的节点,都可能需要按各自运行环境安装相应信任材料。浏览器能访问,只能证明该浏览器所在环境的信任状态,不能代替 Docker 或节点运行时的验证。实施前还应明确证书续期负责人和到期前检查方式,避免仓库投入使用后因证书到期影响推送、拉取。

部署后可从客户端查看入口返回的证书名称、期限和证书链:
openssl s_client -connect harbor.example.com:443 -servername harbor.example.com -showcerts
将域名和端口替换为实际入口。此命令用于观察入口证书,不能单独证明所有镜像客户端都信任该证书;最终仍要在实际构建机和拉取节点上验证。
交付前,用一次真实推拉闭合核对
页面可访问不等于镜像仓库可用。验收应选一个测试项目,使用计划交付的账户或机器人凭据,在真实构建环境中登录并推送测试镜像,再从实际部署节点拉取。这样可以同时检验域名、TLS 信任、入口端口、Registry API、项目权限和数据写入路径。
测试时应分清失败发生在哪一层:域名无法解析或连接超时,优先核对客户端到美国服务器入口的网络规则;证书报错,核对名称、证书链与客户端信任;登录成功但无法推送,核对项目权限、配额及存储状态;推送成功但其他节点无法拉取,则重点检查该节点的网络和证书环境。测试镜像的清理应遵循仓库保留策略,不要为了回收空间直接删除后端文件。
交付记录保留对外域名与端口、允许访问的客户端来源、数据目录及挂载点、容量估算口径、证书到期时间与续期责任人,以及推拉测试的来源位置和结果即可。若其中任何一项尚未确定,应将其列为部署前待确认条件,而不是等 Harbor 上线后再用临时开放端口、跳过证书校验或迁移数据目录来补救。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5385.html



