Apache APISIX 网关安装与部署完全指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00317/article/details/148377801

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

apisix Apisix是一个基于Nginx的API网关，主要用于微服务架构中的API管理和服务发现。它的特点是高性能、轻量级、易于配置等。适用于API管理和负载均衡场景。项目地址: https://gitcode.com/gh_mirrors/api/apisix

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

一、安装方式概览

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

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

二、详细安装方法

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 模板自行配置。

五、最佳实践建议

生产环境建议：
- 使用 Helm 安装在 Kubernetes 环境
- 使用 RPM/DEB 安装在虚拟机环境
开发环境建议：
- 使用 Docker 方式快速启动
- 使用源码安装进行深度定制
安全建议：
- 务必修改默认 Admin key
- 限制 Admin API 的访问权限
- 定期更新到最新版本

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考