> For the complete documentation index, see [llms.txt](https://tccli-agent.gitbook.io/tccli/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tccli-agent.gitbook.io/tccli/v2/tcr-rong-qi-jing-xiang-fu-wu/index-3.md).
# 个人版
> 适合个人开发者和轻量场景——免费使用，与企业版 API 形态完全不同。 控制台：无独立个人版管理页——`https://console.cloud.tencent.com/tcr/personal` 与 `/ccr*` 返回 **404**（页面提示网址已删除或尚未生效）；左栏无个人版入口。规格对比见 [购买页](https://buy.cloud.tencent.com/tcr)，个人版相关面见 [公有镜像](https://console.cloud.tencent.com/tcr/publicimage)（域名 `ccr.ccs.tencentyun.com`）。操作走本页 API / [个人版全功能](/tccli/v2/tcr-rong-qi-jing-xiang-fu-wu/index-3/manage.md)。
>
> 官方文档：[容器镜像服务个人版](https://cloud.tencent.com/document/product/1141/57780) · [个人版快速入门](https://cloud.tencent.com/document/product/1141/63910)
## 是什么
TCR 个人版是腾讯云容器镜像服务的免费版本，提供基础的镜像托管能力。与企业版不同，个人版**不需要先创建实例**，直接使用命名空间组织仓库，是共享服务（所有个人版用户共享后端）。
> ⚠️ 个人版 API 形态与企业版完全不同：所有 Action 带 `Personal` 后缀（如 `CreateNamespacePersonal` 而非 `CreateNamespace`），且个人版是全局服务（无 `--region` 概念，不传地域参数）。两版不能混用接口。
## 何时阅读
* 你要免费托管镜像且无需先建实例（直接用命名空间组织仓库）— 本域是入口，操作见 [个人版全功能](/tccli/v2/tcr-rong-qi-jing-xiang-fu-wu/index-3/manage.md)
* 你要用 `docker login` 推送/拉取镜像到 `ccr.ccs.tencentyun.com` — 先 `CreateUserPersonal` 建登录账号，再 [创建命名空间与仓库](/tccli/v2/tcr-rong-qi-jing-xiang-fu-wu/index-3/manage.md)
* 你遇到个人版 Action 带 `*Personal` 后缀、全局服务不传 `--region` 与企业版接口不兼容 — 看 [个人版 vs 企业版](#个人版-vs-企业版)
* 你要查个人版配额上限（命名空间 10 / 仓库按地域 / Tag 100，不支持调额）— 用 `DescribeUserQuotaPersonal`，不够则升企业版
## 核心概念
| 概念 | 含义 | 为什么重要 |
| ----- | ---------------------------- | ------------------- |
| 个人版用户 | `CreateUserPersonal` 创建的登录账号 | docker login 的用户名密码 |
| 命名空间 | 镜像仓库的逻辑分组 | 组织仓库，个人版内唯一 |
| 仓库 | 存放同名称不同 tag 的镜像 | 相当于一个 Docker 镜像名 |
| 配额 | 命名空间/仓库数上限 | 超过需升级企业版 |
## 个人版 vs 企业版
| 维度 | 个人版 | 企业版 |
| --- | ----------------------------------------------------------- | ------------------------------------------------ |
| 实例 | 无实例概念（共享服务） | 独立实例，有状态机 |
| API | `*Personal` 后缀，全局服务 | `Create*` 等，按地域 |
| 计费 | 免费 | 按量计费 |
| 配额 | 命名空间 **10**/地域；仓库 **广州 500 / 其他 100**；单镜像 Tag **100**（不可调额） | basic 50/1000、standard 100/3000、premium 500/5000 |
| SLA | **不承诺** | 99.9% |
| 安全 | 基础 | 镜像扫描/签名/VPC 访问/不可变 |
> 个人版配额以 `DescribeUserQuotaPersonal` / 官方 FAQ 为准：NS 10、仓库按地域、Tag 100；不够则升企业版，**不支持调额**。共享后端、无 SLA。
## 不适用场景
* 企业生产环境 / 需要 SLA → 升级到 [TCR 企业版](/tccli/v2/tcr-rong-qi-jing-xiang-fu-wu/index-1/create.md)，获得 VPC 内网、安全扫描、跨地域同步
* 大规模 CI/CD → 个人版有 QPS/配额限制且无 SLA
* 需要 VPC 内网拉取 → 个人版不支持，须企业版
* 需要镜像签名/不可变规则 → 个人版不支持，须企业版
## 个人版 → 企业版迁移
个人版与企业版是独立服务，**无自动迁移**。已有镜像需手动搬迁：
> docker CLI（本地镜像传输，非 tccli；TCCLI 不提供镜像层传输）
#### 1. 拉取个人版镜像
```bash
docker pull //:
# expected: Status: Downloaded newer image for ... 或 Image is up to date
```
#### 2. 重新打标为企业版域名
企业版实例域名见 `DescribeInstances`。
```bash
docker tag //: //:
# expected: exit 0（无输出）
```
#### 3. 推送到企业版
须先在企业版实例创建命名空间+仓库，见 [repositories/manage.md](/tccli/v2/tcr-rong-qi-jing-xiang-fu-wu/manage.md)。
```bash
docker push //:
# expected: digest: sha256:... 推送成功
```
| 占位符 | 含义 | 获取方式 |
| ------------------------------ | ---------- | ----------------------------------------------------------- |
| `` | 个人版域名 | `ccr.ccs.tencentyun.com`（固定） |
| `` | 企业版实例域名 | `tccli tcr DescribeInstances` → `Registries[].PublicDomain` |
| ``/``/`` | 命名空间/仓库/标签 | 自定义 |
> 迁移前先在企业版实例 [创建命名空间与仓库](/tccli/v2/tcr-rong-qi-jing-xiang-fu-wu/manage.md)，并 [配置访问凭证](/tccli/v2/zhun-bei-gong-zuo/credentials.md)（企业版用 `CreateInstanceToken`，非个人版凭腾讯云账号）。批量迁移可写脚本循环 pull/tag/push。
## 快速检查
```bash
# 查看个人版配额（返回 Data.LimitInfo[]）
tccli tcr DescribeUserQuotaPersonal
# expected: Data.LimitInfo 含 namespace/repo 配额
# 查看个人版命名空间（必填 Namespace/Limit/Offset）
tccli tcr DescribeNamespacePersonal --Namespace "" --Limit 10 --Offset 0
# expected: Data.NamespaceInfo（数组，空则无命名空间）+ Data.NamespaceCount
# 若账号尚未初始化个人版用户：ResourceNotFound.ErrNoUser → 先 CreateUserPersonal
```
> 个人版是全局服务，**不传 `--region`**。`DescribeNamespacePersonal` 的 `--Namespace`/`--Limit`/`--Offset` 全部必填。未初始化个人版用户时返回 `ResourceNotFound.ErrNoUser`（先 `CreateUserPersonal`）。
## 文档
* [个人版全功能操作](/tccli/v2/tcr-rong-qi-jing-xiang-fu-wu/index-3/manage.md) — 创建用户、命名空间、仓库、推送镜像
* [TCR 企业版概览](/tccli/v2/tcr-rong-qi-jing-xiang-fu-wu/index-1.md) — 对比与升级路径
* [推送拉取镜像](/tccli/v2/tcr-rong-qi-jing-xiang-fu-wu/push-pull.md) — 企业版推送（个人版参考 manage.md）
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://tccli-agent.gitbook.io/tccli/v2/tcr-rong-qi-jing-xiang-fu-wu/index-3.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.