本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com
Docker 镜像非 ASF 官方发布版本,仅为方便使用提供。推荐做法始终是从源码构建。
master 分支对应 Apache APISIX 2.x 版本。如需旧版本,请从 v1.x 标签构建。
# 将 Apache 发布版本赋值给变量 APISIX_VERSION,例如:2.9。 # 最新发布版本可在 [***] 查看 export APISIX_VERSION=2.9 # 构建基于 alpine 的镜像 make build-on-alpine # 构建基于 centos 的镜像 make build-on-centos
export APISIX_VERSION=master # 构建基于 alpine 的镜像 make build-on-alpine # 构建基于 centos 的镜像 make build-on-centos
# 需将本地 APISIX 代码复制到构建上下文路径 cp -r <本地APISIX路径> ./apisix export APISIX_PATH=./apisix make build-on-alpine-local # 若遇 "error checking context: 'can't start'" 错误,可能需要 root 权限
提示:中文环境用户建议执行以下命令,通过附加构建参数 ENABLE_PROXY=true 启用代理加速构建:
$ make build-on-alpine-cn
详情请参见 手动部署文档。
cd example docker-compose -p docker-apisix up -d
更多用法可参考 docker-compose 示例文档。
# 构建一站式镜像 make build-all-in-one # 启动 APISIX 容器 docker run -d \ -p 9080:9080 -p 9091:9091 -p 2379:2379 \ -v `pwd`/all-in-one/apisix/config.yaml:/usr/local/apisix/conf/config.yaml \ apache/apisix:whole
apisix-dashboard 最新版本为 2.9,可与 APISIX 2.10 配合使用。
# 构建 dashboard 镜像 make build-dashboard # 启动 APISIX-Dashboard 容器 docker run -d \ -p 9080:9080 -p 9091:9091 -p 2379:2379 -p 9000:9000 \ -v `pwd`/all-in-one/apisix/config.yaml:/usr/local/apisix/conf/config.yaml \ -v `pwd`/all-in-one/apisix-dashboard/conf.yaml:/usr/local/apisix-dashboard/conf/conf.yaml \ apache/apisix-dashboard:whole
端口冲突处理:若遇端口冲突,可通过 docker run -p 修改主机端口,例如:
# 调整主机端口以避免冲突 docker run -d \ -p 19080:9080 -p 19091:9091 -p 12379:2379 -p 19000:9000 \ -v `pwd`/all-in-one/apisix/config.yaml:/usr/local/apisix/conf/config.yaml \ -v `pwd`/all-in-one/apisix-dashboard/conf.yaml:/usr/local/apisix-dashboard/conf/conf.yaml \ apache/apisix-dashboard:whole
Apache APISIX 的 Prometheus 指标端口默认监听 127.0.0.1:9091,若需从 Docker 外部访问,需修改为监听 0.0.0.0。可在 config.yaml 中添加以下配置:
plugin_attr: prometheus: export_addr: ip: "0.0.0.0" port: 9091
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录方式配置轩辕镜像加速服务,包含7个详细步骤
在 Linux 系统上配置轩辕镜像源,支持主流发行版
在 Docker Desktop 中配置轩辕镜像加速,适用于桌面系统
在 Docker Compose 中使用轩辕镜像加速,支持容器编排
在 k8s 中配置 containerd 使用轩辕镜像加速
在宝塔面板中配置轩辕镜像加速,提升服务器管理效率
在 Synology 群晖NAS系统中配置轩辕镜像加速
在飞牛fnOS系统中配置轩辕镜像加速
在极空间NAS中配置轩辕镜像加速
在爱快ikuai系统中配置轩辕镜像加速
在绿联NAS系统中配置轩辕镜像加速
在威联通NAS系统中配置轩辕镜像加速
在 Podman 中配置轩辕镜像加速,支持多系统
配置轩辕镜像加速9大主流镜像仓库,包含详细配置步骤
无需登录即可使用轩辕镜像加速服务,更加便捷高效
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429