ghcr.io/api7/adc:0.27.0
ghcr.iolinux/amd640.27.0大小: 77.20 MB更新于 2026年6月21日
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
API 声明式 CLI (ADC)
ADC 是一个命令行工具，用于与 API7 Enterprise 和 Apache APISIX 管理 API 交互。
支持的后端
ADC 支持以下后端类型：
- API7 Enterprise
- Apache APISIX
支持的转换器
支持以下转换器将 API 规范转换为 ADC 配置：
- OpenAPI Spec 3
安装
安装 ADC 最简单的方法是通过安装脚本：
curl -sL "https://run.api7.ai/adc/install" | sh
或者，您可以从发布页面下载相应的二进制文件：
目前提供适用于 Linux、Windows 和 macOS 的 amd64 和 arm64 预构建二进制文件。
amd64 arm64
配置 ADC
您可以通过环境变量或命令行标志配置 ADC。运行 adc help [command] 以查看命令的可用配置选项。
adc help [command]
ADC 支持 dotenv，因此您可以在 .env 文件中存储和使用环境变量。以下示例展示了如何为 API7 Enterprise 和 Apache APISIX 后端配置 ADC。
.env
API7 Enterprise 配置示例
ADC_BACKEND=api7ee
ADC_SERVER=https://localhost:7443
ADC_TOKEN=
Apache APISIX 配置示例
ADC_SERVER=http://localhost:9180
ADC_TOKEN=
使用方法
本节重点介绍一些常用的 ADC 命令。
检查连接性
ping 命令通过尝试连接到已配置的后端来验证配置：
ping
adc ping
以 ADC 格式导出配置
dump 命令获取后端的当前配置并将其保存为 ADC 配置文件格式：
dump
adc dump -o adc.yaml
显示本地与远程配置的差异
diff 命令将指定 ADC 配置文件中的配置与后端的当前配置进行比较：
diff
adc diff -f adc.yaml
同步本地配置
sync 命令将指定 ADC 配置文件中的配置与后端同步：
sync
adc sync -f adc.yaml
转换 API 规范
convert 命令将 API 规范转换为 ADC 配置。目前，它支持将 OpenAPI 3 规范转换为 ADC 配置。
convert
adc convert openapi -f openapi.yaml
验证 ADC 配置
lint 命令在本地验证提供的 ADC 配置文件。
lint
adc lint -f adc.yaml
开发
要从源代码构建 ADC，请安装 Nx 并运行：
pnpm install
nx build cli
要使用二进制文件，请运行：
node dist/apps/cli/main.cjs -h
许可证
本项目采用 Apache 2.0 许可证。
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"