Home Assistant는 리버스 프록시 뒤에서 실행할 수 있지만, 재작성된 하위 경로에서 안정적으로 제공하는 방식은 일반적으로 지원되는 배포 경계가 아닙니다.
example.com/homeassistant의 페이지가 HTML을 반환하더라도 이후 요청은 루트 상대 에셋, 인증 경로, WebSocket 또는 통합 콜백을 대상으로 할 수 있습니다. 첫 화면만 테스트하지 마세요. 새 브라우저를 사용해 로그인하고, 실시간 대시보드를 열고, 중첩 경로를 새로 고친 다음, 콜백 하나를 완료하세요. 어느 계층에서든 접두 경로가 사라진다면 재작성 규칙을 더 추가하지 말고 Home Assistant를 자체 호스트 이름으로 옮기세요.
리버스 프록시 지원과 하위 경로 지원 구분하기
리버스 프록시는 TLS를 종료하고 호스트 이름 루트로 들어오는 요청을 Home Assistant로 전달할 수 있습니다. 하위 경로를 사용하려면 애플리케이션이 이해하는 접두 경로를 모든 생성 URL, 에셋, API 호출, WebSocket, 리디렉션 및 콜백에서 일관되게 유지해야 합니다. 프록시 계층에서 성공했다고 해서 애플리케이션 계층의 해당 계약까지 성립하는 것은 아닙니다.
Home Assistant 커뮤니티 테스트에서는 애플리케이션이 URL 접두 경로 아래에 배포되는 것을 지원하지 않는다는 직접적인 결론에 도달했습니다. Home Assistant를 하위 경로에 배치하는 방법에 대한 확정된 답변은 프록시 선택과 관계없이 서브도메인을 권장합니다.
리버스 프록시 지원 PASS는 Home Assistant가 올바른 포워딩을 통해 전용 호스트 이름의 루트에서 작동함을 뜻합니다. 제안된 하위 경로의 FAIL은 하나 이상의 애플리케이션 경로에서 접두 경로가 사라짐을 뜻합니다. 두 판정을 합쳐 리버스 프록시 자체가 호환되지 않는다고 주장하지 마세요.
프런트엔드 에셋을 첫 번째 저위험 테스트로 사용
Home Assistant를 변경하기 전에 비공개 브라우저 프로필에서 제안된 하위 경로를 열고 네트워크 요청을 확인하세요. 기본 문서는 로드되지만 JavaScript, 아이콘, 매니페스트 또는 번역 리소스가 호스트 이름의 루트를 기준으로 경로를 요청한다면, 이 토폴로지는 첫 번째 가역 판별 테스트부터 통과하지 못한 것입니다.
문서화된 경로 재작성 시도에서는 메인 페이지가 반환됐지만, 프런트엔드 리소스는 Home Assistant 접두 경로 없이 슬래시로 시작하는 URL을 요청했습니다. 이 루트 상대 에셋 오류는 애플리케이션 경로 불일치이지, 프록시에 파일이 없다는 뜻이 아닙니다.
PASS는 의도한 경로에서 모든 프런트엔드 리소스가 정상적으로 반환됨을 뜻합니다. FAIL은 404 응답이나 루트 경로 요청이 나타남을 뜻합니다. 여기서 중단하고 전용 호스트 이름을 테스트하세요. 향후 프런트엔드 빌드에서 재작성 규칙이 처리하지 못하는 새 경로가 생길 수 있으므로 응답 본문 치환은 취약합니다.
WebSocket, 인증 및 중첩 경로 테스트
정적 대시보드 셸은 완전한 세션이 아닙니다. 새 브라우저 프로필로 로그인하고, 몇 분 동안 엔터티 업데이트를 확인한 다음, 중첩 대시보드 URL을 새로 고침하고 로그아웃한 뒤 다시 로그인하세요. 그런 다음 HTTP 업그레이드, 토큰, 리디렉션, 경로 재로드가 동일한 공개 오리진과 경로를 유지하는지 확인하세요.
Home Assistant는 프런트엔드 실시간 통신에 WebSocket을 많이 사용하므로 프록시가 업그레이드 경로와 헤더를 그대로 전달해야 합니다. 운영자가 설명한 리버스 프록시의 WebSocket 처리는 HTML을 불러오는 것만으로는 호환성을 충분히 검증할 수 없는 이유를 보여 줍니다.
PASS는 경로 변환 오류 없이 인증, 실시간 업데이트, 탐색, 직접 새로고침이 모두 작동함을 뜻합니다. WebSocket이나 리디렉션에서만 발생하는 FAIL도 하위 경로 설계를 부적합으로 판정하기에 충분합니다. 프록시 지시문 하나를 수정했다고 해서 콜백과 향후 경로가 접두사를 지원하게 된다는 뜻은 아닙니다.
안정적인 경계로 전용 호스트 이름 선택하기
Home Assistant를 ha.example.com과 같은 전용 호스트 이름의 루트에 공개한 다음, 리버스 프록시를 통해 해당 호스트 이름의 요청을 내부 서비스로 라우팅하세요. 이렇게 하면 애플리케이션이 경로 접두사를 인식하지 않아도 하나의 공개 출처를 유지할 수 있습니다. 비공개 VPN이나 터널을 사용하면 공개 노출 없이 동일하게 깔끔한 루트 경계를 만들 수 있습니다.
네트워크 변경 후 기존 원격 경로가 끊기면 DNS, 공인 주소, NAT, 터널, 프록시 라우팅을 각각 확인하세요. 라우터 변경 후 원격 접속에 대한 ZimaSpace 진단에서 관련 경로를 확인할 수 있습니다.
대안은 새 브라우저에서 에셋을 불러오고, WebSocket을 연결하고, 인증을 완료하고, 중첩 경로를 새로고침하고, 프록시 재시작 후에도 Home Assistant에 접속할 수 있으면 통과입니다. DNS 또는 프록시 변경을 롤백하는 데 필요한 동안만 기존 경로를 유지하고, 모호한 공개 URL 두 개를 무기한 운영하지 마세요.
전체 세션이 재시작 후에도 유지되면 중단하세요
프록시와 Home Assistant를 한 번씩 재시작한 뒤, LAN과 예정된 원격 네트워크에서 전체 테스트를 반복하세요. 인증서 이름, 전달된 클라이언트 주소, 신뢰할 수 있는 프록시 범위, 로그인, 실시간 상태, 로그아웃, 통합 콜백 하나를 확인하세요. 이는 원래의 전체 작업이지, 축소된 정적 페이지 확인이 아닙니다.
모든 단계를 통과하는 루트 호스트 이름 설계만 성공으로 판정하세요. 사용자 지정 응답 재작성 후에만 작동하는 하위 경로는 업데이트로 에셋 또는 콜백 동작이 바뀔 수 있으므로, 지원되지 않는 기술 부채로 남습니다. 정상 작동이 확인된 호스트 이름, 업스트림 주소, 롤백 구성을 문서화하세요.
루트 호스트 이름 설계가 여전히 실패하면 문제를 상위 단계로 이관하세요. 남은 원인은 기본 경로 지원보다는 프록시 신뢰 설정, WebSocket 전달, DNS, 인증서 또는 라우팅일 가능성이 높습니다. 원하는 URL 형태를 유지하려고 보호되지 않은 포트에서 Home Assistant를 직접 공개하지 마세요.
지원 및 팁
더 읽어보기

가족에게 NAS의 성인 동영상을 숨기는 방법
가족용 NAS에서 성인 동영상을 비공개로 보관하세요. 폴더 권한, Plex 및 Jellyfin 라이브러리 액세스 권한, 썸네일, 시청 기록, TV 공유 로그인 및 DLNA를 확인하세요.

Transformers에서 커뮤니티 모델을 불러오기 전에 확인할 사항
Transformers Jinja 샌드박스 업데이트를 활용해 모델의 출처, 채팅 템플릿, 원격 코드, 직렬화된 가중치, 격리된 첫 실행을 검토하세요.

Mirage를 로컬에서 실행: 한 장의 이미지로 OCR 및 객체 감지
Cactus Compute의 소형 로컬 비전 모델을 사용해 보고, 실제 입력으로 OCR 및 객체 추출을 검증하며, 메모리, 언어 및 개인정보 보호의 한계를 파악해 보세요.



