Başlarken

Kurulum

Resmi sürümler

İşletim sisteminiz için ikili dosyayı içeren arşivi en son kararlı sürüm sayfası adresinden indirin. Desteklenen platformların tam listesinin yanı sıra beta ve edge (kararsız) sürümlere bağlantılar platformlar sayfamızda bulunabilir.

AdGuard Home'u bir hizmet olarak kurmak için arşivi çıkarın, AdGuardHome dizinine girin ve çalıştırın:

./AdGuardHome -s install

Notlar

• Fedora Linux ve türevlerini kullananlar: AdGuard Home'u `/usr/local/bin' dizinine kurun. Bunun yapılmaması SELinux ve izinlerle ilgili sorunlara neden olabilir. Bkz. [sorun 765] ve [sorun 3281].

• MacOS 10.15 Catalina** ve daha yeni sürüm kullanıcıları AdGuard Home çalışma dizinini /Applications dizininin içine yerleştirmelidir.

Docker ve Snap

We also provide an official AdGuard Home docker image and an official Snap Store package for experienced users.

Diğer

Diğer bazı resmi olmayan seçenekler şunlardır:

• Home Assistant add-on maintained by @frenck.

• OpenWrt LUCI uygulaması, @kongfl888 tarafından sürdürülmektedir.

• Arch Linux, Arch Linux ARM ve diğer Arch tabanlı işletim sistemleri, @graysky2 tarafından sürdürülen AUR'daki adguardhome paketi aracılığıyla oluşturulabilir.

• Cloudron uygulaması, @gramakri tarafından sürdürülmektedir.

İlk başlangıç

Öncelikle güvenlik duvarı ayarlarınızı kontrol edin. AdGuard Home'u kurmak ve kullanmak için aşağıdaki bağlantı noktalarının ve protokollerin kullanılabilir olması gerekir:

• İlk kurulum için 3000/TCP;
• Web arayüzü için 80/TCP;
• DNS sunucusu için 53/UDP.

DNS-over-HTTPS gibi düz DNS dışındaki protokoller için ek bağlantı noktaları açmanız gerekebilir.

DNS sunucuları, çoğu zaman süper kullanıcı ayrıcalıkları gerektiren 53 numaralı bağlantı noktasına bağlanır, aşağıya bakın. Bu nedenle, Unix sistemlerinde, terminalde sudo veya doas ile çalıştırmanız gerekecektir:

sudo ./AdGuardHome

Windows'ta yönetici ayrıcalıklarıyla cmd.exe veya PowerShell'i çalıştırın ve buradan AdGuardHome.exe dosyasını çalıştırın.

AdGuard Home'u ilk kez çalıştırdığınızda, 0.0.0.0:3000 adresini dinlemeye başlar ve tarayıcınızda açmanızı ister:

AdGuard Home aşağıdaki adreslerde mevcuttur:
http://127.0.0.1:3000 adresine gidin
http://[::1]:3000 adresine gidin
[…]

Orada ilk yapılandırma sihirbazından geçeceksiniz.

Size en uygun başlangıç yapılandırmasını nasıl seçeceğiniz konusunda rehberlik için AdGuard Home'u güvenli bir şekilde çalıştırma makalemize bakın.

Hizmet olarak çalıştırma

Bir sonraki adım AdGuard Home'u bir sistem hizmeti (diğer adıyla daemon) olarak kaydetmek olacaktır. AdGuard Home'u bir hizmet olarak kurmak için şunu çalıştırın:

sudo ./AdGuardHome -s install

Windows'ta, yönetici ayrıcalıklarıyla cmd.exe dosyasını çalıştırın ve bir Windows hizmetini kaydetmek için AdGuardHome.exe -s install komutunu çalıştırın.

Hizmeti kontrol etmek için ihtiyaç duyabileceğiniz diğer komutlar şunlardır:

• AdGuardHome -s uninstall: AdGuard Home hizmetini kaldırın.
• AdGuardHome -s start: Hizmeti başlatın.
• AdGuardHome -s stop: Hizmeti durdurun.
• AdGuardHome -s restart: Hizmeti yeniden başlatın.
• AdGuardHome -s status: Geçerli hizmet durumunu gösterin.

Günlükler

