Skip to main content
PromptQuorumPromptQuorum
/Balcony Solar/베란다 태양광을 Home Assistant에 로컬로 연결하기: 브랜드별 가이드
Balcony Solar Foundations

베란다 태양광을 Home Assistant에 로컬로 연결하기: 브랜드별 가이드

·11분 읽기·Hans Kuepper 저 · PromptQuorum 창립자, 멀티 모델 AI 디스패치 도구 · PromptQuorum

세 가지 프로토콜 경로가 거의 모든 베란다 태양광 브랜드를 커버합니다: Modbus TCP(이더넷을 통한 직접 레지스터 접근, 오프라인 작동), MQTT 브리지(로컬 브로커를 통한 pub/sub), 로컬 REST API(기기에 대한 HTTP 호출). 사용 가능한 경로는 브랜드가 아니라 특정 제품 모델에 따라 달라집니다.

대부분의 베란다 태양광 키트는 Home Assistant와의 로컬 통합을 지원하지만, 사용 프로토콜은 브랜드와 제품 라인에 따라 다릅니다. Anker SOLIX는 포트 502에서 공식 Modbus TCP를 사용합니다. Hoymiles는 DTU-Pro 게이트웨이를 통해 동일한 프로토콜을 사용합니다. Zendure SolarFlow 800 Pro는 로컬 HTTP/MQTT API를 가지고 있으며, 구형 Zendure 모델은 클라우드 MQTT 브리지가 필요합니다. EcoFlow PowerStream은 여전히 클라우드에 의존합니다.

핵심 요점

  • 세 가지 로컬 프로토콜이 거의 모든 브랜드를 커버합니다: Modbus TCP, MQTT 브리지, 로컬 REST API. 올바른 선택은 브랜드가 아닌 특정 기기 모델에 따라 달라집니다.
  • Modbus TCP가 가장 신뢰할 수 있는 오프라인 경로입니다 — 인터넷이나 클라우드 브로커 없이 LAN을 통해 직접 레지스터를 읽습니다.
  • EcoFlow PowerStream은 주요 예외입니다: 2026-07-03 검증 날짜 기준으로 로컬 Modbus TCP 또는 MQTT 경로가 없습니다. 모든 모니터링이 EcoFlow 클라우드를 통해 이루어집니다.
  • Victron Cerbo GX는 최고의 로컬 제어를 제공합니다: 공식 HA 통합(HA 2026.5 이상), 문서화된 Modbus TCP, 완전 오프라인 로컬 MQTT.
  • 로컬 인터페이스 지원은 펌웨어 업데이트로 변경될 수 있습니다 — 구매 전 현재 통합 저장소를 확인하세요.

로컬 통합을 위한 세 가지 프로토콜 경로

Modbus TCP는 LAN을 통해 기기 레지스터를 직접 읽습니다 — 클라우드 계정, 브로커, 어댑터 소프트웨어가 필요 없습니다. 기기(또는 로컬 게이트웨이)가 TCP 포트(보통 502 또는 8899)에서 수신하고 레지스터 읽기 명령에 응답합니다. 인터넷 연결이 끊어도 계속 작동합니다.

MQTT 브리지 통합은 기기와 Home Assistant 사이에 위치합니다. 기기는 토픽에 데이터를 게시하고, 어댑터 스크립트 또는 HACS 통합이 구독하여 HA 엔티티를 생성합니다. 로컬 브로커를 향할 때 완전히 오프라인으로 작동합니다.

로컬 REST API 경로는 LAN의 기기나 게이트웨이에 HTTP GET/POST 호출을 사용합니다. Zendure SolarFlow 800 Pro는 이를 기본으로 제공합니다. Marstek은 Marstek Local API (HACS)를 통해 제공합니다.

📍 한 문장으로

Modbus TCP는 LAN을 통해 레지스터를 직접 읽고, MQTT 브리지는 pub/sub 브로커를 사용하며, 로컬 REST API는 기기가 HTTP 요청에 직접 응답합니다.

💬 쉽게 말하면

Modbus TCP = 홈 네트워크에서의 직접 연결; MQTT = 브로커 중개자가 있는 메시지 시스템; REST API = 기기가 웹사이트처럼 요청에 응답.

브랜드별 호환성 표

