원격 접속 가이드

클라우드 Mac에 안전하게 연결하고 첫 사용성 검증을 완료하세요

SSH는 명령줄, 자동화 및 빌드 작업에, VNC는 그래픽 데스크톱 작업에 사용합니다. 먼저 노드 정보와 호스트 지문을 확인한 뒤 세션을 열고 도구 체인을 검증하세요.

명령줄
SSH 및 키 인증
그래픽 데스크톱
VNC 및 제어된 클립보드
검증 목표
연결, 도구 체인, 작업, 종료
연결 전 기록 READY / VERIFY
노드 정보 호스트명, 포트, 사용자명 확인 완료
인증 자료 개인 키 또는 임시 자격 증명 로컬 보관
신뢰 확인 호스트 지문 확인 필수 완료
첫 검증 터미널, 데스크톱, 빌드 작업 결과 기록

채팅 기록이나 출처가 불명확한 곳에서 호스트 지문을 복사하지 마세요. 현재 콘솔 주문에 표시된 정보를 기준으로 하세요.

연결 방식 선택

작업에 따라 SSH 또는 VNC 선택

두 방식 모두 같은 전용 물리 Mac에 연결하지만 용도가 다릅니다. 자동화 작업에는 SSH를 우선 사용하고, 그래픽 인터페이스·해상도·데스크톱 앱을 확인할 때는 VNC를 사용하세요.

명령줄 및 자동화

SSH: 빌드, 스크립트 및 runner에 권장

Git, Xcode 명령줄 도구, Fastlane, 의존성 설치, 로그 수집 및 self-hosted runner 작업에 적합합니다. 연결 전에 로컬 SSH 클라이언트, 보호된 개인 키, 노드 호스트명, 포트, 사용자명과 신뢰할 수 있는 호스트 지문을 준비하세요.

  • 개인 키 파일은 현재 사용자만 읽을 수 있음
  • 로컬 네트워크에서 주문에 표시된 포트에 접속 가능
  • 최초 연결 전에 별도 경로로 지문 확인
  • 자동화 작업에는 별도 키를 사용하고 용도 제한
그래픽 데스크톱 작업

VNC: 데스크톱 앱 및 디스플레이 환경 확인

macOS 그래픽 인터페이스 조작, 키보드 레이아웃 확인, 해상도 점검 및 데스크톱 세션이 필요한 작업에 적합합니다. 연결 전에 신뢰할 수 있는 VNC 클라이언트, 노드 주소, 임시 자격 증명과 명확한 클립보드 정책을 준비하세요.

  • 공용 기기에 접속 비밀번호를 저장하지 않음
  • 작업량에 맞는 해상도 설정
  • 필요하지 않은 파일 및 클립보드 동기화 끄기
  • 유휴 잠금 및 연결 끊김 후 재연결 동작 확인
최초 연결 절차

노드 정보부터 검증 기록까지, 네 단계로 완료

호스트 지문 확인을 건너뛰지 마세요. 연결 성공은 경로에 도달했다는 뜻일 뿐이며, 도구 체인·디렉터리 권한·종료 절차는 별도로 확인해야 합니다.

  1. 01 노드 정보 가져오기

    콘솔에서 현재 주문을 열고 호스트명, 연결 포트, 사용자명, 임시 자격 증명 또는 키 안내와 시스템이 반환한 호스트 지문을 기록하세요.

    검수: 모든 정보가 같은 주문에서 왔고 노드와 이용 기간이 일치함
  2. 02 지문 독립 확인

    최초 SSH 연결 시 표시되는 지문을 콘솔 정보와 구간별로 대조하세요. 일치하지 않으면 연결을 중지하고 경고 무시나 기록 삭제로 우회하지 마세요.

    검수: 알고리즘과 지문 텍스트가 완전히 일치함
  3. 03 세션 생성 및 자격 증명 갱신

    최초 로그인 후 제공 안내에 따라 임시 자격 증명을 변경하고 자신의 공개 키를 등록한 뒤 더 이상 필요하지 않은 임시 접속 자료를 삭제하세요.

    검수: 새 세션을 사용할 수 있고 기존 임시 자료는 더 이상 사용되지 않음
  4. 04 검증 결과 기록

    시스템 버전, Xcode 버전, 디스크 공간 및 작업 디렉터리 쓰기를 확인한 뒤 반복 실행 가능한 소규모 빌드 작업을 실행하고 정상 종료하세요.

    검수: 연결, 도구 체인, 쓰기, 작업 및 종료 결과가 모두 확인됨
