Home Assistant Apps: Add-on Docker Chính Thức

Home Assistant Apps Là Gì?

Home Assistant Apps là repo chính thức chứa các tiện ích mở rộng dựa trên Docker, đổi tên từ "add-ons", bổ sung dịch vụ hỗ trợ xung quanh một cài đặt Home Assistant thay vì nằm trong chính codebase Home Assistant. Một số app là dịch vụ độc lập mà Home Assistant giao tiếp tới, như MQTT broker Mosquitto hay database MariaDB; số khác can thiệp trực tiếp vào cấu hình Home Assistant, như chia sẻ file Samba hay File Editor trên trình duyệt.

Các App Chính Trong Repository Này

• ✓Mosquitto broker mang lại một MQTT broker tự host cho Home Assistant, còn MariaDB bổ sung một backend database SQL đầy đủ thay cho recorder mặc định.
• ✓deCONZ và Z-Wave JS bắc cầu phần cứng Zigbee và Z-Wave vào Home Assistant — deCONZ qua USB ConBee hoặc RaspBee của dresden elektronik, Z-Wave JS qua bộ điều khiển Z-Wave USB.
• ✓Let's Encrypt và NGINX SSL proxy xử lý việc cấp chứng chỉ và định tuyến traffic bên ngoài qua HTTPS ở cổng 443, redirect từ cổng 80.
• ✓Duck DNS giữ một hostname dynamic DNS luôn trỏ đúng IP của bạn và tích hợp sẵn hỗ trợ HTTPS qua Let's Encrypt.
• ✓SSH server và app File editor (configurator) cho bạn một terminal và một trình chỉnh sửa cấu hình chạy trên trình duyệt mà không cần cài thêm gì ngoài Home Assistant.
• ✓Samba share chia sẻ thư mục cấu hình Home Assistant qua giao thức chia sẻ file Windows để bạn sửa YAML từ máy khác.
• ✓Git pull đồng bộ file cấu hình Home Assistant từ một repository Git, còn CEC Scanner và Dnsmasq bổ sung khả năng dò thiết bị HDMI-CEC và một DNS server gọn nhẹ.
• ✓RPC Shutdown tắt máy Windows từ xa ngay trong Home Assistant.

Cách Cài Đặt Home Assistant Apps

Việc cài đặt diễn ra hoàn toàn trong giao diện Home Assistant: mỗi app trong repo này được thêm vào và cấu hình ngay từ frontend, trên bất kỳ hệ thống nào đã chạy sẵn Home Assistant. README không đi sâu vào cơ chế add-on store như cách thêm repo này làm nguồn tuỳ chỉnh, hay các bước kèm ảnh chụp màn hình, nên hãy coi luồng thao tác trên frontend là cách được ghi nhận. Xem README riêng của từng app (có link trong repo) để biết tuỳ chọn cấu hình cụ thể — chẳng hạn deCONZ cần pass-through một thiết bị ConBee hoặc RaspBee, trong khi Mosquitto chỉ cần khởi động.

Tự Phát Triển App Của Riêng Bạn

Câu Hỏi Thường Gặp

Vấn đề nó giải quyết

Dựng một stack smart-home đầy đủ thường có nghĩa là chạy thêm vài dịch vụ tách biệt cạnh Home Assistant: một MQTT broker cho tích hợp Zigbee/Z-Wave, một database đúng nghĩa thay vì SQLite, một reverse proxy cho HTTPS. Bình thường điều đó nghĩa là phải học Docker Compose, tự viết config container, rồi tự cập nhật chúng bằng tay. Home Assistant Apps đóng gói sẵn đúng những dịch vụ đi kèm đó thành các container dựng sẵn mà bạn thêm ngay từ frontend bạn vẫn dùng cho Home Assistant, nên các mảnh xung quanh setup của bạn không đòi hỏi kiến thức hạ tầng riêng để chạy.

Trường hợp sử dụng tốt nhất

• •Bắc cầu phần cứng Zigbee vào Home Assistant bằng deCONZ, khi bạn có USB ConBee hoặc RaspBee của dresden elektronik.
• •Đổi database recorder mặc định của Home Assistant sang MariaDB khi SQLite bắt đầu ì ạch sau nhiều năm lưu lịch sử.
• •Đưa Home Assistant ra internet bằng NGINX SSL proxy và Let's Encrypt, thay vì tự viết container reverse-proxy từ đầu.
• •Sửa cấu hình YAML từ máy khác qua Samba, hoặc ngay trên trình duyệt với app File editor, mà không cần SSH vào trước.
• •Giữ cấu hình Home Assistant trong version control và tự động pull cập nhật bằng Git pull.

Ai nên dùng — và ai nên bỏ qua

Hãy thử Home Assistant Apps nếu bạn đang chạy sẵn Home Assistant và muốn thêm các mảnh hạ tầng — MQTT broker, một database thật sự, bắc cầu Zigbee/Z-Wave, HTTPS — ngay từ cùng một frontend thay vì tự dựng container Docker cạnh nó. Bỏ qua nếu bạn không chạy Home Assistant, hoặc thứ bạn thực sự cần là sửa automation hay dashboard, vì các app này không đụng tới automation engine của Home Assistant.

Repo liên quan