아래 모든 항목은 2026-07-03에 현재 활성 GitHub 통합 저장소와 제조업체 문서를 통해 검증되었습니다. 로컬 인터페이스 지원은 펌웨어 버전에 따라 변경될 수 있습니다 — 구매 전 현재 상태를 확인하세요.

브랜드 / 제품Modbus TCP로컬 MQTT로컬 REST API오프라인?HA 통합
Anker SOLIX (저장장치)✅ 포트 502, 공식⚠️ 클라우드 브리지만✅ Modbus 경유ha-anker-solix-official (HACS)
Zendure SolarFlow 800 Pro✅ 로컬 HTTP+MQTT✅ 로컬 HTTPZendure/Zendure-HA (공식)
Zendure Hub 1200/2000, Hyper 2000⚠️ 클라우드 MQTT만z-master42/solarflow (커뮤니티)
Hoymiles HMS/HMT (DTU-Pro 경유)✅ DTU-Pro 경유✅ OpenDTU / hoymiles-mqtthoymiles-mqtt-integration (HACS)
Marstek B2500 / Jupiter / Venus⚠️ Venus만 RS485✅ hame-relay+hm2mqtt✅ Marstek Local APIMarstek Local API v1.0.0 (HACS)
Growatt NOAH 2000 / 인버터✅ 로컬 Modbus TCP✅ noah-mqtt / growatt2mqttHomeassistant-Growatt-Local-Modbus (HACS)
Deye SUN600G3 (마이크로 인버터)✅ 포트 8899 (비공식)✅ SolarmanV5 / deye-inverter-mqttSolarman HACS 통합
Victron Cerbo GX✅ 공식, 문서화✅ 공식 (HA 2026.5+)공식 HA 통합
Sungrow SH-RT 시리즈✅ 커뮤니티✅ ModbusTCP2MQTTSungrow-SHx-Inverter-Modbus (HACS)
Kostal Plenticore (G3+)✅ HACS✅ 공식 REST API공식 HA 통합 (REST)
EcoFlow PowerStream❌ 클라우드 MQTT만tolwi/hassio-ecoflow-cloud (클라우드 전용)

2026-07-03 검증. 펌웨어 업데이트로 로컬 접근이 추가되거나 제거될 수 있습니다 — 구매 전 확인하세요.

경로 A: Modbus TCP 설정

Modbus TCP에는 세 가지 요구 사항이 있습니다: Home Assistant와 같은 LAN에 기기가 있어야 하고, Modbus 인터페이스가 활성화되어 있어야 하며, 모델의 레지스터 맵이 필요합니다. 대부분의 커뮤니티 HACS 통합은 레지스터 맵을 포함합니다 — IP 주소만 입력하면 됩니다.

  1. 1
    기기에서 Modbus TCP 활성화: Anker SOLIX → Anker 앱 → 기기 설정 → Modbus 활성화. Hoymiles → DTU-Pro 웹 UI. Growatt → 기본으로 활성화. Deye → 설정 불필요, Logger Stick의 포트 8899는 항상 열려 있음.
  2. 2
    라우터에서 기기에 고정 IP 주소를 할당하여(또는 DHCP 예약) HA 통합 주소가 바뀌지 않게 합니다.
  3. 3
    해당 HACS 통합 설치: Anker는 ha-anker-solix-official, Hoymiles는 hoymiles-mqtt-integration, Growatt는 Homeassistant-Growatt-Local-Modbus, Deye는 Solarman 통합, Victron은 공식 Victron GX 통합.
  4. 4
    통합 설정에서 기기 IP와 포트 입력. 표준 Modbus 포트는 502; Deye는 8899 사용.
  5. 5
    HA의 센서 엔티티 확인 — 현재 출력 전력이 5-10초 이내에 업데이트되어야 합니다. 엔티티가 "사용 불가"를 표시하면 IP, Modbus 활성화 설정, 방화벽 규칙을 확인하세요.

경로 B: MQTT 브리지 설정