터미널 검증 예시

재현 가능한 세션으로 SSH, Xcode 및 Fastlane 확인

아래 호스트명, 사용자명 및 작업 이름은 예시입니다. 실제 연결 매개변수는 콘솔에서만 읽고, 운영 자격 증명을 스크립트·빌드 로그·티켓에 기록하지 마세요.

armcli-session — verification
$ ssh -p 22022 developer@host.example
The authenticity of host cannot be established.
ED25519 key fingerprint is SHA256:<compare-with-console>
Are you sure you want to continue connecting (yes/no)? yes
Last login: current session

developer@cloud-mac % xcodebuild -version
Xcode 16.x
Build version 16X000

developer@cloud-mac % fastlane test
[✓] Preparing build environment
[✓] Resolving project dependencies
[✓] Test task completed

developer@cloud-mac % exit
Connection to host.example closed.
확인 항목: 지문 확인 완료 Xcode 호출 가능 작업 정상 종료 세션 종료 완료
데스크톱 연결 확인

VNC 접속 가능 여부만으로 데스크톱 환경이 작업에 적합하다고 볼 수 없습니다

최초 그래픽 데스크톱 접속 후 정해진 순서로 디스플레이, 입력, 데이터 교환 및 세션 복구를 확인하세요. 연결을 끊었다가 다시 연결해도 각 항목을 재현할 수 있어야 합니다.

01

해상도 및 배율

도구 모음과 대화 상자가 모두 보이는 해상도를 선택하세요. 데스크톱이 선명한지만 보지 말고 실제 개발 도구를 열어 텍스트, 사이드바 및 팝업이 잘리지 않는지 확인하세요.

02

키보드 레이아웃

일반 텍스트 입력란에서 문자, 숫자, 기호 및 자주 쓰는 단축키를 확인하세요. 로컬과 원격 레이아웃이 다르면 먼저 레이아웃을 통일한 뒤 코드를 편집하거나 명령을 입력하세요.

03

클립보드 정책

작업에 꼭 필요할 때만 클립보드 동기화를 활성화하세요. 개인 키, 토큰 또는 전체 환경 변수를 복사하지 말고, 공용 기기에서는 양방향 동기화를 끄고 기록을 삭제하세요.

04

유휴 잠금

기기에서 자리를 비우면 데스크톱이 잠기는지 확인하세요. 팀이 함께 사용하는 단말에서는 작업 후 직접 잠그고, 네트워크 연결 끊김으로 세션 보호를 대신하지 마세요.

05

연결 끊김 후 재연결

한 번 직접 연결을 끊었다가 다시 연결해 세션 상태가 예상대로인지 확인하세요. 장시간 빌드 작업에는 대화형 연결과 분리할 수 있는 작업 관리 방식을 사용하세요.

06

공용 기기 정리

종료 후 저장된 호스트 기록, 캐시 자격 증명 및 임시 다운로드 파일을 삭제하세요. 브라우저, VNC 클라이언트 및 비밀번호 관리 도구도 각각 확인해야 합니다.

SSH 터널 활용

현재 작업에 필요한 로컬 포트만 전달

