Chuyển đến nội dung

home-assistant / core

Home Assistant

Trung tâm nhà thông minh mã nguồn mở, điều khiển thiết bị ngay trong mạng nhà, ưu tiên riêng tư

Home Assistant là phần mềm tự động hoá nhà thông minh chạy tại nhà bạn: gom đèn, công tắc, cảm biến, điều hoà, camera của nhiều hãng vào một giao diện và cho bạn đặt kịch bản tự động. Ưu tiên điều khiển cục bộ và riêng tư. README gợi ý chạy trên Raspberry Pi hoặc máy chủ nhỏ. Giấy phép Apache-2.0, do cộng đồng và Open Home Foundation duy trì.

  • 92.331 sao
  • 39.344 fork
  • Python
  • Cập nhật hôm nay
  • Apache 2.0 (dùng tự do, kể cả thương mại)
Độ khó
Vừa Cần gõ vài lệnh hoặc dùng Docker
Dạng
Web tự cài (self-host)
Chạy trên
Linux, Docker, Web, Windows, macOS, Android, iOS
Chi phí
Miễn phí hoàn toàn

Trải nghiệm khi dùng Home Assistant

Bạn chọn một cách cài: mua thiết bị Home Assistant Green dựng sẵn, nạp hệ điều hành Home Assistant lên Raspberry Pi hoặc máy tính nhỏ, hoặc chạy bằng Docker hay máy ảo. Sau khi khởi động xong, bạn mở trình duyệt vào địa chỉ của nó (thường là homeassistant.local ở cổng 8123, hoặc địa chỉ IP của máy) và đi qua màn hình làm quen đầu tiên.

Home Assistant sẽ tự tìm các thiết bị trong mạng nhà và gợi ý thêm. Mỗi thiết bị được thêm bằng một mục tích hợp (integration), hiện có rất nhiều hãng trong trang tích hợp chính thức. Bảng điều khiển (dashboard) cho thấy trạng thái đèn, nhiệt độ, ổ cắm điện; bấm là điều khiển được.

Sức mạnh thật nằm ở tự động hoá: ví dụ khi cảm biến phát hiện chuyển động lúc tối thì bật đèn hành lang, hay tắt hết đèn khi cả nhà ra khỏi nhà. Việc này không khó nhưng cần thời gian làm quen, và mỗi hãng thiết bị lại có cách kết nối riêng.

Tính năng nổi bật

Gom nhiều hãng vào một nơi

Mô hình dạng mô-đun giúp hỗ trợ rất nhiều thiết bị và dịch vụ thông qua các tích hợp.

Điều khiển cục bộ, riêng tư

Định hướng của dự án là điều khiển ngay trong mạng nhà và giữ riêng tư, thay vì đi vòng qua đám mây của từng hãng.

Tự động hoá bằng kịch bản

Tạo quy tắc tự động theo thời gian, cảm biến hay trạng thái thiết bị.

Nhiều cách chạy

Thiết bị dựng sẵn Green, Raspberry Pi, máy x86-64, Docker hoặc máy ảo, hợp từng mức kinh nghiệm.

Cộng đồng lớn

Có demo trực tuyến, tài liệu, hướng dẫn tự động hoá và cộng đồng người dùng đông đảo.

Tận dụng Home Assistant vào việc gì?

Gia đình có thiết bị thông minh

Tự động hoá đèn và điều hoà trong nhà

Hẹn giờ, bật theo cảm biến, tắt khi cả nhà đi vắng để tiết kiệm điện.

Người đã mua rải rác nhiều thiết bị

Gom thiết bị nhiều hãng vào một app

Thay vì mở mỗi hãng một ứng dụng, điều khiển hết từ một bảng điều khiển.

Người thích số liệu

Theo dõi điện nước và cảm biến

Xem biểu đồ nhiệt độ, độ ẩm và các thông số khác theo thời gian.

Người thích DIY, sinh viên điện tử

Dự án mày mò tại nhà

Nối thiết bị tự làm với Home Assistant để học về IoT và tự động hoá.