Varsayılan olarak, AdGuard Home'u bir terminalde çalıştırdığınızda günlükler stderr adresine yazılır. Bir hizmet olarak çalıştırırsanız, günlük çıktısı platforma göre değişir:

• MacOS'ta günlük /var/log/AdGuardHome.*.log dosyalarına yazılır.

• Diğer Unix'lerde günlük syslog veya journald dosyasına yazılır.

• Windows'ta günlük, Windows olay günlüğüne yazılır.

Bu davranışı AdGuard Home yapılandırma dosyası içinde değiştirebilirsiniz.

Güncelleme

Yeni bir sürüm yayınlandığında, AdGuard Home'un kullanıcı arayüzünde bir bildirim mesajı ve Şimdi güncelle düğmesi gösterilir. Bu düğmeye tıkladığınızda AdGuard Home otomatik olarak en son sürüme güncellenecektir. Mevcut AdGuard Home çalıştırılabilir dosyanız, mevcut yapılandırma dosyasıyla birlikte backup dizininin içine kaydedilir, böylece gerekirse değişiklikleri geri alabilirsiniz.

Elle güncelleme

Düğmenin gösterilmemesi veya otomatik güncellemenin başarısız olması durumunda, elle güncelleyebilirsiniz. Elle güncellemeler hakkında ayrıntılı bir kılavuzumuz var, ancak kısaca:

1. Yeni AdGuard Home paketini indirin.

2. Geçici bir dizine çıkarın.

3. Eski AdGuard Home yürütülebilir dosyasını yenisiyle değiştirin.

4. AdGuard Home'u yeniden başlatın.

Docker, Home Assistant, and Snapcraft updates

Auto-updates for Docker, Hass.io/Home Assistant, and Snapcraft installations are disabled. Bunun yerine resmi güncelleyin.

Komut satırı güncellemesi

AdGuard Home paketini Web API'sini kullanmaya gerek kalmadan güncellemek için çalıştırın:

./AdGuardHome --update

Cihazları yapılandırma

Yönlendirici

Bu kurulum, ev yönlendiricinize bağlı tüm cihazları otomatik olarak kapsar ve her birini elle yapılandırmanız gerekmez.

1. Yönlendiricinizin tercihlerini açın. Genellikle, tarayıcınızdan http://192.168.0.1/ veya http://192.168.1.1/ gibi bir URL aracılığıyla erişebilirsiniz. Bir parola girmeniz istenebilir. Hatırlamıyorsanız, genellikle yönlendiricinin üzerindeki bir düğmeye basarak şifreyi sıfırlayabilirsiniz, ancak bu prosedür seçilirse muhtemelen tüm yönlendirici yapılandırmasını kaybedeceğinizi unutmayın. Yönlendiricinizin kurulumu için bir uygulama gerekiyorsa, lütfen uygulamayı telefonunuza veya bilgisayarınıza yükleyin ve yönlendiricinin ayarlarına erişmek için kullanın.

2. DHCP/DNS ayarlarını bulun. Her biri bir ila üç basamaklı dört gruba bölünmüş iki veya üç sayı kümesine izin veren bir alanın yanındaki DNS harflerini arayın.

3. AdGuard Home sunucu adreslerinizi oraya girin.

4. Bazı yönlendirici türlerinde özel bir DNS sunucusu kurulamaz. Bu durumda, AdGuard Home'u bir DHCP sunucusu olarak ayarlamak yardımcı olabilir. Aksi takdirde, belirli yönlendirici modelinizdeki DNS sunucularını nasıl özelleştireceğinizi öğrenmek için yönlendiricinizin kılavuzuna başvurmalısınız.

Windows

1. Başlat menüsünden veya Windows aramasından Denetim Masası öğesini açın.

2. Ağ ve İnternet öğesine ve ardından Ağ ve Paylaşım Merkezi öğesine gidin.

3. Ekranın sol tarafında Bağdaştırıcı ayarlarını değiştir düğmesini bulun ve ona tıklayın.

4. Etkin bağlantınızı seçin, sağ tıklayın ve Özellikler öğesini seçin.

