Langsung ke konten
Localtonet Localtonet Dasbor

Jalankan Localtonet di NAS atau Home Assistant

Templat penyiapan AMD64 dan ARM64

Bantuan untuk halaman ini
Di halaman ini 7 bagian
  1. Apa itu templat ini
  2. Yang bukan templat ini
  3. Sebelum memulai
  4. Menyiapkan NAS dengan Docker Compose
  5. Ekstrak ZIP dan salin folder nas ke NAS
  6. Buat file token
  7. Biarkan compose.yaml apa adanya
  8. Mulai proyek
  9. Buat dan mulai tunnel
  10. Cara kerja templat Compose
  11. Menyiapkan Home Assistant OS atau Supervised
  12. Salin folder aplikasi
  13. Muat ulang toko aplikasi dan pasang Localtonet
  14. Masukkan token Anda dan mulai aplikasi
  15. Buat dan mulai tunnel
  16. Menjangkau layanan Anda
  17. Log dan pembaruan
  18. 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:

TemplatDipakai diFileYang Anda ubah
NAS / Docker Compose (folder nas)Synology Container Manager, QNAP Container Station, NAS lain yang menjalankan Docker, serta host Home Assistant Container atau Corenas/compose.yaml dan nas/auth-token.exampleHanya 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 Supervisedhome-assistant/localtonet/config.json, definisi aplikasi lokal (dulu disebut add-on), dan home-assistant/repository.jsonTidak 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 #

  1. Ekstrak ZIP dan salin folder nas ke NAS #

    Ekstrak arsip di komputer Anda. Salin folder nas ke folder bersama di NAS yang dapat dipakai pengelola kontainer Anda.

  2. Buat file token #

    Di folder nas, salin auth-token.example menjadi auth-token. Buka auth-token dan ganti DUMMY_AUTH_TOKEN dengan 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-token sebagai gantinya, dan kontainer tidak dapat membaca token darinya.

  3. Biarkan compose.yaml apa adanya #

    Anda tidak perlu mengedit compose.yaml. Baris image:-nya menyebut image Localtonet dan versi yang menjadi dasar ZIP ini, misalnya docker.io/localtonet/localtonet:8.6.0. Baris lainnya dijelaskan di Cara kerja templat Compose.

  4. Mulai proyek #

    Impor compose.yaml sebagai proyek di pengelola kontainer Anda lalu mulai:

    • Synology: di Container Manager, buat proyek dari folder nas beserta compose.yaml-nya.
    • QNAP: di Container Station, buat aplikasi dari compose.yaml. File ini me-mount ./auth-token relatif 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.
    Bash
    docker compose up -d

    Tampilan layarnya berbeda antar model dan versi NAS. Ikuti dokumentasi vendor Anda untuk membuat proyek dari file Compose.

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

nas/compose.yaml
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
PengaturanFungsinya
imageImage Localtonet, docker.io/localtonet/localtonet, dan versi yang dijalankan. Ubah tag hanya saat Anda pindah ke versi lain, lihat Log dan pembaruan.
restart: unless-stoppedDocker memulai kontainer lagi setelah reboot atau crash, kecuali Anda sendiri yang menghentikannya.
network_mode: hostKontainer 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_HEADLESSMenjalankan klien tanpa prompt, dengan baris log polos.
LOCALTONET_AUTH_TOKEN_FILEPath, di dalam kontainer, file tempat klien membaca token.
volumesMe-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.

  1. Salin folder aplikasi #

    Ekstrak ZIP. Salin folder home-assistant/localtonet ke direktori aplikasi lokal Home Assistant Anda, sehingga menjadi /addons/localtonet. Folder berisi satu file, config.json. Jangan mengeditnya: file itu menamai aplikasi Localtonet, image docker.io/localtonet/localtonet, dan versi yang menjadi dasar ZIP ini, serta membiarkan opsi authtoken kosong untuk Anda isi nanti.

  2. Muat ulang toko aplikasi dan pasang Localtonet #

    Muat ulang toko aplikasi di Home Assistant agar menemukan aplikasi lokal, lalu pasang Localtonet.

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

  4. 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.1 dan port yang didengarkan Home Assistant Anda. Port default Home Assistant adalah 8123. 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.1 adalah 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.20 menjangkau 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:

Bash
docker compose logs -f localtonet

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

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
  1. Ekstrak ZIP dan baca README.txt.
  2. Untuk NAS, salin nas/auth-token.example ke nas/auth-token dan masukkan AuthToken Anda. Jaga kerahasiaan file ini.
  3. Periksa tag image di nas/compose.yaml, lalu impor sebagai proyek atau jalankan docker compose up -d dari direktori nas.
  4. 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.

Dukungan