相关版本
系统Rocky Linux10.2,docker 29.7.2,apisix 3.18.0
下载 apisix-docker 仓库
bash
git clone https://github.com/apache/apisix-docker.git
cd apisix-docker/example
安装并启动
bash
docker compose -p docker-apisix up -d
含义
| 部分 | 含义 |
|---|---|
docker compose |
Docker Compose V2 的调用方式(作为 Docker CLI 的子命令)。注意中间是空格,而非旧版 V1 的连字符 docker-compose。 |
-p docker-apisix |
指定项目名称(Project Name)。所有由本次启动创建的容器、网络、卷都会以 docker-apisix_ 为前缀命名,避免与同一台机器上其他 Compose 项目冲突。 |
up |
核心子命令:根据 docker-compose.yml 定义,创建并启动所有服务。如果镜像不存在会自动拉取,容器已存在但配置有变更则自动重建。 |
-d |
Detached 模式(后台运行)。不加此参数时,终端会实时输出所有容器的日志并阻塞;加上后命令立即返回,容器在后台持续运行。 |
配套命令
bash
# 查看该项目所有容器状态
docker compose -p docker-apisix ps
# 查看实时日志
docker compose -p docker-apisix logs -f apisix
# 停止并删除该项目所有容器、网络
docker compose -p docker-apisix down
# 仅重启 APISIX 服务(不影响 etcd 等依赖)
docker compose -p docker-apisix restart apisix
安装完成
docker ps

安装完成后,会出现很多容器,apisix_web1_1, apisix_web2_1为测试用例,grafana与prometheus用来提供服务可观测性
对应提供的控制台地址及测试用例
apisix_web1_1:http://ip:9081
apisix_web2_1:http://ip:9082
prometheus: http://ip:9090/
grafana: http://ip:3000/ ---默认账号密码: admin/admin