| name | networking-gateway |
| description | 网络网关与流量管理，覆盖 Nginx / Traefik / API Gateway。DNS 管理、SSL/TLS 证书、CDN 配置、负载均衡策略、流量路由。 |
网络与网关（Networking & Gateway）
参考来源：Nginx 官方文档、Traefik 文档、AWS ALB/NLB 文档、Cloudflare 文档、Let's Encrypt / cert-manager 文档。
适用场景
- 反向代理与负载均衡配置
- API Gateway 设计（路由 / 限流 / 认证）
- SSL/TLS 证书管理（自动续期）
- DNS 记录管理与切换
- CDN 配置与缓存策略
- 多服务流量路由（路径 / 域名）
- WebSocket / gRPC 代理
- DDoS 防护与 WAF
核心原则
1. TLS Everywhere
所有外部流量 HTTPS
内部服务间 mTLS（Service Mesh）
HSTS 强制
2. 最小暴露
只暴露必要端口
内部服务不直接对外
安全组 / NetworkPolicy 限制
3. 高可用
负载均衡多实例
健康检查剔除故障节点
DNS 多记录 / Failover
4. 缓存分层
CDN → 反向代理 → 应用
静态资源长缓存 + 版本化
API 按需缓存
5. 限流保护
全局限流 + 按 IP / 用户
突发容忍 + 平滑限流
429 返回 Retry-After
6. 可观测
访问日志结构化
延迟 / 错误率 / 流量指标
实时流量可视化
7. 零停机变更
配置热加载
DNS 切换 TTL 提前降低
蓝绿 / 金丝雀流量切分
工作流程
1. 网络架构设计
- 外部流量入口（CDN → LB → Gateway）
- 内部服务通信（Service Mesh / 直连）
- 网络分段（公有 / 私有子网）
2. DNS 配置
- 域名注册与托管
- A / CNAME / ALIAS 记录
- TTL 策略（正常 300s，切换前降至 60s）
3. SSL/TLS 证书
- cert-manager 自动签发（Let's Encrypt）
- 通配符证书（*.example.com）
- 证书到期监控
4. 反向代理 / 网关
- 路由规则（路径 / 域名 / Header）
- 上游健康检查
- 超时与重试配置
- WebSocket / gRPC 支持
5. 负载均衡
- 算法选择（Round Robin / Least Conn / IP Hash）
- 会话保持（如需）
- 跨 AZ 分布
6. 安全加固
- WAF 规则（OWASP Top 10）
- Rate Limiting
- IP 白名单 / 黑名单
- Bot 检测
7. CDN 配置
- 静态资源缓存规则
- 动态内容 bypass
- 缓存失效策略（purge）
8. 监控与告警
- 4xx / 5xx 错误率
- P50 / P95 / P99 延迟
- 带宽与连接数
技术选型
| 方案 | 适用场景 | 优势 | 劣势 |
|---|
| Nginx | 通用反向代理 | 性能高、生态成熟 | 配置复杂 |
| Traefik | K8s / Docker 原生 | 自动发现、热加载 | 高并发略逊 |
| AWS ALB | AWS 云原生 | 托管免运维 | 锁定云厂商 |
| Cloudflare | CDN + WAF + DNS | 全球节点、DDoS 防护 | 依赖第三方 |
| Kong | API Gateway | 插件丰富 | 运维复杂 |
| Envoy | Service Mesh | L7 能力强 | 学习曲线高 |
Nginx 核心配置模式
# 反向代理 + 负载均衡
upstream backend {
least_conn;
server app1:3000 weight=3;
server app2:3000 weight=1;
keepalive 32;
}
server {
listen 443 ssl http2;
server_name api.example.com;
ssl_certificate /etc/ssl/cert.pem;
ssl_certificate_key /etc/ssl/key.pem;
# 安全头
add_header Strict-Transport-Security "max-age=31536000" always;
add_header X-Content-Type-Options nosniff;
# 限流
limit_req zone=api burst=20 nodelay;
location / {
proxy_pass http://backend;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_connect_timeout 5s;
proxy_read_timeout 30s;
}
}
质量自检
□ 所有外部流量走 HTTPS
□ HSTS 已启用
□ SSL 证书自动续期
□ 健康检查已配置（剔除故障节点）
□ Rate Limiting 已配置
□ 安全头已添加（HSTS / X-Content-Type / X-Frame）
□ 访问日志结构化输出
□ 超时合理设置（connect / read / write）
□ CDN 缓存规则正确（静态长缓存、API 不缓存）
□ DNS TTL 合理
□ WebSocket / gRPC 代理正确（如需）
□ 负载均衡算法合适
□ 跨 AZ / 多节点部署
□ WAF 规则已启用
常见坑
- 不配 HSTS——中间人降级攻击
- 证书过期——全站不可用
- 超时太长——慢请求拖垮连接池
- 不限流——单用户打爆服务
- CDN 缓存 API 响应——数据不一致
- DNS TTL 太长——切换生效慢
- 不转发真实 IP——日志全是 LB 地址
- WebSocket 无 upgrade——连接失败
- HTTP → HTTPS 不重定向——混合内容
- 负载均衡无健康检查——流量打到故障节点
- 通配符证书不续期——子域名全挂
- Nginx reload 不测试——配置错误导致宕机
配套模板
templates/nginx-config-template.md — Nginx 反向代理 + SSL + 限流完整配置模板
与其他 skill 的协作
上游：
infrastructure-as-code → VPC / 子网 / LB 基础设施
kubernetes-orchestration → Ingress Controller
下游：
release-strategy → 流量切分（金丝雀 / 蓝绿）
monitoring-alerting → 网关指标采集
secrets-config → SSL 证书 / API Key 管理
ci-cd-pipeline → DNS 切换自动化
