Hedy 연결 문제(VPN, 방화벽, 회사 네트워크)
Hedy에 로그인할 수 없거나, 결제 후에도 무료 요금제로 표시되거나, 요약이 생성되지 않거나, 세션이 동기화되지 않거나, 연결 중 상태에서 멈춘다면 대개 Hedy에서 외부로 나가는 연결 중 하나가 차단된 것입니다. 업무용 컴퓨터에서는 보통 회사 네트워크나 VPN이 원인입니다. 개인용 컴퓨터에서는 대개 광고 차단기가 원인입니다. 이 문서에는 허용 목록에 추가할 호스트 이름과 각 호스트가 지원하는 기능이 나와 있습니다. IT 팀에 공유하거나 직접 문제의 원인을 확인할 때 참고하세요.
빠른 확인 방법: 회사 외부 네트워크에서 테스트
허용 목록을 변경하기 전에 네트워크 필터가 문제의 원인인지 확인하세요.
-
회사 VPN 연결을 끊으세요.
-
휴대전화의 모바일 데이터를 쓰는 개인용 핫스팟이나 집 네트워크에 연결하세요.
-
문제가 발생한 작업을 다시 시도하세요.
다른 네트워크에서 정상적으로 작동하면 회사 네트워크나 VPN이 원인입니다. 아래 허용 목록에 따라 설정하세요.
시도한 모든 네트워크에서 실패하면 네트워크 필터링이 원인이 아닙니다. 휴대전화 같은 다른 기기에서 같은 계정이 정상적으로 작동하는지 확인하세요. 휴대전화에서는 정상이고 특정 컴퓨터에서만 문제가 생긴다면 그 컴퓨터에서 실행 중인 무언가가 Hedy를 차단하고 있는 것입니다. 가장 흔한 원인은 다음 섹션에서 설명합니다.
광고 차단기와 콘텐츠 차단기
개인 컴퓨터에서도 연결이 차단될 수 있습니다. 컴퓨터에서 실행 중인 광고 차단기나 콘텐츠 차단기는 방화벽과 마찬가지로 Hedy의 로그인 확인을 차단할 수 있으며, 대개 오류 메시지도 표시되지 않습니다. 가장 흔한 증상은 실제로는 무료 요금제가 아닌데 Hedy에서 무료 요금제로 표시되는 것입니다.
이 문제는 두 가지 이유로 알아차리기 어렵습니다.
-
모든 브라우저와 데스크톱 앱에 동시에 영향을 주므로, 다른 브라우저를 쓰거나 Hedy를 다시 설치해도 달라지지 않습니다.
-
같은 계정이 휴대전화에서는 계속 작동하므로, 컴퓨터에서 실행 중인 프로그램이 원인인데도 컴퓨터 자체에 문제가 있는 것처럼 보입니다.
차단기를 잠시 중지하고 Hedy를 새로고침하세요. 문제가 해결되면 차단기를 계속 꺼 두는 대신, 아래 호스트 목록을 참고해 Hedy를 예외로 추가하세요.
보안 소프트웨어도 같은 문제를 일으킬 수 있습니다. McAfee 같은 바이러스 백신 앱은 컴퓨터의 네트워크 설정에 콘텐츠 필터를 추가할 수 있습니다. 이 경우 로그인은 되지만 Hedy의 동기화 연결은 차단될 수 있습니다. 필터를 잠시 끄고 Hedy를 다시 여세요. 세션이 동기화되기 시작하면 아래 목록에 있는 Hedy 호스트를 해당 필터의 예외로 추가한 뒤 필터를 다시 켜세요.
차단 목록은 자동으로 업데이트됩니다. 그래서 설정을 바꾸지 않았더라도 어제까지 작동하던 연결이 오늘부터 차단될 수 있습니다.
로그인만 차단될 때: 회사 외부 네트워크에서 한 번 로그인
Windows에서는 회사 네트워크가 로그인만 차단하는 경우가 많습니다. 계정 서비스와 처음 연결을 맺는 과정이 차단되는 것이어서, 로그인 이후에는 평소처럼 사용할 수 있습니다. 로그인만 실패한다면 위에서 소개한 핫스팟으로 문제를 해결할 수도 있습니다.
-
업무용 VPN을 모두 끈 상태에서 휴대전화 핫스팟을 켜거나 집 네트워크에 연결하세요.
-
Hedy에 로그인하세요.
-
평소 사용하는 회사 네트워크에 다시 연결하세요.
대부분의 경우 이미 로그인 세션이 설정되어 첫 연결 과정을 반복할 필요가 없으므로 Hedy가 계속 작동합니다. 로그인만 차단된다면 이렇게 한 번 로그인하는 것으로 허용 목록 설정을 생략할 수 있습니다. 회사 네트워크에서 바로 로그인할 수 있도록 문제를 근본적으로 해결하려면 이 문서의 나머지 부분에 나오는 허용 목록과 검사 예외 설정 절차를 따르세요.
클라우드가 필요한 기능
Hedy에는 네트워크 연결 없이 사용할 수 있는 기능도 있습니다. 어떤 기능이 작동하지 않는지 확인하면 어느 엔드포인트가 차단됐는지 범위를 좁힐 수 있습니다.
| 기능 | 클라우드 연결 필요 여부 |
|---|---|
| 로컬 Whisper 음성 텍스트 변환 | 불필요. 완전히 오프라인으로 작동 |
| 로컬 Nemotron 음성 텍스트 변환(네이티브 앱) | 불필요. 완전히 오프라인으로 작동 |
| 로컬 AI 요약 생성 | 불필요. 완전히 오프라인으로 작동 |
| 클라우드 STT(Deepgram, OpenAI, xAI) | 필요. 제공업체의 API 호스트에 연결해야 함 |
| 클라우드 AI 요약 생성 | 필요. Hedy의 AI 제공업체에 연결해야 함 |
| 로그인(Google 또는 Apple) | 필요. OAuth 제공업체와 Hedy의 인증 엔드포인트에 연결해야 함 |
| 기기 간 클라우드 동기화 | 필요. Hedy의 API와 Firebase에 연결해야 함 |
| Hedy 지원 채팅(Intercom 위젯) | 필요. Intercom 호스트에 연결해야 함 |
| 앱 업데이트(Windows 자동 업데이트) | 필요. Hedy의 배포 엔드포인트에 연결해야 함 |
보안 요구 사항이 높은 환경에서 오디오 캡처와 음성 텍스트 변환만 필요하다면 ‘설정’에서 로컬 Whisper와 ‘로컬 AI’로 전환해 대부분의 호스트를 허용 목록에 추가하지 않고도 사용할 수 있습니다. 로컬 AI 처리를 참고하세요.
허용 목록에 추가할 호스트
Hedy는 아래 모든 호스트에 HTTPS(443 포트)로 연결합니다. 실시간 클라우드 STT에 사용하는 WebSocket 연결도 443 포트(wss://)를 사용합니다. 유일한 예외는 데스크톱에서 Google 로그인에 사용하는 OAuth 콜백입니다. 이 콜백은 127.0.0.1에서 동적 포트로 잠시 실행되는 로컬 HTTP 리스너를 사용합니다. 기기 내부에서만 연결하므로 회사 방화벽의 허용 목록에 추가할 필요가 없습니다.
아래 와일드카드로 대부분의 팀에 필요한 호스트를 허용할 수 있습니다. 방화벽이 와일드카드를 지원하지 않거나 보안 팀에서 정확한 하위 도메인을 하나씩 나열한 전체 목록을 요구한다면 support@hedy.bot으로 문의하세요. 최신 공식 목록을 보내 드립니다. 내부 하위 도메인은 시간이 지나면서 바뀌므로 이 문서에 전부 공개하지 않습니다. IT 팀에는 데이터 보관 위치에 맞는 최신 정보를 제공해 드립니다.
Hedy 기본 기능(항상 필요)
-
*.hedy.bot— Hedy API 및 로그인 -
*.hedy.ai— Hedy CDN 및 웹 앱 -
*.firebaseapp.com,*.appspot.com,*.googleapis.com— Firebase 및 Vertex AI -
*.a.run.app— Hedy의 Cloud Run 서비스 -
*.cloudfunctions.net— Hedy의 Cloud Functions
로그인 제공업체
-
accounts.google.com,oauth2.googleapis.com— Google 로그인 -
Apple 로그인은 Windows에서 Hedy의 인증 도메인을 사용하고, iPhone, iPad, Mac에서는 운영체제의 기본 기능을 사용합니다.
클라우드 음성 인식(사용자가 제공한 API 키 사용)
-
api.openai.com— OpenAI STT -
api.deepgram.com— Deepgram STT -
api.x.ai— xAI STT
구독 및 결제
api.revenuecat.com,pay.rev.cat— 구독 및 결제
로컬 AI 모델(사용자가 다운로드하는 경우에만 필요)
huggingface.co— 로컬 AI 모델 다운로드
클라우드 STT가 차단될 때의 동작
음성 인식 제공업체로 Deepgram, OpenAI 또는 xAI를 설정했는데 Hedy가 해당 호스트에 연결할 수 없으면 다음 메시지 중 하나가 표시됩니다.
-
Using Local Transcription — Cloud provider not available. Using on-device transcription instead. — Hedy가 해당 세션에 한해 자동으로 로컬 Whisper로 전환합니다.
-
Configuration Required — Please configure an API key for your speech recognition provider in Settings. — Hedy가 유효한 API 키를 찾지 못했습니다. 네트워크 차단과는 별개의 문제입니다.
-
Cloud transcription failed: [error]. Using on-device transcription. — 제공업체의 WebSocket 연결이 끊어지고 재연결 시도도 실패하면 세션 도중에 기기 내 음성 텍스트 변환으로 전환합니다.
로컬 전환은 자동입니다. 로컬 STT도 사용할 수 없으면 Local Transcription Unavailable — Unable to switch to on-device transcription after cloud failure. Ending session. 메시지가 표시되고 세션이 종료됩니다.
흔한 VPN 및 프록시 문제
TLS 검사 / SSL Bombing
많은 회사 방화벽이 TLS 검사를 수행합니다. 암호화된 연결을 가로채 복호화한 다음 방화벽 자체 인증서로 다시 암호화하는 방식입니다. Hedy에서 사용하는 일부 SDK(Firebase, Google Sign-In, RevenueCat)는 인증서 검증 방식 때문에 TLS 검사를 거친 연결을 거부할 수 있습니다. TLS 검사가 원인으로 의심되면 IT 팀에 Hedy 호스트를 TLS 검사에서 제외해 달라고 요청하고 동작이 달라지는지 확인하세요. 허용 목록에 추가하는 것과 달리, 검사 예외를 적용하면 방화벽이 연결을 가로채는 과정 자체를 건너뜁니다.
분할 터널링 VPN
일부 회사 VPN은 접속 대상이 회사 리소스와 무관해도 모든 트래픽을 회사 네트워크로 보냅니다(“전체 터널”). 개인 Wi-Fi에서는 Hedy가 작동하지만 VPN에 연결하면 작동하지 않는다면, Hedy의 트래픽이 VPN을 거치지 않도록 IT 팀에 Hedy 호스트를 분할 터널링 제외 목록에 추가해 달라고 요청하세요.
DNS 기반 차단
네트워크에서 DNS 기반 콘텐츠 필터(Cisco Umbrella, OpenDNS, Cloudflare Gateway 등)를 사용하면 카테고리에 따라 도메인이 차단될 수 있습니다. 필터 정책의 허용 목록에 Hedy 호스트를 추가해야 합니다.
Windows에서 Apple 로그인
Windows에서 Apple 로그인을 할 때 “connection refused” 오류가 표시되는 경우는 별개의 문제입니다. Mac 및 Windows 로그인 문제를 참고하세요.
IT 팀에 공유할 내용
네트워크 관리자에게 Hedy를 허용 목록에 추가해 달라고 요청해야 한다면 이 페이지를 공유하거나 아래 요약을 복사해 보내세요.
Hedy AI는 다음 호스트에 HTTPS(443 포트) 및 WSS(443 포트)로 연결할 수 있어야 합니다.
항상 필요
*.hedy.bot,*.hedy.ai*.firebaseapp.com,*.appspot.com,*.googleapis.com*.a.run.app,*.cloudfunctions.netaccounts.google.com,oauth2.googleapis.com(Google 로그인)api.revenuecat.com,pay.rev.cat(구독)사용자가 클라우드 음성 인식을 설정한 경우
api.openai.com(OpenAI)api.deepgram.com(Deepgram)api.x.ai(xAI)사용자가 로컬 AI 모델을 다운로드하는 경우
huggingface.co방화벽이 와일드카드를 지원하지 않는다면 데이터 보관 위치에 맞는 정확한 최신 하위 도메인 목록을 Hedy 지원 팀에 요청하세요.
관련 문서
-
로컬 AI 처리 — 완전히 오프라인으로 사용
-
데이터 보관 위치 — 미국과 EU 중 데이터 보관 위치 선택
-
기기 간 세션이 동기화되지 않는 문제 — 동기화에 문제가 있을 때
-
Mac 및 Windows 로그인 문제 — 두 플랫폼의 데스크톱 앱 로그인 문제
문제가 계속되나요? 채팅 위젯으로 문의하세요. 위젯도 차단되면 hello@hedy.bot으로 연락하세요. 작동하지 않는 기능, 정확한 오류 메시지, VPN이나 회사 방화벽을 사용 중인지 함께 알려 주세요.