Jalankan Localtonet di Docker
Di halaman ini 12 bagian
- Sebelum memulai
- Langkah
- Tarik image
- Mulai container dengan token Anda
- Buat dan mulai tunnel
- Cara container berjalan
- Jalankan di latar belakang dan mulai ulang otomatis
- Cara memberikan token
- Docker Compose
- Menjangkau layanan Anda dari container
- Baca log
- Pembaruan
- Arsip image untuk host tanpa akses registry
- Pemecahan masalah
- 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/amd64danlinux/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 #
-
Tarik image #
Menarik image terlebih dahulu memastikan Anda menjalankan versi terbaru, bukan image lama yang masih ada di host.
Bashdocker pull localtonet/localtonetImage tersedia di Docker Hub. Selain
latest, Docker Hub mencantumkan tag untuk setiap versi jika Anda ingin mengunci rilis tertentu. -
Mulai container dengan token Anda #
Semua yang ada setelah nama image diteruskan ke klien Localtonet. Ganti
<YOUR_TOKEN>dengan AuthToken Anda.Bashdocker run localtonet/localtonet --authtoken <YOUR_TOKEN>Container mencetak status koneksinya dan tetap berjalan di latar depan. Tekan Ctrl + C untuk menghentikannya.
-
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.1berarti 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:
docker run -d \
--name localtonet \
--restart unless-stopped \
localtonet/localtonet --authtoken <YOUR_TOKEN>Kelola dengan perintah Docker biasa:
| Perintah | Fungsinya |
|---|---|
docker ps | Mencantumkan container yang berjalan. |
docker logs -f localtonet | Mengikuti log klien. |
docker stop localtonet | Menghentikan klien. Tunnel-nya menjadi offline. |
docker start localtonet | Memulainya lagi dengan token yang sama. |
docker rm -f localtonet | Menghapus 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:
| Sumber | Cara memakainya | Catatan |
|---|---|---|
--authtoken <YOUR_TOKEN> | Argumen setelah nama image. | Paling sederhana. Menang atas LOCALTONET_AUTH_TOKEN. |
LOCALTONET_AUTH_TOKEN | Variabel lingkungan yang berisi token. | Dipakai jika tidak ada argumen --authtoken. |
LOCALTONET_AUTH_TOKEN_FILE | Variabel 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:
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/localtonetBuat 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.
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 #
Penyiapan yang sama sebagai file Compose. Letakkan token di file bernama auth-token di samping 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:rodocker compose up -d
docker compose logs -f localtonetJika 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:
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:roUntuk 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 berjalan | Alamat lokal yang dimasukkan | Yang juga dibutuhkan |
|---|---|---|
| Di host Docker, Linux | 127.0.0.1 | Mulai 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.10 | Layanan harus mendengarkan di alamat yang dapat dijangkau container, bukan hanya di 127.0.0.1, dan firewall host harus mengizinkan koneksi. |
| Di container lain | 127.0.0.1 dengan --network host di Linux, selain itu alamat IP LAN host | Publikasikan port container tersebut di host (-p, Compose: ports) dan gunakan port yang dipublikasikan sebagai port lokal tunnel. |
| Di perangkat lain di jaringan Anda | Alamat IP LAN perangkat tersebut, misalnya 192.168.1.20 | Tidak ada. |
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:
| Baris | Arti |
|---|---|
Localtonet - headless log | Klien 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:
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:
| Arsitektur | Arsip |
|---|---|
| AMD64 | localtonet-docker-amd64.tar |
| ARM64 | localtonet-docker-arm64.tar |
docker load --input localtonet-docker-amd64.tardocker load mencetak apa yang dimuat. Jika yang dicetak adalah ID image dan bukan nama, beri nama pada image sebelum menjalankannya:
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.