docs: 腾讯云 TCR 成为对外主镜像地址,重排发布方案

This commit is contained in:
jinghui committed 2026-10-27 11:46:42 +08:00
1 parent ce004cb49a
commit c2355fe49a
3 files changed
+52 -54

No files matched your search

+7
View File
@@ -1,5 +1,12 @@
# 更新日志
## 2026-10-27 → ☁️ 腾讯云 TCR 公开仓库上线(对外主地址)
- ✅ 已推送 `jpccr.ccs.tencentyun.com/jinghui/docker-center:1.0.1` + `latest`(腾讯云个人版,东京地域),digest `sha256:37022ce4080b26b1d9f8c3e9ba08612cc1169a87fb55eb65a746714f9ce98f01`
- ✅ 仓库已设为公开:清空凭据(`DOCKER_CONFIG=/tmp/nocreds`)匿名拉取成功,digest 一致
- ✨ README「用预构建镜像安装」改为腾讯云为主地址、Gitea 为国内备用;Gitea 仓库描述同步写上两个镜像地址
- 📝 docs/publish-image.md 重排方案:腾讯云(已验证,含 `jpccr`=东京、用户名是账号 ID、默认私有需改公开、`DENIED ... another ccr account` 实为命名空间不对等坑位)→ 阿里云(标注个人版已停止新用户开通,附 API 实测证据)→ Docker Hub → 自建 Gitea
## 2026-10-27 → 🚀 公网镜像仓库打通(gitea.88531.cn 可推可拉)
- ✅ 修掉上游宝塔 WAF 对镜像层的拦截:`/www/server/btwaf/rule/url_white.json` 原来只有某个具体上传会话的 UUID,改为路径前缀 `^/v2/jinghui/docker-center/` + `^/v2/token`,`nginx -t` 后 `nginx -s reload`
+6 -2
View File
@@ -102,16 +102,20 @@ bash install.sh
### 用预构建镜像安装(不编译源码)
镜像已发布到自建 Gitea 容器仓库(公网可拉,无需登录):
镜像已发布到公开仓库,**无需登录直接拉取**(两个地址内容完全一致,digest `sha256:37022ce4...`):
```bash
# 腾讯云 TCR(东京节点,海外/国内都稳,推荐)
docker pull jpccr.ccs.tencentyun.com/jinghui/docker-center:1.0.1
# 自建 Gitea(国内备用)
docker pull gitea.88531.cn/jinghui/docker-center:1.0.1
```
```yaml
services:
docker-center:
image: gitea.88531.cn/jinghui/docker-center:1.0.1
image: jpccr.ccs.tencentyun.com/jinghui/docker-center:1.0.1
container_name: docker-center
ports: ["7030:7030"]
volumes:
+39 -52
View File
@@ -10,68 +10,66 @@
| 仓库 | 免费额度 | 国内拉取速度 | 适合场景 | 需要什么 |
|---|---|---|---|---|
| **阿里云 ACR 个人版** | 仓库数不限,免费 | 快(有全国 CDN + 加速器) | **首选:给国内用户分发** | 阿里云账号 |
| 腾讯云 TCR 个人版 | 免费 | 快 | 备选云仓库 | 腾讯云账号 |
| **腾讯云 TCR 个人版** | 免费(个人版) | 快(可选地域,本仓库用东京 `jpccr`) | **首选:对外分发(已验证可推可拉)** | 腾讯云账号 |
| 自建 Gitea(本机) | 无限 | 取决于你家带宽 | 国内备用 / 内网自用 | 无(已有) |
| 阿里云 ACR 个人版 | — | 快 | ⚠️ **已停止新用户开通**,旧版 API 已下线,新账号只能用付费企业版 | 付费 |
| Docker Hub | 公开仓免费不限 | 慢/常被墙 | 给海外用户、写进 README 好看 | 代理 + 账号 |
| 自建 Gitea(本机) | 无限 | 取决于你家带宽 | 自己内网用、给朋友 | 无(已有) |
> 自建 Gitea 可以当镜像仓库(内置 Registry V2,匿名可拉)。**公网 `https://gitea.88531.cn` 已实测可推可拉**:1.0.1 推送 digest `sha256:37022ce4...`,清空凭据匿名拉取同一 digest。
> 两个可用地址内容一致(digest `sha256:37022ce4080b26b1d9f8c3e9ba08612cc1169a87fb55eb65a746714f9ce98f01`):
> `jpccr.ccs.tencentyun.com/jinghui/docker-center:1.0.1`(腾讯云)、`gitea.88531.cn/jinghui/docker-center:1.0.1`(自建),二者都已用「清空凭据」的方式实测匿名拉取成功。
---
## 方案一:阿里云 ACR 个人版(推荐)
## 方案一:腾讯云 TCR 个人版(推荐,已在本仓库验证)
### 1. 开通并拿到三样东西
本项目的正式对外地址:`jpccr.ccs.tencentyun.com/jinghui/docker-center:1.0.1`
控制台 → 容器镜像服务 ACR → 个人实例(免费,不需要买企业版):
### 实测事实(2026-10-27)
- ** registry 地址**:`registry.cn-hangzhou.aliyuncs.com`(杭州,也可选北京/上海/深圳)
- **命名空间**:自己起名,如 `jinghui`(个人实例只能有一个命名空间)
- **仓库名**:`docker-center`
- 设置仓库属性为 **公开**(默认私有,私有的话别人拉不了)
- 地域选的是**东京**,所以域名叫 `jpccr.ccs.tencentyun.com`(`jp` = 东京);国内地域对应 `ccr.ccs.tencentyun.com` 或 `hkccr`/`sgccr` 等
- 登录用户名不是邮箱,而是**腾讯云账号 ID**(本账号 `100042126615`),密码是个人版「访问凭证」里设的固定密码
- **个人版仓库默认私有**,推上去后匿名拉取会 `unauthorized`;必须到控制台把仓库类型改成「公开」
- 命名空间必须事先在控制台建好;推错命名空间报 `DENIED: no permission! are you logined with another ccr account?`(这个报错很误导,其实是命名空间不存在或不属于你)
- `DescribeInstances` API **不返回个人版实例**,所以别指望用 API 判断个人版是否已开通,只能看控制台
在「访问凭证」里设置固定密码(个人版只能用固定密码,不能用阿里云账号密码登录 docker)。
### 步骤
### 2. 登录并推送
1. 控制台 → 容器镜像服务 TCR → 个人版 → 开通(免费)→ 建命名空间(本仓库用 `jinghui`)→ 建仓库 `docker-center`
2. 个人版 → 访问凭证 → 设固定密码
3. 登录并推送:
```bash
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
docker login jpccr.ccs.tencentyun.com -u <腾讯云账号ID>
REGISTRY=jpccr.ccs.tencentyun.com NAMESPACE=jinghui REUSE=1 ./scripts/push-image.sh custom 1.0.1
```
脚本会构建 → 打 `1.0.0` 和 `latest` → 推两次 → 打印拉取命令。
### 3. 别人怎么装
4. 把仓库改成公开,然后用**清空凭据**的方式验证:
```bash
docker pull registry.cn-hangzhou.aliyuncs.com/jinghui/docker-center:1.0.0
mkdir -p /tmp/nocreds && echo '{}' > /tmp/nocreds/config.json
DOCKER_CONFIG=/tmp/nocreds docker pull jpccr.ccs.tencentyun.com/jinghui/docker-center:1.0.1
```
或者直接写 compose(不用改源码):
```yaml
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`,拉取更快。
> 腾讯云 API 里没有「创建个人版实例」这个动作(`CreateInstance` 的 `RegistryType` 只有 basic/standard/premium,都是企业版且要 `TCR_QCSRole` 服务角色授权、按量计费),所以个人版**只能在控制台点开通**,脚本层无法代劳。
---
## 方案二:Docker Hub
## 方案二:阿里云 ACR 个人版(⚠️ 已停止新用户开通)
2026-10 实测结论:阿里云**已关闭个人版新用户开通**,且旧版 API(版本 `2016-06-07`)整条产品线已下线:
```
GetAuthorizationToken v2016-06-07 → InvalidAction.NotFound
GetAuthorizationToken v2018-12-01 → MissingInstanceId ← 新版只认企业版实例 ID (cri-xxx)
CreateNamespace v2018-12-01 → MissingInstanceId
ListInstance(5 个地域) → TotalCount = 0
```
新账号只能用付费企业版(API 里连 `CreateInstance` 都没有,须控制台/ Terraform 建)。若你已有存量个人版实例,流程仍是:建命名空间 + 公开仓库 → `docker login registry.cn-hangzhou.aliyuncs.com -u <账号>` → `NAMESPACE=<ns> ./scripts/push-image.sh aliyun 1.0.1`。
---
## 方案三:Docker Hub
本机直连 Docker Hub 不通(`registry-1.docker.io` 连接超时),需要给 docker 守护进程配代理:
@@ -96,17 +94,6 @@ NAMESPACE=<dockerhub用户名> ./scripts/push-image.sh dockerhub 1.0.0
---
## 方案三:腾讯云 TCR 个人版
流程和阿里云一样:控制台开通个人版 → 命名空间 + 仓库(设公开)→ 设访问凭证密码。
```bash
docker login ccr.ccs.tencentyun.com -u 1000xxxxxx # 腾讯云账号 ID
NAMESPACE=<命名空间> ./scripts/push-image.sh tencent 1.0.0
```
---
## 方案四:自建 Gitea(本机,内网用)
Gitea 自带容器仓库(Docker Registry V2,本项目实测可用)。