iresty/apisix

APISIX Docker镜像文档

镜像概述

APISIX是一款云原生微服务API网关，基于OpenResty和etcd构建，旨在为所有API和微服务提供极致性能、安全性、开源且可扩展的平台。相比传统API网关，APISIX具备动态路由和插件热加载能力，特别适用于微服务架构下的API管理场景。

核心功能和特性

• 动态路由：支持无需重启网关即可实时更新路由规则，灵活应对业务需求变化
• 插件热加载：可动态加载或卸载插件，无需中断服务，提升系统灵活性和可维护性
• 高性能：基于OpenResty（Nginx+Lua）构建，继承Nginx的高性能特性，处理高并发请求能力强
• 云原生设计：适配微服务架构，支持容器化部署，与Kubernetes等编排平台无缝集成
• 开源可扩展：开源社区活跃，支持丰富的插件生态，可根据业务需求自定义扩展

使用场景和适用范围

• 微服务API管理：统一管理微服务架构中的API请求，实现服务间通信的路由与控制
• API请求路由与负载均衡：根据规则将请求分发至不同服务实例，实现负载均衡和流量控制
• API安全防护：通过插件实现认证授权、限流熔断、WAF防护等安全功能
• 服务监控与可观测性：集成监控插件，收集API调用 metrics、日志，支持可观测性平台对接
• 多环境适配：适用于开发、测试、生产等多环境的API网关需求

使用方法和配置说明

前置依赖

APISIX依赖etcd存储配置数据，使用前需确保etcd服务已正常运行。

Docker快速启动

1. 启动etcd（示例）

bash
docker run -d --name etcd \
  -p 2379:2379 \
  -e ETCD_LISTEN_CLIENT_URLS=http://0.0.0.0:2379 \
  -e ETCD_ADVERTISE_CLIENT_URLS=http://etcd:2379 \
  bitnami/etcd:latest

2. 启动APISIX

bash
docker run -d --name apisix \
  --link etcd:etcd \
  -p 9080:9080 \  # HTTP端口
  -p 9443:9443 \  # HTTPS端口
  -p 9180:9180 \  # Admin API端口
  -e ETCD_ENDPOINTS=http://etcd:2379 \  # 连接etcd的地址
  apache/apisix:latest

关键环境变量说明

验证部署

通过Admin API检查APISIX状态：

bash
curl http://localhost:9180/apisix/admin/status -H "X-API-Key: edd1c9f034335f136f87ad84b625c8f1"

返回类似以下内容表示部署成功：

json
{
  "status": "running",
  "version": "3.7.0",
  "etcd_version": "3.5.0"
}