基于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)
bashdocker 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配置示例
yamlversion: '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_PATH | SSL证书文件路径 | /etc/ssl/certs/server.crt |
| SSL_KEY_PATH | SSL私钥文件路径 | /etc/ssl/certs/server.key |
| LISTEN_PORT | 容器监听端口 | 443 |
| METRICS_PORT | Prometheus指标暴露端口 | 9145 |
| RELOAD_INTERVAL | 证书检查间隔(秒) | 30 |
证书更新说明
将新证书文件替换挂载目录中的对应文件(默认路径:/etc/ssl/certs/server.crt和server.key),容器将在RELOAD_INTERVAL时间内自动检测到变化并重载配置,无需重启容器。
监控指标访问
Prometheus指标可通过http://<container-ip>:<METRICS_PORT>/metrics访问,包含连接数、请求量、状态码分布等关键指标。
travix 命名空间的其他可用镜像:
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 openresty 镜像标签
docker pull docker.xuanyuan.run/travix/openresty:<标签>
DockerHub 原生拉取命令
docker pull travix/openresty:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务