로컬 포트 전달을 사용하면 서비스의 수신 주소를 더 넓은 네트워크에 노출하지 않고 SSH 세션을 통해 로컬 도구로 원격 서비스에 접근할 수 있습니다. 포트, 대상 주소 및 유지 시간에는 명확한 한계를 설정하세요.

  • 최소 공개:원격 서비스는 우선 루프백 주소에서 수신하고 현재 작업에 사용하는 단일 포트만 전달하세요.
  • 명확한 연결 유지:장시간 작업에 적절한 연결 유지 간격과 실패 횟수를 설정해 연결이 끊긴 세션이 무한정 멈추지 않게 하세요.
  • 별도 키:자동화 터널에는 별도 키를 사용하고 권한과 용도를 따로 취소할 수 있게 하며 일상적인 대화형 접속 키와 섞지 마세요.
  • 작업 후 취소:전달이 끝나면 프로세스를 종료하고 더 이상 사용하지 않는 공개 키를 취소한 뒤 로컬 수신 포트가 닫혔는지 확인하세요.
로컬 포트 전달 예시 LOCAL ONLY
ssh \
  -L 127.0.0.1:9000:127.0.0.1:9000 \
  -o ServerAliveInterval=30 \
  -o ServerAliveCountMax=3 \
  -p 22022 \
  developer@host.example
로컬 수신
127.0.0.1:9000
원격 대상
127.0.0.1:9000
종료 방법
SSH 세션을 정상 종료하고 포트가 닫혔는지 확인
CI/CD 연동

먼저 runner가 최소 테스트 파이프라인을 완료하도록 하세요

GitLab CI 같은 시스템을 연동할 때 전체 운영 파이프라인을 바로 이전하지 마세요. 먼저 runner를 등록하고 고정 태그와 디렉터리 권한을 확인한 뒤 민감한 데이터가 없는 소규모 테스트 작업을 실행하세요.

01

runner 등록

별도 서비스 계정으로 등록하고 runner 이름, 실행기, 작업 디렉터리 및 소속 프로젝트를 기록하세요. 등록 토큰은 필요한 단계에서만 사용하고 저장소에 기록하지 마세요.

결과: runner 온라인
02

명확한 태그 추가

macOS, arm64 및 프로젝트 용도처럼 실제 역량을 설명하는 태그를 사용하세요. 의미가 넓은 기본 태그는 피하여 관련 없는 작업이 해당 노드에 배정되지 않게 하세요.

결과: 작업을 정확히 매칭 가능
03

작업 디렉터리 확인

복제, 캐시, 빌드 산출물 및 임시 디렉터리의 읽기·쓰기 권한을 확인하세요. 작업 계정에 작업 디렉터리에 필요한 범위를 넘는 시스템 권한을 부여하지 마세요.

결과: 디렉터리 읽기·쓰기 제어
04

첫 작업 실행

첫 실행에서는 환경 출력, 의존성 해석 및 소규모 테스트만 수행하세요. 종료 코드, 로그 완전성, 캐시 경로 및 실패 시 정리 동작을 확인하세요.

결과: 작업을 반복 실행 가능
runner 첫 검수 기록
점검 항목 실행 방법 통과 조건 실패 시 먼저 확인
아키텍처 및 시스템 uname -m 출력이 작업 태그와 일치 runner 태그 및 실행 노드
Xcode 도구 체인 xcodebuild -version 버전을 읽을 수 있고 명령 종료 코드가 0 명령 경로 및 작업 환경
작업 디렉터리 테스트 파일 생성, 읽기 및 삭제 대상 디렉터리만 필요에 따라 읽고 쓸 수 있음 디렉터리 소유자 및 권한
캐시 동작 동일한 테스트를 연속 두 번 실행 캐시 적중을 설명할 수 있고 프로젝트 간 섞이지 않음 캐시 키 및 정리 정책
연결 문제 해결

DNS부터 로컬 네트워크까지 순서대로 범위 좁히기

한 번에 하나의 변수만 확인하세요. 호스트명, 포트, 키 및 네트워크를 동시에 바꾸지 마세요. 연결이 복구되어도 근본 원인을 확인할 수 없습니다.

01
DNS 및 호스트명

콘솔에 현재 표시된 호스트명을 사용하고 해석 결과가 안정적인지 확인하세요. 오래된 티켓이나 과거 스크립트에서 주소를 복사하지 마세요.

