6.1 KiB
把镜像发布到公开仓库
目标:让别人 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 单架构推 |