5. Listede İnternet Protokolü Sürüm 4 (TCP/IPv4) (veya IPv6 için İnternet Protokolü Sürüm 6 (TCP/IPv6)) öğesini bulun, seçin ve ardından tekrar Özellikler öğesine tıklayın.

6. Aşağıdaki DNS sunucu adreslerini kullan öğesini seçin ve AdGuard Home sunucu adreslerinizi girin.

macOS

1. Apple simgesine tıklayın ve Sistem Tercihleri öğesine gidin.

2. Ağ öğesine tıklayın.

3. Listedeki ilk bağlantıyı seçin ve Gelişmiş öğesine tıklayın.

4. DNS sekmesini seçin ve AdGuard Home sunucunuzun adreslerini girin.

Android

not

Android cihazlar için talimatlar işletim sistemi sürümüne ve üreticiye bağlı olarak farklılık gösterebilir.

1. Android menüsü ana ekranından Ayarlar öğesine dokunun.

2. Menüde Wi-Fi öğesine dokunun. Mevcut tüm ağların bulunduğu ekran görüntülenecektir (mobil bağlantı için özel DNS ayarlamak mümkün değildir).

3. Bağlı olduğunuz ağın üzerine uzun basın ve Ağı Değiştir öğesine dokunun.

4. Bazı cihazlarda, daha fazla ayar görmek için Gelişmiş kutusunu işaretlemeniz gerekebilir. Android DNS ayarlarınızı düzenlemek için IP ayarlarınızı DHCP yerine Statik olarak değiştirmeniz gerekecektir.

5. DNS 1 ve DNS 2 değerlerini AdGuard Home sunucusunun ip adresleri ile değiştirin.

iOS

1. Ana ekrandan Ayarlar öğesine dokunun*.

2. Sol menüden Wi-Fi öğesini seçin (mobil ağlar için DNS yapılandırması mümkün değildir).

3. O anda aktif olan ağın adına dokunun.

4. DNS alanına AdGuard Home sunucu adreslerinizi girin.

Süper kullanıcı olmadan çalıştırma

You can run AdGuard Home without superuser privileges, but you must either grant the binary a capability (on Linux) or instruct it to use a different port (all platforms).

Gerekli yetkilerin verilmesi (yalnızca Linux)

Bu yöntemin kullanılması setcap yardımcı programını gerektirir. Linux dağıtımınızın paket yöneticisini kullanarak kurmanız gerekebilir.

Linux'da çalışan AdGuard Home'un süper kullanıcı ayrıcalıkları olmadan 53 numaralı bağlantı noktasını dinlemesine ve DNS sunucularını belirli bir arayüze bağlamasına izin vermek için çalıştırın:

sudo setcap 'CAP_NET_BIND_SERVICE=+eip CAP_NET_RAW=+eip' ./AdGuardHome

Ardından ./AdGuardHome dosyasını ayrıcalıksız bir kullanıcı olarak çalıştırın.

DNS dinleme bağlantı noktasını değiştirme

AdGuard Home'u süper kullanıcı ayrıcalıkları gerektirmeyen bir bağlantı noktasını dinleyecek şekilde yapılandırmak için AdGuard Home'u durdurun, düzenleyicinizde AdGuardHome.yaml dosyasını açın ve bu satırları bulun:

dns:
    # …
    port: 53

Süper kullanıcı ayrıcalıkları gerektirmemek için bağlantı noktasını 1024'ün üzerinde herhangi bir değerle değiştirebilirsiniz.

Limitations

Bazı dosya sistemleri, istatistik sisteminin gerektirdiği mmap(2) sistem çağrısını desteklemez. Ayrıca bkz. [sorun 1188].

Bu sorunu şu şekilde çözebilirsiniz:

• ya da AdGuardHome ikili dosyasına --work-dir DIRECTORY argümanlarını sağlayarak. Bu seçenek AGH'ye tüm dosyaları için varsayılan ./data dizini yerine başka bir dizin kullanmasını söyler.

• veya mmap(2) destekleyen başka bir dosya sistemine (örneğin tmpfs) işaret eden sembolik bağlantılar oluşturarak:

  ln -s ${YOUR_AGH_PATH}/data/stats.db /tmp/stats.db
  ln -s ${YOUR_AGH_PATH}/data/sessions.db /tmp/sessions.db