xiaojun207/openresty

Openresty 💖 with Auto SSL

https://img.shields.io/docker/v/xiaojun207/openresty?sort=semver](https://hub.docker.com/r/xiaojun207/openresty) https://img.shields.io/docker/image-size/xiaojun207/openresty?sort=semver](https://hub.docker.com/r/xiaojun207/openresty) https://img.shields.io/docker/pulls/xiaojun207/openresty](https://hub.docker.com/r/xiaojun207/openresty)

架构: linux/amd64, linux/arm64

镜像概述和主要用途

本镜像基于Openresty构建，集成acme.sh工具，可自动申请并更新免费SSL证书，支持多种证书服务商。当未配置SSL域名时，可作为普通Openresty镜像使用，适用于需要快速部署HTTPS服务的场景。

核心功能和特性

• 自动SSL管理：通过acme.sh自动申请、续期免费SSL证书
• 多服务商支持：支持zerossl、letsencrypt、buypass等证书服务商，也可指定自定义ACME服务器地址
• 灵活验证方式：支持HTTP验证（默认）和DNS验证（需配置对应DNS API参数）
• 证书持久化：支持将证书文件和acme配置持久化到宿主机，避免重复申请
• 兼容性：可作为普通Openresty镜像使用，保留Openresty全部功能

使用场景和适用范围

• 需要快速部署HTTPS网站或API服务的场景
• 希望自动管理SSL证书生命周期（申请、续期）的用户
• 开发测试环境中需要临时HTTPS证书的场景
• 需要在多架构环境（amd64/arm64）部署Openresty的场景

详细使用方法和配置说明

快速启动

shell
docker pull docker.xuanyuan.run/xiaojun207/openresty:latest

Docker运行示例

shell
docker run -d -p 80:80 -p 443:443 -v "/data/web":/data/web \
      -v /data/openresty/nginx/conf/ssl:/usr/local/openresty/nginx/conf/ssl \
      -v /data/openresty/nginx/conf/conf.d:/usr/local/openresty/nginx/conf/conf.d \
      -v "/data/openresty/acme_cert":/acme_cert/ \
      -e SslDomains="example.com;www.example.com;test.example.com" \
      -e SslServer="zerossl" \
      -e mail="my@example.com" \
      --name myopenresty docker.xuanyuan.run/xiaojun207/openresty:latest

注意事项：

1. 建议将/usr/local/openresty/nginx/conf/ssl（证书存储路径）和/acme_cert/（acme配置路径）持久化到宿主机，避免容器删除后重复申请证书（频繁申请可能被服务商限制）
2. 不要修改nginx.conf的默认路径，否则证书生成会失败
3. 测试环境建议使用Let's Encrypt测试服务器：-e SslServer="https://acme-staging-v02.api.letsencrypt.org/directory"

参数说明

证书路径和Openresty配置方法

容器启动时会生成默认证书（避免Openresty启动失败），成功申请的证书将安装到固定路径：/usr/local/openresty/nginx/conf/ssl。

Openresty配置示例：

nginx
server {
    # 80端口必须可访问，用于域名验证
    listen      80;
    server_name example.com;
    # ...
}

server {
    listen      443 ssl;
    server_name example.com;
    root /data/web/www;

    ssl_stapling off;
    ssl_certificate ssl/fullchain.pem;      # 证书路径：/usr/local/openresty/nginx/conf/ssl/fullchain.pem
    ssl_certificate_key ssl/key.pem;        # 私钥路径：/usr/local/openresty/nginx/conf/ssl/key.pem

    # ... 其他SSL配置
}

证书更新机制

镜像内置定期检查机制，当证书即将过期时（默认30天内），会自动通过acme.sh更新证书并重启Nginx使配置生效，实现证书生命周期的全自动管理。

参考链接

• Openresty镜像GitHub地址：https://github.com/xiaojun207/docker-openresty
• Nginx镜像GitHub地址：https://github.com/xiaojun207/docker-nginx
• acme.sh项目：https://github.com/neilpang/acme.sh.git
• 参考项目：https://github.com/akeylimepie/docker-nginx-letsencrypt
• 相关教程：https://blog.csdn.net/dancen/article/details/***