ttrafelet/traefik_error_pages

自定义Traefik错误页面镜像

镜像概述和主要用途

这是一个托管自定义错误页面的简单Flask容器，基于最新Alpine镜像构建以保持轻量级。该容器旨在与Traefik配合使用，为所有服务提供统一的错误页面，并会注册一个优先级为1（最低）的catchall路由，使Traefik的404错误也能被此服务捕获，从而展示美观的404页面，替代Traefik默认的“404 page not found”提示。

错误页面设计源自Saleh Riaz，原始页面可在其网站查看：[***]

注意：此镜像的设计主要满足个人需求。

核心功能和特性

• 轻量级：基于Alpine镜像，体积小巧
• 自定义错误页面：提供美观的错误页面展示
• Traefik集成：自动注册最低优先级catchall路由，捕获Traefik 404错误
• 安全运行：默认以非root用户“flask”运行

使用场景和适用范围

适用于使用Traefik作为反向代理的环境，需要为所有服务统一自定义错误页面，尤其是希望替换Traefik默认404错误页面的场景。

使用方法和配置说明

运行此镜像时，需相应配置Traefik。Bitbucket仓库中的docker-compose.yml提供了一个工作配置，该配置基于以下前提条件：

• 名为“proxy”的Docker网络（用于容器间内部通信，Traefik和此容器需加入该网络 - 可选）
• 名为“security”的Traefik中间件（通过文件定义，用于设置安全头 - 可选）
• Traefik中名为“web-secure”的入口点（名称可自定义）

该配置假设所有HTTP请求已独立重定向至HTTPS。若您的环境未配置此重定向，则需注册额外的catch-all规则。

安全说明

容器默认以非root用户“flask”运行。因此，$APP_PORT（默认5000）不可使用1024以下的端口。