ha-fusion 项目使用教程

ha-fusion 项目使用教程

ha-fusionA modern, easy-to-use and performant custom Home Assistant dashboard项目地址:https://gitcode.com/gh_mirrors/ha/ha-fusion

1. 项目的目录结构及介绍

ha-fusion 项目的目录结构如下：

ha-fusion/
├── README.md
├── docker-compose.yml
├── config/
│   ├── configuration.yaml
│   └── ...
├── custom_components/
│   └── ha_fusion/
│       ├── __init__.py
│       └── ...
└── ...

目录结构介绍

• README.md: 项目介绍文件，包含项目的基本信息和使用说明。
• docker-compose.yml: Docker 配置文件，用于启动和管理 Docker 容器。
• config/: 配置文件目录，包含项目的配置文件。
  • configuration.yaml: 主配置文件，包含项目的各项配置参数。
• custom_components/: 自定义组件目录，包含项目的自定义组件。
  • ha_fusion/: ha-fusion 自定义组件目录，包含组件的实现代码。

2. 项目的启动文件介绍

项目的启动文件主要是 docker-compose.yml，该文件用于定义和配置 Docker 容器。

docker-compose.yml 文件内容示例

version: '3.8'
services:
  ha-fusion:
    image: matt8707/ha-fusion:latest
    container_name: ha-fusion
    volumes:
      - ./config:/config
    ports:
      - "8123:8123"
    restart: unless-stopped

启动命令

使用以下命令启动项目：

docker-compose up -d

3. 项目的配置文件介绍

项目的配置文件主要位于 config/ 目录下，其中最重要的是 configuration.yaml。

configuration.yaml 文件内容示例

homeassistant:
  name: Home
  latitude: 37.8716
  longitude: -122.2727
  elevation: 10
  unit_system: metric
  time_zone: America/Los_Angeles

frontend:
  themes: !include_dir_merge_named themes/

http:
  server_port: 8123
  ssl_certificate: /ssl/fullchain.pem
  ssl_key: /ssl/privkey.pem

# 其他配置项...

配置文件说明

• homeassistant: 定义 Home Assistant 的基本信息，如名称、位置、单位系统等。
• frontend: 定义前端主题。
• http: 定义 HTTP 服务器的配置，如端口、SSL 证书等。

以上是 ha-fusion 项目的基本使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望对您有所帮助。

ha-fusionA modern, easy-to-use and performant custom Home Assistant dashboard项目地址:https://gitcode.com/gh_mirrors/ha/ha-fusion