iganesh/adguardhome

AdGuard Home Dark Mustard 镜像文档

概述

AdGuard Home Dark Mustard是AdGuard Home的非官方分支，主打深橙色风格的暗色主题，在保留AdGuard Home核心网络过滤功能的基础上，优化了界面视觉体验，特别适合夜间使用场景。

核心功能与特性

• 深橙色基调的暗色主题设计，降低夜间使用时的视觉疲劳
• 完整继承AdGuard Home核心功能：DNS广告过滤、***网站拦截、家长控制等
• 支持多平台部署，包括Docker容器、源码构建、补丁应用等多种安装方式

使用场景与适用范围

• 偏好暗色界面的AdGuard Home用户
• 需要夜间管理网络过滤规则的家庭或小型网络管理员
• 追求个性化界面体验的技术爱好者

安装与使用方法

方法一：Docker部署

bash
# 目前仅提供edge构建版本
docker pull iganesh/adguardhome:latest
docker run --name adguardhome \
-v /my/own/workdir:/opt/adguardhome/work \
-v /my/own/confdir:/opt/adguardhome/conf \
-p 53:53/tcp \
-p 53:53/udp \
-p 67:67/udp \
-p 68:68/tcp \
-p 68:68/udp \
-p 80:80/tcp \
-p 443:443/tcp \
-p 853:853/tcp \
-p 3000:3000/tcp \
-d iganesh/adguardhome

参数说明：

• -v /my/own/workdir:/opt/adguardhome/work: 挂载工作目录，存储运行时数据
• -v /my/own/confdir:/opt/adguardhome/conf: 挂载配置目录，持久化配置文件
• 端口映射包含：DNS(53)、DHCP(67/68)、HTTP(80)、HTTPS(443)、DNS-over-TLS(853)及Web管理界面(3000)

方法二：克隆仓库构建

bash
git clone https://github.com/iganeshk/AdGuardHome
cd AdGuardHome
# 在release.sh脚本中注释掉不需要的目标构建
./release.sh

方法三：应用补丁

bash
wget https://raw.githubusercontent.com/iganeshk/AdGuardHome/dev-assets/dark-mustard-theme.patch
git checkout master/your-branch
git apply dark-mustard-theme.patch
# 在release.sh脚本中注释掉不需要的目标构建
./release.sh

方法四：下载最新发布版

访问 https://github.com/iganeshk/AdGuardHome/releases 下载最新预构建版本。

部署二进制文件（源码构建/发布版适用）

bash
# 停止AdGuard Home服务
service AdGuardHome stop

cd /path/to/AdguardHome
# 复制/下载目标构建文件
# 解压二进制文件（使用对应平台的tar包）
tar -xvf AdGuardHome_linux_amd64.tar.gz --strip-components=1 -C .

# 重新启动服务
service AdguardHome start

# 客户端即可体验暗色主题

截图展示

反馈

如发现界面元素未适配或有功能改进建议，请通过GitHub创建issue反馈。