안전한 연결 및 도구 체인 검증

VNC 및 SSH로 클라우드 Mac에 연결하기

먼저 노드 상태와 호스트 지문을 확인한 후 그래픽 또는 명령줄 세션을 시작하세요. 이 가이드에서는 최초 로그인, 키 설정, Xcode 빌드 검증, 원격 환경 최적화 및 문제 진단을 다룹니다.

연결 주소, 사용자 이름 및 임시 자격 증명은 주문 완료 후 노드 확인이 끝나면 제공됩니다. 사용 가능 여부와 연결 매개변수는 콘솔에 실시간으로 표시되는 정보를 기준으로 합니다.

시작하기 전에

연결 조건 6가지 확인

비밀번호를 반복해서 시도하는 것부터 시작하지 마세요. 노드, 리전, 자격 증명 및 로컬 네트워크를 먼저 확인하면 제공 문제, 인증 문제와 네트워크 경로 문제를 빠르게 구분할 수 있습니다.

노드 상태

콘솔에 로그인하여 인스턴스가 연결 가능한 상태인지 확인하고 노드 ID를 기록하세요. 노드가 아직 초기화 중이라면 확인되지 않은 호스트 지문을 저장하지 마세요.

상태가 정상이면 연결

노드 리전

주문 리전과 인스턴스 리전이 일치하는지 확인하세요. 현재 디렉터리는 싱가포르, 일본(도쿄), 한국(서울), 홍콩, 미국 동부, 미국 서부의 6개 리전을 지원합니다.

Region / Node ID

사용자 이름 및 임시 자격 증명

콘솔에서 제공한 사용자 이름을 대소문자까지 정확히 복사하세요. 최초 로그인 후 임시 비밀번호를 즉시 변경하고 SSH에는 우선 키 인증을 설정하세요.

일반 이메일로 자격 증명을 전달하지 마세요

로컬 네트워크

먼저 안정적인 유선 네트워크 또는 신뢰할 수 있는 Wi-Fi에서 테스트하세요. 기업 프록시, 게스트 네트워크 및 공용 핫스팟은 SSH 또는 VNC에 필요한 포트를 제한할 수 있습니다.

VPN 및 프록시 규칙의 영향을 먼저 배제하세요

시스템 방화벽

로컬 방화벽이 사용하는 클라이언트의 아웃바운드 연결을 허용하는지 확인하세요. 사무실 네트워크를 통해 접속한다면 네트워크 관리자에게 대상 주소와 포트 정책을 확인해 달라고 요청하세요.

SSH 22 / VNC 5900

연결 정보 일치 여부

호스트 주소, 포트, 사용자 이름 및 리전의 네 항목을 비교하세요. 이전 노드에 저장된 클라이언트 설정을 새로 할당된 물리 노드에 그대로 사용하지 마세요.

새 노드에는 새 연결 설정을 만드세요
보안 경계

연결 매개변수는 콘솔에서만 확인하세요. 개인 키, 전체 비밀번호, 액세스 토큰 또는 비식별화되지 않은 빌드 로그를 일반 문서나 코드 저장소에 제출하지 마세요.

그래픽 인터페이스

VNC로 최초 그래픽 연결 완료하기

