hulklab/apisix

docker-apisix

概述

docker-apisix 是一个云原生微服务API网关镜像，基于APISIX构建，旨在为微服务架构提供统一的API入口，实现API路由、流量管理、安全防护等核心功能。

核心功能和特性

• 云原生设计：深度适配Kubernetes等容器编排平台，支持动态扩缩容
• 动态配置：基于etcd实现配置实时更新，无需重启服务即可生效
• 高性能：基于NGINX内核，支持高并发请求处理，低延迟
• 丰富插件生态：内置限流、熔断、认证（JWT/OAuth2）、监控等多种插件
• 可扩展性：支持自定义插件开发和第三方服务集成

使用场景和适用范围

• 微服务架构中的API统一入口管理
• 多服务间的请求路由与负载均衡
• API流量控制（限流、熔断、流量染色）
• API安全防护（认证授权、WAF、数据加密）
• 服务监控与日志收集（与Prometheus、Grafana等集成）

使用方法和配置说明

基本部署（docker run）

bash
docker run -d --name apisix \
  -p 9080:9080 \  # HTTP请求端口
  -p 9443:9443 \  # HTTPS请求端口
  -p 9180:9180 \  # 管理API端口
  apache/apisix:latest

环境变量配置

常用环境变量说明：

• APISIX_LISTEN_PORT: HTTP监听端口，默认9080
• APISIX_SSL_LISTEN_PORT: HTTPS监听端口，默认9443
• APISIX_ADMIN_LISTEN_PORT: 管理API端口，默认9180
• ETCD_HOST: etcd服务地址，默认http://127.0.0.1:2379
• APISIX_ENABLE_PROFILING: 是否启用性能分析，默认false

docker-compose部署示例

yaml
version: '3'
services:
  apisix:
    image: docker.xuanyuan.run/apache/apisix:latest
    ports:
      - "9080:9080"
      - "9443:9443"
      - "9180:9180"
    environment:
      - ETCD_HOST=http://etcd:2379
    depends_on:
      - etcd
    restart: always

  etcd:
    image: docker.xuanyuan.run/bitnami/etcd:latest
    environment:
      - ALLOW_NONE_AUTHENTICATION=yes
      - ETCD_ADVERTISE_CLIENT_URLS=http://etcd:2379
    ports:
      - "2379:2379"

验证部署

部署完成后，可通过以下命令验证服务状态：

bash
# 检查容器运行状态
docker ps | grep apisix

# 访问管理API
curl http://localhost:9180/apisix/admin/routes -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1'