클라우드 엔진 · 03

KaTrain을 Read19 클라우드 KataGo에 연결하는 방법

컴퓨터에서는 KaTrain 인터페이스를 그대로 쓰고 KataGo 계산은 Read19 클라우드 엔진에 맡깁니다. 로컬 GPU 설정이 필요 없습니다.

1. Read19 계정과 접근 토큰을 만듭니다

   계정 페이지에 로그인해 KaTrain 전용 토큰을 만듭니다. 전체 토큰은 한 번만 표시됩니다. 비밀번호 관리자에 저장하고 스크린샷, 기보나 공개 게시물에 넣지 마세요.

   KaTrain 전용 토큰을 만들면 문제가 생겨도 다른 클라이언트에 영향 없이 이 연결만 취소할 수 있습니다. “MacBook · KaTrain”처럼 기기와 용도를 이름에 넣으면 나중에 최근 작업의 출처를 찾기 쉽습니다. 토큰이 나타나면 바로 비밀번호 관리자에 저장하고 셸 기록, 동기화 메모나 스크린샷에 남기지 마세요. 연결 시험 후 계정 페이지에서 마지막 사용 시간이 갱신되었는지도 확인합니다.

2. KaTrain 연결 URL을 복사합니다

   계정 페이지에서 wss://read19.com/v1/katago/ 로 시작하는 KataGo WebSocket URL을 생성합니다. 마지막 부분에 토큰이 있으므로 전체 URL을 자격 증명으로 취급하세요.

   WSS URL은 프로토콜, Read19 도메인, KataGo 엔드포인트와 Token으로 구성되므로 전체 주소가 자격 증명입니다. 복사할 때 마지막 문자를 빼거나 따옴표와 공백을 추가하지 마세요. 브라우저에서 read19.com이 열려도 네트워크가 WebSocket을 허용한다는 뜻은 아닙니다. 회사, 학교 또는 프록시 네트워크는 WSS만 따로 막을 수 있습니다. 진단할 때도 전체 주소를 공개 Issue에 붙이지 마세요.

3. KaTrain에서 원격 엔진을 선택합니다

   KaTrain 엔진 설정을 열고 WebSocket Remote Engine을 선택한 뒤 전체 연결 URL을 붙여 넣습니다. KaTrain 버전에 따라 이름이 조금 다를 수 있습니다. 항목이 없다면 WebSocket 원격 엔진을 지원하는 버전으로 업데이트하세요.

   KaTrain에서 WebSocket Remote Engine을 고른 뒤 다른 컴퓨터의 전체 설정을 복사하지 말고 연결 URL만 바꿉니다. 규칙, 모델 선호와 분석별 설정은 그대로 두고 처음에는 기본 또는 낮은 분석량으로 연결을 확인하세요. 버전에 따라 메뉴 이름은 조금 다르지만 기준은 같습니다. 원격 엔진이 선택되어 있고 URL이 wss://로 시작하며 저장 직후 로컬 프로세스로 돌아가지 않는지 확인합니다.

4. 명국과 TreeView로 연결을 확인합니다

   이 가이드의 귀 붉어진 대국을 불러와 분석합니다. 도착한 후보 수를 TreeView에서 열고 126수로 돌아갈 수 있으면 바둑판, 후보 수와 분기 상태가 모두 정상이라는 증거입니다. 마지막으로 최근 작업과 분석 단위를 확인합니다.

   확인할 때는 열몇 수의 작은 기보를 불러와 국면 하나를 고르고 후보 수를 기다립니다. KaTrain 상태와 Read19 최근 작업을 함께 보세요. 앞쪽은 화면이 결과를 받았다는 증거이고 뒤쪽은 요청이 클라우드를 거쳐 사용량을 만들었다는 증거입니다. 연결로 표시되지만 후보 수가 없으면 분석이 시작됐는지 확인하고, 작업이 생긴 뒤 실패하면 새 토큰을 반복해서 만들기보다 토큰 상태, 분석 단위와 서비스 상태를 살펴봅니다.