---
title: "Harbor 私有镜像仓库：多台机器拉同一个版本"
description: "自建 Harbor 的适用场景、交付内容、存储与备份规划，以及什么时候 registry:2 就够用。"
canonical: "https://localdeploy.dev/zh/services/harbor"
source: "content/pages/zh/services/harbor.md"
lang: "zh"
altPath: "/services/harbor"
---


## 什么时候需要

镜像只留在本机，换台机器就得重新构建；几个人一起用时，也说不清哪个镜像还能用、哪个是上周的。自建 Harbor 之后，多台机器拉同一个版本，回滚就是换个 tag。

## 交付什么

- Harbor 部署：Compose 或 Helm，按你的机器选。
- 项目、用户和权限：谁只能拉、谁能推、哪些项目公开。
- 存储规划：本地磁盘还是 S3 兼容对象存储，容量怎么估。
- 垃圾回收和保留策略：删掉的 tag 什么时候真正释放空间。
- 备份：配置、数据库、镜像清单分别怎么备，怎么验证恢复。
- 升级路径：版本跨度大时先升到哪个中间版本。
- 从本地镜像迁过去：重新 tag、推上去、改 Compose 里的镜像地址。

## 不包含

- 镜像内容的安全审计。里面装了什么，得你自己确认。
- CI 流水线改造，只给推送和拉取的命令示例。
- 存储和备份介质。磁盘、对象存储和异地副本由你提供。

## 适合谁

开始频繁构建镜像、需要版本回滚，或者几台机器要共用一套镜像。只有一台机器、偶尔构建，用 `registry:2` 甚至本地镜像就够了，不必上 Harbor。

## 怎么开始

发邮件说明：几台机器、镜像大概多少、现在怎么存、备份放哪。确认范围后给报价。

## 常见问题

### 和 registry:2 比，Harbor 重在哪？

Harbor 带项目权限、复制、GC、扫描和 Web 界面，组件也多。小规模用 registry:2 更省事；要多用户和保留策略再上 Harbor。

### 磁盘要留多少？

看镜像数量和保留天数。交付时会按你的实际情况估，并给一条清理兜底命令。

## 相关

- [Traefik 反向代理](/zh/services/traefik)
- [k3d / k3s](/zh/services/k8s)
- [定价与付款](/zh/pricing)

## Structured data

```json
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "localdeploy.dev",
  "url": "https://localdeploy.dev/",
  "description": "localdeploy.dev helps home labs and small teams assess the hardware they already own, then deploy a local AI assistant with Cloudflare, self-hosting and containers. Free basics, fixed-scope deployment packages, clear boundaries."
}
```