Cần chuẩn bị gì?

  • Một thiết bị chạy liên tục: Raspberry Pi 4 hoặc 5 (tối thiểu 2 GB RAM theo trang cài đặt), máy x86-64, hoặc thiết bị Home Assistant Green.
  • Thiết bị nhà thông minh có thể kết nối với Home Assistant; mỗi hãng có yêu cầu riêng.
  • Cho cách cài bằng Docker hoặc máy ảo: kinh nghiệm dòng lệnh, container hoặc ảo hoá.
  • Mạng nhà ổn định để Home Assistant và thiết bị cùng mạng nội bộ.

Hướng dẫn cài đặt chi tiết

Cài trên Raspberry Pi (Home Assistant OS)

  1. Tải Raspberry Pi Imager ở trang chính thức của Raspberry Pi và cắm thẻ nhớ vào máy tính (nội dung thẻ sẽ bị xoá).

    Văn bản
    https://www.raspberrypi.com/software/
  2. Trong Imager bấm OS, chọn Other specific-purpose OS, rồi Home automation, rồi Home Assistant. Chọn đúng bản cho board của bạn (RPi 4 hoặc RPi 5), chọn thẻ nhớ, bấm Next rồi Write và đợi ghi xong.

  3. Cắm thẻ vào Pi, nối cáp mạng Ethernet cùng mạng với máy tính (có internet), rồi cắm nguồn.

  4. Đợi khoảng một đến vài phút rồi mở địa chỉ sau trên máy tính. Nếu không vào được, thử http://homeassistant hoặc IP của Pi kèm cổng 8123. Quá 5 phút vẫn không lên thì ghi lại thẻ nhớ (hoặc thử thẻ khác), hoặc nối màn hình HDMI để xem thông báo.

    Văn bản
    http://homeassistant.local:8123
  5. Máy x86-64, thiết bị Home Assistant Green hoặc máy ảo (VirtualBox, KVM, VMware; tối thiểu 2 GB RAM và 2 vCPU, bật UEFI) có trang hướng dẫn riêng; xem trang cài đặt chính thức.

    Văn bản
    https://www.home-assistant.io/installation/

Cài trên Docker

  1. Cần Docker Engine 23.0.0 trở lên trên Linux (Docker Desktop không được hỗ trợ). Thay /DUONG/DAN/CAU/HINH bằng thư mục bạn muốn lưu cấu hình và MUI_GIO bằng múi giờ, ví dụ Asia/Ho_Chi_Minh. Dòng /run/dbus chỉ cần nếu dùng Bluetooth.

    Terminal
    docker run -d \
      --name homeassistant \
      --privileged \
      --restart=unless-stopped \
      -e TZ=MUI_GIO \
      -v /DUONG/DAN/CAU/HINH:/config \
      -v /run/dbus:/run/dbus:ro \
      --network=host \
      ghcr.io/home-assistant/home-assistant:stable
  2. Hoặc dùng Docker Compose: lưu nội dung sau thành compose.yaml (sửa đường dẫn cấu hình và TZ) rồi chạy docker compose up -d.

    YAML
    services:
      homeassistant:
        container_name: homeassistant
        image: "ghcr.io/home-assistant/home-assistant:stable"
        volumes:
          - /DUONG/DAN/CAU/HINH:/config
          - /etc/localtime:/etc/localtime:ro
          - /run/dbus:/run/dbus:ro
        restart: unless-stopped
        stop_grace_period: 60s
        privileged: true
        network_mode: host
        environment:
          TZ: Asia/Ho_Chi_Minh
  3. Mở trình duyệt vào địa chỉ máy chủ ở cổng 8123 và làm theo màn hình thiết lập ban đầu.

    Văn bản
    http://IP_MAY_CHU:8123
  4. Cập nhật: kéo image mới, dừng và xoá container cũ rồi chạy lại đúng lệnh docker run ở trên (cấu hình vẫn còn vì nằm trong thư mục /config).

    Terminal
    docker pull ghcr.io/home-assistant/home-assistant:stable
    docker stop homeassistant
    docker rm homeassistant
  5. Lưu ý: cài kiểu Container không có ứng dụng bổ sung (add-on); docs khuyên Home Assistant OS cho đa số người dùng. Chi tiết xem trang cài đặt Linux.

    Văn bản
    https://www.home-assistant.io/installation/linux/

