Windows下安装APISIX网关的完整指南

APISIX作为一款高性能的云原生API网关，在微服务架构中扮演着重要角色。本文将详细介绍在Windows环境下安装APISIX的步骤，帮助开发者快速搭建本地开发环境。

为什么选择APISIX？

APISIX基于Nginx和OpenResty构建，具有动态路由、负载均衡、服务熔断等丰富功能。相比传统网关，APISIX支持热加载配置变更，无需重启服务，特别适合敏捷开发场景。Windows用户通过Docker可以轻松体验APISIX的强大功能。

准备工作

安装前请确保系统满足以下条件：

• Windows 10 64位专业版或企业版（版本1903及以上）
• 已启用Hyper-V虚拟化功能
• 至少4GB可用内存
• 管理员权限账户

安装Docker Desktop

APISIX在Windows上通过Docker容器运行，首先需要安装Docker环境：

1. 访问Docker官网下载最新版Docker Desktop安装包
2. 双击安装文件，按照向导完成安装
3. 安装完成后启动Docker Desktop，等待服务初始化完成
4. 打开PowerShell，运行docker --version验证安装是否成功

获取APISIX镜像

Docker环境就绪后，通过以下命令获取官方APISIX镜像：

docker pull apache/apisix:latest

这个命令会下载最新稳定版的APISIX镜像，下载速度取决于网络状况，通常需要几分钟时间。

启动APISIX容器

镜像下载完成后，使用以下命令启动APISIX服务：

docker run -d --name apisix 
    -p 9080:9080 -p 9443:9443 -p 2379:2379 
    apache/apisix

参数说明：

• -d：后台运行容器
• --name：指定容器名称
• -p：端口映射（9080为HTTP端口，9443为HTTPS端口，2379为etcd端口）

验证安装

容器启动后，可以通过几种方式验证APISIX是否正常运行：

1. 检查容器状态：

   docker ps

   应该看到apisix容器状态为"Up"

2. 访问管理接口： 在浏览器中打开http://localhost:9080/apisix/admin/，正常情况会返回404页面，这表示APISIX已启动但未配置路由

3. 查看日志：

   docker logs apisix

   日志中不应出现严重错误信息

常见问题解决

端口冲突

如果启动时提示端口被占用，可以通过修改映射端口解决：

docker run -d --name apisix 
    -p 9081:9080 -p 9444:9443 -p 2380:2379 
    apache/apisix

内存不足

APISIX运行至少需要2GB内存，如果系统资源紧张，可以调整Docker内存分配：

1. 右键系统托盘Docker图标选择"Settings"
2. 进入"Resources"选项卡
3. 增加内存分配至4GB或更高
4. 点击"Apply & Restart"保存设置

网络问题

国内用户可能会遇到镜像下载慢的问题，可以配置Docker镜像加速：

1. 编辑C:Users<用户名>.dockerdaemon.json文件
2. 添加以下内容：

   {
   "registry-mirrors": ["https://registry.docker-cn.com"]
   }

3. 重启Docker服务

基本配置与使用

APISIX安装完成后，可以通过Admin API进行配置管理。以下是一个创建简单路由的示例：

curl "http://127.0.0.1:9080/apisix/admin/routes/1" -H "X-API-KEY: edd1c9f034335f136f87ad84b625c8f1" -X PUT -d '
{
    "uri": "/get",
    "upstream": {
        "type": "roundrobin",
        "nodes": {
            "httpbin.org:80": 1
        }
    }
}'

测试路由是否生效：

curl -i http://127.0.0.1:9080/get

进阶配置

启用Dashboard

APISIX提供了可视化管理界面，可以通过以下命令启动：

docker pull apache/apisix-dashboard
docker run -d --name apisix-dashboard 
    -p 9000:9000 
    -v //var/run/docker.sock:/var/run/docker.sock 
    apache/apisix-dashboard

启动后访问http://localhost:9000，默认用户名密码均为"admin"。

配置SSL证书

要为APISIX配置HTTPS访问，首先准备证书文件，然后通过Admin API添加SSL配置：

curl http://127.0.0.1:9080/apisix/admin/ssls/1 -H "X-API-KEY: edd1c9f034335f136f87ad84b625c8f1" -X PUT -d '
{
    "cert": "...", # 证书内容
    "key": "...",  # 私钥内容
    "snis": ["example.com"]
}'

性能优化建议

1. 调整worker进程数：编辑conf/config.yaml，修改nginx_config.worker_processes为CPU核心数
2. 启用缓存：配置路由时添加缓存插件
3. 限制请求速率：使用limit-count插件防止API滥用
4. 启用gzip压缩：减少网络传输量

卸载APISIX

如需移除APISIX，执行以下命令：

docker stop apisix
docker rm apisix
docker rmi apache/apisix

同时删除相关数据卷（如果有）：

docker volume prune

总结

Windows环境下通过Docker安装APISIX是一个简单高效的方式，适合开发测试场景。生产环境建议使用Linux服务器以获得更好性能。APISIX丰富的插件系统和活跃的社区支持，使其成为API网关的优秀选择。