系统管理员、集成商
在服务器上安装EAS
在Ubuntu上部署,首先登录管理面板并检查工作情况。
- 1
准备服务器
Ubuntu 22.04+。 **飞行员的最低配置:** 2 个核心、4 GB RAM、80 GB SSD - 最多约 8 个摄像头、30 个传感器、2 个控制器。对于大型对象,请参阅计算硬件的单独文档(100 个摄像头/100 个传感器/10 个控制器 - 准则 12–16 个核心、32 GB RAM、2–4 TB 用于录像)。静态 IP、端口 8000(管理面板)以及 ACS 面板对服务器的访问。
Tip: 详细表格:/docs/server-sizing/
- 2
运行安装程序
在 Ubuntu 服务器上,运行一个命令(请参见下面的块) - 该脚本将从中心 (manifest.json) 下载当前包,解压并启动本机安装:PostgreSQL、Python venv、eas-server、Home Assistant、第一个安装向导。时间:30分钟至2小时。
curl -fsSL https://asceas.ru/eas-hub/install/install-eas-from-hub.sh | sudo EAS_ACCEPT_EULA=1 bash -s -- --accept-eula
Tip: 没有家庭助理:curl -fsSL https://asceas.ru/eas-hub/install/install-eas-from-hub.sh | sudo EAS_ACCEPT_EULA=1 bash -s -- --accept-eula --without-ha。推送清单:https://asceas.ru/eas-hub/manifest.json
- 3
已经自动完成的事情
向导完成后,无需手动命令即可进行以下操作:eas-server 服务(管理面板:8000)、家庭助理服务(:8123)、EAS 数据库中的“本地家庭助理”条目(127.0.0.1:8123)。检查:systemctl is-active eas-server home-assistant 和curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:8123/ - 通常为302(入门页面)。
Tip: 对于开箱即用的 HA,建议使用 ≥4GB RAM。在弱虚拟机上,第一个响应:8123 可能会在 pip 之后花费 10-20 分钟。
- 4
首次登录EAS管理面板
打开 http://<服务器 IP>:8000/admin,使用 eas.bootstrap.credentials 中的凭据登录并更改密码。非交互模式下的向导 (curl | bash) 自动创建管理员用户。

Tip: 对于 HTTPS,请在 uvicorn 之前配置 nginx 或 Caddy - 不要在生产中仅保留 HTTP。
- 5
加入家庭助理(仅限浏览器)
Home Assistant 无法从终端进行完全配置:打开 http://<IP 服务器>:8123,创建 HA 管理员帐户(名称、密码、时区、地理位置)。这是与 EAS 不同的密码 - 不要与 eas.bootstrap.credentials 中的 admin 混淆。
Tip: 如果 :8123 未打开:journalctl -u home-assistant -n 50 - 首次安装时等待 pip 完成。
- 6
HA 令牌和 EAS 链接
在 Home Assistant 中:个人数据(左下角图标)→“安全”→“长期访问令牌”→“创建令牌”。复制该行。在 EAS 中:“管理”→“Home Assistant”(或“集成”→“打开 Home Assistant”按钮)→ 在“本地 Home Assistant”行旁边,单击“令牌/更改”→ 插入令牌→保存→“同步实体”。

Tip: 另一个子网中的 HA 替代方案:同一页面上的“HA 向导”按钮(子网 + 令牌)。
- 7
检查服务器状态
以管理员身份登录。标题显示界面的登录名、角色和主题。打开“管理→服务器和服务”-确保eas-server服务处于活动状态并且磁盘未满。

- 8
激活您的许可证
转到“许可证”选项卡,输入试用或永久许可证密钥,然后单击“激活”。如果没有许可证,某些功能将受到限制。
