İçeriğe geç
Localtonet Localtonet Panel

Localtonet'i bir NAS veya Home Assistant üzerinde çalıştırın

Kurulum şablonları AMD64 ve ARM64

Bu sayfa için yardım al
Bu sayfada 7 bölüm
  1. Şablonlar nedir
  2. Ne olmadıkları
  3. Başlamadan önce
  4. NAS'ı Docker Compose ile kurun
  5. ZIP'i çıkarın ve nas klasörünü NAS'a kopyalayın
  6. Token dosyasını oluşturun
  7. compose.yaml dosyasını olduğu gibi bırakın
  8. Projeyi başlatın
  9. Bir tünel oluşturun ve başlatın
  10. Compose şablonu ne yapar
  11. Home Assistant OS veya Supervised kurulumu
  12. Uygulama klasörünü kopyalayın
  13. Uygulama mağazasını yeniden yükleyin ve Localtonet'i kurun
  14. Token'ınızı girin ve uygulamayı başlatın
  15. Bir tünel oluşturun ve başlatın
  16. Hizmetlerinize ulaşın
  17. Günlükler ve güncellemeler
  18. İlgili sayfalar

Localtonet, Localtonet istemcisini Docker destekli bir NAS'ta ve Home Assistant üzerinde konteyner olarak çalıştıran dağıtım şablonları sunar. AuthToken'ınızı ekler, konteyneri başlatır ve ardından tünelleri panelden yönetirsiniz.

Şablonlar nedir #

İndirme, toplam beş dosyalı iki şablon içeren küçük bir ZIP arşividir:

ŞablonKullanım yeriDosyalarNeyi değiştirirsiniz
NAS / Docker Compose (nas klasörü)Synology Container Manager, QNAP Container Station, Docker çalıştıran diğer NAS'lar ve Home Assistant Container veya Core ana bilgisayarlarınas/compose.yaml ve nas/auth-token.exampleYalnızca token: auth-token.example dosyasını auth-token olarak kopyalayın ve DUMMY_AUTH_TOKEN yerine AuthToken'ınızı yazın. compose.yaml dosyasını olduğu gibi bırakın.
Home Assistant uygulaması (home-assistant klasörü)Home Assistant OS ve Home Assistant SupervisedYerel bir uygulamanın (eskiden eklenti olarak adlandırılırdı) tanımı olan home-assistant/localtonet/config.json ve home-assistant/repository.jsonDosyalarda hiçbir şey. Token'ı uygulamayı kurduktan sonra Home Assistant içinde girersiniz. Yerel kurulum repository.json dosyasını kullanmaz.

Beşinci dosya olan README.txt, bu sayfadaki adımların kısa bir metin sürümüdür.

Her iki şablon da Localtonet istemcisini, Docker sayfasında anlatıldığı gibi, istem sormadan bir konteynerde çalıştırır. AMD64 (Intel ve AMD işlemciler) ve ARM64 için hazırlanmışlardır. Başlamadan önce NAS'ınızın hangi işlemciye sahip olduğunu kontrol edin; 32 bit ARM'li bir NAS bunu çalıştıramaz.

Ne olmadıkları #

  • Synology SPK veya QNAP QPKG paketleri değildir. Synology Paket Merkezi'nde veya QNAP App Center'da hiçbir şey görünmez.
  • Home Assistant şablonu, resmi Home Assistant mağazasında yer alan bir uygulama değildir. Yerel uygulama olarak kurarsınız.
  • Konteyner imajını içermezler. Cihazınız, şablonların adını verdiği docker.io/localtonet/localtonet imajını çeker; bu, Docker sayfasındaki imajın Docker Hub'daki karşılığıdır.
  • Konteynere bir VPN arayüzünün gerektirdiği ayrıcalıkları vermezler. Şablonlar tüneller içindir; VPN özelliği bunların parçası değildir.

Başlamadan önce #

  • Docker ve Docker Compose destekleyen bir NAS veya Home Assistant OS / Supervised.
  • Token'larım sayfasından bir AuthToken. Başka hiçbir cihazın kullanmadığı bir token kullanın: aynı token ile ikinci bir istemci bağlandığında birincinin bağlantısı kesilir.
  • Şablonların ZIP dosyası. İndirme bağlantısı bu sayfanın sonundaki listede ve İndirmeler sayfasında bulunur.