MQTT 브리지 통합은 기기를 폴링하거나 푸시 데이터를 수신하고 로컬 Mosquitto 브로커에 재게시하는 작은 어댑터 스크립트(또는 HA 애드온)를 실행하여 작동합니다. Home Assistant는 MQTT 통합을 통해 해당 토픽을 구독합니다. 로컬 브로커에 구성하면 완전히 오프라인으로 작동합니다.

  1. 1
    HA 애드온으로 Mosquitto 브로커 설치(설정 → 애드온 → Mosquitto Broker) 및 사용자 이름과 비밀번호 구성.
  2. 2
    HA에서 MQTT 통합 설정(설정 → 기기 및 서비스 → 통합 추가 → MQTT) 및 로컬 브로커에 연결.
  3. 3
    기기별 어댑터 설치: Growatt NOAH 2000에는 noah-mqtt, Marstek에는 hame-relay+hm2mqtt, Hoymiles에는 hoymiles-mqtt, Deye에는 deye-inverter-mqtt, Zendure에는 Zendure-HA. Docker 컨테이너 또는 HA 애드온으로 실행.
  4. 4
    어댑터를 기기 IP와 가능하면 제조업체 클라우드 브로커 대신 로컬 Mosquitto 브로커로 향하게 설정.
  5. 5
    데이터 흐름 확인: 엔티티가 MQTT 디스커버리를 통해 자동으로 나타나야 합니다.

경로 C: 로컬 REST API

로컬 REST API는 기기가 LAN에서 HTTP 서버를 실행한다는 것을 의미합니다 — 별도의 어댑터가 필요 없습니다. Zendure SolarFlow 800 Pro, Marstek(Marstek Local API HACS 통합 경유), Kostal Plenticore가 이 경로를 사용합니다.

  1. 1
    모델의 로컬 API 가용성 확인: HACS 통합 README 또는 제조업체 개발자 포털.
  2. 2
    HACS에서 통합 설치: "Marstek Local API" 또는 "Kostal Plenticore" 검색. Zendure-HA(공식)는 로컬 API와 클라우드 MQTT 모두 처리.
  3. 3
    기기 IP와 필요한 경우 관리자 비밀번호 입력(Kostal은 웹 UI 비밀번호 사용).
  4. 4
    센서 엔티티와 제어 기능 확인 — Kostal과 Marstek의 경우 모니터링뿐만 아니라 배터리 충전 한도 제어도 포함.

EVCC 통합

EVCC(오픈소스 전기차 충전 컨트롤러)는 베란다 태양광의 로컬 발전 데이터를 사용하여 전기차 충전을 태양광 피크 시간에 맞출 수 있습니다. EVCC는 Modbus TCP와 MQTT를 기본으로 지원합니다. evcc.yaml에서 기기를 type: modbus(Modbus TCP) 또는 type: mqtt(MQTT 브리지)의 미터로 구성하세요.

자주 묻는 질문

Anker SOLIX에서 Modbus TCP를 활성화하면 Anker 앱이 비활성화되나요?

아니요. Anker SOLIX의 공식 Modbus 통합은 Anker 앱과 클라우드와 병렬로 실행됩니다. Anker 앱 설정에서 Modbus TCP를 활성화하면 클라우드 기능을 제거하지 않고 로컬 레지스터 접근이 추가됩니다.

왜 표에 Zendure의 두 행이 있나요?

Zendure SolarFlow 800 Pro에는 인터넷 연결 없이 작동하는 로컬 HTTP/MQTT API가 있습니다. 구형 Zendure 모델(Hub 1200, Hub 2000, Hyper 2000, Ace 1500)은 Zendure의 클라우드 MQTT 브로커와만 통신합니다. 공식 Zendure-HA 통합은 두 경로를 모두 처리합니다.

EcoFlow PowerStream이 로컬 제어를 지원하게 될까요?

EcoFlow는 2025년 중반에 로컬 솔루션이 개발 중이라고 밝혔지만 출시 날짜는 없었습니다. 검증 날짜(2026-07-03) 기준으로 PowerStream에 대한 검증된 로컬 API 또는 Modbus TCP 경로가 없었습니다. 현재 상태는 EcoFlow 개발자 커뮤니티나 hassio-ecoflow-cloud 저장소를 확인하세요.

전반적으로 가장 좋은 로컬 제어를 가진 브랜드는 어디인가요?

Victron Cerbo GX가 가장 강력한 로컬 제어를 제공합니다: Home Assistant 코어의 공식 통합(HA 2026.5 이상), 공개된 레지스터 맵이 있는 문서화된 Modbus TCP, 완전 오프라인 로컬 MQTT. 그 다음은 Anker SOLIX로 공식 커뮤니티 HACS 통합과 클라우드 앱과 병렬로 작동하는 포트 502의 Modbus TCP를 제공합니다.

← Balcony Solar으로 돌아가기