E2Guardian Docker镜像

镜像概述和主要用途

该镜像提供E2Guardian内容过滤代理的容器化部署。E2Guardian是一款开源内容过滤代理，支持透明代理和ICAP协议，可用于企业、家庭网络的内容管控。镜像特性包括配置文件实时更新自动重载、多版本标签支持及固定权限控制。

核心功能和特性

• 多模式支持：独立代理模式（8080端口）和ICAP模式（1344端口）
• 自动重载机制：/etc/e2guardian目录下配置文件创建/修改/删除时，进程自动重载（如黑名单更新）
• 版本标签管理：稳定版（vx.x）、开发版（vx.x.dev）及测试版（build-noprod）
• 权限控制：固定UID/GUID为1161，确保容器安全运行
• 跨平台适配：支持64位系统，ARM设备（如Raspberry Pi4/3B）需64位OS

使用场景和适用范围

-企业网络内容过滤与访问控制 -家庭网络不良内容屏蔽 -需集成ICAP协议的网关或防火墙环境 -需要动态更新过滤规则的网络场景

使用方法和配置说明

快速启动

通过以下命令启动容器，挂载配置和日志目录并映射端口：

bash
docker run -d --name="e2guardian" \
    -v /path/to/yourconfig:/etc/e2guardian \
    -v /path/to/yourlog:/var/log \  
    -p 8080:port \
    --restart=unless-stopped \
    fredbcode/e2guardian:v5.4

说明：/etc/e2guardian目录下文件变更时，进程自动重载（如黑名单更新）

标签说明

• vx.x：最新稳定版（PROD），对应E2Guardian稳定发布
• vx.x.dev：开发版本
• build-noprod：最新构建版本，仅用于测试

端口映射

UID/GUID

容器内进程使用UID/GUID 1161运行，确保文件权限一致性。

关于E2Guardian

E2Guardian是开源内容过滤代理，请注意当前版本配置文件有重大变更：

• 示例列表已重组到子目录
• 部分配置文件不向后兼容
• 升级前需阅读notes/NEWIN_v5和notesUpgrading_to_VXX文档

配置文件详情可查看e2guardian.conf、e2guardianf1.conf及configs/lists目录下的README文件。