VNC는 Xcode 그래픽 인터페이스, 서명 아카이브 확인 및 데스크톱 상호 작용이 필요한 작업에 적합합니다. 최초 연결 시 주소, 인증, 화질 및 종료 설정을 순서대로 구성하세요.

  1. 01

    콘솔에서 반환된 주소와 포트 입력

    VNC 클라이언트에서 새 연결을 만들고 호스트 주소를 한 글자도 빠짐없이 복사하세요. 콘솔에 사용자 지정 포트가 표시되면 해당 포트를 사용하고 임의로 추측하거나 이전 인스턴스의 매개변수를 재사용하지 마세요.

    확인 사항:클라이언트 설정의 리전 라벨이 주문 리전과 일치해야 합니다.
  2. 02

    노드 사용자 이름으로 인증

    콘솔에서 제공한 노드 사용자 이름과 임시 자격 증명을 입력하세요. 연속으로 실패하면 먼저 시도를 멈추고 사용자 이름을 다시 복사한 뒤 키보드 레이아웃을 확인하여 반복 오류로 보안 제한이 발생하지 않도록 하세요.

    확인 사항:자격 증명 앞뒤에 공백이나 줄바꿈이 복사되지 않았는지 확인하세요.
  3. 03

    네트워크 경로에 맞춰 디스플레이 품질 조정

    먼저 자동 해상도와 중간 색상 품질로 안정적인 기준을 설정하세요. 대륙 간 연결에서는 해상도, 색 심도 및 새로 고침 빈도를 낮춘 다음 화질을 항목별로 높일 수 있습니다.

    권장 시작 설정:1920 × 1080, 배율 100%, 동적 화질 켜기
  4. 04

    민감하지 않은 내용으로 클립보드 먼저 확인

    일반 텍스트를 복사하여 로컬과 원격 간 양방향 클립보드가 예상대로 작동하는지 확인하세요. 비밀번호, 개인 키 또는 액세스 토큰으로 클립보드 기능을 테스트하지 마세요.

    주의:팀 공유 환경에서는 필요에 따라 클립보드 동기화를 끄세요.
  5. 05

    세션을 종료하되 작업을 직접 중단하지 않기

    창을 닫기 전에 빌드가 포그라운드에서 실행 중인지 확인하세요. 지속 작업은 CI runner, launchd 또는 터미널 세션 관리 도구에 맡겨 VNC 연결이 끊겨 포그라운드 프로세스가 종료되지 않도록 하세요.

    확인 사항:종료 후 콘솔에서 노드가 계속 정상 실행 중인지 확인하세요.
명령줄 접속

감사 가능한 개발 진입점으로 SSH 사용

SSH는 저장소 동기화, 종속성 설치, 자동화 빌드 및 로그 수집에 적합합니다. 최초 연결에서 중요한 것은 경고를 빨리 건너뛰는 것이 아니라 호스트 지문을 확인하고 장기 권한을 최소화하는 것입니다.

지문이 일치하지 않으면 즉시 중지

로컬 기록을 바로 삭제하고 계속 연결하지 마세요. 먼저 노드가 재설치 또는 재할당되었는지, 주소가 변경되었는지 확인한 후 콘솔 티켓으로 검증하세요.

01

호스트 지문 확인

최초 연결 시 터미널에 표시된 지문을 콘솔에서 제공한 정보와 구간별로 비교하세요. 노드 주소는 같지만 지문이 변경되었다면 경고를 무시하지 말고 보안 이벤트로 처리해야 합니다.

02

키 로그인 우선 사용

구성원과 자동화 작업마다 별도의 공개 키를 사용하세요. 개인 키는 관리되는 장치 또는 키 관리 시스템에 보관하고 노드의 공유 디렉터리에 업로드하지 마세요.

03

파일 및 명령 권한 최소화

개인 키 파일 권한은 현재 사용자만 읽을 수 있도록 설정하세요. CI 작업에는 빌드에 필요한 디렉터리와 명령 권한만 부여하고 관리자 권한을 기본 실행 방식으로 사용하지 마세요.

04

임시 비밀번호 변경

최초 로그인 후 즉시 별도의 강력한 비밀번호를 설정하세요. 키 로그인이 정상인지 확인한 다음 팀 정책에 따라 비밀번호 인증을 제한하여 유일한 접속 수단을 먼저 차단하지 않도록 하세요.

독립 SSH 키 생성

ssh-keygen -t ed25519 -a 64 -f ~/.ssh/hexvm_node
chmod 600 ~/.ssh/hexvm_node
ssh-add ~/.ssh/hexvm_node

구성원, CI runner 및 임시 운영 작업마다 별도의 키를 생성하면 개별적으로 폐기하기 쉽습니다.

최초 연결 설정

ssh-keyscan -p "$NODE_PORT" "$NODE_HOST"
ssh -i ~/.ssh/hexvm_node \
  -p "$NODE_PORT" "$NODE_USER@$NODE_HOST"

