容器服务
容器服务
容器服务
文档指南
请输入
容器服务 VKE
产品动态
Kubernetes 版本发布记录
组件发布记录
监控组件
DNS 组件
GPU 组件
Sandbox 组件
安全公告
产品公告
历史公告
用户指南
集群
节点池
授权
网络
容器网络
服务（Service）
路由（Ingress）
APIG Ingress
ALB Ingress
自定义转发规则配置示例
CLB Ingress
Nginx Ingress
Gateway API
工作负载
存储
数据管理中心（DMC）
对象存储（TOS）
FSX 访问方式
文件存储（NAS）
FSX 访问方式
弹性文件存储（EFS）
文件存储（vePFS）
FSX 访问方式
vePFS Client 访问方式
NFS 访问方式
大数据文件存储（CloudFS）
弹性伸缩
工作负载弹性伸缩
事件驱动伸缩（KEDA）
组件管理
网络组件
监控组件
DNS 组件
GPU 组件
Sandbox 组件
异构计算
调度管理
可观测性
基础观测
诊断与巡检
最佳实践
网络
可观测性
安全合规
API 参考
集群管理
节点池管理
组件管理
机型镜像管理
云原生观测
巡检诊断
弹性容器实例
附录
开发指南
常见问题
通用 FAQ
集群 FAQ
集群管理
集群升级
节点与节点池 FAQ
授权 FAQ
工作负载 FAQ
服务与路由 FAQ
存储 FAQ
弹性伸缩 FAQ
可观测性 FAQ
配额 FAQ
组件 FAQ
容器镜像 FAQ
AI 云原生
推理套件
Helm 模板 AI 应用
Deepseek 实践
Qwen 实践
最佳实践
MiniMax 模型部署
Qwen 模型部署
弹性容器实例 VCI
最新动态
用户指南
虚拟节点
VKE 集群使用虚拟节点
自建/跨云集群使用虚拟节点
创建 VCI 实例
VCI Agent Sandbox
安全合规
- 文档首页
容器服务弹性容器实例 VCI用户指南创建 VCI 实例创建实例并配置远端代理仓
复制全文
下载 pdf创建实例并配置远端代理仓
文档反馈
问问助手弹性容器实例（VCI）支持镜像仓库 Mirror 配置，镜像拉取时会将请求的地址替换成 Mirror 仓库的地址拉取镜像。
背景信息
在用户业务中，会存在需要拉取境外镜像源、多云场景协作等需求。VCI 基于火山引擎镜像仓库（CR）的远端代理（Proxy cache）能力，提供镜像仓库 Mirror 配置功能，在使用公开的海外镜像场景中，可通过该能力直接拉取对应的镜像，无需更换镜像地址，满足用户的跨地域业务需求。
说明
功能说明
VCI 通过 Annotation 方式提供 Mirror 配置能力。Annotation 说明如下：
- Annotation Key：vci.volcengine.com/registry-mirror-config
- Annotation Value：
- 参数值支持的格式为 JSON。
- JSON 文件格式及参数说明如下：
- {"mirrors": { // 远端代理仓域名配置。"docker.io": ["address1.cr.volces.com", "address2.cr.volces.com"], // 按需配置，表示将 docker.io 远端仓镜像映射到指定的 CR 代理仓。填写多个代理仓域名时按前后顺序从代理仓中拉取镜像。"hub.byted.org": ["address2.cr.volces.com"], // 按需配置，表示将 hub.byted.org 远端仓镜像映射到指定的 CR 代理仓。"*": ["default-address.cr.volces.com"] // 按需配置，表示所有类型镜像，均映射到指定的 CR 代理仓。}，"configs": {"address1.cr.volces.com": { // 为指定的 CR 代理仓，配置访问策略。"auth": {"username": "xxx", // CR 代理仓实例的登录用户名。"password": "yyy" // CR 代理仓实例的登录密码，需要进行 Base64 编码后传入。}，"tls": {"insecure_skip_verify": true // 按需配置，表示登录 CR 代理仓实例时忽略证书校验。}}}}
使用方法
前提条件
- 已创建 VCI 业务相关集群。详细操作，请参见 在 VPC-CNI 网络模型集群中使用 VCI、在 Flannel 网络模型集群中使用 VCI。
- 已创建私有网络及其子网。详细操作，请参见 创建私有网络。
- 已创建远端代理仓。详细操作，请参见 创建远端代理仓。
代码示例
创建 VCI Deployment 的示例代码如下所示：
说明
apiVersion: apps/v1
kind: Deployment
metadata:
name: nginx-deployment
spec:
replicas: 2
selector:
matchLabels:
app: nginx
template:
metadata:
annotations:
vke.volcengine.com/burst-to-vci: enforce #强制使用 VCI
vke.volcengine.com/preferred-subnet-ids: subnet-3tispp1nai**** #指定子网 ID，可指定同一个可用区内多个子网，多个子网之间用半角逗号（,）分隔
vci.vke.volcengine.com/preferred-instance-family: vci.u1 #指定 VCI 的规格族
vci.volcengine.com/registry-mirror-config: |
{
"mirrors": {
"docker.io": ["address1.cr.volces.com", "address2.cr.volces.com"],
"hub.byted.org": ["address2.cr.volces.com"],
"*": ["default-address.cr.volces.com"]
}，
"configs": {
"address1.cr.volces.com": {
"auth": {
"username": "demo-user",
"password": "*****************"
}，
"tls": {
"insecure_skip_verify": true
}
}
}
}
labels:
app: nginx
spec:
containers:
- name: nginx
image: doc-cn-beijing.cr.volces.com/vke/nginx-demo:v1.0 # 容器镜像的地址和版本，请配置为您自己的远端仓镜像地址
ports:
- containerPort: 80
resources:
requests: #指定容器的 vCPU 和内存
cpu: "500m"
memory: "1024Mi"
limits:
cpu: "1"
memory: "2048Mi"
最近更新时间：2026.08.19 17:32:20
这个页面对您有帮助吗？
有用
有用
无用
无用