AdGuardHome

您和您的設備的隱私保護中心

免費和開源，強大的網絡範圍內廣告和跟踪器阻止DNS服務器。

adguard.com | Wiki | reddit | Twitter | 電報

---

Adguard Home是一個用於阻止廣告和跟踪的網絡範圍的軟件。設置後，它將覆蓋所有家用設備，並且您不需要任何客戶端軟件。

它是DNS服務器的運行，該服務器將跟踪域重新路由重新路由到“黑洞”，從而阻止您的設備連接到這些服務器。它基於我們用於公共ADGUARD DNS服務器的軟件，並且都共享許多代碼。

• 入門

• 自動安裝（linux/unix/macos/freebsd/openBSD）

• 替代方法

• 嚮導

• API

• 將Adguard家與其他解決方案進行比較

• 這與公共adguard DNS服務器有何不同？

• Adguard Home與Pi-Hole相比如何

• Adguard Home與傳統的廣告阻滯劑相比如何

• 已知限制

• 如何從來源構建

• 先決條件

• 建築

• 貢獻

• 測試不穩定版本

• 報告問題

• 幫助翻譯

• 其他

• 使用adguard家的項目

• 致謝

• 隱私

入門

自動安裝（linux/unix/macos/freebsd/openBSD）

To install with curl run the following command:

 curl -s -s -l https：//raw.githubusercontent.com/adguardteam/adguardhome/master/master/scripts/install.sh | sh -s- -v

To install with wget run the following command:

 wget -no -verbose -o -o -https：//raw.githubusercontent.com/adguardteam/adguardhome/master/master/scripts/install.sh | sh -s- -v

To install with fetch run the following command:

 fetch -o -https：//raw.githubusercontent.com/adguardteam/adguardhome/master/master/scripts/install.sh | sh -s- -v

該腳本還接受了一些選項：

• -c <channel> to use specified channel;

• -r to reinstall AdGuard Home;

• -u to uninstall AdGuard Home;

• -v for verbose output.

Note that options -r and -u are mutually exclusive.

替代方法

手動安裝

Please read the Getting Started article on our Wiki to learn how to install AdGuard Home manually, and how to configure your devices to use it.

Docker

您可以在Docker Hub上使用我們的官方Docker圖像。

快照商店

If you're running Linux, there's a secure and easy way to install AdGuard Home: get it from the Snap Store.

嚮導

看到我們的Wiki。

API

如果您想與Adguard Home集成，則可以使用我們的REST API。另外，您可以使用此Python客戶端，該客戶端用於構建Adguard Home Hass.io附加組件。

將Adguard家與其他解決方案進行比較

這與公共adguard DNS服務器有何不同？

運行自己的Adguard Home Server可以讓您做更多的事情，而不是使用公共DNS服務器。這是一個完全不同的級別。為自己看：

• 選擇服務器塊和許可證確切的內容。

• 監視您的網絡活動。

• 添加您自己的自定義過濾規則。

• 最重要的是，它是您自己的服務器，而您是唯一控制的服務器。

Adguard Home與Pi-Hole相比如何

在這一點上，Adguard Home與Pi-Hole有很多共同點。都使用所謂的“ DNS sndholing”方法阻止廣告和跟踪器，並允許自定義阻止的內容。

筆記

我們不會停在這裡。 DNS沉沒並不是一個不好的起點，但這只是開始。

Adguard Home提供了許多開箱即用的功能，無需安裝和配置其他軟件。我們希望它很簡單，即使休閒用戶也能以最小的努力進行設置。

筆記

可以通過安裝其他軟件或手動使用SSH終端並重新配置其中一個實用程序PI-HOLE組成的某些列出的功能。但是，我們認為，這不能合理地算作Pi-Hole的功能。

特徵	Adguard家	pi-hole
阻止廣告和跟踪器	✅	✅
自定義區塊列表	✅	✅
內置DHCP服務器	✅	✅
https的管理接口	✅	有點，但是您需要手動配置LightTPD
加密的DNS上游服務器（DNS-Over-HTTPS，DNS-Over-TLS，DNScrypt）	✅	（需要其他軟件）
跨平台	✅	（不是本地，僅通過碼頭）
作為DNS-Over-HTTPS或DNS-Over-TLS服務器運行	✅	（需要其他軟件）
阻止網絡釣魚和惡意軟件域	✅	（需要非默認地位列表）
父母控制（阻止成人領域）	✅	（需要非默認地位列表）
強制安全搜索在搜索引擎上	✅
每個客戶（設備）配置	✅	✅
訪問設置（選擇誰可以使用AGH DNS）	✅
無根特權運行	✅

Adguard Home與傳統的廣告阻滯劑相比如何

這取決於。

DNS sindholing能夠阻止大量廣告，但缺乏傳統廣告阻滯劑的靈活性和力量。您可以通過閱讀本文對這些方法之間的區別有很好的印象，該文章將Android（傳統的AD阻止器）的Adguard與主機級廣告阻滯劑（幾乎與基於DNS的功能中的阻滯劑相同）。對於某些用戶來說，這種保護水平就足夠了。

此外，使用基於DNS的阻滯劑可以幫助阻止廣告，跟踪和分析請求，例如SMARTTV，智能揚聲器或其他類型的IoT設備（您無法安裝傳統的廣告阻滯劑）。

已知限制

以下是DNS級阻滯劑無法阻止的一些示例：

• YouTube，抽搐廣告；

• Facebook，Twitter，Instagram贊助帖子。

從本質上講，任何與內容共享域的廣告都不能被DNS級阻滯劑阻止。