NAS'ı Docker Compose ile kurun #

  1. ZIP'i çıkarın ve nas klasörünü NAS'a kopyalayın #

    Arşivi bilgisayarınızda çıkarın. nas klasörünü, konteyner yöneticinizin kullanabileceği bir NAS paylaşım klasörüne kopyalayın.

  2. Token dosyasını oluşturun #

    nas klasöründe auth-token.example dosyasını auth-token olarak kopyalayın. auth-token dosyasını açın ve DUMMY_AUTH_TOKEN yerine AuthToken'ınızı, dosyada başka hiçbir şey olmadan tek satıra yazın.

    Token dosyasını gizli tutun. Erişimi NAS üzerindeki kendi hesabınızla sınırlayın ve başkalarının okuyabileceği paylaşımlı veya eşitlenen bir klasöre koymayın. Token, Localtonet istemcisinin bu cihaz olarak bağlanmasına izin verir.

    Dosya, konteyner başlamadan önce var olmalıdır. Eksikse Docker bunun yerine auth-token adında bir dizin oluşturur ve konteyner buradan token okuyamaz.

  3. compose.yaml dosyasını olduğu gibi bırakın #

    compose.yaml dosyasını düzenlemeniz gerekmez. image: satırı, Localtonet imajının adını ve bu ZIP'in hazırlandığı sürümü belirtir, örneğin docker.io/localtonet/localtonet:8.6.0. Diğer satırlar Compose şablonu ne yapar bölümünde açıklanır.

  4. Projeyi başlatın #

    compose.yaml dosyasını konteyner yöneticinizde proje olarak içe aktarın ve başlatın:

    • Synology: Container Manager'da nas klasöründen ve onun compose.yaml dosyasından bir proje oluşturun.
    • QNAP: Container Station'da compose.yaml dosyasından bir uygulama oluşturun. Dosya, ./auth-token yolunu Compose dosyasına göre bağlar; bu yüzden token dosyasına bu yoldan ulaşılabilmelidir.
    • Kabuğu olan herhangi bir Docker ana bilgisayarı: aşağıdaki komutu nas dizininden çalıştırın.
    Bash
    docker compose up -d

    Ekranlar NAS modeline ve sürümüne göre farklılık gösterir. Bir Compose dosyasından proje oluşturmak için üreticinizin belgelerini izleyin.

  5. Bir tünel oluşturun ve başlatın #

    Konteyner çalışırken panele gidin, dosyaya yazdığınız token ile bir tünel oluşturun ve Hızlı başlangıç bölümündeki gibi Başlat düğmesini seçin.

Compose şablonu ne yapar #

Dosyanın tamamı budur. image: satırının sonundaki etiket, ZIP'inizin hazırlandığı Localtonet sürümüdür; 8.6.0 bir örnektir.

nas/compose.yaml
services:
  localtonet:
    image: "docker.io/localtonet/localtonet:8.6.0"
    restart: unless-stopped
    network_mode: host
    environment:
      LOCALTONET_HEADLESS: "1"
      LOCALTONET_AUTH_TOKEN_FILE: /run/secrets/localtonet_auth_token
    volumes:
      - ./auth-token:/run/secrets/localtonet_auth_token:ro
AyarNe yapar
imageLocaltonet imajı docker.io/localtonet/localtonet ve çalıştırılacak sürüm. Etiketi yalnızca başka bir sürüme geçerken değiştirin; bkz. Günlükler ve güncellemeler.
restart: unless-stoppedSiz kendiniz durdurmadığınız sürece Docker, yeniden başlatma veya çökme sonrasında konteyneri tekrar başlatır.
network_mode: hostKonteyner NAS'ın ağını paylaşır. Böylece bir tünel, NAS üzerindeki hizmetlere 127.0.0.1 adresinden, yerel ağınızdaki diğer cihazlara ise yerel ağ adreslerinden ulaşabilir. Bunun için Linux ana bilgisayar ağı gerekir.
LOCALTONET_HEADLESSİstemciyi istem sormadan, sade günlük satırlarıyla çalıştırır.
LOCALTONET_AUTH_TOKEN_FILEİstemcinin token'ı okuduğu dosyanın konteyner içindeki yolu.
volumesauth-token dosyanızı bu yola salt okunur olarak bağlar.

Home Assistant OS veya Supervised kurulumu #

Home Assistant OS ve Supervised, uygulamaları Supervisor üzerinden çalıştırır. Şablon, cihaza kopyaladığınız yerel bir uygulamadır.

  1. Uygulama klasörünü kopyalayın #

    ZIP'i çıkarın. home-assistant/localtonet klasörünü Home Assistant'ınızın yerel uygulamalar dizinine, /addons/localtonet olacak şekilde kopyalayın. Klasörde tek bir dosya vardır: config.json. Düzenlemeyin: dosya uygulamanın adını (Localtonet), docker.io/localtonet/localtonet imajını ve bu ZIP'in hazırlandığı sürümü belirtir; authtoken seçeneğini ise daha sonra doldurmanız için boş bırakır.

  2. Uygulama mağazasını yeniden yükleyin ve Localtonet'i kurun #

    Yerel uygulamayı bulabilmesi için Home Assistant'ta uygulama mağazasını yeniden yükleyin, ardından Localtonet uygulamasını kurun.

  3. Token'ınızı girin ve uygulamayı başlatın #

    Uygulamanın Yapılandırma sayfasını açın, authtoken seçeneğine AuthToken'ınızı girin ve uygulamayı başlatın. Home Assistant değeri şifre gibi gizler. Uygulama bundan sonra Home Assistant ile birlikte otomatik olarak başlar.

  4. Bir tünel oluşturun ve başlatın #

    Panelde bu token ile bir tünel oluşturun ve Başlat düğmesini seçin. Home Assistant'ın kendisini yayınlamak için 127.0.0.1 adresine ve Home Assistant'ınızın dinlediği porta bir HTTP tüneli oluşturun. Home Assistant'ın varsayılan portu 8123'tür. Home Assistant'ın bir proxy üzerinden gelen istekler için kendi ayarları vardır; bunları reddederse Home Assistant HTTP belgelerine bakın.