먼저 출력된 지문을 확인한 후 호스트 기록을 수락하세요. 변수 값은 콘솔에서 복사하고 실제 자격 증명을 스크립트에 커밋하지 마세요.

개발 도구 체인 검증

SSH 로그인부터 아카이브 성공까지

연결이 설정되면 버전 조회, 테스트 빌드 및 아카이브 명령으로 환경을 검증하세요. 먼저 범위를 좁혀 확인한 다음 전체 파이프라인에 연결하세요.

hexvm-node — zsh — 120 × 34 SSH
$ssh -i ~/.ssh/hexvm_node "$NODE_USER@$NODE_HOST"
공개 키로 인증되었습니다.
마지막 로그인: 승인된 네트워크의 현재 세션
$sw_vers && xcodebuild -version
ProductName: macOS
Xcode 16.x
$xcodebuild test -scheme MobileApp -destination 'platform=macOS'
** TEST SUCCEEDED **
$bundle exec fastlane archive
서명 설정 확인 중...
아카이브 산출물 내보내는 중...
아카이브가 성공적으로 완료되었습니다

먼저 버전 확인

macOS, Xcode 및 명령줄 도구 버전을 기록하여 대화형 터미널과 CI runner가 동일한 도구 체인 선택을 사용하는지 확인하세요.

그다음 최소 테스트 실행

먼저 단일 scheme 또는 테스트 대상을 실행하여 종속성, 서명 및 환경 변수 문제를 배제한 후 전체 작업 공간으로 확대하세요.

마지막으로 아카이브 연결

아카이브가 성공하면 산출물 경로, 파일 권한 및 로그 비식별화 규칙을 확인한 다음 명령을 자동화 파이프라인으로 이전하세요.

네트워크 지연 시간 참고

6개 노드 리전의 왕복 지연 시간 중앙값

아래 데이터는 리전 초기 선택을 위한 참고 자료이며 모든 네트워크에서 동일하게 재현되는 결과는 아닙니다. 최종 선택 전 실제 사무실 네트워크와 CI 출구에서 반복 테스트하세요.

테스트 시간대 평일 현지 시간 14:00–16:00
네트워크 기준 현지 유선 광대역, VPN 및 프록시 끔
통계 방식 경로별 ICMP 왕복 20회의 중앙값
단위 ms
주요 클라이언트 테스트 지점에서 6개 HexVM 노드 리전까지의 네트워크 지연 시간 중앙값
클라이언트 테스트 지점 싱가포르 일본(도쿄) 한국(서울) 홍콩 미국 동부 미국 서부
베이징 유선 광대역 78 ms 54 ms 47 ms 42 ms 198 ms 146 ms
상하이 유선 광대역 69 ms 41 ms 49 ms 35 ms 190 ms 132 ms
타이베이 유선 광대역 48 ms 32 ms 43 ms 24 ms 181 ms 112 ms
마닐라 유선 광대역 39 ms 71 ms 76 ms 36 ms 214 ms 139 ms
로스앤젤레스 유선 광대역 177 ms 104 ms 119 ms 151 ms 68 ms 21 ms
뉴욕 유선 광대역 231 ms 168 ms 181 ms 205 ms 19 ms 73 ms
< 60 ms

지속적인 그래픽 작업에 적합

키보드 입력, 창 전환 및 일반적인 Xcode 작업은 대체로 원활하지만 패킷 손실과 지터도 확인해야 합니다.

60–140 ms

빌드 및 가벼운 상호 작용에 적합

화질을 낮추면 그래픽 작업이 가능하며 명령줄 빌드, 로그 확인 및 CI 작업은 대체로 큰 영향을 받지 않습니다.

> 140 ms

명령줄 및 자동화를 우선

대륙 간 연결에서는 지속 작업을 SSH, CI runner 및 백그라운드 작업에 맡기고 VNC는 필요한 확인에만 사용하세요.

실제 지연 시간은 현지 통신사, 국제 출구, 라우팅 변경, 사무실 프록시, Wi-Fi 품질 및 동시간대 트래픽의 영향을 받습니다. 리전 디렉터리의 조합은 일반적으로 대여할 수 있으며 실제 사용 가능 여부는 콘솔에 실시간으로 표시되는 정보를 기준으로 합니다.

