AdGuardHome
v0.107.54
Sumber gratis dan terbuka, iklan & pelacak di seluruh jaringan yang kuat yang memblokir server DNS.
Adguard.com | Wiki | Reddit | Twitter | Telegram
Adguard Home adalah perangkat lunak di seluruh jaringan untuk memblokir iklan dan pelacakan. Setelah Anda mengaturnya, itu akan mencakup semua perangkat rumah Anda, dan Anda tidak memerlukan perangkat lunak sisi klien untuk itu.
Ini beroperasi sebagai server DNS yang merutekan kembali domain pelacakan ke "lubang hitam", sehingga mencegah perangkat Anda menghubungkan ke server tersebut. Ini berdasarkan perangkat lunak yang kami gunakan untuk server DNS Adguard publik kami, dan keduanya berbagi banyak kode.
Memulai
Instalasi Otomatis (Linux/UNIX/MacOS/FREEBSD/OpenBSD)
Metode alternatif
Pemandu
API
Membandingkan rumah Adguard dengan solusi lain
Apa bedanya dengan server DNS Adguard publik?
Bagaimana Adguard Home Dibandingkan dengan Pi-Hole
Bagaimana Adguard Home Dibandingkan dengan Blocker Iklan Tradisional
Keterbatasan yang diketahui
Bagaimana membangun dari sumber
Prasyarat
Bangunan
Berkontribusi
Uji versi yang tidak stabil
Masalah pelaporan
Membantu terjemahan
Lainnya
Proyek yang menggunakan Adguard Home
Ucapan Terima Kasih
Pribadi
Untuk menginstal dengan curl jalankan perintah berikut:
curl -s -s -l https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --v
Untuk menginstal dengan wget menjalankan perintah berikut:
wget ---no -verbose -o -https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --v
Untuk menginstal dengan fetch run command berikut:
fetch -o - https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --v
Script juga menerima beberapa opsi:
-c <channel> Untuk menggunakan saluran yang ditentukan;
-r untuk menginstal ulang Adguard Home;
-u untuk menghapus instalasi Adguard Home;
-v untuk output verbose.
Perhatikan bahwa opsi -r dan -u saling eksklusif.
Harap baca artikel memulai di wiki kami untuk mempelajari cara menginstal Adguard Home secara manual, dan cara mengkonfigurasi perangkat Anda untuk menggunakannya.
Anda dapat menggunakan gambar Docker resmi kami di Docker Hub.
Jika Anda menjalankan Linux, ada cara yang aman dan mudah untuk menginstal Adguard Home: dapatkan dari Snap Store.
Lihat wiki kami.
Jika Anda ingin berintegrasi dengan Adguard Home, Anda dapat menggunakan REST API kami. Atau, Anda dapat menggunakan klien Python ini, yang digunakan untuk membangun add-on home hass.io adguard.
Menjalankan Adguard Home Server Anda sendiri memungkinkan Anda melakukan lebih banyak daripada menggunakan server DNS publik. Ini adalah level yang sama sekali berbeda. Lihat sendiri:
Pilih apa sebenarnya yang diblokir dan diizinkan oleh server.
Pantau aktivitas jaringan Anda.
Tambahkan aturan penyaringan khusus Anda sendiri.
Yang terpenting, itu server Anda sendiri, dan Anda adalah satu -satunya yang memegang kendali.
Pada titik ini, Adguard Home memiliki banyak kesamaan dengan pi-hole. Baik iklan blok dan pelacak menggunakan metode yang disebut "DNS Sinkholing" dan keduanya memungkinkan menyesuaikan apa yang diblokir.
Catatan
Kami tidak akan berhenti di sini. DNS sinkholing bukan titik awal yang buruk, tapi ini baru permulaan.
Adguard Home menyediakan banyak fitur di luar kotak tanpa perlu menginstal dan mengkonfigurasi perangkat lunak tambahan. Kami ingin menjadi mudah sampai saat bahkan pengguna biasa dapat mengaturnya dengan upaya minimal.
Catatan
Beberapa fitur yang terdaftar dapat ditambahkan ke pi-hole dengan memasang perangkat lunak tambahan atau dengan menggunakan terminal SSH secara manual dan mengkonfigurasi ulang salah satu utilitas yang terdiri dari Pi-hole. Namun, menurut kami, ini tidak dapat secara sah dihitung sebagai fitur pi-hole.
| Fitur | Adguard Home | Pi-hole |
|---|---|---|
| Memblokir iklan dan pelacak | ✅ | ✅ |
| Menyesuaikan daftar blok | ✅ | ✅ |
| Server DHCP bawaan | ✅ | ✅ |
| Https untuk antarmuka admin | ✅ | Agak, tetapi Anda harus mengonfigurasi lighttpd secara manual |
| DNS terenkripsi server hulu (DNS-over-https, dns-over-tls, dnscrypt) | ✅ | (membutuhkan perangkat lunak tambahan) |
| Cross-Platform | ✅ | (Tidak secara asli, hanya melalui Docker) |
| Berjalan sebagai server DNS-over-HTTPS atau DNS-over-TLS | ✅ | (membutuhkan perangkat lunak tambahan) |
| Memblokir phishing dan domain malware | ✅ | (membutuhkan blocklist non-default) |
| Kontrol orang tua (memblokir domain dewasa) | ✅ | (membutuhkan blocklist non-default) |
| Paksa pencarian yang aman di mesin pencari | ✅ | |
| Konfigurasi per-klien (perangkat) | ✅ | ✅ |
| Pengaturan akses (pilih siapa yang bisa menggunakan AGH DNS) | ✅ | |
| Berjalan tanpa hak istimewa | ✅ |
Itu tergantung.
DNS sinkholing mampu memblokir persentase iklan yang besar, tetapi tidak memiliki fleksibilitas dan kekuatan pemblokir iklan tradisional. Anda bisa mendapatkan kesan yang baik tentang perbedaan antara metode ini dengan membaca artikel ini, yang membandingkan AdGuard untuk Android (blocker iklan tradisional) dengan pemblokir iklan tingkat host (yang hampir identik dengan blocker berbasis DNS dalam kemampuan mereka). Tingkat perlindungan ini cukup untuk beberapa pengguna.
Selain itu, menggunakan blocker berbasis DNS dapat membantu memblokir iklan, pelacakan dan permintaan analitik pada jenis perangkat lain, seperti SmartTV, speaker pintar atau jenis perangkat IoT lainnya (di mana Anda tidak dapat menginstal blocker iklan tradisional).
Berikut adalah beberapa contoh dari apa yang tidak dapat diblokir oleh blocker tingkat DNS:
YouTube, iklan Twitch;
Facebook, Twitter, posting yang disponsori Instagram.
Pada dasarnya, iklan apa pun yang berbagi domain dengan konten tidak dapat diblokir oleh blocker tingkat DNS.
Apakah ada kesempatan untuk menangani ini di masa depan? DNS tidak akan pernah cukup untuk melakukan ini. Satu -satunya pilihan kami adalah menggunakan proxy pemblokiran konten seperti apa yang kami lakukan di aplikasi Adguard yang mandiri. Kami akan membawa dukungan fitur ini ke Adguard Home di masa depan. Sayangnya, bahkan dalam kasus ini, masih ada kasus ketika ini tidak akan cukup atau akan membutuhkan konfigurasi yang cukup rumit.
Jalankan make init untuk mempersiapkan lingkungan pengembangan.
Anda akan membutuhkan ini untuk membangun rumah Adguard:
Pergi v1.23 atau lebih baru;
Node.js v18.18 atau lebih baru;
NPM V8 atau lebih baru;
Buka terminal Anda dan jalankan perintah ini:
git clone https://github.com/adguardteam/adguardhomecd adguardhome membuat
Peringatan
Bendera non -standar -j saat ini tidak didukung, jadi membangun dengan make -j 4 atau mengatur MAKEFLAGS Anda untuk memasukkan, misalnya, -j 4 cenderung memecahkan build. Jika Anda memiliki MAKEFLAGS yang diatur ke sana, dan Anda tidak ingin mengubahnya, Anda dapat menimpanya dengan menjalankan make -j 1 .
Periksa Makefile untuk mempelajari tentang perintah lain.
Anda dapat membangun rumah Adguard untuk setiap OS/lengkungan yang didukung. Untuk melakukan ini, tentukan variabel lingkungan GOOS dan GOARCH sebagai makro saat menjalankan make .
Misalnya:
env goos = 'linux' goarch = 'arm64' make
atau:
buat goos = 'linux' goarch = 'arm64'
Anda akan membutuhkan snapcraft untuk menyiapkan pembangunan rilis. Setelah diinstal, jalankan perintah berikut:
buat saluran pembuatan-rilis = '...' versi = '...'
Lihat dokumentasi target build-release .
Jalankan make build-docker untuk membangun gambar Docker secara lokal (yang kami terbitkan ke Dockerhub). Harap dicatat, bahwa kami menggunakan Docker BuildX untuk membangun gambar resmi kami.
Anda mungkin perlu mempersiapkan sebelum menggunakan bangunan ini:
(Hanya Linux) Instal Qemu:
Docker Run --RM-Priviled Multiarch/QEMU-USER-STATIC ---RESET -P Ya-Kredensial Ya
Siapkan pembangun:
Docker Buildx Create --Name BuildX-Builder --Driver Docker-Container --Use
Lihat dokumentasi target build-docker .
Ketika Anda perlu men -debug frontend tanpa mengkompilasi ulang versi produksi setiap kali, misalnya untuk memeriksa bagaimana label Anda akan terlihat pada formulir, Anda dapat menjalankan frontend membangun lingkungan pengembangan.
Di terminal terpisah, jalankan:
(cd ./client/ & quv node_env = 'pengembangan' npm run watch)
Jalankan Biner AdGuardHome Anda dengan bendera --local-frontend , yang menginstruksikan Adguard Home untuk mengabaikan file frontend bawaan dan menggunakannya dari direktori ./build/ .
Sekarang setiap perubahan yang Anda lakukan di direktori ./client/ harus dikompilasi ulang dan tersedia di Web UI. Pastikan Anda menonaktifkan cache browser untuk memastikan bahwa Anda benar -benar mendapatkan versi yang dikompilasi ulang.
Anda dipersilakan untuk membayar repositori ini, membuat perubahan Anda dan mengirimkan permintaan tarik. Pastikan Anda mengikuti pedoman kode kami.
Harap dicatat bahwa kami tidak mengharapkan orang untuk berkontribusi pada UI dan bagian backend dari program secara bersamaan. Idealnya, bagian backend diimplementasikan terlebih dahulu, IE Configuration, API, dan fungsionalitasnya sendiri. Bagian UI dapat diimplementasikan nanti dalam permintaan tarik yang berbeda oleh orang yang berbeda.
Ada dua saluran pembaruan yang dapat Anda gunakan:
beta : versi beta dari Adguard Home. Versi yang kurang lebih stabil, biasanya dirilis setiap dua minggu atau lebih sering.
edge : Versi terbaru Adguard Home dari Cabang Pengembangan. Pembaruan baru didorong ke saluran ini setiap hari.
Ada tiga opsi bagaimana Anda dapat menginstal versi yang tidak stabil:
Snap Store: Cari beta dan edge Channels.
Hub Docker: Cari tag beta dan edge .
Bangunan mandiri. Gunakan skrip instalasi otomatis atau cari build yang tersedia di wiki.
Skrip untuk menginstal versi beta:
curl -s -s -l https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --c beta
Skrip untuk menginstal versi tepi:
curl -s -s -l https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --c edge
Jika Anda mengalami masalah apa pun atau memiliki saran, buka halaman ini dan klik tombol "Masalah Baru". Harap ikuti instruksi dalam formulir edisi dengan hati -hati dan jangan lupa untuk memulai dengan mencari duplikat.
Jika Anda ingin membantu dengan terjemahan rumah Adguard, silakan pelajari lebih lanjut tentang menerjemahkan produk Adguard di basis pengetahuan kami. Anda dapat berkontribusi pada Proyek AdguardHome di Crowdin.
Cara lain yang dapat Anda kontribusikan adalah dengan mencari masalah yang ditandai sebagai help wanted , menanyakan apakah masalahnya diperebutkan, dan mengirim PR yang memperbaiki bug atau mengimplementasikan fitur tersebut.
Harap dicatat bahwa proyek-proyek ini tidak berafiliasi dengan Adguard, tetapi dibuat oleh pengembang dan penggemar pihak ketiga.
Adguard Home Remote: Aplikasi iOS oleh Joost.
Perpustakaan Python oleh @Frenck.
Home Assistant Add-on oleh @Frenck.
Aplikasi OpenWrt Luci oleh @kongfl888 (awalnya oleh @rufengsuixing).
Sinkronisasi AdguardHome oleh @bakito.
Pemantauan lalu lintas dan statistik waktu nyata berbasis terminal untuk instance rumah adguard Anda oleh @lissy93
Adguard Home On Glinet Router oleh GL-Inet.
Aplikasi Cloudron oleh @Gramakri.
AsUSWRT-MERLIN-ADGUARDHOME-INSTALLER OLEH @jumpsmm7 alias @somewhereovererainbow.
Pustaka node.js oleh @andrea055.
Ekstensi browser oleh @satheshshiva.
Template Zabbix untuk Adguard Home oleh @DiasDMhub.
Paket cokelat oleh NIKS255.
Perangkat lunak ini tidak akan mungkin tanpa:
Pergi dan Perpustakaannya:
GCACHE
DNS Miekg
Go-yaml
melayani
dnsproxy
Urlfilter
Node.js dan perpustakaannya:
React.js
Tabler
Dan banyak lagi paket Node.js.
whotracks.me data
Anda mungkin pernah melihat bahwa Coredns disebutkan di sini sebelumnya, tetapi kami telah berhenti menggunakannya di Adguard Home.
Untuk daftar lengkap semua paket node.js yang digunakan, silakan lihat file client/package.json .
Gagasan utama kami adalah bahwa Anda adalah orang yang harus mengendalikan data Anda. Jadi wajar saja, bahwa Adguard Home tidak mengumpulkan statistik penggunaan apa pun, dan tidak menggunakan layanan web apa pun kecuali Anda mengkonfigurasinya untuk melakukannya. Lihat juga Kebijakan Privasi Lengkap dengan setiap bit yang secara teori dapat dikirim oleh Adguard Home tersedia.
