Quản trị hệ thống, tích hợp
Cài đặt EAS trên máy chủ
Triển khai trên Ubuntu, trước tiên hãy đăng nhập vào bảng quản trị và kiểm tra công việc.
- 1
Chuẩn bị máy chủ
Ubuntu 22.04+. **Tối thiểu cho triển khai thử nghiệm:** 2 lõi, RAM 4 GB, SSD 80 GB - tối đa ~8 camera, 30 cảm biến, 2 bộ điều khiển. Đối với đối tượng lớn, hãy xem hướng dẫn riêng để tính toán phần cứng (100 camera / 100 cảm biến / 10 bộ điều khiển - hướng dẫn 12–16 lõi, RAM 32 GB, 2–4 TB để lưu trữ). IP tĩnh, cổng 8000 (bảng quản trị) và quyền truy cập của bảng ACS vào máy chủ.
Tip: Bảng chi tiết: /docs/server-sizing/
- 2
Chạy trình cài đặt
Trên máy chủ Ubuntu, hãy chạy một lệnh (xem khối bên dưới) - tập lệnh sẽ tải xuống gói hiện tại từ trung tâm (manifest.json), giải nén và khởi chạy cài đặt gốc: PostgreSQL, Python venv, eas-server, Home Assistant, trình hướng dẫn thiết lập đầu tiên. Thời gian: từ 30 phút đến 2 giờ.
curl -fsSL https://asceas.ru/eas-hub/install/install-eas-from-hub.sh | sudo EAS_ACCEPT_EULA=1 bash -s -- --accept-eula
Tip: Không có Home Assistant: curl -fsSL https://asceas.ru/eas-hub/install/install-eas-from-hub.sh | sudo EAS_ACCEPT_EULA=1 bash -s -- --accept-eula --without-ha. Bản kê khai phát hành: https://asceas.ru/eas-hub/manifest.json
- 3
Những gì đã được thực hiện tự động
Sau trình hướng dẫn, các dịch vụ sau hoạt động mà không cần lệnh thủ công: eas-server (bảng quản trị :8000), home-assistant (:8123), mục “Local Home Assistant” (127.0.0.1:8123) trong cơ sở dữ liệu EAS. Kiểm tra: systemctl is-active eas-server home-assistant và curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:8123/ - thường là 302 (trang cấu hình ban đầu).
Tip: Đối với HA sẵn có, nên sử dụng RAM ≥4GB. Trên các máy ảo yếu, phản hồi đầu tiên :8123 có thể mất 10-20 phút sau pip.
- 4
Đăng nhập vào bảng quản trị EAS lần đầu tiên
Mở http://<server IP>:8000/admin, đăng nhập bằng thông tin đăng nhập từ eas.bootstrap.credentials và thay đổi mật khẩu. Trình hướng dẫn ở chế độ không tương tác (curl | bash) tự động tạo người dùng quản trị.
Tip: Đối với HTTPS, hãy định cấu hình nginx hoặc Caddy trước uvicorn - không chỉ để lại HTTP trong sản xuất.
- 5
Tích hợp Trợ lý tại nhà (chỉ trên trình duyệt)
Không thể định cấu hình đầy đủ Home Assistant từ thiết bị đầu cuối: mở http://<IP server>:8123, tạo tài khoản quản trị viên HA (tên, mật khẩu, múi giờ, vị trí địa lý). Đây là mật khẩu riêng biệt với EAS - đừng nhầm lẫn với quản trị viên trong eas.bootstrap.credentials.
Tip: Nếu :8123 không mở: journalctl -u home-assistant -n 50 - đợi cho đến khi pip kết thúc khi cài đặt lần đầu tiên.
- 6
Mã thông báo HA và liên kết tới EAS
Trong Home Assistant: hồ sơ (biểu tượng phía dưới bên trái) → “Bảo mật” → “Mã thông báo truy cập lâu dài” → “Tạo mã thông báo”. Sao chép dòng. Trong EAS: “Quản trị” → “Trợ lý gia đình” (hoặc nút “Tích hợp” → nút “Mở Trợ lý gia đình”) → bên cạnh dòng “Trợ lý gia đình cục bộ”, nhấp vào “Mã thông báo / thay đổi” → chèn mã thông báo → lưu → “Đồng bộ hóa thực thể”.
Tip: Thay thế cho HA trong mạng con khác: nút "HA Wizard" trên cùng một trang (mạng con + mã thông báo).
- 7
Kiểm tra trạng thái máy chủ
Đăng nhập với tư cách quản trị viên. Tiêu đề hiển thị thông tin đăng nhập, vai trò và chủ đề giao diện. Mở “Quản trị → Máy chủ và Dịch vụ” - đảm bảo eas-server đang hoạt động và đĩa chưa đầy.
- 8
Kích hoạt giấy phép của bạn
Chuyển đến tab “Giấy phép”, nhập khóa cấp phép dùng thử hoặc vĩnh viễn và nhấp vào “Kích hoạt”. Nếu không có giấy phép, một số chức năng sẽ bị hạn chế.
