# 构建自定义 Docker 镜像

你可以基于已发布的 Docker 源码构建 APISIX 镜像，并根据环境定制该源码。

## 前置条件[​](#前置条件 "前置条件的直接链接")

* 安装 [Git](https://git-scm.com/downloads) 以下载 Docker 源码。
* 安装 [Docker](https://docs.docker.com/engine/install/) 以构建并运行镜像。
* 安装 [Make](https://www.gnu.org/software/make/) 以运行镜像构建目标。

## 克隆仓库[​](#克隆仓库 "克隆仓库的直接链接")

克隆与本版本文档对应的发布分支：

```
git clone --branch release/apisix-3.20.0 --depth 1 https://github.com/apache/apisix-docker.git

cd apisix-docker
```

## 构建 Docker 镜像[​](#构建-docker-镜像 "构建 Docker 镜像的直接链接")

使用 Make 构建 Ubuntu 镜像：

```
make build-on-ubuntu
```

若要构建其他受支持的镜像，请使用 `make build-on-debian` 或 `make build-on-redhat`。

## 检查 Docker 镜像[​](#检查-docker-镜像 "检查 Docker 镜像的直接链接")

确认构建的镜像包含预期的 APISIX 版本：

```
docker run --rm --entrypoint apisix \

  apache/apisix:3.20.0-ubuntu version
```

你应该看到 APISIX 版本：

```
3.20.0
```

## 保留容器入口点[​](#保留容器入口点 "保留容器入口点的直接链接")

扩展镜像时，请保留发布镜像的 `/docker-entrypoint.sh` 入口点和 `docker-start` 命令。入口点会初始化 APISIX，然后以 `daemon off;` 执行 OpenResty，使网关作为容器的最终进程保持在前台运行。

不要将容器命令替换为 `apisix start`。该命令在 OpenResty 以守护进程模式启动后返回。因此，如果容器的最终进程仅为 `apisix start`，即使守护进程已经启动，容器仍会退出。