사용 환경 최적화

최고 화질보다 안정적인 원격 세션을 우선하세요

상호 작용 작업, 지속 작업 및 대용량 파일 전송을 분리하면 네트워크 지터가 빌드 프로세스에 미치는 영향을 줄일 수 있습니다.

01

단일 화면 기준 해상도부터 시작

먼저 단일 화면 1920 × 1080 으로 안정적인 기준을 설정하세요. 지연 시간이 긴 연결에서는 듀얼 모니터, 높은 배율 및 잦은 동적 조정을 바로 사용하지 마세요.

  • 텍스트가 너무 작으면 해상도를 무작정 높이지 말고 시스템 배율을 먼저 조정하세요.
  • 모바일 네트워크에서는 고정 창 크기를 우선 사용하여 화면 재렌더링을 줄이세요.
02

네트워크 경로에 맞춰 색상 품질 선택

코드 편집, 빌드 로그 및 설정 작업에는 최고 색상 정확도가 필요하지 않습니다. 연결이 불안정하면 먼저 색 심도와 이미지 품질을 낮춘 후 입력 지연을 확인하세요.

  • 디자인 검토 및 동영상 작업에서는 일시적으로 화질을 높일 수 있습니다.
  • 일반 개발에는 적응형 압축과 정적 배경을 우선 사용하세요.
03

필요하지 않은 오디오 및 동영상 전송 끄기

원격 개발은 코드, 터미널 및 빌드 상태가 중심입니다. 사용하지 않는 오디오, 카메라 리디렉션 및 애니메이션 효과를 끄면 대역폭 사용량을 줄일 수 있습니다.

  • VNC 세션에서 고비트레이트 미디어를 재생하지 마세요.
  • 관련 없는 데스크톱 동적 효과와 지속적으로 새로 고침되는 모니터링 창을 끄세요.
04

지속 작업을 대화형 세션에서 분리

장시간 빌드, 테스트 및 종속성 다운로드는 별도의 터미널 세션, CI runner 또는 시스템 작업에서 실행해야 합니다. VNC 또는 SSH 연결이 끊겨도 작업이 직접 종료되어서는 안 됩니다.

  • 작업별 로그 파일에 기록하고 종료 코드를 저장하세요.
  • 다시 연결한 후 먼저 프로세스 상태를 확인하고 동일한 빌드를 중복 실행하지 마세요.
05

대용량 파일은 재개 가능한 방식으로 전송

저장소, 캐시 및 빌드 산출물에는 증분 전송과 검증을 지원하는 방식을 사용하세요. 그래픽 클립보드로 대용량 파일을 옮기거나 민감한 산출물을 공개 위치에 저장하지 마세요.

  • 전송 전에 작은 파일이 많다면 압축하여 왕복 비용을 줄이세요.
  • 완료 후 파일 크기, 해시 및 액세스 권한을 확인하세요.
06

캐시를 올바른 위치에 저장

종속성 캐시와 DerivedData는 프로젝트, 브랜치 또는 도구 체인 버전별로 격리해야 합니다. 적중률이 낮아지면 캐시 키를 먼저 분석하고 디스크 사용량을 무한히 늘리지 마세요.

  • 사용하지 않는 캐시와 오래된 아카이브를 정기적으로 정리하세요.
  • 디스크 공간이 부족하면 먼저 용량이 큰 디렉터리를 찾은 후 삭제하세요.
문제 진단

증상별로 연결 문제 범위 좁히기

한 번에 하나의 변수만 변경하고 노드 ID, 리전, 발생 시간 및 전체 오류 텍스트를 기록하세요. 그래야 문제가 로컬, 네트워크, 인증 또는 노드 측에 있는지 판단할 수 있습니다.

