Apache APISIX 网关安装完全指南

Apache APISIX 网关安装完全指南

apisix The Cloud-Native API Gateway 项目地址: https://gitcode.com/gh_mirrors/ap/apisix

Apache APISIX 是一个高性能、可扩展的云原生 API 网关，基于 Nginx 和 etcd 实现。本文将详细介绍 APISIX 的多种安装方式，帮助开发者根据实际环境选择最适合的安装方案。

安装前准备

在安装 APISIX 之前，需要确保系统满足以下基本要求：

1. 操作系统：支持 Linux、macOS 等主流操作系统
2. 硬件配置：建议至少 2 核 CPU 和 4GB 内存
3. 依赖组件：需要安装 etcd 作为配置中心（Docker 和 Helm 方式会自动安装）

多种安装方式详解

1. Docker 安装（推荐开发环境使用）

Docker 安装是最简单快捷的方式，特别适合开发测试环境。

安装步骤：

1. 确保已安装 Docker 和 Docker Compose
2. 获取 APISIX Docker 项目文件
3. 根据 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 环境首选）

对于 Kubernetes 环境，推荐使用 Helm 进行安装。

安装命令：

helm repo add apisix https://charts.apiseven.com
helm repo update
helm install apisix apisix/apisix --create-namespace --namespace apisix

特点：

• 原生支持 Kubernetes 环境
• 可轻松扩展和升级
• 支持自定义配置

3. RPM 安装（CentOS 生产环境推荐）

适合 CentOS 7/8 生产环境部署。

安装步骤：

1. 添加 APISIX 仓库：

   sudo yum install -y https://repos.apiseven.com/packages/centos/apache-apisix-repo-1.0-1.noarch.rpm
   

2. 安装 APISIX：

   sudo yum install apisix
   

离线安装方案：

1. 在有网络的环境下载 RPM 包
2. 将包复制到目标机器
3. 使用 yum install ./apisix/*.rpm 安装

服务管理命令：

• 初始化：apisix init
• 启动：apisix start
• 停止：apisix stop
• 查看帮助：apisix help

4. DEB 安装（Debian 系统）

目前支持 Debian 11 (Bullseye)，支持 amd64 和 arm64 架构。

安装步骤：

1. 添加仓库和密钥：

   wget -O - http://repos.apiseven.com/pubkey.gpg | sudo apt-key add -
   echo "deb http://repos.apiseven.com/packages/debian bullseye main" | sudo tee /etc/apt/sources.list.d/apisix.list
   

2. 安装特定版本：

   sudo apt update
   sudo apt install -y apisix=3.8.0-0
   

5. 源码编译安装

适合需要深度定制或开发 APISIX 的场景，具体编译方法请参考 APISIX 官方构建文档。

etcd 独立安装指南

如果选择非 Docker/Helm 安装方式，需要手动安装 etcd。

Linux 系统安装：

ETCD_VERSION='3.5.4'
wget https://github.com/etcd-io/etcd/releases/download/v${ETCD_VERSION}/etcd-v${ETCD_VERSION}-linux-amd64.tar.gz
tar -xvf etcd-v${ETCD_VERSION}-linux-amd64.tar.gz
cd etcd-v${ETCD_VERSION}-linux-amd64
sudo cp -a etcd etcdctl /usr/bin/
nohup etcd >/tmp/etcd.log 2>&1 &

macOS 系统安装：

brew install etcd
brew services start etcd

安装后配置

基础配置

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

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

deployment:
  role: traditional
  role_traditional:
    config_provider: etcd
  etcd:
    host:
      - "http://etcd-server:2379"  # 配置 etcd 地址

重要提示：

1. 不要直接修改 config-default.yaml 文件
2. 不要手动修改 nginx.conf 文件

安全配置

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

deployment:
  admin:
    admin_key:
      -
        name: "admin"
        key: your_secure_key_here  # 修改为安全的密钥
        role: admin

Systemd 集成

对于生产环境，建议配置 systemd 管理 APISIX 服务。RPM 安装方式已自动配置，其他方式可参考官方模板手动配置。

总结

本文详细介绍了 Apache APISIX 的五种安装方式，开发者可以根据实际环境需求选择最适合的方案。对于生产环境，推荐使用 RPM/DEB 或 Helm 安装方式；开发测试环境则可以使用 Docker 快速启动。安装完成后，请务必进行适当的安全配置，特别是修改默认的 Admin API key。

apisix The Cloud-Native API Gateway 项目地址: https://gitcode.com/gh_mirrors/ap/apisix