packetworks/nxfilter-base

NxFilter Base Docker镜像

镜像概述

NxFilter 是一款易用的DNS服务器，具备可配置的过滤功能和用户控制能力。本镜像基于 https://registry.hub.docker.com/u/1science/java/ 构建，旨在提供精简的Java运行环境并减小容器整体体积。

!NxFilter Logo

支持的标签

• https://github.com/packetworks/docker-nxfilter/tree/nxfilter-latest
• https://github.com/packetworks/docker-nxfilter/tree/nxfilter-debian

核心功能与特性

• 易用的DNS服务器功能
• 可配置的内容过滤规则
• 灵活的用户控制机制
• 基于精简Java镜像，减小容器体积
• 支持数据持久化存储

使用场景

适用于需要DNS级内容过滤和用户上网控制的场景，如家庭网络、小型企业网络、学校网络等环境。

使用方法

docker-compose 配置

yaml
nxfilter:
  image: packetworks/nxfilter-base:latest
  tty: true
  volumes:
    - nxfilter-conf:/nxfilter/conf
    - nxfilter-log:/nxfilter/log
    - nxfilter-db:/nxfilter/db
  restart: unless-stopped
  ports:
    - 80:80
    - 443:443
    - 53:53/udp
    - 19002-19004:19002-19004

单个持久化容器

bash
docker run -it \
  --name nxfilter \
  --restart unless-stopped \
  -p 80:80 -p 443:443 \
  -p 53:53/udp \
  packetworks/nxfilter-base:latest

参数说明：

• -it：以交互模式启动容器并分配TTY
• -p：端口映射，其中：
  • 53/udp：用于接收DNS查询
  • 80：用于Web管理界面
  • 其他端口（443、-）用于实现NxFilter的完整功能
• 可通过 CTRL-P + CTRL-Q 将交互控制台切换到后台运行

带持久化数据卷的后台容器

bash
docker run -dt \
  --name nxfilter \
  --restart unless-stopped \
  -v nxfilter-conf:/nxfilter/conf \
  -v nxfilter-log:/nxfilter/log \
  -v nxfilter-db:/nxfilter/db \
  -p 80:80 -p 443:443 -p 53:53/udp \
  -p 19002-19004:19002-19004 \
  packetworks/nxfilter-base:latest

此方式将容器作为后台服务运行，所有用户数据（配置、日志、数据库）通过Docker数据卷持久化保存。

鸣谢

感谢以下贡献者和测试人员：

• Daniel Gibbs
• Vincent Tacquet
• Adam Trust
• Daniele (brugnara)
• Nathan Sanders