Apache APISIX 安装指南：从入门到精通
【免费下载链接】apisix The Cloud-Native API Gateway 
项目地址: https://gitcode.com/GitHub_Trending/ap/apisix
前言
Apache APISIX 是一个高性能、可扩展的云原生 API 网关，作为微服务架构中的重要组件，它提供了丰富的流量管理功能。本文将全面介绍 APISIX 的多种安装方式，帮助开发者根据自身环境选择最合适的安装方案。
安装前准备
在安装 APISIX 之前，需要确保系统满足以下基本要求：
- 操作系统：支持 Linux、macOS 等主流操作系统
- 依赖环境：需要安装 etcd 作为配置中心（Docker 和 Helm 安装方式会自动包含）
- 硬件要求：建议至少 2 核 CPU 和 4GB 内存
多种安装方式详解
1. Docker 安装（推荐开发环境使用）
Docker 安装是最简单快捷的方式，特别适合开发测试环境：
# 克隆官方 Docker 仓库
git clone apisix-docker.git
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
优势：
- 一键部署所有依赖组件
- 环境隔离，不影响主机系统
- 支持多架构（x86/ARM）
2. Helm 安装（Kubernetes 环境首选）
对于 Kubernetes 环境，推荐使用 Helm 进行安装：
# 添加 Helm 仓库
helm repo add apisix https://charts.apiseven.com
helm repo update
# 安装 APISIX
helm install apisix apisix/apisix --create-namespace --namespace apisix
特点：
- 原生支持 Kubernetes 环境
- 可配置性强，支持自定义参数
- 包含完整的监控组件
3. RPM 安装（CentOS 系统推荐）
适合 CentOS 7/8 系统的安装方式：
通过 RPM 仓库安装
# 安装仓库（包含 OpenResty）
sudo yum install -y apache-apisix-repo-1.0-1.noarch.rpm
# 仅安装 APISIX 仓库（已有 OpenResty）
sudo yum-config-manager --add-repo https://repos.apiseven.com/packages/centos/apache-apisix.repo
# 安装 APISIX
sudo yum install apisix
离线安装方式
# 下载离线包
sudo mkdir -p apisix
sudo yum install -y --downloadonly --downloaddir=./apisix apisix
# 在目标机器安装
sudo yum install ./apisix/*.rpm
4. DEB 安装（Debian 系统）
适用于 Debian 11 (Bullseye) 系统：
# 添加仓库（amd64）
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
# 更新并安装
sudo apt update
sudo apt install -y apisix=3.8.0-0
5. 源码编译安装
适合需要深度定制或开发 APISIX 的场景，需要参考专门的构建文档。
etcd 安装指南
APISIX 依赖 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
安装后配置
1. 初始化 APISIX
# RPM/DEB 安装方式
apisix init
# Docker/Helm 会自动完成初始化
2. 启动 APISIX
apisix start
# 或使用 systemd（RPM 安装）
systemctl start apisix
3. 基本配置
配置文件位于 conf/config.yaml，支持以下配置方式：
apisix:
node_listen: 8000 # 修改监听端口
deployment:
admin:
admin_key: # 修改 Admin API 密钥
- name: "admin"
key: your_secure_key
role: admin
重要提示：
- 不要直接修改
conf/config-default.yaml默认配置文件 conf/nginx.conf是自动生成的，不应手动修改
部署模式选择
APISIX 支持三种部署模式：
- 传统模式：单节点全功能部署
- 控制面/数据面分离：适合大规模生产环境
- 无 etcd 模式：使用其他配置中心
常见问题
- 端口冲突：确保默认的 9080/9180/9443 端口未被占用
- etcd 连接失败：检查 etcd 服务是否正常运行
- 权限问题：使用 sudo 或确保当前用户有足够权限
结语
本文详细介绍了 Apache APISIX 的各种安装方式，从简单的 Docker 安装到生产环境适用的 RPM/DEB 安装，开发者可以根据实际需求选择最适合的方案。安装完成后，建议立即修改默认的 Admin API 密钥，并按照业务需求调整配置参数。
【免费下载链接】apisix The Cloud-Native API Gateway 项目地址: https://gitcode.com/GitHub_Trending/ap/apisix
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
