basecamp/kamal-proxy

轻量级零停机部署HTTP代理镜像

镜像概述

本镜像提供一个轻量级HTTP代理服务，专为零停机部署场景设计。通过在前端代理层管理后端服务实例，实现服务更新或重启时的无缝切换，避免业务中断。其极简设计确保资源占用低，适用于各类需要高可用性的Web服务环境。

核心功能与特性

• 轻量级架构：采用极简设计，二进制文件体积小，内存占用低，适合资源受限环境
• 零停机部署支持：支持后端服务实例的动态切换，更新时无需中断客户端请求
• 健康检查机制：内置后端服务健康探测能力，仅将流量路由至健康实例
• 快速配置：通过环境变量即可完成基础配置，无需复杂配置文件
• 低延迟转发：优化的请求转发逻辑，确保代理过程对响应时间影响最小

使用场景

• 生产环境Web服务的版本更新与迭代
• 需要持续可用的API服务部署
• 微服务架构中的前端流量入口层
• CI/CD流水线中的部署验证环节
• 多环境（开发/测试/生产）服务的统一入口管理

使用方法

基本部署（Docker Run）

bash
docker run -d \
  --name zero-downtime-proxy \
  -p 8080:8080 \
  -e BACKEND_URL=http://backend-service:3000 \
  -e HEALTH_CHECK_PATH=/health \
  -e CHECK_INTERVAL=3s \
  your-registry/zero-downtime-proxy:latest

Docker Compose配置

yaml
version: '3'
services:
  proxy:
    image: your-registry/zero-downtime-proxy:latest
    ports:
      - "80:8080"
    environment:
      - PORT=8080
      - BACKEND_URL=http://app-service:8000
      - HEALTH_CHECK_PATH=/health
      - CHECK_INTERVAL=2s
      - TIMEOUT=5s
    depends_on:
      - app-service

  app-service:
    image: your-app-image:latest
    # 应用服务配置...

环境变量配置

多后端实例配置

通过逗号分隔多个后端URL实现基础负载均衡或主备切换：

bash
docker run -d \
  -p 8080:8080 \
  -e BACKEND_URL="http://backend-1:3000,http://backend-2:3000" \
  your-registry/zero-downtime-proxy:latest

部署最佳实践

1. 后端服务健康检查：确保后端服务实现可靠的健康检查接口（建议返回200 OK状态码）
2. 滚动更新策略：结合容器编排工具（如Kubernetes、Docker Compose）的滚动更新功能使用
3. 资源限制：根据实际需求设置CPU/内存限制，通常50MB内存即可满足基本运行需求
4. 监控集成：通过代理暴露的/metrics端点（如支持）集成Prometheus等监控工具
5. 日志配置：建议挂载日志目录，持久化代理访问日志以便问题排查