Apache APISIX 网关安装与部署完全指南

Apache APISIX 是一个高性能、可扩展的云原生 API 网关，本文将全面介绍 APISIX 的多种安装方式，帮助开发者根据自身环境选择最适合的部署方案。

一、安装方式概览

APISIX 提供了多种灵活的安装方式，适用于不同场景：

1. Docker 安装：适合快速体验和开发环境
2. Helm 安装：适合 Kubernetes 环境
3. RPM 安装：适合 CentOS/RHEL 系统
4. DEB 安装：适合 Debian/Ubuntu 系统
5. 源码安装：适合需要自定义编译的场景

二、详细安装方法

1. Docker 安装方式

适用场景：本地开发测试、快速体验 APISIX 功能

前置条件：

• 已安装 Docker
• 已安装 Docker Compose

安装步骤：

# 克隆官方 Docker 示例仓库
git clone apisix-docker-repo
cd apisix-docker/example

# 根据 CPU 架构选择启动命令
# x86 架构
docker-compose -p docker-apisix up -d

# ARM/M1 架构
docker-compose -p docker-apisix -f docker-compose-arm64.yml up -d

特点：

• 自动包含 etcd 服务
• 一键启动所有依赖组件
• 适合快速验证功能

2. Helm 安装方式

适用场景：Kubernetes 生产环境部署

安装命令：

# 添加 APISIX Helm 仓库
helm repo add apisix apisix-charts-repo
helm repo update

# 安装 APISIX
helm install apisix apisix/apisix --create-namespace --namespace apisix

特点：

• 完整的 Kubernetes 原生支持
• 可配置高可用部署
• 支持 Helm 的版本管理和回滚功能

3. RPM 安装方式

适用系统：CentOS 7/8

安装步骤：

# 添加 APISIX 仓库
sudo yum install -y apisix-repo-rpm

# 安装 APISIX
sudo yum install apisix

# 初始化配置
apisix init

# 启动服务
apisix start

离线安装方案：

# 下载离线包
sudo yum install -y --downloadonly --downloaddir=./apisix apisix

# 目标机器安装
sudo yum install ./apisix/*.rpm

4. DEB 安装方式

适用系统：Debian 11 (Bullseye)

安装步骤：

# 添加 APISIX 仓库
wget -O - apisix-repo-key | sudo apt-key add -
echo "deb apisix-debian-repo bullseye main" | sudo tee /etc/apt/sources.list.d/apisix.list

# 安装指定版本
sudo apt update
sudo apt install -y apisix=3.8.0-0

# 初始化并启动
sudo apisix init
sudo apisix start

三、etcd 安装指南

APISIX 使用 etcd 作为配置中心，若未使用 Docker/Helm 安装方式，需单独安装 etcd。

Linux 系统安装：

ETCD_VERSION='3.5.4'
wget etcd-download-url
tar -xvf etcd-package && cd etcd-dir
sudo cp -a etcd etcdctl /usr/bin/
nohup etcd >/tmp/etcd.log 2>&1 &

macOS 系统安装：

brew install etcd
brew services start etcd

四、安装后配置

1. 基础配置

通过修改 config.yaml 文件配置 APISIX：

apisix:
  node_listen: 8000  # 修改监听端口

deployment:
  etcd:
    host:
      - "http://etcd-host:2379"  # 配置 etcd 地址

重要提示：不要直接修改 nginx.conf，APISIX 会根据 config.yaml 自动生成。

2. 安全配置

强烈建议修改默认 Admin API key：

deployment:
  admin:
    admin_key:
      - name: "admin"
        key: your-secure-key-here
        role: admin

验证新 key：

curl http://127.0.0.1:9180/apisix/admin/routes?api_key=your-secure-key-here -i

3. 服务管理

RPM 安装已包含 systemd 配置，可直接使用：

systemctl start apisix
systemctl status apisix

其他安装方式可参考官方 systemd 模板自行配置。

五、最佳实践建议

1. 生产环境建议：

   • 使用 Helm 安装在 Kubernetes 环境
   • 使用 RPM/DEB 安装在虚拟机环境

2. 开发环境建议：

   • 使用 Docker 方式快速启动
   • 使用源码安装进行深度定制

3. 安全建议：

   • 务必修改默认 Admin key
   • 限制 Admin API 的访问权限
   • 定期更新到最新版本

通过本文介绍的多种安装方式，您可以根据实际需求选择最适合的方案部署 APISIX 网关。安装完成后，建议参考官方文档进一步了解路由配置、插件使用等进阶功能。