{"id":8225,"date":"2024-09-11T15:22:46","date_gmt":"2024-09-11T06:22:46","guid":{"rendered":"https:\/\/hasu0707.duckdns.org\/blog\/?p=8225"},"modified":"2024-09-23T22:57:21","modified_gmt":"2024-09-23T13:57:21","slug":"home-assistant-%ec%84%a4%ec%b9%98","status":"publish","type":"post","link":"https:\/\/hasu0707.duckdns.org\/blog\/?p=8225","title":{"rendered":"Install Home Assistant Core"},"content":{"rendered":"\n\ucc38\uace0: https:\/\/www.home-assistant.io\/installation\/odroid<\/a>
\ud14c\uc2a4\ud2b8 \uc7a5\ube44: Orange Pi Zero2

1. \uae30\ubcf8 \uc694\uad6c\uc0ac\ud56d
  Ubuntu 24.04 \uc774\uc0c1
  Python 3.12 \uc774\uc0c1

2. \ud544\uc694\ud55c \ub9ac\ub205\uc2a4 \ud328\ud0a4\uc9c0 \uc124\uce58
  apt install -y python3 python3-dev python3-venv python3-pip bluez libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential libopenjp2-7 libturbojpeg0-dev tzdata ffmpeg liblapack3 liblapack-dev libatlas-base-dev
  apt install -y libtiff6

3. \uc0ac\uc6a9\uc790 \ucd94\uac00
  useradd --system --create-home -c \"Home Assistant\" -d \"\/var\/homeassistant\" homeassistant -G dialout,i2c,gpio
  mkdir \"\/opt\/homeassistant\"
  chown homeassistant:homeassistant \/opt\/homeassistant

4. \uae30\ubcf8 Python\uacfc \ubd84\ub9ac\ud558\uc5ec \ub3c5\ub9bd\uc801\uc73c\ub85c \uc2e4\ud589\ud560 \uac00\uc0c1 \ud658\uacbd\uc744 \uc124\uce58\ud55c\ub2e4.
  sudo -u homeassistant -H -s
  cd \/opt\/homeassistant
  python3 -m venv \/opt\/homeassistant
  source \/opt\/homeassistant\/bin\/activate
  python3 -m pip install wheel

5. Home Assistant\ub97c \uc124\uce58\ud55c\ub2e4.
  pip3 install homeassistant==2024.9.9
  \uc704\uc758 \uad6c\ubb38\uc744 \uc2e4\ud589\ud558\uba74 \uc624\ub958\uac00 \ubc1c\uc0dd\ud558\uba74\uc11c \uc124\uce58\uac00\ub2a5\ud55c \ubc84\uc804 \ubaa9\ub85d\uc774 \ub098\uc624\ub294\ub370 2024.9.9 \uc790\ub9ac\uc5d0 \ucd5c\uc2e0 \ubc84\uc804\uc744 \uba85\uc2dc\ud558\uc5ec \uc124\uce58\ud55c\ub2e4.

6. Home Assistant systemd \uc11c\ube44\uc2a4 \uae30\uc220 \ud30c\uc77c \uc791\uc131
  exit
  vi \/usr\/lib\/systemd\/system\/hass.service

----------
[Unit]
Description=Home Assistant
After=network-online.target

[Service]
Type=simple
User=homeassistant
Group=homeassistant
WorkingDirectory=\/var\/homeassistant
ExecStartPre=\/bin\/sleep 5
ExecStart=\/opt\/homeassistant\/bin\/hass -c \"\/var\/homeassistant\"
ExecStop=pkill -SIGTERM -f \"homeassistant\\\/bin\\\/hass\"
RestartForceExitStatus=100

[Install]
WantedBy=multi-user.target
----------

  systemctl daemon-reload
  systemctl enable hass.service
  systemctl start hass.service
  \u203b\ucd5c\ucd08 \uc2e4\ud589\ub418\ub294\ub370 10\ubd84 \uc815\ub3c4 \uc18c\uc694\ub41c\ub2e4.

7. \uc6f9\ube0c\ub77c\uc6b0\uc800\uc5d0\uc11c \uc544\ub798 \ud615\uc2dd\uc73c\ub85c \uc811\uc18d\uc744 \ud655\uc778\ud55c\ub2e4.
  http:\/\/10.10.10.108:8123



\u25a0 SSL \uc801\uc6a9

1. configuration.yaml\uc5d0 \uc124\uc815 \ucd94\uac00
  \uc544\ub798 \uc124\uc815\uc73c\ub85c Reverse Proxy\ub97c \ud5c8\uc6a9\ud558\uace0 WebSocket\uc774 \ud65c\uc131\ud654 \ub41c\ub2e4.

  vi \/var\/homeassistant\/configuration.yaml
----------
# Enable Reverse Proxy
http:
  use_x_forwarded_for: true
  trusted_proxies:
    - 10.10.10.0\/24
    - 10.10.10.108
    - 127.0.0.1

# Enable WebSocket
websocket_api:
----------

2. nginx \uc124\uce58
  apt -y install nginx
  systemctl enable nginx.service

3. ngix\uc5d0 Reverse Proxy \uc124\uc815\ud30c\uc77c\uc744 \uc791\uc131
  hasu0707.duckdns.org\ub97c \uc678\ubd80 HOST\uba85\uc73c\ub85c \ubcc0\uacbd\ud558\uace0 \uc6d0\ud65c\ud55c \uc11c\ube44\uc2a4\ub97c \uc704\ud574\uc11c\ub294 \uc790\uccb4 \uc11c\uba85\uc774 \uc815\uc0c1\uc801\uc778 SSL \uc778\uc99d\uc11c\ub97c \ubc1c\uae09\ubc1b\uc544 \uc14b\ud305\ud55c\ub2e4.

  vi \/etc\/nginx\/sites-available\/reverse_proxy
----------
###########################################################
# \/etc\/nginx\/sites-available\/reverse_proxy
#
# Add the following to Home Assistant's configuration.yaml:
###########################################################
#http:
#  use_x_forwarded_for: true
#  trusted_proxies:
#    - 10.10.10.0\/24
#    - 10.10.10.108
#    - 127.0.0.1
#
#websocket_api:
###########################################################

server {
    listen [::]:443 ssl default_server http2 ipv6only=off;
    server_name 'hasu0707.duckdns.org';

    # These shouldn't need to be changed
    add_header Strict-Transport-Security \"max-age=31536000; includeSubdomains\";
    ssl_protocols TLSv1.2;
    ssl_ciphers \"EECDH+AESGCM:EDH+AESGCM:AES256+EECDH:AES256+EDH:!aNULL:!eNULL:!EXPORT:!DES:!MD5:!PSK:!RC4\";
    ssl_prefer_server_ciphers on;
    ssl_session_cache shared:SSL:10m;
    proxy_buffering off;

    location \/ {
        proxy_pass                          http:\/\/localhost:8123\/;
        proxy_http_version                  1.1;
        proxy_redirect                      http:\/\/ https:\/\/;
        proxy_cache_bypass                  $http_upgrade;
        proxy_set_header Connection         \"upgrade\";
        proxy_set_header Host               $host;
        proxy_set_header Upgrade            $http_upgrade;
        proxy_set_header X-Forwarded-Host   $host;
        proxy_set_header X-Forwarded-Port   $server_port;
        proxy_set_header X-Forwarded-Proto  $scheme;
        proxy_set_header X-Forwared-For     $proxy_add_x_forwarded_for;
        proxy_set_header X-Real-IP          $remote_addr;
    }

    # self signed certificate
    ssl_certificate '\/etc\/ssl\/opizero2\/certs\/ssl-cert.crt';
    ssl_certificate_key '\/etc\/ssl\/opizero2\/private\/ssl-cert.key';
}

server {
    # managed by Certbot
    if ($host = 'hasu0707.duckdns.org') {
        return 301 https:\/\/$host$request_uri;
    }

    listen 80;
    server_name 'hasu0707.duckdns.org';

    # managed by Certbot
    return 404;
}
----------
  ln -s \/etc\/nginx\/sites-available\/reverse_proxy \/etc\/nginx\/sites-enabled\/reverse_proxy


4. nginx \uc7ac\uc2dc\uc791
  systemctl restart nginx.service



\u25a0 Zigbee2MQTT \uc124\uce58
\ucc38\uace0: https:\/\/docs.jethome.ru\/en\/controllers\/linux\/howto\/zigbee2mqtt.html<\/a>

1.MQTT broker mosquitto \ud328\ud0a4\uc9c0 \uc124\uce58
  apt install -y mosquitto mosquitto-clients
  systemctl enable mosquitto.service
  systemctl restart mosquitto.service
  systemctl status mosquitto.service

2.mosquitto broker ID\/Password \ucd94\uac00 \ubc0f \uc554\ud638\ud654
  vi \/etc\/mosquitto\/conf.d\/account.conf
----------
# \ube44\ubc00\ubc88\ud638 \ud30c\uc77c\uacbd\ub85c \uc124\uc815
password_file \/etc\/mosquitto\/passwd

# \uc775\uba85 \uc811\uc18d \ucc28\ub2e8
allow_anonymous false
----------

  vi \/etc\/mosquitto\/passwd
----------
# username:password
mqttuser:mqTT123@
----------
  mosquitto_passwd -U \/etc\/mosquitto\/passwd
  systemctl restart mosquitto.service

3.mosquitto broker \ud14c\uc2a4\ud2b8
  # subscribe
  mosquitto_sub -h localhost -t \/topic -u mqttuser -P mqTT815@
  \u203bsubscribe\ub294 listen \ubaa8\ub4dc\uc774\ub2e4. publish\uac00 \ubcf4\ub0b8 \uba54\uc138\uc9c0\uac00 \ud45c\uc2dc\ub41c\ub2e4.

  # publish (\ub2e4\ub978 \uc138\uc158\uc5d0\uc11c \uc2e4\ud589\ud55c\ub2e4)
  mosquitto_pub -h localhost -t \/topic -u mqttuser -P mqTT815@ -m \"test\"
  \u203bsubscribe \uc138\uc158\uc5d0\uc11c test\uac00 \ub728\uba74 \uc131\uacf5.

4.node.js \ucd5c\uc2e0\ubc84\uc804 \ud655\uc778 \ud6c4 NODE_MAJOR \ubcc0\uc218\uc5d0 major \ubc84\uc804\ubc88\ud638 \uc124\uc815
  https:\/\/nodejs.org\/en\/download\/package-manager\/current
  export NODE_MAJOR=22

5.20.x \uc774\uc0c1\uc758 node.js \ubc0f \ube4c\ub4dc\uc5d0 \ud544\uc694\ud55c \ucd94\uac00 \ud328\ud0a4\uc9c0 \uc124\uce58
  apt install -y ca-certificates curl gnupg
  mkdir -p \/etc\/apt\/keyrings
  curl -fsSL https:\/\/deb.nodesource.com\/gpgkey\/nodesource-repo.gpg.key | gpg --dearmor -o \/etc\/apt\/keyrings\/nodesource.gpg
  echo \"deb [signed-by=\/etc\/apt\/keyrings\/nodesource.gpg] https:\/\/deb.nodesource.com\/node_$NODE_MAJOR.x nodistro main\" | tee \/etc\/apt\/sources.list.d\/nodesource.list
  apt -y update
  apt install -y nodejs git make g++ gcc

6.Zigbee2MQTT \uc124\uce58
  mkdir -p \/opt\/zigbee2mqtt
  chown -R homeassistant:homeassistant \/opt\/zigbee2mqtt
  git clone --depth 1 https:\/\/github.com\/Koenkk\/zigbee2mqtt.git \/opt\/zigbee2mqtt
  cd \/opt\/zigbee2mqtt

7.npm clean-install\uc744 \ud1b5\ud574 \ud328\ud0a4\uc9c0\ub4e4\uc744 \uc124\uce58\ud558\uc5ec node_modules\uc5d0 \uc801\uc7ac
  npm ci

8.\/opt\/zigbee2mqtt\/data\/configuration.yaml \uc124\uc815
  vi \/opt\/zigbee2mqtt\/data\/configuration.yaml
----------
# Home Assistant integration (MQTT discovery)
homeassistant: true

# Allow new devices to join
permit_join: false

# MQTT settings
mqtt:
  # MQTT base topic for Zigbee2MQTT MQTT messages
  base_topic: zigbee2mqtt
  # MQTT server URL
  server: 'mqtt:\/\/localhost'

# Serial settings
serial:
  # SONOFF Zigbee 3.0 USB Dongle Plus V2 (EFR32MG21)
  port: \/dev\/ttyUSB0
  adapter: ember
  rtscts: false

# Optional: advanced settings
advanced:
  # Optional: ZigBee channel (Note: changing requires re-pairing of all devices)
  channel: 15
  # Optional: ZigBee pan ID
  pan_id: 0x1a62
  # Optional: network encryption key, will improve security (Note: changing requires repairing of all devices)
  network_key: [1, 3, 5, 7, 9, 11, 13, 15, 0, 2, 4, 6, 8, 10, 12, 13]

frontend:
  # Optional, default 8080
  port: 8080
  # Optional, default 0.0.0.0
  host: 0.0.0.0
----------

9.Zigbee2MQTT \uc218\ub3d9 \uc2dc\uc791 \ud14c\uc2a4\ud2b8
  cd \/opt\/zigbee2mqtt
  npm start

10.Zigbee2MQTT systemd \uc11c\ube44\uc2a4 \uae30\uc220 \ud30c\uc77c \uc791\uc131
  vi \/usr\/lib\/systemd\/system\/zigbee2mqtt.service
----------
[Unit]
Description=zigbee2mqtt
After=network.target

[Service]
User=homeassistant
Group=homeassistant
WorkingDirectory=\/opt\/zigbee2mqtt
ExecStart=\/usr\/bin\/npm start
StandardOutput=inherit
StandardError=inherit
Restart=always

[Install]
WantedBy=multi-user.target
----------
  systemctl daemon-reload
  systemctl enable zigbee2mqtt.service
  chown -R homeassistant:homeassistant \/opt\/zigbee2mqtt
  systemctl restart zigbee2mqtt.service

11.\uc815\uc0c1 \uc2e4\ud589 \ubaa8\ub2c8\ud130\ub9c1
  journalctl -u zigbee2mqtt.service -f

12.Home Assistant \ud1b5\ud569
  •MQTT \uc0ac\uc6a9\uc790 \uc0dd\uc131 (Home Assistant Supervisor \ubc84\uc804\ub9cc \ud574\ub2f9)
    \uc124\uc815 > \uad6c\uc131\uc6d0 > +\uad6c\uc131\uc6d0 \ucd94\uac00\ud558\uae30 > \u2611\ub85c\uadf8\uc778 \ud5c8\uc6a9\ud558\uae30 \/ \uc774\ub984:mqttuser, \uc554\ud638:mqTT815@

  •MQTT \ud1b5\ud569
    \uc124\uc815 > \uae30\uae30 \ubc0f \uc11c\ube44\uc2a4 > +\ud1b5\ud569\uad6c\uc131\uc694\uc18c \ucd94\uac00\ud558\uae30 > MQTT
      \ube0c\ub85c\ucee4: localhost
      \ud3ec\ud2b8: 1883
      \uc0ac\uc6a9\uc790\uc774\ub984: mqttuser
      \uc554\ud638: mqTT815@

13.MQTT \uae30\uae30 \ucd94\uac00
  •MQTT\uc5d0\uc11c \uc8fc\ubcc0 \uae30\uae30 \uc790\ub3d9 \ucd94\uac00
    \uc124\uc815 > \uae30\uae30 \ubc0f \uc11c\ube44\uc2a4 > MQTT > n\uac1c\uc758 \uae30\uae30 > Zigbee2MQTT Bridge > \uc81c\uc5b4\uc7a5\uce58-Permit join:Enable

  •IoT \uc7a5\ube44 \ud398\uc5b4\ub9c1 \ubaa8\ub4dc \ucf1c\uae30

14.\ud398\uc5b4\ub9c1\ub41c IoT \uc7a5\ube44\uba85\ub4e4\uc758 \uc7a5\ube44\uba85 \ubc0f \uc601\uc5ed \ubcc0\uacbd
  •\uc124\uc815 > \uae30\uae30 \ubc0f \uc11c\ube44\uc2a4 > MQTT > n\uac1c\uc758 \uae30\uae30 > \uae30\uae30 \uc120\ud0dd
  •\uc6b0\uce21 \ucd5c\uc0c1\ub2e8 \uc5f0\ud544\ubaa8\uc591 \uc544\uc774\ucf58 \ud074\ub9ad
<\/span>\n","protected":false},"excerpt":{"rendered":"

\ucc38\uace0: https:\/\/www.home-assistant.io\/installation\/odroid\ud14c\uc2a4\ud2b8 \uc7a5\ube44: Orange Pi Zero2 1. \uae30\ubcf8 \uc694\uad6c\uc0ac\ud56d  Ubuntu 24.04 \uc774\uc0c1  Python 3.12 \uc774\uc0c1 2. \ud544\uc694\ud55c \ub9ac\ub205\uc2a4 \ud328\ud0a4\uc9c0 \uc124\uce58  apt install -y python3 python3-dev python3-venv python3-pip bluez libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential libopenjp2-7 libturbojpeg0-dev tzdata ffmpeg liblapack3 liblapack-dev libatlas-base-dev  apt install -y libtiff6 3. \uc0ac\uc6a9\uc790 \ucd94\uac00  useradd –system –create-home -c “Home Assistant” -d […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_import_markdown_pro_load_document_selector":0,"_import_markdown_pro_submit_text_textarea":"","site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"set","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[93],"tags":[],"class_list":["post-8225","post","type-post","status-publish","format-standard","hentry","category-computing_iot"],"_links":{"self":[{"href":"https:\/\/hasu0707.duckdns.org\/blog\/index.php?rest_route=\/wp\/v2\/posts\/8225","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/hasu0707.duckdns.org\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/hasu0707.duckdns.org\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/hasu0707.duckdns.org\/blog\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/hasu0707.duckdns.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=8225"}],"version-history":[{"count":0,"href":"https:\/\/hasu0707.duckdns.org\/blog\/index.php?rest_route=\/wp\/v2\/posts\/8225\/revisions"}],"wp:attachment":[{"href":"https:\/\/hasu0707.duckdns.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=8225"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/hasu0707.duckdns.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=8225"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/hasu0707.duckdns.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=8225"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}