APISIX Dashboard实战：从零构建微服务路由网关

1. 认识APISIX Dashboard你的微服务交通指挥官第一次接触APISIX Dashboard时我把它想象成一个繁忙机场的空中交通管制塔台。就像塔台需要协调无数航班起降一样这个可视化面板能帮你管理所有进出微服务集群的网络请求。不同于需要手写YAML配置文件的传统方式Dashboard用图形界面把网关配置变成了拖拽填空的简单操作。去年我在电商项目中首次使用它时原本需要2天完成的网关配置只用3小时就搞定了。Dashboard默认运行在9000端口浏览器访问http://localhost:9000就能看到登录界面初始账号密码都是admin。登录后你会看到六个核心功能模块仪表盘实时显示请求量、延迟等关键指标就像汽车仪表盘显示车速油耗路由定义请求转发规则相当于快递分拣中心的传送带控制系统服务将相同功能的路由打包管理类似把寄往同一地区的快递包裹装进同一个集装箱上游管理后端服务节点好比维护多个可用的快递配送站点插件提供限流、鉴权等增值功能相当于给快递包裹添加保价、代收货款服务证书配置HTTPS所需的SSL证书就像给快递车辆安装防盗锁2. 搭建微服务演示环境模拟真实业务场景2.1 准备三组服务节点为了演示完整配置流程我们先模拟一个包含三个微服务的电商系统前端服务运行在192.168.1.100的Vue应用用户服务处理登录/注册的SpringBoot应用192.168.1.101:5000商品服务管理商品信息的Go应用192.168.1.102:6000用Docker快速启动这些服务最方便。比如用户服务可以这样启动docker run -d -p 5000:5000 --name user-service \ -e SPRING_PROFILES_ACTIVEprod \ your-docker-repo/user-service:1.02.2 网关节点部署APISIX网关需要部署在独立服务器192.168.1.103。用Docker Compose部署最省事version: 3 services: apisix: image: apache/apisix:3.8.0 ports: - 9080:9080 - 9000:9000 volumes: - ./apisix_conf:/usr/local/apisix/conf etcd: image: bitnami/etcd:3.5 environment: ETCD_ADVERTISE_CLIENT_URLS: http://0.0.0.0:2379 ETCD_LISTEN_CLIENT_URLS: http://0.0.0.0:23793. 配置第一个路由用户登录功能3.1 创建上游(Upstream)点击Dashboard左侧上游菜单新建一个名为华南区-用户服务的上游负载均衡算法选择轮询适合初期流量均匀分配在节点列表添加目标地址192.168.1.101:5000健康检查配置间隔5秒HTTP状态码200为健康这里有个实用技巧当同个服务有多个实例时比如用户服务扩容到3个节点可以一次性添加所有节点地址APISIX会自动进行流量分配。3.2 设置路由(Route)转到路由菜单创建新路由名称user-login路径/api/v1/login匹配所有登录请求绑定上游选择刚创建的华南区-用户服务启用JWT插件为路由添加身份验证层测试时可以用curl验证配置curl http://192.168.1.103:9080/api/v1/login \ -H Authorization: Bearer your_jwt_token4. 进阶配置服务抽象与插件应用4.1 使用服务(Service)抽象通用配置当多个路由需要相同配置时比如都要调用用户服务就该使用Service了。创建名为用户中心的服务绑定上游华南区-用户服务添加公共插件限流1000次/分钟CORS允许前端域名跨域访问请求日志记录所有访问日志之后创建/login、/profile等路由时只需绑定这个Service不用重复配置插件。这就像公司给所有部门统一采购办公用品比各部门单独采购更高效。4.2 典型插件使用场景APISIX的插件系统是其超级武器分享几个实战案例流量控制在秒杀活动中给/product/limited路由添加限流插件金丝雀发布使用流量分割插件将5%的请求导流到新版本服务故障熔断配置响应码检测当错误率超过10%时自动切换备用服务配置Prometheus插件监控网关状态plugins: - name: prometheus config: export_addr: ip: 0.0.0.0 port: 90915. 生产环境最佳实践5.1 高可用架构设计我在金融项目中的部署方案网关层3台APISIX实例组成集群前置负载均衡器配置中心5节点ETCD集群确保配置信息不丢失监控体系PrometheusGrafana告警管理器关键配置项# apisix_conf/config.yaml deployment: role: traditional role_traditional: config_provider: etcd etcd: host: - http://etcd1:2379 - http://etcd2:2379 - http://etcd3:23795.2 安全防护策略去年某次安全审计中发现的问题及解决方案接口防刷为敏感路由添加IP限速插件敏感信息过滤使用response-rewrite插件隐藏内部错误详情证书管理每月轮换SSL证书启用TLS 1.3配置示例# 创建自动续期的Lets Encrypt证书 curl http://127.0.0.1:9180/apisix/admin/ssl \ -H X-API-KEY: your-admin-key \ -X PUT -d { cert: $(cat /path/to/cert.pem), key: $(cat /path/to/key.pem), snis: [your-domain.com] }6. 故障排查与性能调优6.1 常见问题处理踩过的坑之一路由匹配失效现象请求未按预期转发排查步骤检查Dashboard路由列表的优先级数值用curl -v查看请求头是否携带必要参数查看APISIX错误日志logs/error.log6.2 性能优化记录压测某政务平台时的调优过程初始QPS1200调优步骤启用HTTP2插件调整worker进程数等于CPU核心数开启内存缓存路由规则最终QPS9500关键配置nginx_config: worker_processes: auto event: worker_connections: 2048 http: lua_shared_dicts: router: 100m