以下是对网页内容的详尽笔记:
项目简介
- 项目名称:renhai-lab/easy-homeassistant
- 项目描述:Homeassistant 极简安装法,通过 Docker 容器运行 Home Assistant Core,不包含 Supervisor 和 Add-ons,但可以通过自己运行 Docker 容器来扩展,安装简单,不依赖特定硬件。
安装指南
官方资源
- 官方安装指南:Installation - Home Assistant
- 不同安装方法的说明:Installation Methods & Community Guides Wiki - Home Assistant
安装步骤
- 准备设备:需要一台 Windows、Mac 或 Linux 设备。
安装 Docker:
国外环境:
wget -qO- get.docker.com | bash
中国环境:
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh --mirror=Aliyun
配置镜像源(可选):
- 由于中国科学技术大学(USTC)的 Docker 镜像源已限制为仅供校内网络使用,可以使用 Cloudflare Worker 上的代理,例如 ciiii/cloudflare-docker-proxy。
配置方法:
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<<'EOF'
{
"registry-mirrors": ["http://mirrors.ustc.edu.cn"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker
部署 Home Assistant:
创建文件夹:
mkdir ha
cd ha创建
docker-compose.yml
文件:touch docker-compose.yml
nano docker-compose.yml # 或使用 vim填写
docker-compose.yml
文件内容:services:
homeassistant:container_name: homeassistant image: ghcr.io/home-assistant/home-assistant:stable # 中国地区镜像地址:ghcr.nju.edu.cn/home-assistant/home-assistant:stable volumes: - "./config:/config" - "/etc/localtime:/etc/localtime:ro" - "/run/dbus:/run/dbus:ro" # 蓝牙设备需要 environment: - SET_CONTAINER_TIMEZONE=true - CONTAINER_TIMEZONE=Asia/Shanghai restart: unless-stopped privileged: true</code></pre></li><li><p>运行:</p><pre><code class="lang-bash">docker compose up --build -d # -d 后台运行
docker compose logs -f # 查看日志,按 Ctrl+C 退出
- 访问:
http://localhost:8123
高级配置
安装 Node-RED
在
docker-compose.yml
文件中新增以下内容:services:
homeassistant:# 现有内容
node-red:
image: nodered/node-red container_name: nodered environment: - TZ=Asia/Shanghai ports: - "1880:1880" volumes: - ./node-red-data:/data depends_on: - homeassistant</code></pre></li><li><p>安装 <code>node-red-contrib-home-assistant-websocket</code>:</p><ul><li><p>通过命令行:</p><pre><code class="lang-bash">docker compose exec node-red bash
npm config set registry https://registry.npm.taobao.org
npm install node-red-contrib-home-assistant-websocket -y按 Ctrl+D 退出
docker compose restart node-red
或通过图形界面:
- 访问
http://localhost:1880
,安装node-red-contrib-home-assistant-websocket
。 - 配置节点,例如拖入一个 HA 节点并双击进行配置。
- 访问
设置 Node-RED 登录密码
- 修改
node-red-data
文件夹中的settings
文件,找到adminAuth
部分。 生成加密密码:
node -e "console.log(require('bcryptjs').hashSync(process.argv[1], 8));" your-password-here
- 将生成的加密密码填入
settings
文件中。
项目信息
- Stars:15
- Forks:2
- Watchers:1
其他信息
- 项目中包含
.idea
和assets
文件夹,分别用于开发环境和存储静态资源。 最近一次提交信息:
- 提交者:renhai-lab
- 提交时间:2025 年 1 月 4 日
- 提交内容:更新
README.md
文件