Home Assistant Cloudflare Tunnel ile Port Açmadan Güvenli Uzaktan Erişim

Bu rehber, Home Assistant OS (HAOS) üzerine Cloudflare Tunnel (Cloudflared) eklentisinin kurulmasını ve modemde hiçbir port açmaya (Port Forwarding / NAT) gerek kalmadan, kendi alan adınız üzerinden otomatik ücretsiz SSL sertifikasıyla güvenli dış erişim sağlamayı anlatır.

🚀 Cloudflare Tunnel Avantajları

Sıfır Port Açma: Modemin 80, 443 veya 8123 portlarını internete açmanız gerekmez; saldırı yüzeyi sıfıra iner.
CGNAT Engeline Takılmaz: Türkiye'deki internet servis sağlayıcılarının uyguladığı dinamik IP veya CGNAT havuzu arkasında bile sorunsuz çalışır.
Otomatik SSL (HTTPS): Let's Encrypt yenileme dertleri olmadan Cloudflare üzerinden otomatik uçtan uca şifreleme sunar.

1. Özel Deponun Eklenmesi ve Kurulum

Home Assistant sol menüsünden Ayarlar → Eklentiler → Eklenti Mağazası (Add-on Store) yolunu izleyin.
Sağ üst köşedeki üç noktaya (⋮) tıklayıp Depolar (Repositories) seçeneğini seçin.
Açılan kutucuğa aşağıdaki topluluk deposu adresini ekleyin:
```
https://github.com/brenner-tobias/ha-addons
```
Sayfayı yenileyin. Listede beliren "Cloudflared" eklentisine tıklayın ve Kur (Install) deyin.
Kurulum bitince şu seçenekleri aktif hale getirin:
Başlangıçta çalıştır (Start on boot)
Bekçi köpeği (Watchdog)

2. Kritik Adım: Alan Adını (URL) Belirleme

Cloudflared eklentisi, hedef alan adını bilmeden çalışmayı reddeder ve yetkilendirme linki üretmez.

Cloudflared eklentisinde üst menüden Yapılandırma (Configuration) sekmesine geçin.
external_hostname (Dış Alan Adı) kutucuğuna, erişim için kullanacağınız alt alan adını yazın:
```
ha.ornekdomain.com
```
(veya kendi alan adınız: <SENIN_SUBDOMAININ.SENIN_DOMAININ.COM>)
Sağ alttaki Kaydet (Save) butonuna basın.

3. Eklentiyi Cloudflare Hesabına Bağlama (Kimlik Doğrulama)

Eklentinin Bilgi (Info) sekmesine dönün ve eklentiyi Başlat (Start) butonuna basarak çalıştırın.
Üst menüden Günlük (Log) sekmesine geçin ve sayfayı birkaç saniye sonra yenileyin.

Günlük kayıtları içinde şu mesajı bulun:

Please open the following URL and log in with your Cloudflare account:

Altında beliren uzun yetkilendirme bağlantısını kopyalayıp tarayıcınızda yeni bir sekmede (gerekirse Gizli Pencerede) açın.
Cloudflare hesabınıza giriş yapın, domain listenizden ilgili alan adınızı seçin ve sağ alttaki Authorize (Yetkilendir) butonuna basın.
Ekranda "Success" onayını gördüğünüzde tüneliniz tescillenmiştir.

4. Reverse Proxy ve Ağ İzni (Dönen Mavi Logo Hatasının Çözümü)

Tünel kurulduktan sonra Home Assistant güvenlik politikası gereği dışarıdan gelen vekil (reverse proxy) trafiğini varsayılan olarak reddedebilir ve ekranda sonsuz dönen Home Assistant logosu (Unable to connect) kalır.

Bunu çözmek için configuration.yaml dosyanıza şu bloğu eklemeniz veya Ağ ayarlarından izin vermeniz gerekir:

`configuration.yaml` İçerisine Eklenecek Kod:

http:
  use_x_forwarded_for: true
  trusted_proxies:
    - 172.30.33.0/24  # Cloudflared dahili Docker ağ bloğu

Yapılandırmayı ekledikten sonra Home Assistant Core'u yeniden başlatın (Ayarlar → Sistem → Yeniden Başlat).

5. Evdeki Diğer Cihazlara Erişim (Additional Hosts)

Cloudflare tüneliniz üzerinden ev ağınızdaki diğer cihazlara (modem, NAS, mini PC vb.) ayrı tünel açmadan güvenle bağlanabilirsiniz:

Eklentiler → Cloudflared → Yapılandırma sekmesine gidin.

Sayfanın altındaki additional_hosts bölümüne cihazı tanımlayın:

additional_hosts:
  - hostname: router.ornekdomain.com
    service: http://192.168.1.1
  - hostname: nas.ornekdomain.com
    service: http://192.168.1.50:8080

Kaydedip eklentiyi yeniden başlattığınızda, Cloudflare DNS kayıtları otomatik olarak açılır ve tarayıcınızdan doğrudan şifreli erişebilirsiniz.