İçeriğe geç
Localtonet Localtonet Panel

Localtonet'i Docker'da çalıştırma

Bu sayfa için yardım al
Bu sayfada 12 bölüm
  1. Başlamadan önce
  2. Adımlar
  3. İmajı çekin
  4. Konteyneri token'ınızla başlatın
  5. Bir tünel oluşturun ve başlatın
  6. Konteyner nasıl çalışır
  7. Arka planda çalıştırma ve otomatik yeniden başlatma
  8. Token'ı iletme yolları
  9. Docker Compose
  10. Hizmetinize konteynerden ulaşma
  11. Günlüğü okuma
  12. Güncelleme
  13. Kayıt defterine erişimi olmayan ana makineler için imaj arşivleri
  14. Sorun giderme
  15. İ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/amd64 ve linux/arm64 iç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 #

  1. İ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.

    Bash
    docker pull localtonet/localtonet

    İmaj Docker Hub'dadır. Bir sürümü sabitlemek isterseniz Docker Hub, latest etiketinin yanı sıra her sürüm için bir etiket listeler.

  2. Konteyneri token'ınızla başlatın #

    İmaj adından sonraki her şey Localtonet istemcisine iletilir. <YOUR_TOKEN> yerine AuthToken'ınızı yazın.

    Bash
    docker 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.

  3. 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.1 bir 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.
  • -it ile 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:

Bash
docker run -d \
  --name localtonet \
  --restart unless-stopped \
  localtonet/localtonet --authtoken <YOUR_TOKEN>

Olağan Docker komutlarıyla yönetin:

KomutNe 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 localtonetAynı token'la yeniden başlatır.
docker rm -f localtonetKonteyneri 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:

KaynakNasıl kullanılırNotlar
--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_TOKENToken'ı tutan ortam değişkeni.--authtoken argümanı verilmediğinde kullanılır.
LOCALTONET_AUTH_TOKEN_FILEYalnı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:

Bash
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/localtonet

Konteyneri 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.

Bash
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-config

Docker Compose #

Aynı kurulum bir Compose dosyası olarak. Token'ı compose.yaml dosyasının yanında auth-token adlı bir dosyaya koyun:

compose.yaml
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:ro
Bash
docker compose up -d
docker compose logs -f localtonet

Yayı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:

compose.yaml
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:ro

Bu ö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ığı yerGirilecek yerel adresBaşka ne gerekir
Docker ana makinesinde, Linux127.0.0.1Konteyneri --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.10Hizmet 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 konteynerdeLinux'ta --network host ile 127.0.0.1, aksi halde ana makinenin LAN IP adresiO 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 cihazdaO cihazın LAN IP adresi, örneğin 192.168.1.20Hiçbir şey.
Linux, hizmet ana makinede
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ırAnlamı
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:

Bash
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:

Bash
docker load --input localtonet-docker-amd64.tar

docker 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:

Bash
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.

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

Destek