장치 상태
로그인콘솔주문에 연결된 장치에 접근할 수 있는지 확인하고, 현재 올바른 인스턴스를 보고 있는지 점검하세요. 이전 주문 스크린샷의 주소를 재사용하지 마세요.
이 가이드는 이미 장치 정보를 확보한 개발자를 위한 문서입니다. 먼저 노드, 호스트 주소와 로컬 네트워크를 확인한 뒤 VNC 세션을 연결하세요. 연결 후 디스플레이, 키보드와 클립보드를 조정해 네트워크 문제를 호스트 장애로 오인하지 않도록 합니다.
장치 상태, 주소 또는 로컬 네트워크를 확인하기 전에 클라이언트를 계속 바꾸는 것이 원격 연결에서 가장 흔한 실수입니다. 아래 순서대로 확인하면 계정, 네트워크와 디스플레이 문제를 분리해 처리할 수 있습니다.
로그인콘솔주문에 연결된 장치에 접근할 수 있는지 확인하고, 현재 올바른 인스턴스를 보고 있는지 점검하세요. 이전 주문 스크린샷의 주소를 재사용하지 마세요.
장치가 싱가포르, 도쿄, 서울, 홍콩 또는 미국 서부 중 어느 노드에 있는지 확인하세요. 지역 간 경로는 입력 반응과 화면 새로 고침에 직접 영향을 줍니다.
주소를 한 글자씩 확인하고 포트, 공백 또는 설명 문구를 함께 복사하지 마세요. 주소가 변경되면 콘솔에 현재 표시된 정보를 기준으로 사용하세요.
연결 계정과 비밀번호는 신뢰할 수 있는 장치에서만 입력하세요. 연결 자격 증명을 코드 저장소, 단체 채팅 스크린샷, 공개 티켓 또는 공유 문서에 보관하지 마세요.
안정적인 유선 네트워크나 신호가 양호한 Wi-Fi를 우선 사용하고, 업로드 대역폭을 모두 사용하는 동기화 작업을 일시 중지하세요. 로컬 네트워크가 원격 연결을 차단하지 않는지도 확인합니다.
다음 절차는 macOS 클라이언트를 기준으로 합니다. 각 단계를 마칠 때마다 결과를 확인하고, 주소·인증·디스플레이 설정 사이를 오가지 마세요.
콘솔에서 해당 장치의 상세 정보를 열고 노드, 호스트 주소와 연결 계정을 기록하세요. 팀에서 여러 장치를 관리한다면 먼저 주문 번호와 장치 태그를 대조해 정확히 연결합니다.
검수: 주문·노드·장치 태그 일치macOS의 화면 공유 클라이언트를 열고 주소란에 콘솔에서 제공한 호스트 주소를 입력하세요. 프로젝트명, 노드와 장치 태그처럼 식별하기 쉬운 이름을 항목에 지정합니다.
검수: 클라이언트가 즉시 주소 오류를 표시하지 않고 연결을 시작함장치에 해당하는 연결 계정과 비밀번호를 입력하세요. 최초 연결 시 호스트 정보를 확인하고, 콘솔 기록과 다르면 작업을 중지한 뒤 주소를 다시 확인합니다.
검수: 인증이 완료되고 대상 장치에 진입함데스크톱 요소가 모두 로드될 때까지 기다린 뒤 마우스, 키보드, 창 이동과 클립보드를 차례로 테스트하세요. 이후 터미널을 열어 호스트 이름을 확인하고 다른 장치에서 명령을 실행하지 않도록 합니다.
검수: 화면·입력·클립보드·호스트 이름이 모두 정상고해상도, 다국어 키보드와 다중 모니터는 원격 데스크톱의 변수를 늘립니다. 조정할 때는 한 번에 하나의 설정만 변경하고 변경 전후 입력 지연과 화면 선명도를 기록하세요.
최초 연결에서는 낮은 해상도로 경로가 안정적인지 확인한 뒤 단계적으로 높이세요. 글자가 흐리면 원격 해상도와 로컬 디스플레이 배율을 동시에 바꾸지 말고 먼저 클라이언트 배율을 조정합니다.
로컬 입력 소스와 원격 레이아웃이 일치하는지 확인하세요. 중·일·한 입력기는 한영 전환과 후보 창을 중점적으로 확인하고, 유럽식 키보드는 Option, AltGr, 백슬래시와 기호 키 매핑을 확인합니다.
먼저 한 줄의 일반 텍스트로 양방향 복사를 테스트한 뒤 여러 줄 명령을 테스트하세요. 클립보드로 비밀번호, 개인 키 또는 비식별화되지 않은 설정을 전송하지 마세요. 대용량 파일은 관리되는 전송 절차를 사용해야 합니다.
먼저 단일 모니터 모드에서 연결 검수를 완료한 뒤 두 번째 화면을 추가하세요. 검은 여백, 배율 불일치 또는 커서 오프셋이 발생하면 단일 화면으로 돌아가 주·보조 화면 배치를 다시 확인합니다.
아래 표는 상대적인 거리를 비교하기 위한 자료이며 모든 사용자 경로의 고정된 결과를 의미하지 않습니다. 수치는 현지 통신사, 국제 라우팅, Wi-Fi 품질과 측정 시간의 영향을 받으므로 주문 전에 실제 네트워크에서 다시 측정할 수 있습니다.
| 접속 도시 | 싱가포르 | 도쿄 | 서울 | 홍콩 | 미국 서부 |
|---|---|---|---|---|---|
| 상하이 | 73 ms | 48 ms | 55 ms | 34 ms | 142 ms |
| 선전 | 42 ms | 66 ms | 72 ms | 21 ms | 151 ms |
| 타이베이 | 58 ms | 31 ms | 46 ms | 37 ms | 126 ms |
| 오사카 | 78 ms | 18 ms | 35 ms | 61 ms | 113 ms |
| 서울 | 89 ms | 37 ms | 9 ms | 67 ms | 128 ms |
| 싱가포르 | 8 ms | 72 ms | 86 ms | 39 ms | 168 ms |
| 로스앤젤레스 | 176 ms | 112 ms | 128 ms | 151 ms | 24 ms |
강조된 값은 이번 샘플에서 해당 접속 도시가 기록한 최저 중앙값입니다. VNC 상호작용은 지터, 패킷 손실과 업로드 대역폭의 영향도 받으므로 단 한 번의 Ping만으로 노드를 선택하지 마세요.
독립 물리 Mac은 리소스 격리를 제공하지만 연결 보안은 여전히 계정, 자격 증명과 사용 습관에 달려 있습니다. 팀은 작업자별로 추적 가능한 접근 범위를 설정해야 합니다.
주문 번호, 노드, 발생 시각, macOS 버전, 클라이언트 버전, 재현 단계와 비식별화 오류 로그를 기록하세요.
비밀번호, 개인 키, 전체 연결 자격 증명, 저장소 키와 비식별화되지 않은 설정 파일은 공개 커뮤니케이션 영역에 올리지 마세요.
먼저 발생 시각과 현재 증상을 기록한 다음 가장 쉽게 확인할 수 있는 조건부터 점검하세요. 각 점검을 마칠 때마다 한 번씩 재시도해야 어떤 변수가 연결에 영향을 주었는지 확인할 수 있습니다.
원격 데스크톱과 self-hosted runner는 동시에 사용할 수 있지만, 동일한 독립 물리 Mac의 프로세서, 메모리, 디스크와 네트워크를 공유합니다. 팀은 관찰 지표와 작업 범위를 명확히 정해야 합니다.
대용량 파일 복사, 종속성 설치 또는 그래픽 작업을 시작하기 전에 프로세서, 메모리, 디스크 공간과 네트워크 사용량을 확인하고 실행 중인 빌드가 있는지 점검하세요.
수동 디버깅에서 runner가 사용 중인 작업 영역을 직접 수정하지 마세요. 임시 검증에는 별도 디렉터리를 만들어 정리 스크립트가 다른 작업의 파일을 삭제하지 않도록 합니다.
빌드 실행 중에는 핵심 프로세스를 임의로 종료하거나 캐시를 일괄 삭제하고, 툴체인 버전을 변경하거나 장치를 재시작하지 마세요. 필요한 변경은 새 작업이 대기열에 들어오지 않도록 먼저 일시 중지해야 합니다.
이상 발생 시각, 관련 저장소, runner 태그, 작업 번호와 수동 작업을 기록하세요. 타임라인을 통해 문제가 네트워크, 리소스 경쟁 또는 환경 변경에서 비롯되었는지 판단할 수 있습니다.
지원 가이드에 먼저 도구 버전, 작업 디렉터리와 runner 태그를 기록하세요. 연결 문제가 계속되면 발생 시각, 노드, 클라이언트 버전과 비식별화 로그를 보관한 뒤 콘솔 티켓 또는 지원 이메일로 팀에 문의하세요.
support@globemini.com