Harbor命令速查
安装部署、服务管理、项目与制品 API、保留策略、复制同步、权限、GC、扫描与备份升级等 137 条命令
共 137 条命令 · 11 类场景 · 点击右侧图标可复制
| 命令 / 接口 | 说明 | 复制 |
|---|---|---|
tar xzvf harbor-offline-installer-v2.11.0.tgz -C /opt | 解压离线安装包到安装目录 | |
cp /opt/harbor/harbor.yml.tmpl /opt/harbor/harbor.yml | 从模板生成配置文件,后续所有修改都在 harbor.yml | |
hostname: harbor.example.com | 必改项:对外访问域名或 IP,影响镜像地址与证书 | |
harbor_admin_password: Harbor12345 | 初始管理员密码,装完立即登录修改 | |
data_volume: /data | 数据目录,镜像、数据库、日志默认都落在这里 | |
database: password: root123 与 max_idle_conns: 50 | 内置 PostgreSQL 配置,生产建议改用外部数据库 | |
https: certificate: /data/cert/harbor.crt 与 private_key: /data/cert/harbor.key | 启用 HTTPS,生产环境必须开启,否则 docker push 受限 | |
openssl req -x509 -newkey rsa:4096 -nodes -keyout harbor.key -out harbor.crt -days 3650 -subj "/CN=harbor.example.com" | 生成自签证书(仅测试用,生产用企业 CA) | |
./prepare | 根据 harbor.yml 生成 docker-compose.yml 与各组件配置,改配置后必须重跑 | |
./install.sh | 一键安装并启动全部组件 | |
./install.sh --with-trivy --with-chartmuseum | 同时启用漏洞扫描与 Helm Chart 仓库 | |
./install.sh --help | 查看安装脚本支持的参数 | |
docker compose ps | 确认 core、jobservice、registry、portal、nginx 等容器状态 | |
external: 配置外部 PostgreSQL 与 Redis | 高可用部署:数据库与缓存外置,多节点共享对象存储 |
| 命令 / 接口 | 说明 | 复制 |
|---|---|---|
cd /opt/harbor && docker compose ps | 查看各组件健康状态,unhealthy 需立即排查 | |
docker compose stop | 停止全部组件(保留数据与容器) | |
docker compose start | 启动已创建的容器 | |
docker compose restart core | 只重启核心 API 服务,改动配置后常用 | |
docker compose down | 删除容器与网络(不含数据卷),重装前使用 | |
docker compose logs -f core | 实时跟踪核心服务日志 | |
docker compose logs --tail=200 jobservice | 查看任务服务日志,复制、GC、扫描任务都在这 | |
tail -f /var/log/harbor/core.log | 查看宿主机上的核心日志文件 | |
./prepare && docker compose up -d | 修改 harbor.yml 后的标准生效流程 | |
curl -k https://harbor.example.com/api/v2.0/health | 健康检查接口,返回各组件状态 | |
curl -k https://harbor.example.com/api/v2.0/ping | 轻量存活探针,适合监控脚本 | |
curl -k https://harbor.example.com/api/v2.0/systeminfo | 查看版本、认证模式与存储驱动 | |
systemctl status docker 与 systemctl restart docker | Docker 服务异常会连带所有容器退出 | |
ss -lntp | grep -E ":80|:443" | 确认 80/443 监听正常,端口被占用会导致安装失败 |
| 命令 / 接口 | 说明 | 复制 |
|---|---|---|
curl -k -u admin:密码 -X POST "https://harbor.example.com/api/v2.0/projects" -H "Content-Type: application/json" -d "{\"project_name\": \"app\", \"public\": false}" | 创建私有项目(public 为 false 时需登录才能拉取) | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/projects?page=1&page_size=20" | 分页列出项目 | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/projects?name=app" | 按名称查询项目 | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/projects/app" | 查看项目详情,含存储配额与仓库数 | |
curl -k -u admin:密码 -X PUT "https://harbor.example.com/api/v2.0/projects/app" -H "Content-Type: application/json" -d "{\"metadata\": {\"public\": \"true\"}}" | 修改项目属性(公开、自动扫描、内容信任等) | |
curl -k -u admin:密码 -X PUT "https://harbor.example.com/api/v2.0/quotas/{quota_id}" -H "Content-Type: application/json" -d "{\"hard\": {\"storage\": 107374182400}}" | 设置项目存储配额(示例 100GB) | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/quotas?reference=project&reference_id={project_id}" | 查询项目当前用量与配额 | |
curl -k -u admin:密码 -X POST "https://harbor.example.com/api/v2.0/projects/app/members" -H "Content-Type: application/json" -d "{\"role_id\": 3, \"member_user\": {\"username\": \"dev\"}}" | 添加项目成员并指定角色(1 项目管理员、2 开发者、3 访客、4 受限访客) | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/projects/app/members" | 查看项目成员与角色 | |
curl -k -u admin:密码 -X POST "https://harbor.example.com/api/v2.0/projects/app/robots" -H "Content-Type: application/json" -d "{\"name\": \"ci-push\", \"duration\": 365, \"level\": \"project\", \"permissions\": [{\"kind\": \"project\", \"namespace\": \"app\", \"access\": [{\"resource\": \"repository\", \"action\": \"push\"}]}]}" | 创建机器人账号给 CI 使用,避免共用管理员密码 | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/projects/app/robots?q=level=project" | 列出项目下的机器人账号 | |
curl -k -u admin:密码 -X POST "https://harbor.example.com/api/v2.0/projects/app/webhook/policies" -H "Content-Type: application/json" -d "{\"name\": \"push-hook\", \"targets\": [{\"type\": \"http\", \"address\": \"http://ci.example.com/hook\"}], \"event_types\": [\"PUSH_ARTIFACT\"]}" | 配置推送事件 Webhook,触发下游流水线 | |
curl -k -u admin:密码 -X DELETE "https://harbor.example.com/api/v2.0/projects/app" | 删除项目(会移除其下全部镜像与配额,谨慎) | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/projects/app/summary" | 查看项目仓库数、镜像数与角色分布 |
| 命令 / 接口 | 说明 | 复制 |
|---|---|---|
docker login harbor.example.com -u admin -p 密码 | 登录仓库,证书不受信时先配置 CA 或 insecure-registries | |
docker tag nginx:1.25 harbor.example.com/app/nginx:1.25 | 打上仓库地址前缀,项目名必须已存在 | |
docker push harbor.example.com/app/nginx:1.25 | 推送镜像,层已存在时会秒传 | |
docker pull harbor.example.com/app/nginx:1.25 | 拉取镜像 | |
docker logout harbor.example.com | 退出登录,清理凭据 | |
docker build -t harbor.example.com/app/api:20261102 . && docker push harbor.example.com/app/api:20261102 | 构建并推送,标签建议使用版本或提交号 | |
skopeo copy docker://nginx:1.25 docker://harbor.example.com/app/nginx:1.25 | 不落地磁盘直接同步镜像,跨仓库迁移首选 | |
helm registry login harbor.example.com -u admin -p 密码 | Helm OCI 仓库登录(需启用 chartmuseum 或 OCI 支持) | |
helm push app-1.0.0.tgz oci://harbor.example.com/app | 把 Chart 推送到 OCI 仓库 | |
oras push harbor.example.com/app/config:v1 ./config.json:text/plain | 推送任意 OCI 制品(配置文件、模型、策略包) | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/projects/app/repositories?page_size=50" | 列出项目下的全部仓库 | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/projects/app/repositories/nginx/artifacts?with_tag=true&with_label=true" | 查看仓库内制品与标签 | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/projects/app/repositories/nginx/artifacts/1.25" | 按标签查询单个制品详情 | |
curl -k -u admin:密码 -X DELETE "https://harbor.example.com/api/v2.0/projects/app/repositories/nginx/artifacts/1.25" | 删除指定标签的制品(digest 方式可删除整个镜像) | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/projects/app/repositories/nginx/artifacts/1.25/additions/build_history" | 查看镜像构建历史,确认基础镜像与构建命令 | |
curl -k -u admin:密码 -X POST "https://harbor.example.com/api/v2.0/projects/app/repositories/nginx/artifacts" -H "Content-Type: application/json" -d "{\"tag\": \"1.25-copy\", \"copy_from\": {\"project_name\": \"app\", \"repository_name\": \"nginx\", \"tag\": \"1.25\"}}" | 在仓库内复制制品标签,便于版本冻结 | |
curl -k -u admin:密码 -X POST "https://harbor.example.com/api/v2.0/projects/app/repositories/nginx/artifacts/1.25/labels" -H "Content-Type: application/json" -d "{\"id\": 1}" | 给制品打标签,便于按业务维度检索 |
| 命令 / 接口 | 说明 | 复制 |
|---|---|---|
curl -k -u admin:密码 -X POST "https://harbor.example.com/api/v2.0/projects/app/repositories/nginx/artifacts/1.25/immutable-tag-rules" -H "Content-Type: application/json" -d "{\"name\": \"release-\", \"match\": \"release-*\"}" | 设置不可变标签规则,防止覆盖已发布镜像 | |
curl -k -u admin:密码 -X POST "https://harbor.example.com/api/v2.0/projects/app/immutabletagrules" -H "Content-Type: application/json" -d "{\"name\": \"prod\", \"match\": \"prod-*\"}" | 项目级不可变标签规则 | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/projects/app/immutabletagrules" | 查看项目已配置的不可变规则 | |
curl -k -u admin:密码 -X POST "https://harbor.example.com/api/v2.0/projects/app/retentions" -H "Content-Type: application/json" -d "{\"algorithm\": \"or\", \"rules\": [{\"template\": \"latestPushedK\", \"params\": {\"latestPushedK\": 10}, \"tag_selectors\": [{\"kind\": \"doublestar\", \"pattern\": \"**\"}]}]}" | 保留策略:只保留最近推送的 10 个镜像,其余可清理 | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/projects/app/retentions" | 查看保留策略规则 | |
curl -k -u admin:密码 -X PUT "https://harbor.example.com/api/v2.0/projects/app/retentions/{id}" -H "Content-Type: application/json" -d "{\"algorithm\": \"or\", \"rules\": [{\"template\": \"nDaysSinceLastPush\", \"params\": {\"nDaysSinceLastPush\": 30}}]}" | 调整为只保留 30 天内推送的镜像 | |
curl -k -u admin:密码 -X GET "https://harbor.example.com/api/v2.0/projects/app/retentions/{id}/executions" | 查看保留策略执行记录与清理结果 | |
保留策略只标记可删除,空间需靠 GC 回收 | 清理流程:保留策略执行 → Jobservice 标记 → 手动触发 GC |
| 命令 / 接口 | 说明 | 复制 |
|---|---|---|
curl -k -u admin:密码 -X POST "https://harbor.example.com/api/v2.0/registries" -H "Content-Type: application/json" -d "{\"name\": \"remote-harbor\", \"type\": \"harbor\", \"url\": \"https://harbor2.example.com\", \"credential\": {\"access_key\": \"admin\", \"access_secret\": \"密码\", \"type\": \"basic\"}}" | 添加远端仓库,供复制规则使用 | |
curl -k -u admin:密码 -X POST "https://harbor.example.com/api/v2.0/registries/ping" -H "Content-Type: application/json" -d "{\"id\": 1}" | 测试远端仓库连通性与凭据 | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/registries" | 列出已配置的远端仓库 | |
curl -k -u admin:密码 -X POST "https://harbor.example.com/api/v2.0/replication/policies" -H "Content-Type: application/json" -d "{\"name\": \"sync-to-backup\", \"src_registry\": {\"id\": 0}, \"dest_registry\": {\"id\": 1}, \"dest_namespace\": \"app\", \"filters\": [{\"type\": \"name\", \"value\": \"app/**\"}], \"trigger\": {\"type\": \"manual\"}, \"deletion\": false, \"override\": true}" | 创建复制规则,触发方式可为 manual/event_based/scheduled | |
curl -k -u admin:密码 -X POST "https://harbor.example.com/api/v2.0/replication/executions" -H "Content-Type: application/json" -d "{\"policy_id\": 1}" | 手动触发一次复制并返回执行 ID | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/replication/executions?policy_id=1" | 查看复制执行历史与状态 | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/replication/executions/{id}/tasks" | 查看每个制品的复制结果,失败原因在此 | |
curl -k -u admin:密码 -X PUT "https://harbor.example.com/api/v2.0/replication/executions/{id}" -H "Content-Type: application/json" -d "{\"status\": \"Stop\"}" | 停止正在执行的复制任务 | |
curl -k -u admin:密码 -X POST "https://harbor.example.com/api/v2.0/replication/executions/{id}/tasks/{tid}/log" | 获取单个复制任务的详细日志 | |
filters: tag 过滤可用 pattern "v*" 排除 latest | 复制规则支持按名称与标签过滤,避免同步临时镜像 |
| 命令 / 接口 | 说明 | 复制 |
|---|---|---|
curl -k -u admin:密码 -X POST "https://harbor.example.com/api/v2.0/users" -H "Content-Type: application/json" -d "{\"username\": \"dev\", \"password\": \"密码\", \"email\": \"dev@example.com\", \"realname\": \"开发者\"}" | 创建普通用户 | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/users?q=username=dev" | 按用户名查询用户 ID | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/users/current" | 查看当前登录用户与管理员标志 | |
curl -k -u admin:密码 -X PUT "https://harbor.example.com/api/v2.0/users/{id}/password" -H "Content-Type: application/json" -d "{\"old_password\": \"旧密码\", \"new_password\": \"新密码\"}" | 修改用户密码(管理员重置时无需 old_password) | |
curl -k -u admin:密码 -X PUT "https://harbor.example.com/api/v2.0/users/{id}/sysadmin" -H "Content-Type: application/json" -d "{\"sysadmin_flag\": true}" | 授予或取消系统管理员权限 | |
curl -k -u admin:密码 -X DELETE "https://harbor.example.com/api/v2.0/users/{id}" | 删除用户(其项目角色需同步清理) | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/configurations" | 查看系统配置,含认证模式、令牌过期时间 | |
curl -k -u admin:密码 -X PUT "https://harbor.example.com/api/v2.0/configurations" -H "Content-Type: application/json" -d "{\"auth_mode\": \"ldap_auth\"}" | 切换认证模式为 LDAP(也可 oidc_auth、db_auth) | |
curl -k -u admin:密码 -X POST "https://harbor.example.com/api/v2.0/robots" -H "Content-Type: application/json" -d "{\"name\": \"system-pull\", \"duration\": 365, \"level\": \"system\", \"permissions\": [{\"kind\": \"system\", \"namespace\": \"/\", \"access\": [{\"resource\": \"repository\", \"action\": \"pull\"}]}]}" | 创建系统级机器人账号,适合全集群拉取 | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/robots" | 列出系统级机器人账号 | |
curl -k -u admin:密码 -X PATCH "https://harbor.example.com/api/v2.0/robots/{id}" -H "Content-Type: application/json" -d "{\"duration\": 30}" | 续期或修改机器人账号有效期 | |
curl -k -u admin:密码 -X DELETE "https://harbor.example.com/api/v2.0/robots/{id}" | 删除机器人账号,泄露时立即执行 |
| 命令 / 接口 | 说明 | 复制 |
|---|---|---|
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/system/gc" | 查看 GC 历史记录与状态 | |
curl -k -u admin:密码 -X POST "https://harbor.example.com/api/v2.0/system/gc/schedule" -H "Content-Type: application/json" -d "{\"schedule\": {\"type\": \"Manual\"}, \"parameters\": {\"delete_untagged\": true, \"workers\": 3}}" | 手动触发垃圾回收,delete_untagged 会清理无标签镜像 | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/system/gc/{id}" | 查询本次 GC 的进度与释放空间 | |
curl -k -u admin:密码 -X PUT "https://harbor.example.com/api/v2.0/system/gc/schedule" -H "Content-Type: application/json" -d "{\"schedule\": {\"type\": \"Custom\", \"cron\": \"0 30 3 * * *\"}, \"parameters\": {\"delete_untagged\": true}}" | 配置每天 3:30 自动 GC(cron 为 6 段格式) | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/system/gc/{id}/log" | 下载 GC 输出日志,确认清理数量与耗时 | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/systeminfo" | 查看存储总容量与已用容量 | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/quotas?page_size=50" | 查看各项目配额与使用量,定位超限项目 | |
du -sh /data/registry /data/database /data/redis | 宿主机侧确认各数据目录占用 | |
df -h /data | 磁盘剩余空间不足会直接导致 push 失败 | |
docker system df | 查看镜像层与构建缓存占用,清理无用对象 | |
不要手工删除 /data/registry 下的文件 | 必须先删制品再跑 GC,否则 registry 元数据与磁盘不一致 |
| 命令 / 接口 | 说明 | 复制 |
|---|---|---|
curl -k -u admin:密码 -X POST "https://harbor.example.com/api/v2.0/projects/app/repositories/nginx/artifacts/1.25/scan" | 对指定制品触发漏洞扫描 | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/projects/app/repositories/nginx/artifacts/1.25/additions/vulnerabilities" | 查看扫描结果:漏洞等级与修复版本 | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/projects/app/repositories/nginx/artifacts/1.25/scan/{report_id}/log" | 查看扫描器执行日志,扫描失败时定位原因 | |
curl -k -u admin:密码 -X POST "https://harbor.example.com/api/v2.0/projects/app/repositories/nginx/artifacts/1.25/scan/stop" | 停止正在进行的扫描 | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/scanners" | 查看已注册扫描器(Trivy)状态与版本 | |
curl -k -u admin:密码 -X PUT "https://harbor.example.com/api/v2.0/projects/app" -H "Content-Type: application/json" -d "{\"metadata\": {\"auto_scan\": \"true\"}}" | 开启推送后自动扫描 | |
curl -k -u admin:密码 -X PUT "https://harbor.example.com/api/v2.0/system/scanAll/schedule" -H "Content-Type: application/json" -d "{\"schedule\": {\"type\": \"Custom\", \"cron\": \"0 0 4 * * *\"}}" | 配置每日全量扫描任务 | |
cosign sign --key cosign.key harbor.example.com/app/nginx@sha256:xxxx | 对镜像签名,启用内容信任后可校验来源 | |
cosign verify --key cosign.pub harbor.example.com/app/nginx@sha256:xxxx | 校验签名,部署流水线可据此做准入 | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/projects/app/repositories/nginx/artifacts/1.25/additions/sbom" | 获取 SBOM(启用后可用),梳理依赖组件 |
| 命令 / 接口 | 说明 | 复制 |
|---|---|---|
cp /opt/harbor/harbor.yml /data/backup/harbor.yml.$(date +%F) | 升级前先备份配置文件,是回滚的关键 | |
docker exec harbor-db pg_dump -U postgres -d registry > /data/backup/registry_$(date +%F).sql | 备份 Harbor 业务库(项目、用户、策略都在这里) | |
docker exec harbor-db pg_dump -U postgres -d notarysigner > /data/backup/notary.sql | 使用了签名服务时一并备份 | |
rsync -a --delete /data/registry/ /backup/registry/ | 备份镜像数据目录(量大,建议文件系统快照) | |
docker compose stop | 升级前停止全部组件,保证数据一致 | |
tar xzvf harbor-offline-installer-v2.12.0.tgz -C /opt/harbor-new | 解压新版本安装包到独立目录 | |
cp /opt/harbor/harbor.yml /opt/harbor-new/harbor/harbor.yml | 沿用旧配置,注意新版可能新增必填项 | |
./prepare && docker compose up -d | 执行数据库迁移并启动新版本组件 | |
docker compose logs -f core | grep -i migrate | 观察迁移日志,异常时立即停止并回滚 | |
curl -k -u admin:密码 "https://harbor.example.com/api/v2.0/systeminfo" | 升级后确认 harbor_version 已变更 | |
docker run -it --rm -v /data/database:/var/lib/postgresql/data goharbor/harbor-migrator:v2.12.0 --db up | 仅迁移数据库时使用迁移镜像 | |
回滚:停服 → 恢复旧目录与数据库备份 → 启动旧版本 | 大版本升级不可逆,务必先做完整备份与演练 | |
docker compose down && cp -r /data/registry /backup/registry.bak | 迁移到新主机前的完整数据拷贝 |
| 命令 / 接口 | 说明 | 复制 |
|---|---|---|
502 Bad Gateway | nginx 到 core 不通:看 docker compose ps 是否 healthy,再看 core 日志 | |
docker login 报 401 Unauthorized | 密码或机器人账号错误、账号被锁、或访问的是错误域名(证书与 hostname 不匹配) | |
x509: certificate signed by unknown authority | 把 CA 证书放到 /etc/docker/certs.d/harbor.example.com/ca.crt 并重启 docker | |
http: server gave HTTP response to HTTPS client | 未启用 HTTPS:daemon.json 配置 insecure-registries 后重启 docker | |
413 Request Entity Too Large | 镜像层过大:调大 nginx 的 client_max_body_size 并重启 | |
denied: requested access to the resource is denied | 项目不存在或无 push 权限,确认项目名与机器人账号范围 | |
no such host | 域名无法解析,检查 /etc/hosts 与 DNS 配置 | |
docker compose ps 显示 unhealthy | 看该容器日志:core 常见数据库连不上,registry 常见存储不可写 | |
push 时报磁盘空间不足 | 清理旧镜像 → 保留策略 → GC,并检查 data_volume 分区 | |
GC 执行中 push 失败 | GC 会短暂限制写入,安排在低峰并避免与其他任务并发 | |
令牌校验失败 / 登录后立刻失效 | 宿主机与客户端时间偏差过大,校准 NTP | |
复制任务一直 pending | 看 jobservice 日志与远端连通性,检查远端证书与凭据 | |
docker compose logs --tail=100 core | grep -i error | 快速提取核心服务错误行 | |
docker stats --no-stream | 查看各组件资源占用,core 内存暴涨多为任务堆积 |
运维常用组合
vim harbor.yml → ./prepare → docker compose up -d → docker compose psPOST /projects → POST /projects/{name}/robots(push 权限) → docker login 验证保留策略执行 → POST /system/gc/schedule(delete_untagged) → GET /system/gc/{id} 看释放量POST /registries → POST /registries/ping → POST /replication/policies → POST /replication/executionscp harbor.yml → pg_dump registry → rsync /data/registrydocker compose stop → 备份 → 解压新版本 → ./prepare → docker compose up -d → 看迁移日志常见问题排查
1. 改配置不生效
harbor.yml 修改后必须 ./prepare 重新生成 compose 与配置,再 docker compose up -d
2. 推送镜像 413
大镜像层被 nginx 拦截:调大 client_max_body_size(如 0 表示不限)后重启 nginx 容器
3. 空间没释放
删除制品只是标记,必须执行垃圾回收(GC)才真正释放磁盘;delete_untagged 会清理无标签镜像
4. 证书告警
客户端需将 CA 放入 /etc/docker/certs.d/<hostname>/ca.crt;生产不要用 insecure-registries 绕过
5. 升级失败
大版本升级不可逆:先备份 harbor.yml、数据库与 registry 数据,并在测试环境演练迁移
6. CI 权限过大
为流水线创建项目级机器人账号只给 push 权限,避免直接用 admin 账号
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于Harbor命令速查
在线 Harbor 命令速查手册,按安装与初始化部署、服务状态与生命周期、项目管理 API、镜像与制品管理、保留策略与标签规则、复制与多实例同步、用户认证与权限、垃圾回收与存储清理、漏洞扫描与内容信任、备份升级与迁移、常见故障排查等 11 类场景整理 130+ 条常用命令与 REST API 示例,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 harbor.yml 关键配置(hostname、harbor_admin_password、data_volume、database、https 证书)、openssl 生成自签证书、./prepare 与 ./install.sh --with-trivy、docker compose ps/logs/restart/up/down、systeminfo 与 health 与 ping 接口、POST /projects 创建项目与配额 quotas、项目成员 members 与角色、机器人账号 robots 与权限、webhook 策略、docker login/tag/push/pull、skopeo copy、helm registry login 与 helm push、oras push、artifacts 与 build_history 与标签、不可变标签规则 immutabletagrules、保留策略 retentions 的 latestPushedK 与 nDaysSinceLastPush、registries 与 replication policies/executions/tasks 复制同步、users 与 sysadmin 与 configurations 切换 ldap_auth/oidc_auth、system/gc/schedule 垃圾回收与 delete_untagged、quotas 存储配额、trivy 扫描 scan 与 vulnerabilities 与 scanAll、cosign 签名校验、pg_dump 备份 registry 库与 rsync /data/registry、harbor-migrator 数据库迁移、升级与回滚流程、502 与 401 与 x509 与 413 与 denied 与 no such host 等报错排查。适用于 Harbor 私有镜像仓库部署运维、CI 推送权限管理、多机房镜像同步、磁盘空间治理与版本升级,以及运维面试复习。
核心能力
- 涵盖 harbor.yml 关键配置(hostname、harbor_admin_password、data_volume、database、https 证书)、openssl 生成自签证书、./prepare 与 ./install.sh --with-trivy、docker compose ps/logs/restart/up/down、systeminfo 与 health 与 ping 接口、POST /projects 创建项目与配额 quotas、项目成员 members 与角色、机器人账号 robots 与权限、webhook 策略、docker login/tag/push/pull、skopeo copy、helm registry login 与 helm push、oras push、artifacts 与 build_history 与标签、不可变标签规则 immutabletagrules、保留策略 retentions 的 latestPushedK 与 nDaysSinceLastPush、registries 与 replication policies/executions/tasks 复制同步、users 与 sysadmin 与 configurations 切换 ldap_auth/oidc_auth、system/gc/schedule 垃圾回收与 delete_untagged、quotas 存储配额、trivy 扫描 scan 与 vulnerabilities 与 scanAll、cosign 签名校验、pg_dump 备份 registry 库与 rsync /data/registry、harbor-migrator 数据库迁移、升级与回滚流程、502 与 401 与 x509 与 413 与 denied 与 no such host 等报错排查
适用场景
适用于 Harbor 私有镜像仓库部署运维、CI 推送权限管理、多机房镜像同步、磁盘空间治理与版本升级,以及运维面试复习。Harbor命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。
常见问题
- Harbor命令速查是免费的吗?需要注册或安装吗?
- Harbor命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
- Harbor命令速查支持哪些功能?
- 涵盖 harbor.yml 关键配置(hostname、harbor_admin_password、data_volume、database、https 证书)、openssl 生成自签证书、./prepare 与 ./install.sh --with-trivy、docker compose ps/logs/restart/up/down、systeminfo 与 health 与 ping 接口、POST /projects 创建项目与配额 quotas、项目成员 members 与角色、机器人账号 robots 与权限、webhook 策略、docker login/tag/push/pull、skopeo copy、helm registry login 与 helm push、oras push、artifacts 与 build_history 与标签、不可变标签规则 immutabletagrules、保留策略 retentions 的 latestPushedK 与 nDaysSinceLastPush、registries 与 replication policies/executions/tasks 复制同步、users 与 sysadmin 与 configurations 切换 ldap_auth/oidc_auth、system/gc/schedule 垃圾回收与 delete_untagged、quotas 存储配额、trivy 扫描 scan 与 vulnerabilities 与 scanAll、cosign 签名校验、pg_dump 备份 registry 库与 rsync /data/registry、harbor-migrator 数据库迁移、升级与回滚流程、502 与 401 与 x509 与 413 与 denied 与 no such host 等报错排查。
- Harbor命令速查适合哪些场景使用?
- 适用于 Harbor 私有镜像仓库部署运维、CI 推送权限管理、多机房镜像同步、磁盘空间治理与版本升级,以及运维面试复习。