Dùng thử lần đầu

  1. Mở trang Home Assistant lần đầu và tạo tài khoản quản trị. Bước này cũng hỏi vị trí nhà của bạn để tính giờ mặt trời và múi giờ.

  2. Để Home Assistant dò thiết bị trong mạng, rồi thêm các thiết bị nó tìm thấy hoặc thêm tích hợp thủ công cho hãng bạn dùng.

  3. Mở bảng điều khiển, thử bật tắt một đèn hoặc ổ cắm để chắc chắn kết nối hoạt động.

  4. Tạo một tự động hoá đơn giản như bật đèn lúc trời tối, theo hướng dẫn tự động hoá trên trang tài liệu.

Mẹo dùng hay

  • Bắt đầu với vài thiết bị là đủ, rồi mở rộng dần; thêm quá nhiều một lúc dễ rối.
  • Cài app Home Assistant trên điện thoại (từ cửa hàng ứng dụng chính thức) để điều khiển và nhận thông báo.
  • Sao lưu cấu hình định kỳ; nâng cấp lớn có thể ảnh hưởng tích hợp cũ, nên đọc ghi chú phát hành.

Lưu ý và hạn chế

  • README của repo core rất ngắn và dẫn sang trang home-assistant.io; hướng dẫn cài chi tiết và yêu cầu nằm trên trang đó.
  • Cần thời gian làm quen; một số thiết bị cần thiết lập riêng hoặc chỉ hoạt động qua đám mây của hãng.
  • Nếu cho truy cập từ ngoài internet, phải bảo mật kỹ vì hệ thống điều khiển thiết bị trong nhà bạn.

Câu hỏi thường gặp

Home Assistant có miễn phí không?

Phần mềm miễn phí, mã nguồn mở Apache-2.0. Bạn trả tiền phần cứng chạy nó và các thiết bị nhà thông minh; Home Assistant Green là thiết bị bán sẵn.

Có tiếng Việt không?

README repo không nêu danh sách ngôn ngữ. Hãy kiểm tra phần ngôn ngữ trong phần cài đặt của Home Assistant sau khi cài.

Máy yếu chạy được không?

Trang cài đặt chính thức nêu Raspberry Pi 4 hoặc 5 với tối thiểu 2 GB RAM cho cách cài trên Pi. Các cách khác xem yêu cầu trên trang cài đặt tương ứng.

Tải mã nguồn về máy

Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.

Terminal
git clone https://github.com/home-assistant/core.git

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: Tự host & máy chủ nhà

Tự host & máy chủ nhà338K

Awesome-Selfhosted

awesome-selfhosted / awesome-selfhosted

Danh mục khổng lồ các phần mềm mã nguồn mở tự cài trên máy chủ của riêng bạn

DễWeb
Tự host & máy chủ nhà115K

Supabase

supabase / supabase

Nền tảng backend trên Postgres: cơ sở dữ liệu, đăng nhập, lưu file và API tự sinh, thay thế Firebase

KhóDockerWebNode.jsLinux+2
Tự host & máy chủ nhà111K

frp

fatedier / frp

Đưa máy hoặc dịch vụ trong mạng nhà ra internet qua một máy chủ trung gian, không cần mở cổng router

KhóWindowsmacOSLinux
Tự host & máy chủ nhà94,4K

Uptime Kuma

louislam / uptime-kuma

Theo dõi website và dịch vụ còn sống hay chết, báo qua Telegram, Discord, email bằng giao diện đẹp

VừaDockerLinuxWindowsNode.js
Tự host & máy chủ nhà81,4K

Netdata

netdata / netdata

Giám sát máy chủ và hệ thống theo từng giây, cài xong là có bảng điều khiển ngay, gần như không cần cấu hình

VừaLinuxWindowsmacOSDocker
Tự host & máy chủ nhà79,1K

Caddy

caddyserver / caddy

Máy chủ web tự động bật HTTPS, cấu hình chỉ vài dòng, dùng làm reverse proxy cho website và ứng dụng tự cài

VừaWindowsmacOSLinuxDocker

Xem cả 16 repo Tự host & máy chủ nhà Về Kho Repo