Apache APISIX 安装指南：从入门到精通
项目地址: https://gitcode.com/gh_mirrors/api/apisix Apache APISIX 作为云原生 API 网关，提供了多种灵活的安装方式以适应不同环境需求。本文将全面介绍 APISIX 的各种安装方法，帮助开发者快速搭建自己的 API 网关服务。
一、安装前准备
在安装 APISIX 之前，需要确保系统满足以下基本要求：
- 操作系统：支持 Linux、macOS 等主流操作系统
- 依赖组件：需要先安装 etcd（APISIX 的配置存储中心）
- 硬件要求：
- 内存：建议至少 4GB
- CPU：建议至少 2 核
- 磁盘空间：建议至少 10GB
二、安装 etcd
etcd 是 APISIX 的核心依赖组件，用于存储和同步配置信息。以下是不同系统下的安装方法：
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
三、APISIX 安装方法
1. Docker 安装（推荐开发环境使用）
Docker 安装方式最为简单，适合快速搭建开发测试环境：
git clone https://github.com/apache/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
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
3. RPM 安装（CentOS 系统）
适合 CentOS 7/8 系统的安装方式：
通过 RPM 仓库安装
sudo yum install -y https://repos.apiseven.com/packages/centos/apache-apisix-repo-1.0-1.noarch.rpm
sudo yum install apisix
离线安装方式
sudo mkdir -p apisix
sudo yum install -y https://repos.apiseven.com/packages/centos/apache-apisix-repo-1.0-1.noarch.rpm
sudo yum clean all && yum makecache
sudo yum install -y --downloadonly --downloaddir=./apisix apisix
将下载的包复制到目标机器后执行：
sudo yum install ./apisix/*.rpm
4. DEB 安装（Debian 系统）
目前支持 Debian 11 (Bullseye) 系统：
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，可参考官方构建文档进行编译安装。
四、APISIX 服务管理
安装完成后，需要进行初始化和启动：
-
初始化配置：
apisix init -
启动服务：
apisix start -
查看帮助：
apisix help
对于 RPM 安装方式，还可以使用 systemd 管理服务：
systemctl start apisix
systemctl stop apisix
五、基础配置
1. 配置文件位置
APISIX 的主配置文件位于 conf/config.yaml，可以通过以下方式指定配置文件：
apisix start -c /path/to/your/config.yaml
2. 常用配置项
示例配置修改监听端口：
apisix:
node_listen: 8000
修改 etcd 地址：
deployment:
role: traditional
role_traditional:
config_provider: etcd
etcd:
host:
- "http://your-etcd-address:2379"
3. 安全配置
强烈建议修改默认的 Admin API 密钥：
deployment:
admin:
admin_key:
- name: "admin"
key: your_secure_key_here
role: admin
修改后访问 Admin API 需使用新密钥：
curl http://127.0.0.1:9180/apisix/admin/routes?api_key=your_secure_key_here -i
六、部署模式选择
APISIX 支持三种部署模式，适用于不同场景：
- 传统模式：单节点部署，适合简单场景
- 集群模式：多节点部署，提供高可用性
- 无 etcd 模式：配置中心化管理的部署方式
开发者可根据实际需求选择合适的部署模式。
七、常见问题
- 端口冲突：确保 APISIX 的监听端口（默认 9080）未被占用
- etcd 连接失败：检查 etcd 服务是否正常运行，网络是否通畅
- 权限问题：确保运行 APISIX 的用户有足够的权限访问相关目录和端口
通过本文的详细指导，开发者应该能够顺利完成 Apache APISIX 的安装和基础配置。安装完成后，建议参考官方文档进一步了解路由配置、插件使用等高级功能。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