해석 결과
02
연결 포트

포트 번호와 프로토콜을 확인하고 로컬에서 대상 포트에 도달할 수 있는지 테스트하세요. 회사 네트워크에 제한이 있으면 신뢰할 수 있는 다른 네트워크로 교차 확인하세요.

포트 연결 가능 여부
03
키 및 파일 권한

클라이언트가 실제로 불러오는 키 파일, 파일 권한 및 해당 공개 키를 확인하세요. 상세 로그를 켤 때는 먼저 민감 정보를 가린 뒤 인증 순서를 확인하세요.

인증 단계
04
호스트 지문

지문이 변경되면 먼저 연결을 중지하고 노드 정보를 다시 확인하세요. 알려진 호스트 기록을 바로 삭제한 뒤 계속 로그인하지 마세요.

신뢰 확인
05
세션 점유

종료되지 않은 데스크톱 세션, 장시간 작업 또는 로컬 포트 전달이 있는지 확인하세요. 먼저 작업 상태를 확인한 뒤 프로세스 종료 여부를 결정하세요.

세션 상태
06
로컬 네트워크

마지막으로 프록시, 방화벽, VPN, 무선 네트워크 품질 및 출구 정책을 확인하세요. 신뢰할 수 있는 대체 네트워크로 재테스트해 로컬 경로 문제와 노드 문제를 구분하세요.

네트워크 범위
티켓 제출 전에 다음 정보를 준비하세요

노드 식별자, 문제 발생 시간, 연결 방식, 전체 명령 구조, 오류 요약, 시도한 단계 및 민감 정보를 가린 로그를 준비하세요. 제출 전에 개인 키, 토큰, 비밀번호, 전체 지문 및 업무 데이터를 삭제하세요.

종료 체크리스트

작업을 끝내기 전에 접속, 데이터를 정리하고 이용 기간도 확인하세요

원격 창을 닫는 것만으로는 완전한 종료가 아닙니다. 세션을 종료하고 접속 자료를 취소하며 민감 파일을 정리하고 백업을 확인한 뒤 주문 이용 기간을 점검해야 합니다.

  1. 01 모든 세션 종료

    SSH, VNC, 로컬 포트 전달 및 runner 대화형 세션을 종료하고 남아 있는 테스트 프로세스나 백그라운드 수신 포트가 없는지 확인하세요.

  2. 02 더 이상 사용하지 않는 키 취소

    임시 공개 키, 테스트 runner 자격 증명 및 일회성 접속 자료를 삭제하세요. 보관하는 항목에는 명확한 소유자와 후속 용도가 있어야 합니다.

  3. 03 캐시 및 민감 파일 정리

    shell 기록, 임시 디렉터리, 빌드 로그, 다운로드 디렉터리, 클립보드 기록 및 작업 공간의 구성 파일을 확인하고 더 이상 보관할 필요가 없는 내용을 삭제하세요.

  4. 04 백업 읽기 가능 여부 확인

    코드와 필요한 산출물이 외부로 이전되었는지 확인하고 독립된 위치에서 한 번 읽기 검증을 완료하세요. 노드에 있는 단일 파일을 백업으로 간주하지 마세요.

  5. 05 이용 기간 및 주문 상태 확인

    콘솔에서 만료 시간, 갱신 상태 및 서비스 기록을 확인하세요. 계속 사용해야 한다면 먼저 이용 기간을 확인한 뒤 후속 빌드 작업을 계획하세요.

시작할 준비가 되셨나요

전용 물리 Mac을 대여하고 이 가이드에 따라 연결하세요

세 가지 판매 구성이 명령줄 빌드, 그래픽 데스크톱, CI/CD runner 및 병렬 작업을 지원합니다. 실제 사용 가능 상태는 콘솔에 실시간으로 표시되는 정보를 기준으로 합니다.

SSH 및 VNC 전용 물리 노드 365일 연중 정상 운영