Uygulama ana bilgisayar ağını kullanır, bu yüzden Home Assistant'a ve ağınızdaki diğer cihazlara doğrudan ulaşır. Home Assistant mimarilerinden amd64 ve aarch64'ü destekler.

Home Assistant Container ve Core'da Supervisor yoktur, bu yüzden uygulama kuramazlar. Bu kurulumlarda bunun yerine Docker ana bilgisayarında NAS / Docker Compose şablonunu kullanın.

home-assistant/repository.json dosyası, kopyaladığınız klasörün dışındadır ve yerel kurulumun parçası değildir. Bir depo URL'si ve bir bakımcı için yer tutucu değerler (DUMMY) içerir; yok sayın.

Hizmetlerinize ulaşın #

Her iki şablon da ana bilgisayar ağını kullanır. Bir tünelin Yerel IP adresi alanında:

  • 127.0.0.1, NAS'ın veya Home Assistant ana bilgisayarının kendisidir. NAS web arayüzü, Home Assistant veya o cihazdaki herhangi bir hizmet için, o hizmetin dinlediği portla birlikte kullanın.
  • 192.168.1.20 gibi bir yerel ağ adresi, ağınızdaki başka bir cihaza ulaşır.

Başlatılmış bir tünele internetten ulaşılabilir. Bir NAS giriş sayfasını veya Home Assistant'ı yayınlamadan önce hizmetin kendisinde güçlü şifreler ve iki adımlı girişi kullanın ve Erişim kontrolü sayfasındaki seçenekleri değerlendirin.

Günlükler ve güncellemeler #

Konteyner sade günlük satırları yazar: bağlantı durumunu, oturum açtığı token'ın adını ve bir tünel eklendiğinde, durumu değiştiğinde veya kaldırıldığında bir satır. Bunları konteyner yöneticinizin günlük görünümünde, Home Assistant'ta uygulamanın Günlük sekmesinde veya şu komutla okuyabilirsiniz:

Bash
docker compose logs -f localtonet

Invalid Localtonet headless configuration. Check the token file or environment settings. satırı, istemcinin kullanılabilir bir token bulamadığı anlamına gelir: token dosyası eksik veya boştur, hâlâ DUMMY_AUTH_TOKEN içerir ya da token 33 karakter uzunluğunda değildir. Authentication failed: AuthToken was rejected. ise token'ın biçiminin doğru olduğunu ama Localtonet'in onu kabul etmediğini gösterir.

Her şablon ZIP'i tek bir Localtonet sürümü için hazırlanır: Compose dosyası sürümü image: satırındaki etiketle, Home Assistant uygulaması config.json dosyasındaki version alanıyla sabitler. Bir NAS'ı daha yeni bir sürüme geçirmek için etiketi Docker Hub'ın imaj için listelediği bir sürümle değiştirin (bkz. Docker) ve docker compose up -d komutunu yeniden çalıştırın (veya konteyner yöneticinizde projeyi güncelleyin). auth-token dosyanız olduğu gibi kalır.

NAS ve Home Assistant

Synology Container Manager, QNAP Container Station ve Docker destekli diğer NAS cihazları için Docker Compose şablonları; ayrıca OS / Supervised için bir Home Assistant uygulama şablonu. AMD64 ve ARM64.

Bunlar kurulum şablonlarıdır; SPK / QPKG yükleyicileri veya resmi bir Home Assistant mağaza kaydı değildir. Kayıt deposunda (registry) uygun bir Docker imajı bulunmalıdır. Home Assistant Container / Core kullanıcıları Compose şablonunu kullanabilir.

NAS'ınızı veya Home Assistant'ı kurun
  1. ZIP dosyasını çıkarın ve README.txt dosyasını okuyun.
  2. NAS için nas/auth-token.example dosyasını nas/auth-token olarak kopyalayın ve AuthToken'ınızı girin. Bu dosyayı gizli tutun.
  3. nas/compose.yaml içindeki imaj etiketini kontrol edin, ardından dosyayı proje olarak içe aktarın veya nas dizininden docker compose up -d komutunu çalıştırın.
  4. Home Assistant OS / Supervised için README'deki yerel uygulama kurulum talimatlarını izleyin ve token'ı uygulama yapılandırmasına girin.

Şablonlar LAN erişimi için Linux ana makine ağını (host networking) kullanır. VPN yetkilerini etkinleştirmezler.

Bu sayfa için yardıma mı ihtiyacınız var? Topluluğa sorun veya bir destek talebi açın.

Destek