tutum/hipache

tutum-docker-hipache

镜像概述

该镜像基于官方 hipache:0.3.1 镜像扩展而来，核心功能是允许通过环境变量在容器运行时动态配置hipache代理服务器，无需预先修改配置文件。

核心功能和特性

• 支持通过环境变量覆盖hipache的所有核心配置参数
• 内置默认配置，可直接使用或按需调整
• 支持链接Redis容器自动配置驱动，简化部署流程
• 配置文件动态生成，基于环境变量值构建

使用场景

适用于需要快速部署和灵活配置hipache反向代理服务器的场景，尤其适合：

• 开发和测试环境中需要频繁调整代理配置的情况
• 容器化部署环境中通过环境变量管理服务配置
• 需要与Redis集成的代理服务场景

配置说明

配置文件结构

容器使用的配置文件模板如下：

json
{
    "server": {
        "accessLog": "{{ SERVER_ACCESSLOG }}",
        "workers": {{ SERVER_WORKERS }},
        "maxSockets": {{ SERVER_MAXSOCKETS }},
        "deadBackendTTL": {{ SERVER_DEADBACKENDTTL }},
        "tcpTimeout": {{ SERVER_TCPTIMEOUT }},
        "retryOnError": {{ SERVER_RETRYONERROR }},
        "deadBackendOn500": {{ SERVER_DEADBACKENDON500 }},
        "httpKeepAlive": {{ SERVER_HTTPKEEPALIVE }},
        "lruCache": {
            "size": {{ SERVER_LRUCACHE_SIZE }},
            "ttl": {{ SERVER_LRUCACHE_TTL }}
        },
        "port": {{ SERVER_PORT }},
        "address": ["{{ SERVER_ADDRESS }}"]
    },
    "driver": "{{ DRIVER }}"
}

环境变量说明

所有配置项均可通过环境变量覆盖，默认值如下：

使用方法示例

基本运行

通过环境变量自定义配置启动容器：

bash
docker run -d -p 80:80 -e DRIVER="redis://:password@externalredishost" tutum/hipache

链接Redis容器

通过--link参数链接Redis容器，自动配置驱动：

bash
docker run -d -p 80:80 --link redis:redis tutum/hipache

链接Redis容器时的额外环境变量：

• REDIS_ENV_REDIS_PASS (可选): Redis认证密码，使用tutum/redis镜像时会自动设置
• REDIS_DB: Redis数据库编号，默认值为0