將來是否有機會處理此問題？ DNS永遠不足以做到這一點。我們唯一的選擇是使用像我們在獨立的Adguard應用程序中所做的那樣使用內容阻止代理。將來，我們將將此功能支持帶給Adguard回家。不幸的是，即使在這種情況下，仍然會有這種情況是不夠的，或者需要相當複雜的配置。

如何從來源構建

先決條件

Run make init to prepare the development environment.

您將需要此建造Adguard Home：

• GO V1.23或更高版本；

• node.js v18.18或更高版本；

• NPM V8或更高版本；

建築

打開您的終端並執行以下命令：

 git克隆https://github.com/adguardteam/adguardhomecd adguardhome
製作

警告

The non-standard -j flag is currently not supported, so building with make -j 4 or setting your MAKEFLAGS to include, for example, -j 4 is likely to break the build. If you do have your MAKEFLAGS set to that, and you don't want to change it, you can override it by running make -j 1 .

Check the Makefile to learn about other commands.

為不同平台建造

您可以為任何支持的操作系統/拱門建造Adguard Home。 In order to do this, specify GOOS and GOARCH environment variables as macros when running make .

例如：

 env goos ='linux'goarch ='arm64'製造

或者：

製作鵝='linux'goarch ='arm64'

準備版本

You'll need snapcraft to prepare a release build.安裝後，運行以下命令：

使構建釋放頻道='...'版本='...'

See the build-release target documentation.

Docker圖像

Run make build-docker to build the Docker image locally (the one that we publish to DockerHub).請注意，我們正在使用Docker Buildx來構建我們的官方形象。

您可能需要在使用這些構建之前準備：

• （僅Linux）安裝QEMU：

   docker run -rm-私有的多門/qemu-user static -reset -p yes-credential是

• 準備建造者：

   docker buildx create -name buildx-builder -driver docker-container -use

See the build-docker target documentation.

調試前端

當您需要每次重新編譯生產版本的情況下調試前端，例如檢查標籤在表單上的外觀時，您可以運行前端構建開發環境。

1. 在單獨的終端中，運行：

    （cd./client/ && envondod_env ='開發'npm運行手錶）

2. Run your AdGuardHome binary with the --local-frontend flag, which instructs AdGuard Home to ignore the built-in frontend files and use those from the ./build/ directory.

3. Now any changes you make in the ./client/ directory should be recompiled and become available on the web UI.確保您禁用瀏覽器緩存，以確保實際獲取重新編譯的版本。

貢獻

歡迎您來叉這個存儲庫，進行更改並提交拉動請求。不過，請確保您遵循我們的代碼指南。

請注意，我們不希望人們同時為UI和後端部分做出貢獻。理想情況下，後端部分首先實現，即配置，API和功能本身。 UI零件可以在稍後由其他人的其他拉力請求實施。

測試不穩定版本

您可以使用兩個更新渠道：

• beta : beta versions of AdGuard Home.或多或少穩定的版本，通常每兩週或更頻繁地發布一次。

• edge : the newest version of AdGuard Home from the development branch.每天將新的更新推向此頻道。

有三個選項如何安裝不穩定版本：

1. Snap Store: look for the beta and edge channels.

2. Docker Hub: look for the beta and edge tags.

3. 獨立建造。使用自動安裝腳本或查找Wiki上的可用版本。

   安裝Beta版本的腳本：

    curl -s -s -l https：//raw.githubusercontent.com/adguardteam/adguardhome/master/master/scripts/install.sh | sh -s -c beta

   安裝邊緣版本的腳本：

    curl -s -s -l https：//raw.githubusercontent.com/adguardteam/adguardhome/master/master/scripts/install.sh | sh -s- -c edge

報告問題

如果您遇到任何問題或有建議，請轉到此頁面，然後單擊“新問題”按鈕。請仔細遵循問題表中的說明，不要忘記從搜索重複項開始。

幫助翻譯

如果您想幫助Adguard家庭翻譯，請在我們的知識庫中了解有關翻譯Adguard產品的更多信息。您可以為Crowdin的Adguardhome項目做出貢獻。

其他

Another way you can contribute is by looking for issues marked as help wanted , asking if the issue is up for grabs, and sending a PR fixing the bug or implementing the feature.

使用adguard家的項目

請注意，這些項目不隸屬於Adguard，而是由第三方開發人員和粉絲製作的。

• Adguard Home Remote：Joost的iOS應用程序。

• @frenck的Python庫。

• @frenck的家庭助理加載。

• @kongfl888的OpenWrt Luci應用程序（最初是@rufengsuixing）。

• @bakito的adguardhome同步。

• @lissy93的基於終端的，實時流量監控和adguard Home實例的統計信息

• Adguard在Glinet路由器上的Adguard Home。

• @gramakri的Cloudron應用程序。

• Asuswrt-Merlin-Adguardhome-Installer @jumpsmm7 aka @SomeWhereOverTherainBow。

• @andrea055的node.js庫。

• @sathshshiva的瀏覽器擴展。

• @diasdmhub的Adguard Home的Zabbix模板。

• NIKS255的巧克力包裝。

致謝

沒有這個軟件是不可能的：

• Go及其圖書館：

• GCACHE

• Miekg的DNS

• go-yaml

• 服務

• DNSproxy

• urlfilter

• Node.js及其庫：

• React.js

• 表格

• 還有更多的node.js軟件包。

• whotracks.me數據

您可能已經看到這里以前在這裡提到過核心，但是我們已經在Adguard Home停止使用它。

For the full list of all Node.js packages in use, please take a look at client/package.json file.

隱私

我們的主要思想是您是一個應該控制數據的人。因此，Adguard Home不會收集任何用法統計信息，也不會使用任何Web服務，除非您將其配置為此，否則這是很自然的。 See also the full privacy policy with every bit that could in theory be sent by AdGuard Home is available.