EP.028 브라우저 넷 중 둘만 로스터와 통신한다

"로스터가 연결이 안 돼요"라는 문의에 하이퍼 로그가 어떻게 답하는지 궁금해서 연결 가이드와 트러블슈팅 페이지를 직접 읽어봤다. 결론부터 말하면, 이 문제는 케이블 불량이나 사용자 실수보다 훨씬 구조적인 이유로 발생하는 경우가 많았다. 로스터 연결 방식이 애초에 두 갈래로 나뉘어 있고, 그중 한 갈래는 브라우저 두 종류에서만 작동하도록 설계돼 있기 때문이다.

트러블슈팅 페이지는 로스터를 연결 방식에 따라 두 그룹으로 나눈다. 하나는 USB(시리얼) 로스터, 다른 하나는 네트워크(TCP·S7) 로스터다. 기센(Giesen)이나 이지스터 같은 브랜드가 후자의 예시로 명시돼 있다. USB 로스터는 브라우저가 Web Serial 권한만 허용하면 별다른 중계 프로그램 없이 바로 연결된다. 반면 네트워크 로스터는 브라우저가 로스터기와 직접 통신할 수 없다고 페이지에 분명히 적혀 있다. 왜 안 되는지에 대한 기술적 근거(프로토콜 수준의 제약인지, 브라우저 보안 정책 때문인지)는 페이지에 구체적으로 설명돼 있지 않아서, 이 부분은 추측하지 않고 "직접 통신 불가"라는 사실만 그대로 옮긴다.

그래서 네트워크 로스터를 쓰는 사람은 Hyper Bridge라는 별도 프로그램을 PC에서 실행해야 한다. 이 프로그램이 실행되면 설정 화면이 자동으로 열리는데, 주소가 http://localhost:3030 이라고 페이지에 명시돼 있다. 실제 통신은 WebSocket 8765번 포트를 쓴다. 두 개의 포트 번호가 이렇게 구체적으로 공개돼 있다는 점은, 방화벽이나 백신 프로그램이 연결을 막는 경우 사용자가 정확히 어느 포트를 열어줘야 하는지 스스로 확인할 수 있게 해준다는 점에서 꽤 실용적인 정보 공개라고 느껴졌다.

여기서 흥미로운 점은 데스크톱 앱과 웹 브라우저 버전의 차이다. 트러블슈팅 페이지는 "데스크톱 앱은 Hyper Bridge가 내장돼 있다"고 적고 있다. 즉 데스크톱 앱을 쓰는 사람은 이 중계 프로그램을 따로 설치하거나 실행할 필요가 없다는 뜻이다. 반면 웹 브라우저로 접속하는 사람은 로스팅을 시작하기 전에 매번 Hyper Bridge를 먼저 켜둬야 한다. 이건 단순한 "더 많은 기능" 차이가 아니라, 웹 버전 사용자에게만 해당되는 실제 운영 부담이다. 브릿지를 깜빡하고 안 켠 채로 로스팅을 시작하려다 연결 실패를 겪는 시나리오가 충분히 현실적으로 그려진다.

브라우저 제약은 더 단호하게 적혀 있다. "Safari·Firefox는 보안 정책 때문에 로컬 브릿지(ws://localhost) 연결을 막습니다"라는 문장이 그대로 나온다. 이 말은 곧, 네트워크 로스터를 웹 버전으로 쓰려는 사람은 4대 주요 브라우저 중 정확히 절반, 즉 Chrome과 Edge만 선택지로 남는다는 뜻이다. Safari나 Firefox를 평소에 쓰는 사람이 이 사실을 모른 채 연결을 시도하면, 아무리 설정을 다시 확인해도 근본적으로 해결되지 않는다. 이건 사용자 잘못이 아니라 브라우저 차원의 정책 문제이므로, 트러블슈팅 항목 중 두 번째 순서로 배치돼 있다는 점도 납득이 간다.

실제로 페이지에 나열된 점검 순서는 총 6단계인데, ①Hyper Bridge 실행 여부 ②Chrome/Edge 사용 여부 ③포트·방화벽 ④같은 네트워크(LAN)·IP ⑤USB 시리얼 권한 ⑥그래도 안 되면 문의, 순이다. 순서가 곧 우선순위라고 가정한다면, 이 서비스가 가장 흔하다고 판단하는 연결 실패 원인은 "브릿지를 안 켰다"는 것이고, 그 다음이 "브라우저가 잘못됐다"는 것이다. 다만 이 순서가 실제 문의 빈도 통계를 근거로 정해진 것인지, 아니면 기술적 의존관계(브릿지가 꺼져 있으면 다른 원인을 점검해봐야 소용없다는 논리) 때문인지는 페이지만으로는 확인할 수 없었다. 이 부분은 확인 안 된 추정으로 남겨둔다.

USB 로스터 쪽은 상대적으로 단순하다. 브릿지도 필요 없고 브라우저 제약도 없다. 대신 "Web Serial 권한을 허용하고, 다른 프로그램이 포트를 점유하지 않았는지 확인하라"는 항목이 별도로 있다. 로스팅 소프트웨어를 여러 개 켜두는 사람이라면 포트 점유 충돌이 실제로 일어날 법한 문제다.

정리하면, 하이퍼 로그의 로스터 연결은 하나의 통합된 절차가 아니라 로스터 통신 방식에 따라 완전히 다른 경로를 탄다. USB 로스터라면 웹이든 데스크톱이든 큰 차이가 없지만, 네트워크 로스터를 쓴다면 웹 버전에서는 Hyper Bridge 실행과 Chrome·Edge 사용이라는 두 가지 전제 조건이 붙는다. 이 정보가 마케팅 페이지가 아니라 트러블슈팅 페이지에 이렇게 구체적인 포트 번호와 브라우저 이름까지 명시돼 있다는 점은, 적어도 이 부분에서는 서비스가 자신의 제약을 숨기기보다 그대로 드러내는 쪽을 택했다는 인상을 준다.