Langsung ke konten
Localtonet Localtonet Dasbor

Jalankan Localtonet di Docker

Bantuan untuk halaman ini
Di halaman ini 12 bagian
  1. Sebelum memulai
  2. Langkah
  3. Tarik image
  4. Mulai container dengan token Anda
  5. Buat dan mulai tunnel
  6. Cara container berjalan
  7. Jalankan di latar belakang dan mulai ulang otomatis
  8. Cara memberikan token
  9. Docker Compose
  10. Menjangkau layanan Anda dari container
  11. Baca log
  12. Pembaruan
  13. Arsip image untuk host tanpa akses registry
  14. Pemecahan masalah
  15. Halaman terkait

Image resmi localtonet/localtonet menjalankan klien Localtonet di dalam container. Berikan AuthToken Anda, lalu buat dan mulai tunnel di dasbor seperti biasa.

Sebelum memulai #

  • Docker di host 64-bit. Image diterbitkan untuk linux/amd64 dan linux/arm64, dan Docker memilih yang cocok dengan host Anda. Untuk perangkat ARM 32-bit, gunakan build Linux.
  • AuthToken dari Token Saya. Berikan setiap container token sendiri: saat klien kedua terhubung dengan token yang sama, klien pertama diputus.

Langkah #

  1. Tarik image #

    Menarik image terlebih dahulu memastikan Anda menjalankan versi terbaru, bukan image lama yang masih ada di host.

    Bash
    docker pull localtonet/localtonet

    Image tersedia di Docker Hub. Selain latest, Docker Hub mencantumkan tag untuk setiap versi jika Anda ingin mengunci rilis tertentu.

  2. Mulai container dengan token Anda #

    Semua yang ada setelah nama image diteruskan ke klien Localtonet. Ganti <YOUR_TOKEN> dengan AuthToken Anda.

    Bash
    docker run localtonet/localtonet --authtoken <YOUR_TOKEN>

    Container mencetak status koneksinya dan tetap berjalan di latar depan. Tekan Ctrl + C untuk menghentikannya.

  3. Buat dan mulai tunnel #

    Buka dasbor, buat tunnel dengan token yang Anda berikan ke container, lalu pilih Mulai. Mulai cepat menampilkan formulirnya. Baca Menjangkau layanan Anda dari container sebelum mengisi Alamat IP lokal, karena 127.0.0.1 berarti hal yang berbeda di dalam container.

Cara container berjalan #

Image menjalankan klien dalam mode headless. Ini mengubah tiga hal dibandingkan klien di desktop:

  • Klien tidak pernah mengajukan pertanyaan. Jika token tidak ada atau formatnya salah, container mencetak kesalahan dan keluar dengan kode 2.
  • Klien menulis baris log biasa alih-alih tabel status langsung, juga saat Anda memulainya dengan -it.
  • Klien tidak menyimpan token. Image tidak mendeklarasikan volume, jadi berikan token setiap kali container dibuat: lewat baris perintah, variabel lingkungan, atau file.

Tunnel tidak dikonfigurasi di dalam container. Anda membuat, memulai, dan menghentikannya di dasbor, dan container mengambilnya lewat koneksinya.

Jalankan di latar belakang dan mulai ulang otomatis #

Gunakan -d untuk melepas dari terminal dan kebijakan restart agar Docker memulai container lagi setelah reboot atau crash:

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

Kelola dengan perintah Docker biasa:

PerintahFungsinya
docker psMencantumkan container yang berjalan.
docker logs -f localtonetMengikuti log klien.
docker stop localtonetMenghentikan klien. Tunnel-nya menjadi offline.
docker start localtonetMemulainya lagi dengan token yang sama.
docker rm -f localtonetMenghapus container.

Cara memberikan token #

Token di baris perintah terlihat di docker inspect dan di daftar proses host. Image juga membaca token dari lingkungan atau dari file:

SumberCara memakainyaCatatan
--authtoken <YOUR_TOKEN>Argumen setelah nama image.Paling sederhana. Menang atas LOCALTONET_AUTH_TOKEN.
LOCALTONET_AUTH_TOKENVariabel lingkungan yang berisi token.Dipakai jika tidak ada argumen --authtoken.
LOCALTONET_AUTH_TOKEN_FILEVariabel lingkungan yang berisi path, di dalam container, dari file yang hanya berisi token.File token selalu menang atas token yang diberikan langsung. Argumen --authtoken-file <PATH> melakukan hal yang sama.

Image itu sendiri mengatur LOCALTONET_HEADLESS=1. Anda tidak perlu mengaturnya.

Dengan file token, jauhkan token dari definisi container dan mount sebagai hanya-baca:

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

Buat file token sebelum memulai container. Jika file tidak ada, Docker membuat direktori dengan nama itu dan klien tidak dapat membaca token darinya.

Untuk memeriksa sumber token tanpa menyambung, tambahkan --check-config. Klien memeriksa bahwa token ada dan formatnya benar (33 karakter, tanpa spasi), mencetak Localtonet headless configuration OK., lalu keluar. Klien tidak menanyakan ke server apakah token valid.

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 #

Penyiapan yang sama sebagai file Compose. Letakkan token di file bernama auth-token di samping compose.yaml:

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