연결 시간 초과: 클라이언트가 장시간 응답하지 않음
  1. 콘솔에서 노드 상태와 연결 주소가 변경되지 않았는지 확인하세요.
  2. 포트를 확인하고 로컬 VPN 또는 프록시를 잠시 끈 뒤 다시 테스트하세요.
  3. 가정용 네트워크와 모바일 핫스팟에서 각각 테스트하여 사무실 네트워크가 아웃바운드 연결을 제한하는지 판단하세요.
  4. 시간 초과가 발생한 시간, 리전, 클라이언트 네트워크 및 대상 포트를 기록한 후 콘솔 티켓을 제출하세요.
인증 실패: 사용자 이름, 비밀번호 또는 키가 거부됨
  1. 콘솔에서 반환된 사용자 이름을 다시 복사하고 대소문자와 앞뒤 공백을 확인하세요.
  2. 이전 인스턴스에 저장된 비밀번호나 키가 아니라 현재 노드의 자격 증명을 사용하고 있는지 확인하세요.
  3. SSH 키가 실패하면 개인 키 경로, 파일 권한 및 해당 공개 키가 설정되어 있는지 확인하세요.
  4. 연속으로 실패하면 재시도를 중지하고 콘솔 티켓으로 확인을 요청하세요. 이메일로 전체 자격 증명을 보내지 마세요.
화면 끊김: 연결되지만 입력 지연이 뚜렷함
  1. 단일 화면 1920 × 1080으로 낮추고 높은 색상 품질과 오디오·동영상 전송을 끄세요.
  2. 로컬 Wi-Fi 신호, 패킷 손실 및 백그라운드 다운로드를 확인하고 유선 네트워크로 전환하는 것을 우선하세요.
  3. VNC와 SSH의 응답을 비교하세요. SSH가 정상이라면 그래픽 인코딩과 디스플레이 매개변수를 우선 조정하세요.
  4. 대륙 간 접속에서는 장시간 빌드를 백그라운드에서 실행하고 VNC로 필요한 화면만 확인하세요.
호스트 지문 변경: SSH에서 신원 경고 표시
  1. 즉시 연결을 중지하고 검사를 건너뛰는 명령을 직접 사용하지 마세요.
  2. 노드가 재할당 또는 재설치되었는지, 연결 주소가 이전 설정에서 가져온 것인지 확인하세요.
  3. 콘솔에서 현재 지문을 다시 받아 구간별로 대조하세요.
  4. 원인을 확인할 수 없다면 노드 ID, 리전 및 비식별화한 경고 텍스트를 첨부하여 콘솔 티켓을 제출하세요.
포트에 연결할 수 없음: 네트워크 테스트에서 즉시 거부됨
  1. 사용하는 프로토콜과 포트가 일치하는지 확인하고 SSH 포트를 VNC 클라이언트에 입력하지 마세요.
  2. 로컬 방화벽, 기업 네트워크 출구 정책 및 보안 소프트웨어의 아웃바운드 규칙을 확인하세요.
  3. 다른 독립 네트워크에서 동일한 주소와 포트를 테스트하여 특정 통신사 경로 문제인지 판단하세요.
  4. 여러 네트워크에서 모두 연결할 수 없다면 테스트 결과와 영향 범위를 명시하여 콘솔 티켓을 제출하세요.

티켓 제출 전에 다음 정보를 준비하세요

노드 ID 노드 리전 문제 발생 시간 로컬 네트워크 유형 클라이언트 및 버전 전체 재현 절차 비식별화한 오류 로그 영향 범위

개인 키, 전체 비밀번호, 액세스 토큰 또는 민감한 서명 자료가 포함된 로그를 제출하지 마세요. 추가 지원이 필요하면 콘솔에 로그인하여 티켓을 제출하거나 다음 주소로 이메일을 보내세요. support@hexvm.com.

전용 Apple Silicon 노드

전용 Mac을 선택하고 약 4분 후 연결 시작

각 주문에는 가상 머신이 아닌 독립된 Mac mini 물리 노드가 할당됩니다. 싱가포르, 일본(도쿄), 한국(서울), 홍콩, 미국 동부, 미국 서부의 6개 리전에서 365일 연중 지속 운영됩니다.

모든 요금은 미국 달러(USD)로 결제됩니다. 노드 및 리전의 실제 사용 가능 여부는 콘솔에 실시간으로 표시되는 정보를 기준으로 합니다.