varthe/defaulterr

Defaulterr Docker镜像

概述

Defaulterr是一个轻量级工具，旨在帮助Web开发者和系统管理员为各种HTTP状态码生成统一、美观且功能完善的默认错误页面。通过Docker容器化部署，可以轻松集成到现有的Web服务架构中，提供一致的错误处理体验。

核心功能与特性

• 支持所有标准HTTP状态码的错误页面生成
• 响应式设计，适配各种设备屏幕尺寸
• 可自定义的页面样式、颜色和内容
• 简洁明了的错误信息展示
• 可选的返回首页、联系支持等快捷操作按钮
• 轻量级实现，资源占用低

使用场景

• Web服务器(Nginx, Apache等)的默认错误页面替换
• 应用程序错误处理页面统一管理
• 开发环境与生产环境错误页面标准化
• 需要快速部署美观错误页面的各类Web项目

使用方法

基本用法

使用以下命令启动Defaulterr容器:

bash
docker run -d -p 8080:80 --name defaulterr varthe/defaulterr

容器启动后，可以通过访问 http://localhost:8080/[状态码] 来查看对应状态码的错误页面，例如:

• http://localhost:8080/404
• http://localhost:8080/500

自定义配置

环境变量

Defaulterr支持以下环境变量进行配置:

自定义启动示例

bash
docker run -d -p 8080:80 \
  --name defaulterr \
  -e PRIMARY_COLOR="#e74c3c" \
  -e LANGUAGE="zh" \
  -e HOME_LINK="https://example.com" \
  -e SUPPORT_EMAIL="help@example.com" \
  varthe/defaulterr

Docker Compose 配置

yaml
version: '3'
services:
  defaulterr:
    image: varthe/defaulterr
    container_name: defaulterr
    restart: always
    ports:
      - "8080:80"
    environment:
      - PRIMARY_COLOR="#2ecc71"
      - SECONDARY_COLOR="#34495e"
      - LANGUAGE="en"
      - HOME_LINK="/"
      - SUPPORT_EMAIL="support@example.com"

集成示例

与Nginx集成

在Nginx配置中使用Defaulterr作为错误页面处理:

nginx
server {
    listen 80;
    server_name example.com;

    error_page 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 421 422 423 424 425 426 428 429 431 451 500 501 502 503 504 505 506 507 508 510 511 http://defaulterr:80/$status;

    location / {
        # 你的主要应用配置
        proxy_pass http://your_app:80;
    }
}

自定义错误页面内容

如需进一步自定义错误页面内容，可以通过挂载配置文件实现:

bash
docker run -d -p 8080:80 \
  --name defaulterr \
  -v /path/to/custom/templates:/app/templates \
  -v /path/to/custom/static:/app/static \
  varthe/defaulterr

支持的HTTP状态码

Defaulterr支持所有标准HTTP状态码，包括但不限于:

• 400 (Bad Request)
• 401 (Unauthorized)
• 403 (Forbidden)
• 404 (Not Found)
• 405 (Method Not Allowed)
• 500 (Internal Server Error)
• 502 (Bad Gateway)
• 503 (Service Unavailable)
• 504 (Gateway Timeout)