Files
docker-center/docs/publish-image.md
T

6.1 KiB
Raw Blame History

把镜像发布到公开仓库

目标:让别人 docker pull 就能用,不用 clone 源码、不用装 Node、不用现编译。

本仓库自带 scripts/push-image.sh,一次构建、多处推送。


先说结论(按推荐顺序)

仓库 免费额度 国内拉取速度 适合场景 需要什么
阿里云 ACR 个人版 仓库数不限,免费 快(有全国 CDN + 加速器) 首选:给国内用户分发 阿里云账号
腾讯云 TCR 个人版 免费 快 备选云仓库 腾讯云账号
Docker Hub 公开仓免费不限 慢/常被墙 给海外用户、写进 README 好看 代理 + 账号
自建 Gitea(本机) 无限 取决于你家带宽 自己内网用、给朋友 无(已有)

本机实测:自建 Gitea 仓库推送成功(digest sha256:4361c9...),但公网域名 gitea.88531.cn 走的是内网穿透隧道,240MB 镜像推不上去(上传层会卡在 Retrying),所以不要用自建 Gitea 做公网分发。


方案一:阿里云 ACR 个人版(推荐)

1. 开通并拿到三样东西

控制台 → 容器镜像服务 ACR → 个人实例(免费,不需要买企业版):

  • ** registry 地址**:registry.cn-hangzhou.aliyuncs.com(杭州,也可选北京/上海/深圳)
  • 命名空间:自己起名,如 jinghui(个人实例只能有一个命名空间)
  • 仓库名:docker-center
  • 设置仓库属性为 公开(默认私有,私有的话别人拉不了)

在「访问凭证」里设置固定密码(个人版只能用固定密码,不能用阿里云账号密码登录 docker)。

2. 登录并推送

docker login registry.cn-hangzhou.aliyuncs.com -u <阿里云账号全名>

cd /vol1/1000/HD1/docker/docker-center
NAMESPACE=jinghui ./scripts/push-image.sh aliyun 1.0.0

脚本会构建 → 打 1.0.0 和 latest → 推两次 → 打印拉取命令。

3. 别人怎么装

docker pull registry.cn-hangzhou.aliyuncs.com/jinghui/docker-center:1.0.0

或者直接写 compose(不用改源码):

services:
  docker-center:
    image: registry.cn-hangzhou.aliyuncs.com/jinghui/docker-center:1.0.0
    container_name: docker-center
    ports: ["7030:7030"]
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /:/host:ro
      - ./data:/app/data
    environment:
      - TZ=Asia/Shanghai
      - COMPOSE_ROOT=/compose
    restart: always

阿里云还免费送镜像加速器地址(控制台「镜像工具 → 镜像加速器」),填到 /etc/docker/daemon.json 的 registry-mirrors,拉取更快。


方案二:Docker Hub

本机直连 Docker Hub 不通(registry-1.docker.io 连接超时),需要给 docker 守护进程配代理:

# /etc/systemd/system/docker.service.d/http-proxy.conf
[Service]
Environment="HTTP_PROXY=http://127.0.0.1:7890"
Environment="HTTPS_PROXY=http://127.0.0.1:7890"
Environment="NO_PROXY=localhost,127.0.0.1,192.168.0.0/16"
systemctl daemon-reload && systemctl restart docker   # 注意:会重启所有容器

docker login -u <dockerhub用户名>
NAMESPACE=<dockerhub用户名> ./scripts/push-image.sh dockerhub 1.0.0

拉取:docker pull <用户名>/docker-center:1.0.0

公开仓库免费且数量不限;私有仓库免费版只有 1 个。


方案三:腾讯云 TCR 个人版

流程和阿里云一样:控制台开通个人版 → 命名空间 + 仓库(设公开)→ 设访问凭证密码。

docker login ccr.ccs.tencentyun.com -u 1000xxxxxx     # 腾讯云账号 ID
NAMESPACE=<命名空间> ./scripts/push-image.sh tencent 1.0.0

方案四:自建 Gitea(本机,内网用)

Gitea 自带容器仓库(Docker Registry V2,本项目实测可用)。

一次性准备(已在本机做过)

# 1) 允许 HTTP 仓库(Gitea 在 3200 端口跑 HTTP)
#    编辑 /etc/docker/daemon.json,加:
#    "insecure-registries": ["192.168.68.19:3200"]
systemctl reload docker        # reload 即可,不会重启容器

# 2) 签发有 package 权限的 token(普通 git token 没有 package 权限,会报 unauthorized: reqPackageAccess)
docker exec -u git gitea gitea admin user generate-access-token \
  --username jinghui --token-name docker-push \
  --scopes write:package,read:package,write:repository,read:repository

# 3) 登录
docker login 192.168.68.19:3200 -u jinghui

推送

REUSE=1 ./scripts/push-image.sh gitea-lan 1.0.0

推完可在 http://192.168.68.19:3200/jinghui/-/packages 看到包。

为什么不用公网域名 gitea.88531.cn

实测 docker push gitea.88531.cn/... 会卡在 Retrying,docker pull 直接 Get "https://gitea.88531.cn/v2/": EOF。该域名经 Lucky → NPC 内网穿透,大体积 blob(每层几十 MB)在隧道上超时。要公网分发请用方案一。


多架构(amd64 + arm64)

群晖/飞牛 ARM 机型、Mac M 系列、树莓派都是 arm64。想一个镜像通吃:

# 一次性装 qemu 模拟(本机当前没装)
docker run --privileged --rm tonistiigi/binfmt --install all

MULTIARCH=1 NAMESPACE=jinghui ./scripts/push-image.sh aliyun 1.0.0

buildx 会直接 --push,不会在本地留镜像。


版本号怎么打

  • 每次功能变更 → 1.0.1、1.1.0 递增,同时覆盖 latest
  • 不删旧版本(用户可能锁版本),仓库里累积
  • 本仓库 CHANGELOG.md 与 tag 对应,方便用户对版本

常见报错

报错 原因 解决
unauthorized: reqPackageAccess token 缺 package 权限 用 --scopes write:package 重新签发
Get .../v2/: EOF 走隧道/被墙 换局域网地址或用云仓库
http: server gave HTTP response to HTTPS client 未加 insecure-registries 加进 daemon.json 后 systemctl reload docker
denied: requested access to the resource is denied 命名空间/仓库名不对,或没登录 核对控制台的 registry 地址与命名空间
层一直 Retrying 上传带宽不够/代理不稳 换云仓库,或 MULTIARCH=0 单架构推