Localtonet'i Docker'da çalıştırma
Bu sayfada 12 bölüm
- Başlamadan önce
- Adımlar
- İmajı çekin
- Konteyneri token'ınızla başlatın
- Bir tünel oluşturun ve başlatın
- Konteyner nasıl çalışır
- Arka planda çalıştırma ve otomatik yeniden başlatma
- Token'ı iletme yolları
- Docker Compose
- Hizmetinize konteynerden ulaşma
- Günlüğü okuma
- Güncelleme
- Kayıt defterine erişimi olmayan ana makineler için imaj arşivleri
- Sorun giderme
- İlgili sayfalar
Resmî localtonet/localtonet imajı, Localtonet istemcisini bir konteynerde çalıştırır. AuthToken'ınızı iletin, ardından tünelleri her zamanki gibi panelde oluşturup başlatın.
Başlamadan önce #
- 64 bit bir ana makinede Docker. İmaj
linux/amd64velinux/arm64için yayımlanır ve Docker ana makinenize uyanı seçer. 32 bit ARM cihazı için bunun yerine Linux sürümünü kullanın. - Token'larım sayfasından bir AuthToken. Her konteynere kendi token'ını verin: aynı token'la ikinci bir istemci bağlandığında birincinin bağlantısı kesilir.
Adımlar #
-
İmajı çekin #
Önce çekmek, ana makinede hâlâ duran eski bir imajı değil, güncel sürümü çalıştırdığınızdan emin olmanızı sağlar.
Bashdocker pull localtonet/localtonetİmaj Docker Hub'dadır. Bir sürümü sabitlemek isterseniz Docker Hub,
latestetiketinin yanı sıra her sürüm için bir etiket listeler. -
Konteyneri token'ınızla başlatın #
İmaj adından sonraki her şey Localtonet istemcisine iletilir.
<YOUR_TOKEN>yerine AuthToken'ınızı yazın.Bashdocker run localtonet/localtonet --authtoken <YOUR_TOKEN>Konteyner bağlantı durumunu yazdırır ve ön planda kalır. Durdurmak için Ctrl + C tuşlarına basın.
-
Bir tünel oluşturun ve başlatın #
Paneli açın, konteynere verdiğiniz token'la bir tünel oluşturun ve Başlat düğmesini seçin. Hızlı başlangıç formu gösterir. Yerel IP adresi alanını doldurmadan önce Hizmetinize konteynerden ulaşma bölümünü okuyun, çünkü
127.0.0.1bir konteynerin içinde farklı bir anlama gelir.
Konteyner nasıl çalışır #
İmaj istemciyi başsız modda başlatır. Bu, masaüstündeki istemciye kıyasla üç şeyi değiştirir:
- Hiçbir zaman soru sormaz. Token eksikse veya biçimi bozuksa konteyner bir hata yazdırır ve 2 koduyla çıkar.
-itile başlatsanız bile canlı durum tablosu yerine düz günlük satırları yazar.- Token'ı kaydetmez. İmaj hiçbir birim tanımlamaz; bu yüzden bir konteyner her oluşturulduğunda token'ı iletin: komut satırında, bir ortam değişkeninde veya bir dosya olarak.
Tüneller konteynerde yapılandırılmaz. Onları panelde oluşturur, başlatır ve durdurursunuz; konteyner bunları bağlantısı üzerinden alır.
Arka planda çalıştırma ve otomatik yeniden başlatma #
Ayırmak için -d ve Docker'ın yeniden başlatma veya çökmeden sonra konteyneri yeniden başlatması için bir yeniden başlatma ilkesi kullanın:
docker run -d \
--name localtonet \
--restart unless-stopped \
localtonet/localtonet --authtoken <YOUR_TOKEN>Olağan Docker komutlarıyla yönetin:
| Komut | Ne yapar |
|---|---|
docker ps | Çalışan konteynerleri listeler. |
docker logs -f localtonet | İstemcinin günlüğünü izler. |
docker stop localtonet | İstemciyi durdurur. Tünelleri çevrimdışı olur. |
docker start localtonet | Aynı token'la yeniden başlatır. |
docker rm -f localtonet | Konteyneri kaldırır. |
Token'ı iletme yolları #
Komut satırındaki bir token, docker inspect çıktısında ve ana makinenin işlem listesinde görünür. İmaj token'ı ortamdan veya bir dosyadan da okur:
| Kaynak | Nasıl kullanılır | Notlar |
|---|---|---|
--authtoken <YOUR_TOKEN> | İmaj adından sonraki argüman. | En basit yöntem. LOCALTONET_AUTH_TOKEN değişkeninin önüne geçer. |
LOCALTONET_AUTH_TOKEN | Token'ı tutan ortam değişkeni. | --authtoken argümanı verilmediğinde kullanılır. |
LOCALTONET_AUTH_TOKEN_FILE | Yalnızca token'ı içeren bir dosyanın konteyner içindeki yolunu tutan ortam değişkeni. | Token dosyası, doğrudan iletilen bir token'ın her zaman önüne geçer. --authtoken-file <PATH> argümanı aynı işi yapar. |
İmajın kendisi LOCALTONET_HEADLESS=1 değerini ayarlar. Sizin ayarlamanız gerekmez.
Token dosyasıyla token'ı konteyner tanımının dışında tutun ve dosyayı salt okunur olarak bağlayın:
printf '%s' '<YOUR_TOKEN>' > auth-token
chmod 600 auth-token
docker run -d \
--name localtonet \
--restart unless-stopped \
-e LOCALTONET_AUTH_TOKEN_FILE=/run/secrets/localtonet_auth_token \
-v "$(pwd)/auth-token:/run/secrets/localtonet_auth_token:ro" \
localtonet/localtonetKonteyneri başlatmadan önce token dosyasını oluşturun. Dosya yoksa Docker o adla bir dizin oluşturur ve istemci ondan token okuyamaz.
Bir token kaynağını bağlanmadan denetlemek için --check-config ekleyin. İstemci token'ın var olduğunu ve biçiminin doğru olduğunu (33 karakter, boşluk yok) denetler, Localtonet headless configuration OK. yazdırır ve çıkar. Sunucuya token'ın geçerli olup olmadığını sormaz.
docker run --rm \
-e LOCALTONET_AUTH_TOKEN_FILE=/run/secrets/localtonet_auth_token \
-v "$(pwd)/auth-token:/run/secrets/localtonet_auth_token:ro" \
localtonet/localtonet --check-configDocker Compose #
Aynı kurulum bir Compose dosyası olarak. Token'ı compose.yaml dosyasının yanında auth-token adlı bir dosyaya koyun:
services:
localtonet:
image: localtonet/localtonet
restart: unless-stopped
environment:
LOCALTONET_AUTH_TOKEN_FILE: /run/secrets/localtonet_auth_token
volumes:
- ./auth-token:/run/secrets/localtonet_auth_token:rodocker compose up -d
docker compose logs -f localtonetYayımlamak istediğiniz hizmet bir Linux ana makinesinde aynı Compose projesindeyse, portunu ana makinede yayımlayın ve Localtonet konteynerini ana makine ağıyla çalıştırın. Tünelin yerel adresi bir IP adresi olmalıdır; bu yüzden web gibi bir Compose hizmet adı bunun için kullanılamaz:
services:
web:
image: nginx
ports:
- "8080:80"
localtonet:
image: localtonet/localtonet
restart: unless-stopped
network_mode: host
environment:
LOCALTONET_AUTH_TOKEN_FILE: /run/secrets/localtonet_auth_token
volumes:
- ./auth-token:/run/secrets/localtonet_auth_token:roBu örnek için tünelin yerel adresini 127.0.0.1, yerel portunu 8080 yapın.
Bir NAS veya Home Assistant için hazır şablonlar NAS ve Home Assistant sayfasındadır.
Hizmetinize konteynerden ulaşma #
Tünelin Yerel IP adresi ve Yerel port değerleri, istemciye hizmetinizin nerede olduğunu söyler. İstemci konteynerin içinden bağlanır; orada 127.0.0.1 sizin makineniz değil konteynerin kendisidir. Bir IP adresi girin: istemci host.docker.internal gibi Docker adlarını, bir Compose hizmet adını veya bir konteyner adını çözümlemez. Hizmetin çalıştığı yere uyan değeri kullanın:
| Hizmetin çalıştığı yer | Girilecek yerel adres | Başka ne gerekir |
|---|---|---|
| Docker ana makinesinde, Linux | 127.0.0.1 | Konteyneri --network host ile başlatın (Compose: network_mode: host). Konteyner o zaman ana makinenin ağını paylaşır. |
| Docker ana makinesinde, ana makine ağı olmadan (Windows veya macOS üzerindeki Docker Desktop dahil) | Ana makinenin LAN IP adresi, örneğin 192.168.1.10 | Hizmet yalnızca 127.0.0.1 üzerinde değil, konteynerin ulaşabileceği bir adreste dinlemelidir ve ana makinenin güvenlik duvarı bağlantıya izin vermelidir. |
| Başka bir konteynerde | Linux'ta --network host ile 127.0.0.1, aksi halde ana makinenin LAN IP adresi | O konteynerin portunu ana makinede yayımlayın (-p, Compose: ports) ve yayımlanan portu tünelin yerel portu olarak kullanın. |
| Ağınızdaki başka bir cihazda | O cihazın LAN IP adresi, örneğin 192.168.1.20 | Hiçbir şey. |
docker run -d \
--name localtonet \
--restart unless-stopped \
--network host \
localtonet/localtonet --authtoken <YOUR_TOKEN>Mevcut bir tünelin adresini, tünel ayarlarında Yerel adres altında değiştirebilirsiniz. Bkz. ayarlar başvurusu.
Günlüğü okuma #
docker logs -f localtonet her değişiklik için bir satır gösterir. İlkinden sonraki her satır bir zaman damgasıyla başlar:
| Satır | Anlamı |
|---|---|
Localtonet - headless log | İstemci başladı. |
Connection: … | Localtonet'e olan bağlantının durumu. Değiştiğinde yeni bir satır görünür. |
AuthTokenName: … | Konteynerin oturum açtığı token'ın adı; Token'larım sayfasında gösterildiği gibi. |
OPEN …, ADDED … | Bu token'ın bir tüneli. OPEN, istemci başladığında var olan tüneller için, ADDED daha sonra ortaya çıkan tüneller için kullanılır. |
STATUS … | Bir tünelin durumu değişti. |
CLOSED … | Bir tünel bu istemciden kaldırıldı. |
Authentication failed: AuthToken was rejected. | Localtonet token'ı kabul etmedi. |
Token'ın kendisi günlüğe hiçbir zaman yazılmaz.
Güncelleme #
İmajı yeniden çekin ve konteyneri yeniden oluşturun:
docker pull localtonet/localtonet
docker rm -f localtonet
docker run -d --name localtonet --restart unless-stopped localtonet/localtonet --authtoken <YOUR_TOKEN>Compose ile önce docker compose pull, ardından docker compose up -d çalıştırın. Her zaman en yeni imajla başlamak için docker run komutuna --pull always ekleyin.
Kayıt defterine erişimi olmayan ana makineler için imaj arşivleri #
Ana makine Docker Hub'a ulaşamıyorsa imajı başka bir makinede TAR arşivi olarak indirin, kopyalayın ve yükleyin:
| Mimari | Arşiv |
|---|---|
| AMD64 | localtonet-docker-amd64.tar |
| ARM64 | localtonet-docker-arm64.tar |
docker load --input localtonet-docker-amd64.tardocker load yüklediği şeyi yazdırır. Ad yerine bir imaj kimliği yazdırırsa, çalıştırmadan önce imaja bir ad verin:
docker tag <IMAGE_ID> localtonet/localtonet
docker run -d --name localtonet --restart unless-stopped localtonet/localtonet --authtoken <YOUR_TOKEN>Sorun giderme #
Konteyner hemen "Invalid Localtonet headless configuration" hatasıyla çıkıyor
Tam mesaj Invalid Localtonet headless configuration. Check the token file or environment settings. şeklindedir. İstemci kullanılabilir bir token bulamadı: hiçbir şey iletilmedi, değer 33 karakter uzunluğunda değil, ortasında bir boşluk veya satır sonu var ya da token dosyasının yolu konteynerde yok. Bir token dosyası bağlıyorsanız, ana makinede bunun bir dizin değil dosya olduğunu kontrol edin. Yeniden başlatma ilkesiyle konteyner, token'ı düzeltene kadar yeniden başlamayı sürdürür; bu yüzden docker logs localtonet çıktısını okuyun.
Günlükte "Authentication failed: AuthToken was rejected." görünüyor
Token'ın biçimi doğru ama Localtonet onu kabul etmiyor. Token'ı Token'larım sayfasından yeniden kopyalayın ve konteyneri yeniden oluşturun.
Tünel başlatıldı ama herkese açık adres hizmetime ulaşmıyor
Tünelin yerel adresini kontrol edin. 127.0.0.1 yalnızca Linux'ta --network host ile çalışır. Aksi halde ana makinenin LAN IP adresini kullanın. host.docker.internal gibi bir ad ya da başka bir konteynerin adı, Hizmetinize konteynerden ulaşma bölümünde açıklandığı gibi bu alanda çalışmaz.
Konteyner bağlantısını sürekli kaybediyor
Aynı token'ı başka hiçbir istemcinin kullanmadığından emin olun. Token'la bağlanan ikinci bir istemci birincinin bağlantısını keser. Token'larım sayfasında her konteyner veya cihaz için bir token oluşturun.