{"id":24915522,"url":"https://github.com/hasscc/hass-docker","last_synced_at":"2025-10-17T01:32:05.875Z","repository":{"id":260603475,"uuid":"881804310","full_name":"hasscc/hass-docker","owner":"hasscc","description":"Home Assistant 预装HACS极速版、米家、天气预报、文件管理等常用集成","archived":false,"fork":false,"pushed_at":"2025-01-17T05:39:32.000Z","size":18,"stargazers_count":5,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-17T06:28:08.253Z","etag":null,"topics":["docker","hacs","home-assistant"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/u/hacn","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hasscc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-01T09:11:52.000Z","updated_at":"2025-01-17T05:39:34.000Z","dependencies_parsed_at":"2024-11-01T10:25:43.761Z","dependency_job_id":"778d0ee7-b48a-41e3-b785-e7ddd37a4a62","html_url":"https://github.com/hasscc/hass-docker","commit_stats":null,"previous_names":["hasscc/hass-docker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasscc%2Fhass-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasscc%2Fhass-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasscc%2Fhass-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasscc%2Fhass-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hasscc","download_url":"https://codeload.github.com/hasscc/hass-docker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":236761705,"owners_count":19200661,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","hacs","home-assistant"],"created_at":"2025-02-02T07:17:59.127Z","updated_at":"2025-10-17T01:32:05.870Z","avatar_url":"https://github.com/hasscc.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Home Assistant for China\n\n### 预装集成\n\u003e 本镜像每日更新，[可用标签](https://github.com/hasscc/hass-docker/pkgs/container/hacn/versions?filters[version_type]=tagged)有`stable`、`latest`、`dev`及月度版本如`2024.9`\n\u003e\n\u003e 如果想要加载项功能，可以使用[hass-super](https://github.com/hasscc/hass-super)，或使用[内置扩展](#addons)镜像\n\u003e\n\u003e HA启动时会逐个检测是否安装以下集成，如果没有则自动安装，已安装不会覆盖\n\n- [HACS极速版](https://hacs.vip)\n- [小米 · Xiaomi Miot](https://github.com/al-one/hass-xiaomi-miot)\n- [小米 · Xiaomi Home](https://github.com/XiaoMi/ha_xiaomi_home) _(2024.11+)_\n- [小米 · XiaomiGateway3](https://github.com/AlexxIT/XiaomiGateway3)\n- [易微联 · Sonoff Lan](https://github.com/AlexxIT/SonoffLAN) _(2024.11+)_\n- [天气预报](https://github.com/hasscc/tianqi)\n- [文件管理](https://github.com/shaonianzhentan/ha_file_explorer)\n- [美的 · Midea AC Lan](https://github.com/georgezhao2010/midea_ac_lan) _(2024.11+)_\n- [美的 · Midea AC Py](https://github.com/mill1000/midea-ac-py) _(2024.11+)_\n- [海尔 · Haier](https://github.com/banto6/haier) _(2024.12+)_\n- [巴法 · Bemfa](https://github.com/larry-wong/bemfa) _(2024.11+)_ ~~(2025.5)~~\n- [小燕 · Terncy](https://github.com/rxwen/homeassistant-terncy-component) _(2024.12+)_\n- [Edge TTS](https://github.com/hasscc/hass-edge-tts) _(2024.11+)_\n- [AI Conversation Agent](https://github.com/hasscc/ai-conversation) _(2024.9+)_\n\n\n### 可用镜像\n* ghcr.nju.edu.cn/hasscc/hacn\n* registry.cn-hangzhou.aliyuncs.com/hasscc/hacn\n* hacn/hacn\n\n### 可用标签\n* `stable` `latest` 最新稳定版\n* `2025.1` `2024.9` 对应HA Core月度版本\n* `addons` `2025.1-addons` [内置插件](#addons)版本\n* `mqtt` `2025.2-mqtt` 仅内置MQTT Broker版本\n* `nodered` `2025.3-nodered` 仅内置Node-RED版本\n* `dev` `dev-addons` `dev-mqtt` HA Core开发版\n\n\n### 命令安装\n\u003e https://www.home-assistant.io/installation/linux#install-home-assistant-container\n\n```bash\ndocker run -d \\\n  --name homeassistant \\\n  --privileged \\\n  --restart=unless-stopped \\\n  -v /PATH_TO_YOUR_CONFIG:/config \\\n  -v /run/dbus:/run/dbus:ro \\\n  -e TZ=Asia/Shanghai \\\n  -e ALWAYS_INSTALL=true \\\n  --network=host \\\n  ghcr.nju.edu.cn/hasscc/hacn:stable\n```\n\n### Compose 安装\n\u003e https://www.home-assistant.io/installation/linux#docker-compose\n\n```yaml\nservices:\n  homeassistant:\n    container_name: homeassistant\n    image: ghcr.nju.edu.cn/hasscc/hacn:stable\n    volumes:\n      - /PATH_TO_YOUR_CONFIG:/config\n      - /etc/localtime:/etc/localtime:ro\n      - /run/dbus:/run/dbus:ro\n    environment:\n      - TZ=Asia/Shanghai\n      - ALWAYS_INSTALL=true  # 默认为true，每次启动都会逐个预装，否则仅全新HA才会预装\n      - ALWAYS_UPGRADE=false # 默认为false，每次启动都会逐个预装最新版本的插件\n    restart: unless-stopped\n    privileged: true\n    network_mode: host\n    healthcheck:\n      test: [CMD-SHELL, curl -I localhost:8123 || exit 1]\n```\n\n\n### 内置扩展\n\u003ca name=\"addons\"\u003e\u003c/a\u003e\n\n\u003e 需要2025.1及以上的镜像，标签 `addons` 包含以下所有扩展\n\n#### MQTT Broker\n- 镜像标签: `mqtt` `stable-mqtt` `dev-mqtt`\n- 环境变量:\n  ```yaml\n  MQTT_USERNAME: homeassistant # 默认为`homeassistant`\n  MQTT_PASSWORD: homeassistant # 默认为空无需授权，推荐设置\n  MQTT_PORT: 1883 # 默认为`1883`\n  ```\n\n#### Node-RED\n- 镜像标签: `nodered` `stable-nodered` `dev-nodered`\n- 环境变量:\n  ```yaml\n  NODERED_USERNAME: homeassistant # 默认为`homeassistant`\n  NODERED_PASSWORD: homeassistant # Node-Red后台密码\n  NODERED_PORT: 1880 # 默认为`1880`\n  ```\n- 访问`http://IP:1880`并登录，需[手动配置HA的长效令牌](https://zachowj.github.io/node-red-contrib-home-assistant-websocket/guide/#configuration)\n\n\n### 相关链接\n- [DockerHub](https://hub.docker.com/r/hacn/hacn)\n- [Dockerfile](https://github.com/hasscc/hass-docker/blob/main/Dockerfile)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhasscc%2Fhass-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhasscc%2Fhass-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhasscc%2Fhass-docker/lists"}