Dashboard는 external-controller API에 연결해야 합니다. 열리지 않는 문제는 보통 수신 주소, 포트, secret, 교차 출처, 리버스 프록시 또는 방화벽과 관련이 있습니다. 로컬에서 제어 주소와 포트를 먼저 확인한 뒤 Dashboard에 같은 secret을 사용하세요. 원격 접근에는 마지막 단계에서 HTTPS와 접근 제어를 추가합니다.
connection refused, unauthorized 및 CORS 구분 방법
connection refused는 인터페이스에 연결되지 않았음을, unauthorized는 인터페이스가 응답했지만 인증에 실패했음을 뜻합니다. CORS는 브라우저의 교차 출처 제한입니다.
- external-controller가 활성화되어 올바른 주소에서 수신 중인지 확인
- 포트가 9090 또는 클라이언트에 실제 구성된 포트인지 확인
- Dashboard에 입력한 secret이 구성과 일치하는지 확인
- 브라우저 콘솔이나 로그에 unauthorized, connection refused 또는 CORS 오류가 표시되는지 확인
제어 주소, 포트 및 secret 일치시키기
- 먼저 클라이언트 또는 코어가 실행 중인지 확인
- 로컬에서 127.0.0.1과 제어 포트에 접속해 API가 응답하는지 확인
- Dashboard의 API 주소와 secret을 현재 구성 값으로 변경
- 포트가 사용 중이면 external-controller 포트를 바꾸고 Dashboard에도 동일하게 적용(참고: 외부 컨트롤러 설정, 포트 사용 중 문제 FAQ)
- 원격 접근에는 접근 제어와 HTTPS를 먼저 추가한 뒤 신뢰할 수 있는 네트워크에만 공개
9090은 일반적인 예제 포트일 뿐이며 실제 포트는 구성을 기준으로 합니다.
secret이 비어 있으면 제어 인터페이스의 위험이 커집니다.
external-controller를 공용 인터넷에 직접 노출하지 마세요.
Dashboard 복구 확인 방법
- 인터페이스에 접근할 수 있고 인증이 유효함
- 제어 주소에서 버전 정보가 반환되고 같은 secret을 사용하는 Dashboard에서 노드와 연결을 읽을 수 있습니다.
- 계속 연결 거부 또는 미인증 메시지가 표시됨
- connection refused와 unauthorized를 구분한 뒤 수신 주소, 포트, secret 및 요청 헤더를 각각 확인하세요.