Запуск Localtonet на NAS або в Home Assistant
Шаблони налаштування AMD64 і ARM64
На цій сторінці 7 розділів
- Що це за шаблони
- Чим вони не є
- Перш ніж почати
- Налаштування NAS через Docker Compose
- Розпакуйте ZIP і скопіюйте папку nas на NAS
- Створіть файл токена
- Залиште compose.yaml без змін
- Запустіть проєкт
- Створіть і запустіть тунель
- Що робить шаблон Compose
- Налаштування Home Assistant OS або Supervised
- Скопіюйте папку застосунку
- Перезавантажте магазин застосунків і встановіть Localtonet
- Введіть токен і запустіть застосунок
- Створіть і запустіть тунель
- Доступ до ваших сервісів
- Журнали та оновлення
- Пов’язані сторінки
Localtonet надає шаблони розгортання, які запускають клієнт Localtonet як контейнер на NAS із підтримкою Docker і в Home Assistant. Ви додаєте свій AuthToken, запускаєте контейнер, а потім керуєте тунелями на панелі керування.
Що це за шаблони #
Завантаження — це невеликий ZIP-архів із двома шаблонами, разом п'ять файлів:
| Шаблон | Де використовувати | Файли | Що змінити |
|---|---|---|---|
NAS / Docker Compose (папка nas) | Synology Container Manager, QNAP Container Station, будь-який інший NAS із Docker, а також хости Home Assistant Container або Core | nas/compose.yaml і nas/auth-token.example | Лише токен: скопіюйте auth-token.example у auth-token і замініть DUMMY_AUTH_TOKEN своїм AuthToken. Файл compose.yaml залиште без змін. |
Застосунок Home Assistant (папка home-assistant) | Home Assistant OS і Home Assistant Supervised | home-assistant/localtonet/config.json, опис локального застосунку (раніше — додатка, add-on), і home-assistant/repository.json | У файлах нічого. Токен ви вводите в Home Assistant після встановлення застосунку. Локальне встановлення не використовує repository.json. |
П'ятий файл, README.txt, — це коротка текстова версія кроків із цієї сторінки.
Обидва шаблони запускають клієнт Localtonet у контейнері без запитів, як описано на сторінці Docker. Вони розраховані на AMD64 (процесори Intel і AMD) та ARM64. Перед початком перевірте, який процесор у вашому NAS: 32-бітний ARM NAS їх запустити не може.
Чим вони не є #
- Це не пакети Synology SPK і не пакети QNAP QPKG. У Synology Package Center і QNAP App Center нічого не з'являється.
- Шаблон Home Assistant не є записом в офіційному магазині Home Assistant. Ви встановлюєте його як локальний застосунок.
- Вони не містять образ контейнера. Ваш пристрій завантажує образ, названий у шаблонах, —
docker.io/localtonet/localtonet, тобто образ зі сторінки Docker на Docker Hub. - Вони не надають контейнеру привілеїв, потрібних VPN-інтерфейсу. Шаблони призначені для тунелів; функція VPN до них не входить.
Перш ніж почати #
- NAS із підтримкою Docker і Docker Compose або Home Assistant OS / Supervised.
- AuthToken зі сторінки Мої токени. Використовуйте токен, який не використовує жоден інший пристрій: коли другий клієнт підключається з тим самим токеном, перший відключається.
- ZIP із шаблонами. Завантаження є в списку наприкінці цієї сторінки та на сторінці Завантаження.
Налаштування NAS через Docker Compose #
-
Розпакуйте ZIP і скопіюйте папку nas на NAS #
Розпакуйте архів на своєму комп'ютері. Скопіюйте папку
nasу спільну папку на NAS, яку може використовувати ваш менеджер контейнерів. -
Створіть файл токена #
У папці
nasскопіюйтеauth-token.exampleуauth-token. Відкрийтеauth-tokenі замінітьDUMMY_AUTH_TOKENсвоїм AuthToken в одному рядку, без будь-чого іншого у файлі.Тримайте файл токена в таємниці. Обмежте доступ до нього лише власним обліковим записом на NAS і не кладіть його в спільну чи синхронізовану папку, яку можуть читати інші люди. Токен дає змогу клієнту Localtonet підключатися як цей пристрій.
Файл має існувати до запуску контейнера. Якщо його немає, Docker замість нього створить каталог із назвою
auth-token, і контейнер не зможе прочитати з нього токен. -
Залиште compose.yaml без змін #
Редагувати
compose.yamlне потрібно. Рядокimage:у ньому вказує образ Localtonet і версію, для якої створено цей ZIP, наприкладdocker.io/localtonet/localtonet:8.6.0. Решту рядків пояснено в розділі Що робить шаблон Compose. -
Запустіть проєкт #
Імпортуйте
compose.yamlяк проєкт у своєму менеджері контейнерів і запустіть його:- Synology: у Container Manager створіть проєкт із папки
nasта їїcompose.yaml. - QNAP: у Container Station створіть застосунок із
compose.yaml. Файл монтує./auth-tokenвідносно файлу Compose, тож файл токена має бути доступний за цим шляхом. - Будь-який хост Docker з оболонкою: виконайте наведену нижче команду з каталогу
nas.
Bashdocker compose up -dТочні екрани відрізняються залежно від моделі та версії NAS. Дотримуйтеся документації виробника щодо створення проєкту з файлу Compose.
- Synology: у Container Manager створіть проєкт із папки
-
Створіть і запустіть тунель #
Коли контейнер працює, відкрийте панель керування, створіть тунель із токеном, який ви помістили у файл, і виберіть Запустити, як у Швидкому старті.
Що робить шаблон Compose #
Це весь файл. Тег наприкінці рядка image: — це версія Localtonet, для якої створено ваш ZIP; 8.6.0 — приклад.
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| Параметр | Що робить |
|---|---|
image | Образ Localtonet, docker.io/localtonet/localtonet, і версія для запуску. Змінюйте тег лише тоді, коли переходите на іншу версію, див. Журнали та оновлення. |
restart: unless-stopped | Docker знову запускає контейнер після перезавантаження або збою, якщо ви не зупинили його самі. |
network_mode: host | Контейнер використовує мережу NAS. Тоді тунель може звертатися до сервісів на самому NAS за адресою 127.0.0.1, а до інших пристроїв у вашій локальній мережі — за їхніми локальними адресами. Для цього потрібна мережа хоста Linux. |
LOCALTONET_HEADLESS | Запускає клієнт без запитів, зі звичайними рядками журналу. |
LOCALTONET_AUTH_TOKEN_FILE | Шлях усередині контейнера до файлу, з якого клієнт читає токен. |
volumes | Монтує ваш файл auth-token за цим шляхом лише для читання. |
Налаштування Home Assistant OS або Supervised #
Home Assistant OS і Supervised запускають застосунки через Supervisor. Шаблон — це локальний застосунок, який ви копіюєте на пристрій.
-
Скопіюйте папку застосунку #
Розпакуйте ZIP. Скопіюйте папку
home-assistant/localtonetу каталог локальних застосунків вашого Home Assistant, щоб вийшло/addons/localtonet. У папці один файл,config.json. Не редагуйте його: він називає застосунок Localtonet, образdocker.io/localtonet/localtonetі версію, для якої створено цей ZIP, а параметрauthtokenзалишає порожнім, щоб ви заповнили його пізніше. -
Перезавантажте магазин застосунків і встановіть Localtonet #
Перезавантажте магазин застосунків у Home Assistant, щоб він знайшов локальний застосунок, а потім встановіть Localtonet.
-
Введіть токен і запустіть застосунок #
Відкрийте сторінку Configuration застосунку, введіть свій AuthToken у параметр
authtokenі запустіть застосунок. Home Assistant приховує значення, як пароль. Відтоді застосунок запускається автоматично разом із Home Assistant. -
Створіть і запустіть тунель #
Створіть на панелі керування тунель із цим токеном і виберіть Запустити. Щоб опублікувати сам Home Assistant, створіть HTTP-тунель на
127.0.0.1і порт, який прослуховує ваш Home Assistant. Типовий порт Home Assistant —8123. Home Assistant має власні налаштування для запитів, що надходять через проксі; якщо він їх відхиляє, див. документацію Home Assistant про HTTP.
Застосунок використовує мережу хоста, тому напряму звертається до Home Assistant та інших пристроїв у вашій мережі. Він підтримує архітектури Home Assistant amd64 і aarch64.
Home Assistant Container і Core не мають Supervisor, тому не можуть встановлювати застосунки. На таких інсталяціях натомість скористайтеся шаблоном NAS / Docker Compose на хості Docker.
Файл home-assistant/repository.json лежить поза папкою, яку ви копіюєте, і не є частиною локального встановлення. Він містить значення-заповнювачі (DUMMY) для URL репозиторію та супровідника; ігноруйте його.
Доступ до ваших сервісів #
Обидва шаблони використовують мережу хоста. У полі Локальна IP-адреса тунелю:
127.0.0.1— це сам NAS або хост Home Assistant. Використовуйте її для вебінтерфейсу NAS, Home Assistant чи будь-якого іншого сервісу на цьому пристрої, з портом, який прослуховує цей сервіс.- Локальна адреса на кшталт
192.168.1.20дає доступ до іншого пристрою у вашій мережі.
Запущений тунель доступний з інтернету. Перш ніж публікувати сторінку входу NAS або Home Assistant, використовуйте на самому сервісі надійні паролі та двофакторний вхід і розгляньте можливості зі сторінки Контроль доступу.
Журнали та оновлення #
Контейнер записує звичайні рядки журналу: стан підключення, назву токена, з яким він увійшов, і рядок щоразу, коли тунель додається, змінює статус або видаляється. Читайте їх в огляді журналу вашого менеджера контейнерів, на вкладці Log застосунку в Home Assistant або командою:
docker compose logs -f localtonetРядок Invalid Localtonet headless configuration. Check the token file or environment settings. означає, що клієнт не знайшов придатного токена: файл токена відсутній або порожній, досі містить DUMMY_AUTH_TOKEN або токен не має довжини 33 символи. Authentication failed: AuthToken was rejected. означає, що токен має правильний формат, але Localtonet його не приймає.
Кожен ZIP із шаблонами створено для однієї версії Localtonet: файл Compose закріплює її в тегу рядка image:, застосунок Home Assistant — у полі version файлу config.json. Щоб перевести NAS на новішу версію, змініть тег на версію, яку Docker Hub показує для цього образу (див. Docker), і знову виконайте docker compose up -d (або оновіть проєкт у менеджері контейнерів). Файл auth-token залишається без змін.
Пов’язані сторінки #
NAS і Home Assistant
Шаблони Docker Compose для Synology Container Manager, QNAP Container Station та інших NAS із підтримкою Docker, а також шаблон застосунку Home Assistant для OS / Supervised. AMD64 і ARM64.
Це шаблони налаштування, а не інсталятори SPK / QPKG і не офіційний застосунок у магазині Home Assistant. У реєстрі має бути відповідний образ Docker. Користувачі Home Assistant Container / Core можуть скористатися шаблоном Compose.
Налаштуйте NAS або Home Assistant
- Розпакуйте ZIP і прочитайте
README.txt. - Для NAS скопіюйте
nas/auth-token.exampleуnas/auth-tokenі впишіть свій AuthToken. Нікому не показуйте цей файл. - Перевірте тег образу в
nas/compose.yaml, потім імпортуйте його як проєкт або виконайтеdocker compose up -dу папціnas. - Для Home Assistant OS / Supervised виконайте інструкції зі встановлення локального застосунку з README і введіть токен у конфігурації застосунку.
Шаблони використовують мережу хоста Linux для доступу до LAN. Вони не надають привілеїв VPN.