Jalankan Localtonet di NAS atau Home Assistant
Templat penyiapan AMD64 dan ARM64
Di halaman ini 7 bagian
- Apa itu templat ini
- Yang bukan templat ini
- Sebelum memulai
- Menyiapkan NAS dengan Docker Compose
- Ekstrak ZIP dan salin folder nas ke NAS
- Buat file token
- Biarkan compose.yaml apa adanya
- Mulai proyek
- Buat dan mulai tunnel
- Cara kerja templat Compose
- Menyiapkan Home Assistant OS atau Supervised
- Salin folder aplikasi
- Muat ulang toko aplikasi dan pasang Localtonet
- Masukkan token Anda dan mulai aplikasi
- Buat dan mulai tunnel
- Menjangkau layanan Anda
- Log dan pembaruan
- Halaman terkait
Localtonet menyediakan templat deployment yang menjalankan klien Localtonet sebagai kontainer di NAS yang mendukung Docker dan di Home Assistant. Anda menambahkan AuthToken, memulai kontainer, lalu mengelola tunnel di dasbor.
Apa itu templat ini #
Unduhannya berupa arsip ZIP kecil berisi dua templat, lima file semuanya:
| Templat | Dipakai di | File | Yang Anda ubah |
|---|---|---|---|
NAS / Docker Compose (folder nas) | Synology Container Manager, QNAP Container Station, NAS lain yang menjalankan Docker, serta host Home Assistant Container atau Core | nas/compose.yaml dan nas/auth-token.example | Hanya token: salin auth-token.example menjadi auth-token dan ganti DUMMY_AUTH_TOKEN dengan AuthToken Anda. Biarkan compose.yaml apa adanya. |
Aplikasi Home Assistant (folder home-assistant) | Home Assistant OS dan Home Assistant Supervised | home-assistant/localtonet/config.json, definisi aplikasi lokal (dulu disebut add-on), dan home-assistant/repository.json | Tidak ada yang perlu diubah di file. Anda memasukkan token di Home Assistant setelah memasang aplikasinya. Instalasi lokal tidak memakai repository.json. |
File kelima, README.txt, adalah versi teks singkat dari langkah-langkah di halaman ini.
Kedua templat menjalankan klien Localtonet di dalam kontainer, tanpa prompt, seperti dijelaskan di halaman Docker. Templat dibuat untuk AMD64 (prosesor Intel dan AMD) dan ARM64. Periksa prosesor NAS Anda sebelum mulai; NAS ARM 32-bit tidak dapat menjalankannya.
Yang bukan templat ini #
- Templat ini bukan paket Synology SPK atau QNAP QPKG. Tidak ada yang muncul di Package Center Synology atau App Center QNAP.
- Templat Home Assistant bukan entri di toko resmi Home Assistant. Anda memasangnya sebagai aplikasi lokal.
- Templat tidak berisi image kontainer. Perangkat Anda menarik image yang disebut templat,
docker.io/localtonet/localtonet, yaitu image dari halaman Docker di Docker Hub. - Templat tidak memberi kontainer hak istimewa yang dibutuhkan antarmuka VPN. Templat ini untuk tunnel; fitur VPN bukan bagian darinya.
Sebelum memulai #
- NAS yang mendukung Docker dan Docker Compose, atau Home Assistant OS / Supervised.
- AuthToken dari Token Saya. Gunakan token yang tidak dipakai perangkat lain: saat klien kedua terhubung dengan token yang sama, klien pertama diputus.
- ZIP templat. Unduhannya ada di daftar di akhir halaman ini dan di halaman Unduhan.
Menyiapkan NAS dengan Docker Compose #
-
Ekstrak ZIP dan salin folder nas ke NAS #
Ekstrak arsip di komputer Anda. Salin folder
naske folder bersama di NAS yang dapat dipakai pengelola kontainer Anda. -
Buat file token #
Di folder
nas, salinauth-token.examplemenjadiauth-token. Bukaauth-tokendan gantiDUMMY_AUTH_TOKENdengan AuthToken Anda, dalam satu baris tanpa isi lain di file.Jaga kerahasiaan file token. Batasi aksesnya hanya untuk akun Anda sendiri di NAS dan jangan letakkan di folder bersama atau folder sinkronisasi yang dapat dibaca orang lain. Token memungkinkan klien Localtonet terhubung sebagai perangkat ini.
File harus ada sebelum kontainer dimulai. Jika tidak ada, Docker membuat direktori bernama
auth-tokensebagai gantinya, dan kontainer tidak dapat membaca token darinya. -
Biarkan compose.yaml apa adanya #
Anda tidak perlu mengedit
compose.yaml. Barisimage:-nya menyebut image Localtonet dan versi yang menjadi dasar ZIP ini, misalnyadocker.io/localtonet/localtonet:8.6.0. Baris lainnya dijelaskan di Cara kerja templat Compose. -
Mulai proyek #
Impor
compose.yamlsebagai proyek di pengelola kontainer Anda lalu mulai:- Synology: di Container Manager, buat proyek dari folder
nasbesertacompose.yaml-nya. - QNAP: di Container Station, buat aplikasi dari
compose.yaml. File ini me-mount./auth-tokenrelatif terhadap file Compose, jadi file token harus dapat dijangkau di path tersebut. - Host Docker mana pun dengan shell: jalankan perintah di bawah dari direktori
nas.
Bashdocker compose up -dTampilan layarnya berbeda antar model dan versi NAS. Ikuti dokumentasi vendor Anda untuk membuat proyek dari file Compose.
- Synology: di Container Manager, buat proyek dari folder
-
Buat dan mulai tunnel #
Saat kontainer berjalan, buka dasbor, buat tunnel dengan token yang Anda letakkan di file, lalu pilih Mulai, seperti di Mulai cepat.
Cara kerja templat Compose #
Ini seluruh isi file. Tag di akhir baris image: adalah versi Localtonet yang menjadi dasar ZIP Anda; 8.6.0 hanyalah contoh.
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| Pengaturan | Fungsinya |
|---|---|
image | Image Localtonet, docker.io/localtonet/localtonet, dan versi yang dijalankan. Ubah tag hanya saat Anda pindah ke versi lain, lihat Log dan pembaruan. |
restart: unless-stopped | Docker memulai kontainer lagi setelah reboot atau crash, kecuali Anda sendiri yang menghentikannya. |
network_mode: host | Kontainer berbagi jaringan NAS. Dengan begitu tunnel dapat menjangkau layanan di NAS itu sendiri di 127.0.0.1 dan perangkat lain di LAN Anda pada alamat LAN-nya. Ini membutuhkan host networking Linux. |
LOCALTONET_HEADLESS | Menjalankan klien tanpa prompt, dengan baris log polos. |
LOCALTONET_AUTH_TOKEN_FILE | Path, di dalam kontainer, file tempat klien membaca token. |
volumes | Me-mount file auth-token Anda sebagai read-only di path tersebut. |
Menyiapkan Home Assistant OS atau Supervised #
Home Assistant OS dan Supervised menjalankan aplikasi melalui Supervisor. Templatnya adalah aplikasi lokal yang Anda salin ke perangkat.
-
Salin folder aplikasi #
Ekstrak ZIP. Salin folder
home-assistant/localtonetke direktori aplikasi lokal Home Assistant Anda, sehingga menjadi/addons/localtonet. Folder berisi satu file,config.json. Jangan mengeditnya: file itu menamai aplikasi Localtonet, imagedocker.io/localtonet/localtonet, dan versi yang menjadi dasar ZIP ini, serta membiarkan opsiauthtokenkosong untuk Anda isi nanti. -
Muat ulang toko aplikasi dan pasang Localtonet #
Muat ulang toko aplikasi di Home Assistant agar menemukan aplikasi lokal, lalu pasang Localtonet.
-
Masukkan token Anda dan mulai aplikasi #
Buka halaman Configuration aplikasi, masukkan AuthToken Anda pada opsi
authtoken, lalu mulai aplikasi. Home Assistant menyembunyikan nilainya seperti kata sandi. Mulai saat itu aplikasi berjalan otomatis bersama Home Assistant. -
Buat dan mulai tunnel #
Buat tunnel dengan token itu di dasbor dan pilih Mulai. Untuk mempublikasikan Home Assistant sendiri, buat tunnel HTTP ke
127.0.0.1dan port yang didengarkan Home Assistant Anda. Port default Home Assistant adalah8123. Home Assistant punya pengaturan sendiri untuk permintaan yang datang melalui proxy; jika permintaan ditolak, lihat dokumentasi HTTP Home Assistant.
Aplikasi memakai host networking, sehingga menjangkau Home Assistant dan perangkat lain di jaringan Anda secara langsung. Aplikasi mendukung arsitektur Home Assistant amd64 dan aarch64.
Home Assistant Container dan Core tidak memiliki Supervisor, sehingga tidak dapat memasang aplikasi. Pada instalasi tersebut, gunakan templat NAS / Docker Compose di host Docker.
File home-assistant/repository.json berada di luar folder yang Anda salin dan bukan bagian dari instalasi lokal. File ini berisi nilai placeholder (DUMMY) untuk URL repositori dan maintainer; abaikan saja.
Menjangkau layanan Anda #
Kedua templat memakai host networking. Di kolom Alamat IP lokal sebuah tunnel:
127.0.0.1adalah NAS atau host Home Assistant itu sendiri. Pakai untuk antarmuka web NAS, Home Assistant, atau layanan lain di perangkat itu, dengan port yang didengarkan layanan tersebut.- Alamat LAN seperti
192.168.1.20menjangkau perangkat lain di jaringan Anda.
Tunnel yang sudah dimulai dapat dijangkau dari internet. Sebelum Anda mempublikasikan halaman login NAS atau Home Assistant, gunakan kata sandi yang kuat dan login dua faktor pada layanan itu sendiri, dan pertimbangkan opsi di halaman Kontrol akses.
Log dan pembaruan #
Kontainer menulis baris log polos: status koneksinya, nama token tempat ia masuk, dan satu baris setiap kali tunnel ditambahkan, berubah status, atau dihapus. Bacalah di tampilan log pengelola kontainer Anda, di tab Log aplikasi di Home Assistant, atau dengan:
docker compose logs -f localtonetBaris Invalid Localtonet headless configuration. Check the token file or environment settings. berarti klien tidak menemukan token yang dapat dipakai: file token tidak ada atau kosong, masih berisi DUMMY_AUTH_TOKEN, atau token tidak berjumlah 33 karakter. Authentication failed: AuthToken was rejected. berarti token berformat benar tetapi Localtonet tidak menerimanya.
Setiap ZIP templat dibuat untuk satu versi Localtonet: file Compose menguncinya pada tag di baris image:, aplikasi Home Assistant pada kolom version di config.json. Untuk memindahkan NAS ke versi yang lebih baru, ubah tag ke versi yang didaftarkan Docker Hub untuk image tersebut (lihat Docker) dan jalankan docker compose up -d lagi (atau perbarui proyek di pengelola kontainer Anda). File auth-token Anda tidak berubah.
Halaman terkait #
NAS & Home Assistant
Template Docker Compose untuk Synology Container Manager, QNAP Container Station, dan perangkat NAS lain yang mendukung Docker, serta template aplikasi Home Assistant untuk OS / Supervised. AMD64 dan ARM64.
Ini adalah template penyiapan, bukan installer SPK / QPKG atau listing resmi di store Home Assistant. Image Docker yang sesuai harus tersedia di registry. Pengguna Home Assistant Container / Core dapat memakai template Compose.
Siapkan NAS atau Home Assistant Anda
- Ekstrak ZIP dan baca
README.txt. - Untuk NAS, salin
nas/auth-token.examplekenas/auth-tokendan masukkan AuthToken Anda. Jaga kerahasiaan file ini. - Periksa tag image di
nas/compose.yaml, lalu impor sebagai proyek atau jalankandocker compose up -ddari direktorinas. - Untuk Home Assistant OS / Supervised, ikuti petunjuk instalasi aplikasi lokal di README dan masukkan token di konfigurasi aplikasi.
Template ini menggunakan host networking Linux untuk akses LAN. Template ini tidak mengaktifkan hak akses VPN.