README 未给出安装命令与端口等细节，具体配置需查阅 adguard/DOCS.md 文档
在 Home Assistant 的 App 商店添加 hassio-addons 仓库后安装 AdGuard Home 应用 硬件要求按 README 说明
README 未说明
Home Assistant 社区应用版 AdGuard Home，为整个网络提供去广告与反跟踪 DNS 服务
把 AdGuard Home 打包成 Home Assistant 社区应用，一键部署 DNS 级广告拦截和家庭网络过滤，省去手动配置的麻烦。
核心能力
- 以 DNS 服务在整网范围拦截广告与跟踪器
- 支持家长控制，可拦截成人内容
- 无需在客户端安装任何程序
- 提供功能丰富的 Web 界面管理过滤规则与设置
容易踩的坑
内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README
- v6.3.2最新正式版2026-11-03 · 2026-11-03 20:15 UTC
What’s changed
⬆️ Dependency updates
- ⬆️ Update ghcr.io/hassio-addons/base Docker tag to v21.0.10 @renovate[bot] (#741)
- ⬆️ Update AdguardTeam/AdGuardHome to v0.107.80 @renovate[bot] (#742)
- v6.3.12026-10-24 · 2026-10-24 14:31 UTC
查看更新说明
What’s changed
⬆️ Dependency updates
- ⬆️ Update ghcr.io/hassio-addons/base Docker tag to v21.0.6 @renovate[bot] (#732)
- ⬆️ Update ghcr.io/hassio-addons/base Docker tag to v21.0.7 @renovate[bot] (#733)
- ⬆️ Update ghcr.io/hassio-addons/base Docker tag to v21.0.8 @renovate[bot] (#735)
- ⬆️ Update alpine_3_24/yq-go to v4.53.3-r2 @renovate[bot] (#736)
- ⬆️ Update alpine_3_24/nginx to v1.30.6-r0 @renovate[bot] (#738)
- ⬆️ Update hassio-addons/workflows action to v5 @renovate[bot] (#740)
- ⬆️ Update ghcr.io/hassio-addons/base Docker tag to v21.0.9 @renovate[bot] (#739)
- v6.3.02026-09-18 · 2026-09-18 19:59 UTC
查看更新说明
What’s changed
✨ New features
- Add options for the safe browsing and parental control block hosts @frenck (#728)
🐛 Bug fixes
- Restore the AdGuard Home configuration when it is found damaged on start @frenck (#729)
🚀 Enhancements
- Explicitly request NET_RAW privileges @agners (#726)
🧰 Maintenance
- Migrate the s6 user bundle to /etc/s6-overlay/user-bundles.d @frenck (#727)
⬆️ Dependency updates
- ⬆️ Update hassio-addons/workflows action to v4 @renovate[bot] (#719)
- ⬆️ Update ghcr.io/hassio-addons/base Docker tag to v21.0.3 @renovate[bot] (#721)
- ⬆️ Update ghcr.io/hassio-addons/base Docker tag to v21.0.4 @renovate[bot] (#722)
- ⬆️ Update alpine_3_24/yq-go to v4.53.3-r1 @renovate[bot] (#723)
- ⬆️ Update ghcr.io/hassio-addons/base Docker tag to v21.0.5 @renovate[bot] (#724)
- v6.2.12026-08-19 · 2026-08-19 15:00 UTC
查看更新说明
What’s changed
🐛 Bug fixes
- Fix translations for network ports @flaparoo (#707)
- Add Hebrew translations for AdGuard configuration @tzagim (#703)
- 🐛 Fix non-existent bashio::warning calls in schema migration warning @frenck (#715)
- 🐛 Wait for host network before collecting AdGuard Home bind hosts @frenck (#717)
🧰 Maintenance
- 🚿 Tidy up NGINX service scripts @frenck (#701)
- 🔒 Improve NGINX response headers @frenck (#700)
- 👷 Replace Repology with Alpine CDN datasource for package pins @frenck (#714)
📚 Documentation
- 📝 Document how to reach the AdGuard Home API @frenck (#716)
🌎 Translations
- Fix translations for network ports @flaparoo (#707)
- Add Hebrew translations for AdGuard configuration @tzagim (#703)
⬆️ Dependency updates
- ⬆️ Update alpine_3_24/nginx to v1.30.4-r0 @renovate[bot] (#702)
- ⬆️ Update alpine_3_24/nginx to v1.30.4-r1 @renovate[bot] (#708)
- ⬆️ Update AdguardTeam/AdGuardHome to v0.107.78 @renovate[bot] (#706)
- ⬆️ Update ghcr.io/hassio-addons/base Docker tag to v21.0.1 @renovate[bot] (#710)
- ⬆️ Update ghcr.io/hassio-addons/base Docker tag to v21.0.2 @renovate[bot] (#711)
- ⬆️ Update AdguardTeam/AdGuardHome to v0.107.79 @renovate[bot] (#713)
- ⬆️ Update hassio-addons/workflows action to v3.0.1 @renovate[bot] (#712)
- v6.2.02026-06-11 · 2026-06-11 20:21 UTC
查看更新说明
What’s changed
🐛 Bug fixes
- 🐛 Pass --verbose to AdGuard Home in debug mode @frenck (#694)
- 🐛 Fix AdGuard Home config schema version detection @frenck (#695)
🧰 Maintenance
- ⬆️ Update to base image 21.0.0 (Alpine 3.24) @frenck (#690)
- 🔧 Workflow cleanup, release drafter restore, and bashio v0.18 compat @frenck (#691)
- 🔧 Remove non-functional NGINX OCSP stapling @frenck (#696)
📚 Documentation
- 📝 Fix AdGuard Home documentation issues @frenck (#693)
- 🌐 Add English configuration translations @frenck (#697)
- 🌐 Add Dutch configuration translations @frenck (#698)
⬆️ Dependency updates
- ⬆️ Update ghcr.io/hassio-addons/base Docker tag to v20.1.0 @renovate[bot] (#682)
- ⬆️ Update ghcr.io/hassio-addons/base Docker tag to v20.1.1 @renovate[bot] (#683)
- ⬆️ Update alpine_3_23/nginx to v1.28.3-r1 @renovate[bot] (#684)
- ⬆️ Update alpine_3_23/yq-go to v4.49.2-r6 @renovate[bot] (#686)
- ⬆️ Update alpine_3_23/nginx to v1.28.3-r2 @renovate[bot] (#687)
- ⬆️ Update AdguardTeam/AdGuardHome to v0.107.77 @renovate[bot] (#685)
- ⬆️ Update to base image 21.0.0 (Alpine 3.24) @frenck (#690)
用户点评
登录用户的真实使用记录，可按版本和硬件筛选共 0 条
还没有人点评。第一个说出真实体验的人最有价值。
Home Assistant Community App: AdGuard Home
Network-wide ads & trackers blocking DNS server.
About
AdGuard Home is a network-wide ad-and-tracker blocking DNS server with parental control (adult content blocking) capabilities. Its purpose is to let you control your entire network and all your devices, and it does not require using a client-side program.
AdGuard Home provides a beautiful, easy and feature-rich web interface to easily manage the filtering process and its settings.
:books: Read the full app documentation
Support
Got questions?
You have several options to get them answered:
- The Home Assistant Community Apps Discord chat server for app support and feature requests.
- The Home Assistant Discord chat server for general Home Assistant discussions and questions.
- The Home Assistant Community Forum.
- Join the Reddit subreddit in /r/homeassistant
You could also open an issue here GitHub.
Contributing
This is an active open-source project. We are always open to people who want to use the code or contribute to it.
We have set up a separate document containing our contribution guidelines.
Thank you for being involved! :heart_eyes:
Authors & contributors
The original setup of this repository is by Franck Nijhof.
For a full list of all authors and contributors, check the contributor's page.
We have got some Home Assistant apps for you
Want some more functionality to your Home Assistant instance?
We have created multiple apps for Home Assistant. For a full list, check out our GitHub Repository.
License
MIT License
Copyright (c) 2019-2026 Franck Nijhof
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
uBlock
gorhill·JavaScript
一款高效轻量的浏览器广告与追踪拦截扩展，支持 Chromium 和 Firefox，占用资源少、过滤速度快，能显著减少网页广告和隐私追踪。
广告拦截+4DNS / 广告拦截入门
69247+1144.4k1.76.02026-11-10 18:07 UTC
pi-hole
pi-hole·Shell
把树莓派变成全网 DNS 级广告拦截器，在域名解析阶段直接屏蔽广告和追踪域名，无需给每台设备装插件。
广告拦截+4DNS / 广告拦截进阶
61799+983.4kv6.52026-11-07 10:54 UTC
cleanyourtv
Gathin23·Python
通过 Wi-Fi 远程精简 Android TV 和 Google TV 的预装软件，并换成类似 Apple TV 的简洁主界面，顺带拦截广告、保护隐私。
电视去预装+4DNS / 广告拦截进阶
56104+26407.2kv3.4.02026-11-10 16:10 UTC
AdGuardHome
AdguardTeam·TypeScript
自建全网广告与追踪器拦截 DNS 服务，在路由器或服务器上部署后，所有设备无需装插件即可过滤广告和隐私追踪。
DNS 服务器+4DNS / 广告拦截进阶
38332+1102.6kv0.107.802026-11-10 16:03 UTC