dokku/openresty-docker-proxy

Openresty反向代理镜像（Dokku部署的Docker容器）

镜像概述

该镜像基于Openresty构建，专门设计作为由Dokku部署的Docker容器的反向代理。它整合了Nginx的高性能核心与Lua脚本支持，旨在简化Dokku环境下多容器应用的流量路由、负载均衡和请求处理，为容器化部署提供高效的代理解决方案。

核心功能和特性

• 高性能代理：基于Nginx核心，提供高效的HTTP/HTTPS请求转发能力，支持高并发场景
• Dokku集成：针对Dokku部署流程优化，支持容器动态发现与配置同步
• Lua扩展能力：通过Lua脚本实现灵活的请求处理、路由规则自定义和业务逻辑嵌入
• 动态配置管理：支持配置热加载，无需重启服务即可更新路由策略和代理规则
• 负载均衡：内置轮询、IP哈希、最少连接等多种负载均衡策略，优化容器资源利用

使用场景和适用范围

• Dokku作为容器编排工具的开发/生产环境
• 多容器应用的请求路由与流量分配管理
• 微服务架构中的服务网关与API请求转发
• 需要通过自定义脚本处理请求逻辑的场景
• 对代理性能有较高要求的容器化部署环境

使用方法和配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name openresty-dokku-proxy \
  --network dokku-network \  # 确保与Dokku容器在同一网络
  -p 80:80 -p 443:443 \
  -v /path/to/nginx.conf:/usr/local/openresty/nginx/conf/nginx.conf \  # 挂载自定义配置
  -e BACKEND_SERVICE=my-dokku-app \  # Dokku应用名称
  -e BACKEND_PORT=5000 \  # 后端容器端口
  your-image-name:tag

Docker Compose配置

yaml
version: '3'
services:
  proxy:
    image: your-image-name:tag
    container_name: openresty-dokku-proxy
    network_mode: dokku-network  # 或使用自定义网络
    ports:
      - "80:80"
      - "443:443"
    environment:
      - BACKEND_SERVICE=my-dokku-app
      - BACKEND_PORT=5000
      - LOAD_BALANCE_STRATEGY=round_robin
      - SSL_ENABLED=false
    volumes:
      - ./nginx.conf:/usr/local/openresty/nginx/conf/nginx.conf
      - ./ssl:/etc/nginx/ssl  # 如需HTTPS，挂载证书目录
    restart: always

配置参数说明

环境变量

Nginx配置示例

基础配置模板（nginx.conf）：

nginx
worker_processes auto;

events {
    worker_connections {{MAX_CONCURRENCY}};
}

http {
    include mime.types;
    default_type application/octet-stream;
    sendfile on;
    keepalive_timeout 65;

    # 后端服务 upstream 配置
    upstream backend {
        {{LOAD_BALANCE_STRATEGY}};
        server {{BACKEND_SERVICE}}:{{BACKEND_PORT}};
        # 如需多实例负载均衡，添加更多 server 行
    }

    # HTTP 服务器配置
    server {
        listen 80;
        server_name localhost;

        location / {
            proxy_pass http://backend;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }
    }

    # HTTPS 配置（当 SSL_ENABLED=true 时生效）
    {{ if SSL_ENABLED }}
    server {
        listen 443 ssl;
        server_name localhost;

        ssl_certificate /etc/nginx/ssl/cert.pem;
        ssl_certificate_key /etc/nginx/ssl/key.pem;
        ssl_protocols TLSv1.2 TLSv1.3;
        ssl_ciphers HIGH:!aNULL:!MD5;

        location / {
            proxy_pass http://backend;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }
    }
    {{ end }}
}

注意事项

• 确保代理容器与Dokku部署的后端容器处于同一网络，以实现容器名称解析
• 自定义Lua脚本可放置于/usr/local/openresty/nginx/lua/目录，并在Nginx配置中通过content_by_lua_file等指令引用
• 启用HTTPS时，需确保SSL证书文件正确挂载且权限配置正确
• 生产环境建议通过环境变量或配置文件限制请求速率，防止DoS***