amazeeio/haproxy

amazee.io haproxy - 已归档

注意：本镜像已归档，替代项目请参见 https://github.com/pygmystack/haproxy

镜像概述

本镜像属于 amazee.io 本地Docker开发环境 的一部分，提供HAProxy作为反向代理，用于在多个容器前转发请求。通过本镜像，可通过友好URL访问多个容器，无需发布或知晓容器端口。

核心功能和特性

• 作为反向代理，转发HTTP（80端口）和HTTPS（443端口）请求至后端容器
• 集成 https://github.com/jwilder/docker-gen%EF%BC%8C%E7%9B%91%E5%90%ACDocker socket以动态生成HAProxy配置
• 支持通过环境变量配置非amazee.io容器的反向代理规则
• 提供状态页面用于监控代理状态

使用场景

• 本地Docker开发环境中，需要通过统一入口访问多个容器服务
• 简化多容器应用的访问方式，无需记忆或暴露容器端口
• 与amazee.io的 cachalot 或 pygmy 工具配合使用

使用方法

与amazee.io工具配合使用

当与 cachalot 或 pygmy 配合使用时，所有配置已预先设置，可直接使用，无需额外操作。

手动启动

bash
docker run -d -p 80:80 -p 443:443 --volume=/var/run/docker.sock:/tmp/docker.sock --name=amazeeio-haproxy amazeeio/haproxy

默认监听80（HTTP）和443（HTTPS）端口，也可自定义端口：

bash
docker run -d -p 8080:80 -p 4443:443 --volume=/var/run/docker.sock:/tmp/docker.sock --name=amazeeio-haproxy amazeeio/haproxy

工作原理

容器内置 docker-gen，通过监听Docker socket监控容器变化。当检测到设置了 AMAZEEIO 环境变量的容器时，docker-gen 会基于 https://github.com/amazeeio/haproxy/blob/master/haproxy.tmpl 模板生成HAProxy配置，并重启HAProxy服务。

与非amazee.io容器配合使用

本镜像可反向代理任何类型的容器，只需为目标容器设置以下环境变量：

• AMAZEEIO：告知docker-gen处理该容器（值无特殊要求，建议设为 AMAZEEIO=AMAZEEIO）
• AMAZEEIO_URL：HAProxy转发请求的目标URL（未设置时默认使用容器名称，需确保DNS可解析该URL至Docker主机IP）
• AMAZEEIO_HTTP_PORT：容器HTTP监听端口（需暴露该端口，未设置时默认80）
• AMAZEEIO_HTTPS_PORT：容器HTTPS监听端口（需暴露该端口，未设置时默认443）

示例（启动Nginx容器并配置反向代理）：

bash
docker run --rm -e AMAZEEIO_URL=nginx.docker.amazee.io -e AMAZEEIO=AMAZEEIO -e AMAZEEIO_HTTP_PORT=80 -p 80 nginx

问题排查

状态页面

HAProxy状态页面可通过 /stats 访问（例如：使用amazee.io环境时访问 [***]

调试命令

若出现问题，可在运行的容器内执行以下命令启动HAProxy调试模式，查看错误信息：

bash
haproxy -f haproxy.cfg -d

支持渠道

若问题无法解决，可加入amazee.io Slack频道：[***] 获取帮助。

开发

为方便开发，项目提供 docker-compose.yml 文件，可启动容器并挂载模板文件，便于实时修改配置。