aeron/404

404 Container

镜像概述和主要用途

404 Container是一个超紧凑的容器，唯一功能是返回HTTP 404响应。该容器使用Rust和async-std编写，旨在提供高性能的默认后端服务，特别适用于Kubernetes Ingress部署场景。

核心功能和特性

• 超紧凑体积：镜像体积极小，资源占用低
• 高性能：基于Rust和async-std构建，处理请求高效
• 跨平台支持：解决了传统默认后端镜像（如k8s.gcr.io/defaultbackend-amd64）在arm64平台上的兼容性问题
• 可配置性：支持通过环境变量自定义监听端口
• 安全设计：支持以非特权用户身份运行

使用场景和适用范围

• Kubernetes Ingress控制器的默认后端，当没有匹配的路由规则时返回404响应
• 需要简单、高效的404响应服务的各类基础设施环境
• 替代老旧或平台兼容性差的默认后端镜像

使用方法和配置说明

镜像拉取

容器镜像可从以下两个仓库获取，两者可互换使用：

sh
# 从Docker Hub拉取
docker pull docker.io/aeron/404

# 或从GitHub Container Registry拉取
docker pull ghcr.io/Aeron/404

容器运行

默认配置运行

默认情况下，容器监听0.0.0.0:8080地址：

sh
docker run -d --restart unless-stopped --name http-404 \
    --user=65534 \
    -p 80:8080 \
    docker.io/aeron/404

自定义端口运行

通过PORT环境变量可指定监听端口：

sh
docker run -d --restart unless-stopped --name http-404 \
    --user=65534 \
    -e PORT=1080 \
    -p 80:1080 \
    docker.io/aeron/404

配置参数说明

注意事项

• 容器本身不强制特定的用户ID，建议使用--user=65534（nobody用户）以非特权方式运行，增强安全性
• 确保端口映射与指定的PORT环境变量一致
• 支持amd64和arm64等多平台架构，无平台不匹配问题