Jika layanan yang ingin Anda publikasikan berada di proyek Compose yang sama di host Linux, publikasikan port-nya di host dan jalankan container Localtonet dengan jaringan host. Alamat lokal tunnel harus berupa alamat IP, sehingga nama layanan Compose seperti web tidak dapat dipakai:

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

Untuk contoh ini, atur alamat lokal tunnel ke 127.0.0.1 dan port lokalnya ke 8080.

Untuk NAS atau Home Assistant, templat siap pakai ada di halaman NAS dan Home Assistant.

Menjangkau layanan Anda dari container #

Alamat IP lokal dan Port lokal tunnel memberi tahu klien di mana layanan Anda berada. Klien terhubung dari dalam container, tempat 127.0.0.1 adalah container itu sendiri dan bukan mesin Anda. Masukkan alamat IP: klien tidak me-resolve nama Docker seperti host.docker.internal, nama layanan Compose, atau nama container. Gunakan nilai yang sesuai dengan tempat layanan berjalan:

Tempat layanan berjalanAlamat lokal yang dimasukkanYang juga dibutuhkan
Di host Docker, Linux127.0.0.1Mulai container dengan --network host (Compose: network_mode: host). Container kemudian berbagi jaringan host.
Di host Docker, tanpa jaringan host (termasuk Docker Desktop di Windows atau macOS)Alamat IP LAN host, misalnya 192.168.1.10Layanan harus mendengarkan di alamat yang dapat dijangkau container, bukan hanya di 127.0.0.1, dan firewall host harus mengizinkan koneksi.
Di container lain127.0.0.1 dengan --network host di Linux, selain itu alamat IP LAN hostPublikasikan port container tersebut di host (-p, Compose: ports) dan gunakan port yang dipublikasikan sebagai port lokal tunnel.
Di perangkat lain di jaringan AndaAlamat IP LAN perangkat tersebut, misalnya 192.168.1.20Tidak ada.
Linux, layanan di host
docker run -d \
  --name localtonet \
  --restart unless-stopped \
  --network host \
  localtonet/localtonet --authtoken <YOUR_TOKEN>

Anda dapat mengubah alamat tunnel yang sudah ada di pengaturannya pada Alamat lokal. Lihat referensi pengaturan.

Baca log #

docker logs -f localtonet menampilkan satu baris per perubahan. Setiap baris setelah yang pertama diawali dengan stempel waktu:

BarisArti
Localtonet - headless logKlien telah dimulai.
Connection: …Status koneksi ke Localtonet. Baris baru muncul saat status berubah.
AuthTokenName: …Nama token yang dipakai container untuk masuk, seperti yang ditampilkan di Token Saya.
OPEN …, ADDED …Sebuah tunnel milik token ini. OPEN dipakai untuk tunnel yang sudah ada saat klien dimulai, ADDED untuk tunnel yang muncul kemudian.
STATUS …Status sebuah tunnel berubah.
CLOSED …Sebuah tunnel dihapus dari klien ini.
Authentication failed: AuthToken was rejected.Localtonet tidak menerima token.

Token itu sendiri tidak pernah ditulis ke log.

Pembaruan #

Tarik image lagi dan buat ulang container:

Bash
docker pull localtonet/localtonet
docker rm -f localtonet
docker run -d --name localtonet --restart unless-stopped localtonet/localtonet --authtoken <YOUR_TOKEN>

Dengan Compose, jalankan docker compose pull lalu docker compose up -d. Untuk selalu memulai dari image terbaru, tambahkan --pull always ke docker run.

Arsip image untuk host tanpa akses registry #

Jika host tidak dapat menjangkau Docker Hub, unduh image sebagai arsip TAR di mesin lain, salin, lalu muat:

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

docker load mencetak apa yang dimuat. Jika yang dicetak adalah ID image dan bukan nama, beri nama pada image sebelum menjalankannya:

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

Pemecahan masalah #

Container langsung keluar dengan "Invalid Localtonet headless configuration"

Pesan lengkapnya adalah Invalid Localtonet headless configuration. Check the token file or environment settings. Klien tidak menemukan token yang dapat dipakai: tidak ada yang diberikan, nilainya tidak sepanjang 33 karakter, mengandung spasi atau pemisah baris di tengah, atau path file token tidak ada di dalam container. Jika Anda me-mount file token, periksa di host bahwa itu file dan bukan direktori. Dengan kebijakan restart, container terus dimulai ulang sampai token diperbaiki, jadi baca docker logs localtonet.

Log menampilkan "Authentication failed: AuthToken was rejected."

Token berformat benar tetapi Localtonet tidak menerimanya. Salin lagi dari Token Saya dan buat ulang container.

Tunnel sudah dimulai tetapi alamat publik tidak sampai ke layanan saya

Periksa alamat lokal tunnel. 127.0.0.1 hanya berfungsi dengan --network host di Linux. Selain itu gunakan alamat IP LAN host. Nama seperti host.docker.internal atau nama container lain tidak berfungsi di kolom ini, seperti dijelaskan di Menjangkau layanan Anda dari container.

Container terus kehilangan koneksinya

Pastikan tidak ada klien lain yang memakai token yang sama. Klien kedua yang terhubung dengan token tersebut memutus yang pertama. Buat satu token per container atau perangkat di Token Saya.

Dukungan