travix/openresty

docker-openresty

概述

docker-openresty是一个基于Openresty的边车（Sidecar）容器，主要用于在微服务架构中提供SSL终止功能，支持证书更新时自动重载配置，并输出Prometheus可采集的监控指标。该镜像旨在简化SSL管理流程，提升服务安全性和可观测性。

核心功能与特性

• SSL终止：作为流量入口，负责处理SSL/TLS加密连接，减轻后端服务的加密计算负担
• 证书自动重载：监测证书文件变化，无需手动重启即可应用新证书
• Prometheus指标输出：内置指标采集功能，提供连接数、请求量、响应时间等关键监控数据
• 轻量级设计：基于Openresty构建，兼具Nginx的高性能和Lua的灵活性

使用场景与适用范围

• 微服务架构中为后端服务提供统一的SSL终结层
• 需要频繁更新SSL证书的环境（如Let's Encrypt证书自动续期场景）
• 对服务流量监控有需求的应用场景
• Kubernetes等容器编排环境中的边车部署模式

使用方法与配置说明

基本部署（docker run）

bash
docker run -d \
  --name openresty-sidecar \
  -p 443:443 \
  -v /path/to/certificates:/etc/ssl/certs \
  -e TARGET_SERVICE=backend:8080 \
  docker.xuanyuan.run/docker-openresty

docker-compose配置示例

yaml
version: '3'
services:
  openresty-sidecar:
    image: docker.xuanyuan.run/docker-openresty
    ports:
      - "443:443"
    volumes:
      - ./certs:/etc/ssl/certs
    environment:
      - TARGET_SERVICE=backend:8080
      - SSL_CERT_PATH=/etc/ssl/certs/server.crt
      - SSL_KEY_PATH=/etc/ssl/certs/server.key
      - METRICS_PORT=9145
    depends_on:
      - backend

  backend:
    image: docker.xuanyuan.run/your-backend-service
    ports:
      - "8080:8080"

环境变量配置

证书更新说明

将新证书文件替换挂载目录中的对应文件（默认路径：/etc/ssl/certs/server.crt和server.key），容器将在RELOAD_INTERVAL时间内自动检测到变化并重载配置，无需重启容器。

监控指标访问

Prometheus指标可通过http://<container-ip>:<METRICS_PORT>/metrics访问，包含连接数、请求量、状态码分布等关键指标。