AdGuardHome
v0.107.54
Бесплатный и открытый исходный код, мощная сеть реклама и трекеры, блокирующие DNS-сервер.
Adguard.com | Вики | Reddit | Twitter | Телеграмма
Adguard Home-это программное обеспечение для блокировки рекламы и отслеживания. После того, как вы настроили его, он будет охватывать все ваши домашние устройства, и вам не понадобится какое-либо программное обеспечение на стороне клиента.
Он работает как DNS-сервер, который перенаправляет домены отслеживания в «черной дыре», что предотвращает подключение ваших устройств к этим серверам. Он основан на программном обеспечении, которое мы используем для наших публичных серверов DNGUARD DNS, и оба делятся большим количеством кода.
Начиная
Автоматическая установка (Linux/Unix/macos/freebsd/openbsd)
Альтернативные методы
Гиды
API
Сравнение домов Adguard с другими решениями
Чем это отличается от публичных серверов DNGUARD DNS?
Как Adguard Home по сравнению с Pi-Hole
Как Adguard Home по сравнению с традиционными блокировщиками рекламы
Известные ограничения
Как построить из источника
Предварительные условия
Здание
Внося
Проверьте нестабильные версии
Проблемы отчетности
Помогите с переводами
Другой
Проекты, которые используют дом Adguard
Благодарности
Конфиденциальность
Чтобы установить с помощью curl Запустите следующую команду:
curl -s -s -l https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --v
Чтобы установить с wget запустить следующую команду:
wget -no -verbose -o -https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --v
Чтобы установить с помощью fetch Запустите следующую команду:
fetch -o - https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --v
Сценарий также принимает некоторые варианты:
-c <channel> для использования указанного канала;
-r чтобы переустановить adguard Home;
-u , чтобы удалить дом;
-v для многословного вывода.
Обратите внимание, что параметры -r и -u являются взаимоисключающими.
Пожалуйста, прочитайте статью «Начало работы» в нашей вики, чтобы узнать, как установить домашнюю adguard вручную и как настроить свои устройства для его использования.
Вы можете использовать наше официальное изображение Docker на Docker Hub.
Если вы используете Linux, есть надежный и простой способ установить Home Home: получить его из магазина Snap.
Смотрите нашу вики.
Если вы хотите интегрироваться с Adguard Home, вы можете использовать наш API REST. В качестве альтернативы, вы можете использовать этот клиент Python, который используется для построения дополнения Home Hass.io Hass.io.
Запуск собственного домашнего сервера Adguard позволяет вам сделать гораздо больше, чем использование общедоступного DNS -сервера. Это совершенно другой уровень. Смотрите сами:
Выберите, что именно сервер блокирует и разрешает.
Следите за своей сетевой деятельностью.
Добавьте свои собственные правила фильтрации.
Самое главное, это ваш собственный сервер, и вы единственный, кто находится в контроле.
На данный момент у Adguard Home много общего с Pi-Hole. И блокируют рекламу, и трекеры с использованием так называемого метода «DNS Counkholing», и оба позволяют настраивать то, что заблокировано.
Примечание
Мы не собираемся останавливаться здесь. DNS Coungholing - не плохая отправная точка, но это только начало.
Adguard Home предоставляет много функций вне коробки, и не нужно устанавливать и настраивать дополнительное программное обеспечение. Мы хотим, чтобы это было просто до такой степени, когда даже случайные пользователи могут настроить его с минимальными усилиями.
Примечание
Некоторые из перечисленных функций могут быть добавлены в PI-отверстия путем установки дополнительного программного обеспечения или вручную, используя SSH-терминал и перенастроив один из коммунальных Pi-Hole. Однако, по нашему мнению, это нельзя законно считать особенностью PI-Hole.
| Особенность | Дом | Пи |
|---|---|---|
| Блокировка рекламы и трекеров | ✅ | ✅ |
| Настройка блоков | ✅ | ✅ |
| Встроенный DHCP-сервер | ✅ | ✅ |
| Https для интерфейса администратора | ✅ | Вроде, но вам нужно вручную настроить LightTPD |
| Зашифрованные DNS-серверы (DNS-Over-HTTPS, DNS-Over-TLS, DNSCRYPT) | ✅ | (требует дополнительного программного обеспечения) |
| Кроссплатформенный | ✅ | (не изначально, только через Docker) |
| Запуск в качестве сервера DNS-over-HTTPS или DNS-Over-TLS | ✅ | (требует дополнительного программного обеспечения) |
| Блокирование фишинговых и вредных доменов | ✅ | (Требуется не деко-блок-списки) |
| Родительский контроль (блокировка взрослых доменов) | ✅ | (Требуется не деко-блок-списки) |
| Поиск по обеспечению безопасного поиска в поисковых системах | ✅ | |
| Конфигурация для каждого клиента (устройства) | ✅ | ✅ |
| Настройки доступа (выберите, кто может использовать AGH DNS) | ✅ | |
| Бег без корневых привилегий | ✅ |
Это зависит.
DNS Coungholing способен блокировать большой процент рекламы, но ему не хватает гибкости и силы традиционных блокаторов рекламы. Вы можете получить хорошее впечатление о разнице между этими методами, прочитав эту статью, которая сравнивает Adguard для Android (традиционный блокатор рекламы) с блокировщиками рекламы на уровне хостов (которые практически идентичны блокаторам на основе DNS в своих возможностях). Этого уровня защиты достаточно для некоторых пользователей.
Кроме того, использование блокатора на основе DNS может помочь блокировать рекламу, отслеживание и аналитические запросы на другие типы устройств, такие как SmartTV, интеллектуальные динамики или другие виды устройств IoT (на которых вы не можете установить традиционные блокировщики рекламы).
Вот несколько примеров того, что не может быть заблокировано блокатором уровня DNS:
YouTube, Twitch Ads;
Facebook, Twitter, Instagram, спонсируемые сообщениями.
По сути, любая реклама, которая разделяет домен с контентом, не может быть заблокирована блокатором уровня DNS.
Есть ли шанс справиться с этим в будущем? DNS никогда не будет достаточно, чтобы сделать это. Наш единственный вариант - использовать прокси, блокирующий контент, как то, что мы делаем в автономных приложениях Adguard. Мы собираемся принести эту функцию поддержку в Adguard Home в будущем. К сожалению, даже в этом случае все еще будут случаи, когда этого не будет достаточно или потребует довольно сложной конфигурации.
Запустить make init , чтобы подготовить среду разработки.
Вам понадобится это, чтобы построить дому adguard:
Go v1.23 или более поздней версии;
Node.js v18.18 или более поздней версии;
NPM V8 или более поздней версии;
Откройте свой терминал и выполните эти команды:
git clone https://github.com/adguardteam/adguardhomecd adguardhome делать
Предупреждение
Нестандартный флаг -j в настоящее время не поддерживается, поэтому строительство с помощью make -j 4 или установить ваши MAKEFLAGS , например, -j 4 , вероятно, сломает сборку. Если у вас есть свои MAKEFLAGS , и вы не хотите менять, вы можете переопределить его, выполнив make -j 1 .
Проверьте Makefile , чтобы узнать о других командах.
Вы можете построить Hadguard Home для любой ОС/арки, которая поддерживает поддержку. Чтобы сделать это, укажите переменные среды GOOS и GOARCH в качестве make при запуске.
Например:
env goos = 'linux' goarch = 'arm64'
или:
сделать Goos = 'linux' goarch = 'arm64'
Вам понадобится snapcraft , чтобы подготовить сборку релиза. После установки запустите следующую команду:
Сделать сборочный канал = '...' version = '...'
Смотрите целевую документацию build-release .
Запустите make build-docker , чтобы построить изображение Docker локально (которое мы публикуем в Dockerhub). Обратите внимание, что мы используем Docker Buildx для создания нашего официального изображения.
Вам может потребоваться подготовить перед использованием этих сборки:
(Только Linux) Установить QEMU:
Docker run-rm-Привилегированная многоирш/qemu-user-static-reset -p Да-
Подготовьте строитель:
Docker Buildx Create-Name Buildx-Builder-Driver Docker-Container-use
Смотрите целевую документацию build-docker .
Когда вам нужно отлаживать Frontend, не перепроизводив производственную версию каждый раз, например, чтобы проверить, как будут выглядеть ваши этикетки в форме, вы можете запустить среду разработки Frontend.
В отдельном терминале запустите:
(cd ./client/ && env node_env = 'development' npm run watch)
Запустите свой двоичный файл AdGuardHome с флагом --local-frontend флагом, который инструктирует Adguard Home игнорировать встроенные фронтальные файлы и использовать их из каталога ./build/ .
Теперь любые изменения, которые вы вносите в каталоге ./client/ должны быть перекомпилированы и становятся доступными в веб -интерфейсе. Убедитесь, что вы отключите кеш браузера, чтобы убедиться, что вы действительно получили перекомпилированную версию.
Вы можете разобраться в этом репозитории, внесите изменения и отправите запрос на тягу. Пожалуйста, убедитесь, что вы следуете нашим руководящим принципам кода.
Обратите внимание, что мы не ожидаем, что люди будут внести свой вклад в пользовательский интерфейс и бэкэнд -части программы одновременно. В идеале, бэкэнд -деталь реализована в первую очередь, т.е. конфигурация, API и сама функциональность. Часть пользовательского интерфейса может быть реализована позже в другом запросе на притяжение другого человека.
Есть два канала обновления, которые вы можете использовать:
beta : бета -версии Adguard Home. Более или менее стабильные версии, обычно выпускаемые каждые две недели или чаще.
edge : новейшая версия Adguard Home из филиала разработчиков. Новые обновления ежедневно выдвигаются на этот канал.
Есть три варианта, как вы можете установить нестабильную версию:
Магазин Snap: edge beta -каналы.
Docker Hub: Ищите beta и edge .
Автономные сборки. Используйте сценарий автоматического установки или ищите доступные сборки на вики.
Скрипт для установки бета -версии:
curl -s -s -l https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --c бета
Скрипт для установки версии края:
curl -s -s -l https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --c Edge
Если вы столкнетесь с какой -либо проблемой или имеете предложение, перейдите на эту страницу и нажмите кнопку «Новая проблема». Пожалуйста, следуйте инструкциям в форме выпуска аккуратно и не забудьте начать с поиска дубликатов.
Если вы хотите помочь с домашними переводами Adguard, пожалуйста, узнайте больше о переводе продуктов Adguard в нашей базе знаний. Вы можете внести свой вклад в проект Adguardhome на Краудин.
Еще один способ внести свой вклад - найти проблемы, помеченные как help wanted , спрашивая, не поддается ли проблема для захвата, и отправка пиара, исправляя ошибку или реализацию этой функции.
Обратите внимание, что эти проекты не связаны с Adguard, но сделаны сторонними разработчиками и поклонниками.
Adguard Home Remote: IOS -приложение от Joost.
Библиотека Python от @frenck.
Домашний помощник @frenck.
Приложение OpenWrt Luci от @kongfl888 (первоначально @rufengsuixing).
Adguardhome Sync от @bakito.
Терминал, мониторинг трафика в реальном времени и статистика для вашего экземпляра Home Home от @lissy93
Adguard Home на маршрутизаторах Glinet от GL-inet.
Приложение Cloudron от @gramakri.
Asuswrt-merlin-adguardhome-installer от @Jumpsmm7 aka @somewhereovertherainbow.
Библиотека node.js от @andrea055.
Расширение браузера от @satheshshiva.
Шаблон Zabbix для Adguard Home от @diasdmhub.
Шоколадная упаковка от NIKS255.
Это программное обеспечение было бы невозможно без:
Иди и его библиотеки:
gcache
Miekg's DNS
Go-yaml
услуга
Dnsproxy
Urlfilter
Node.js и его библиотеки:
React.js
Таблетка
И многие другие пакеты Node.js.
Whotracks.me Данные
Возможно, вы видели, что Coredns упоминался здесь раньше, но мы перестали использовать его в доме Adguard.
Для полного списка всех используемых пакетов Node.js, пожалуйста, посмотрите на файл client/package.json .
Наша основная идея заключается в том, что вы тот, кто должен контролировать ваши данные. Таким образом, это только естественно, что Adguard Home не собирает какую -либо статистику использования и не использует никаких веб -сервисов, если вы не настроите его на это. См. Также полная политика конфиденциальности с каждым битом, который теоретически может быть отправлен Adguard Home, доступна.
