openresty

travix/openresty Docker Image

travix
自动构建

基于Openresty的边车容器,用于终止SSL连接、证书更新时自动重载,并输出Prometheus指标

1 次收藏下载次数: 0状态:自动构建维护者:travix仓库类型:镜像最近更新:

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"

环境变量配置

环境变量描述默认值
TARGET_SERVICE后端服务地址(格式:host:port)必填
SSL_CERT_PATHSSL证书文件路径/etc/ssl/certs/server.crt
SSL_KEY_PATHSSL私钥文件路径/etc/ssl/certs/server.key
LISTEN_PORT容器监听端口443
METRICS_PORTPrometheus指标暴露端口9145
RELOAD_INTERVAL证书检查间隔(秒)30

证书更新说明

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

监控指标访问

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

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 openresty 镜像标签

docker pull docker.xuanyuan.run/travix/openresty:<标签>

DockerHub 原生拉取命令

docker pull travix/openresty:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告