Localtonet'i bir NAS veya Home Assistant üzerinde çalıştırın
Kurulum şablonları AMD64 ve ARM64
Bu sayfada 7 bölüm
- Şablonlar nedir
- Ne olmadıkları
- Başlamadan önce
- NAS'ı Docker Compose ile kurun
- ZIP'i çıkarın ve nas klasörünü NAS'a kopyalayın
- Token dosyasını oluşturun
- compose.yaml dosyasını olduğu gibi bırakın
- Projeyi başlatın
- Bir tünel oluşturun ve başlatın
- Compose şablonu ne yapar
- Home Assistant OS veya Supervised kurulumu
- Uygulama klasörünü kopyalayın
- Uygulama mağazasını yeniden yükleyin ve Localtonet'i kurun
- Token'ınızı girin ve uygulamayı başlatın
- Bir tünel oluşturun ve başlatın
- Hizmetlerinize ulaşın
- Günlükler ve güncellemeler
- İ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:
| Şablon | Kullanım yeri | Dosyalar | Neyi 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.example | Yalnı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 Supervised | Yerel bir uygulamanın (eskiden eklenti olarak adlandırılırdı) tanımı olan home-assistant/localtonet/config.json ve home-assistant/repository.json | Dosyalarda 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/localtonetimajı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 #
-
ZIP'i çıkarın ve nas klasörünü NAS'a kopyalayın #
Arşivi bilgisayarınızda çıkarın.
nasklasörünü, konteyner yöneticinizin kullanabileceği bir NAS paylaşım klasörüne kopyalayın. -
Token dosyasını oluşturun #
nasklasöründeauth-token.exampledosyasınıauth-tokenolarak kopyalayın.auth-tokendosyasını açın veDUMMY_AUTH_TOKENyerine 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-tokenadında bir dizin oluşturur ve konteyner buradan token okuyamaz. -
compose.yaml dosyasını olduğu gibi bırakın #
compose.yamldosyasını düzenlemeniz gerekmez.image:satırı, Localtonet imajının adını ve bu ZIP'in hazırlandığı sürümü belirtir, örneğindocker.io/localtonet/localtonet:8.6.0. Diğer satırlar Compose şablonu ne yapar bölümünde açıklanır. -
Projeyi başlatın #
compose.yamldosyasını konteyner yöneticinizde proje olarak içe aktarın ve başlatın:- Synology: Container Manager'da
nasklasöründen ve onuncompose.yamldosyasından bir proje oluşturun. - QNAP: Container Station'da
compose.yamldosyasından bir uygulama oluşturun. Dosya,./auth-tokenyolunu 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
nasdizininden çalıştırın.
Bashdocker compose up -dEkranlar 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.
- Synology: Container Manager'da
-
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.
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| Ayar | Ne yapar |
|---|---|
image | Localtonet 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-stopped | Siz kendiniz durdurmadığınız sürece Docker, yeniden başlatma veya çökme sonrasında konteyneri tekrar başlatır. |
network_mode: host | Konteyner 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. |
volumes | auth-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.
-
Uygulama klasörünü kopyalayın #
ZIP'i çıkarın.
home-assistant/localtonetklasörünü Home Assistant'ınızın yerel uygulamalar dizinine,/addons/localtonetolacak şekilde kopyalayın. Klasörde tek bir dosya vardır:config.json. Düzenlemeyin: dosya uygulamanın adını (Localtonet),docker.io/localtonet/localtonetimajını ve bu ZIP'in hazırlandığı sürümü belirtir;authtokenseçeneğini ise daha sonra doldurmanız için boş bırakır. -
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.
-
Token'ınızı girin ve uygulamayı başlatın #
Uygulamanın Yapılandırma sayfasını açın,
authtokenseç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. -
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.1adresine ve Home Assistant'ınızın dinlediği porta bir HTTP tüneli oluşturun. Home Assistant'ın varsayılan portu8123'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.20gibi 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:
docker compose logs -f localtonetInvalid 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.
İlgili sayfalar #
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
- ZIP dosyasını çıkarın ve
README.txtdosyasını okuyun. - NAS için
nas/auth-token.exampledosyasınınas/auth-tokenolarak kopyalayın ve AuthToken'ınızı girin. Bu dosyayı gizli tutun. nas/compose.yamliçindeki imaj etiketini kontrol edin, ardından dosyayı proje olarak içe aktarın veyanasdizinindendocker compose up -dkomutunu çalıştırın.- 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.