원격 접속 요약

전원 켠 뒤 10분 안에
Mac에 연결

먼저 SSH로 연결을 확인한 다음 화면 공유를 여세요. 단독으로 사용하는 물리 Mac mini에서 macOS 그래픽 인터페이스와 명령줄을 모두 사용할 수 있어 원격 작업, 빌드, 테스트에 적합합니다.

10분은 접속 정보와 클라이언트, 네트워크가 준비된 뒤 작업을 시작하는 목표 시간이며, 주문 후 장비 제공 시간을 뜻하지 않습니다. 접속 주소, 포트, 인증 방식은 콘솔에 표시된 정보를 기준으로 하세요.

접속 방식 선택

데스크톱 작업은 화면 공유, 자동화 작업은 SSH

일반 설정은 그래픽 인터페이스로, 컴파일·로그 확인·파일 전송은 명령줄로 처리하세요. 두 접속 방식은 서로 보완하므로 매번 빌드할 때마다 데스크톱을 계속 열어 둘 필요는 없습니다.

아래 표는 서비스 기본 포트입니다. 실제 접속에는 콘솔에 표시된 포트를 사용하세요.
접속 방식용도필요한 포트인증 및 참고 사항
macOS 화면 공유Xcode 설정, 시뮬레이터 실행, 그래픽 인터페이스 확인, 원격 작업VNC 기본 TCP 5900, 터널 모드에서는 SSH 포트도 필요제공된 시스템 계정으로 인증하세요. 데스크톱 접속은 SSH 공개 키 인증을 대신하지 않습니다.
타사 VNC 클라이언트Windows 또는 Linux에서 macOS 데스크톱 접속VNC 기본 TCP 5900 또는 클라이언트가 연결하는 로컬 터널 포트서버의 인증 방식과 호환되는 클라이언트가 필요합니다. 호환성 문제를 해결하려고 인증을 끄거나 모든 출처의 접속을 허용하지 마세요.
SSH 명령줄빌드 실행, 로그 확인, runner 등록, SFTP 파일 전송SSH 기본 TCP 22, 공용 IP 포트 매핑은 콘솔에서 확인공개 키 로그인을 권장합니다. 처음 연결할 때 호스트 지문을 확인한 뒤 신뢰 여부를 결정하세요.

먼저 포트를 확인하고 클라이언트를 점검하세요.연결 시간이 초과되면 주소, 아웃바운드 정책, 대상 포트부터 확인하세요. 인증 안내가 표시된다면 네트워크 경로는 대체로 연결된 상태이므로 사용자 이름, 비밀번호 또는 키를 확인해야 합니다.

사용 중인 운영체제 선택

세 가지 클라이언트, 동일한 점검 순서

먼저 SSH 세션을 열어 인스턴스와 작업 디렉터리를 확인한 다음 데스크톱에 연결하세요. 아래 방법은 로컬 방화벽을 끄거나 클라우드 Mac을 모든 출처에 노출하지 않아도 됩니다.

macOS에서 연결

  1. ‘터미널’을 열고 콘솔에 표시된 사용자 이름, 주소, SSH 포트로 연결하세요. 처음 호스트 지문 확인 메시지가 나오면 지문을 확인한 뒤 진행하세요.
  2. 데스크톱이 필요하면 ‘화면 공유’를 열고 인스턴스의 화면 공유 주소를 입력하세요. 터널을 이용할 때는 로컬에서 수신 대기 중인 주소와 포트를 입력하세요.
  3. 시스템 사용자 이름과 비밀번호를 입력하세요. 데스크톱이 열리면 키보드 배열, 화면 해상도, 시간대를 확인한 뒤 프로젝트를 여세요.
  4. 데스크톱 세션을 끝내기 전에 빌드 로그가 파일로 저장됐는지 확인하세요. 화면 공유를 끊어도 대여가 종료되거나 백그라운드 작업이 끝나는 것은 아닙니다.

최초 점검: 터미널에서 시스템 정보를 확인할 수 있고, 데스크톱에서 Finder가 열리며, 프로젝트 디렉터리에 파일을 쓸 수 있어야 합니다.

Windows에서 연결

  1. PowerShell에서 OpenSSH 클라이언트를 사용할 수 있는지 확인하세요. 회사 장비에서 구성 요소 설치가 제한되어 있다면 먼저 사내 관리자에게 문의하세요.
  2. SSH 명령으로 주소와 포트를 확인하세요. 비밀번호를 입력할 때 문자가 표시되지 않는 것은 정상입니다. 그 때문에 비밀번호를 다시 붙여 넣지 마세요.
  3. macOS 화면 공유 인증 방식과 호환되는 VNC 클라이언트를 설치하고 호스트와 포트를 각각 입력하세요. 주소 형식은 클라이언트마다 다를 수 있습니다.
  4. SSH 터널을 통해 데스크톱에 접속하는 것을 권장합니다. 핸드셰이크에 실패하면 비밀번호를 반복해서 추측하지 말고 먼저 인증 호환성을 확인한 다음 서비스 상태를 점검하세요.

최초 점검: SSH 세션이 연결되고, VNC 인증이 완료되며, 단축키 매핑이 일상 작업에 맞아야 합니다.

Linux에서 연결

  1. 배포판에서 제공하는 OpenSSH 클라이언트를 사용하세요. 로컬 키 권한을 확인해 개인 키를 다른 사용자가 읽을 수 없도록 하세요.
  2. 제공된 접속 정보로 SSH에 연결하세요. 프로젝트나 빌드 결과물을 전송할 때는 같은 SSH 접속 경로를 사용해 SFTP로 전송할 수 있습니다.
  3. 서버 인증 방식과 호환되는 VNC 클라이언트를 선택하세요. 데스크톱 서비스를 직접 노출하는 대신 SSH로 전달되는 로컬 포트에 연결하는 것을 권장합니다.
  4. 데스크톱에 처음 접속하면 클립보드와 입력기를 확인하세요. 여러 파일은 SFTP로 전송하고, 데스크톱 클립보드를 프로젝트 동기화 도구로 사용하지 마세요.

최초 점검: 키 인증에 성공하고, SFTP로 대상 디렉터리에 접근할 수 있으며, 데스크톱의 입력과 화면 표시가 정상이어야 합니다.

SSH 및 데스크톱 터널 명령

먼저 로컬 터미널에서 변수를 설정하세요: SSH_USER 은 시스템 사용자 이름, SSH_HOST 은 인스턴스 주소, SSH_PORT 는 콘솔에 표시된 SSH 포트입니다. 비밀번호를 명령이나 스크립트에 입력하지 마세요.

ssh -p "$SSH_PORT" "$SSH_USER@$SSH_HOST"

ssh -N -o ExitOnForwardFailure=yes \
  -L 127.0.0.1:15900:127.0.0.1:5900 \
  -p "$SSH_PORT" "$SSH_USER@$SSH_HOST"

두 번째 명령은 원격 화면 공유 서비스가 로컬 TCP 5900에서 수신 대기하고 SSH 포워딩이 허용된 경우에만 사용할 수 있습니다. 해당 터미널을 계속 실행한 상태에서 VNC 클라이언트로 127.0.0.1:15900에 연결하세요. 이 주소는 로컬 포트이며 인스턴스의 공용 포트가 아닙니다. 이미 사용 중이라면 사용하지 않는 다른 로컬 포트로 바꾸세요.

원활한 조작을 위한 설정

대역폭을 무작정 높이기보다 화면 부하를 줄이세요

원격 데스크톱 성능은 왕복 지연 시간, 패킷 손실, 화면 변화량, 클라이언트의 인코딩 성능에 영향을 받습니다. 아래 설정은 시작점일 뿐, 인스턴스의 속도 측정 결과나 대역폭을 보장하지 않습니다. 실제 사용 중인 로컬 네트워크에서 확인하세요.

낮은 해상도부터 시작해 안정적인 세션을 만든 뒤 화질을 단계별로 높이세요
네트워크 및 작업시작 해상도화질 및 색 심도조정 방법
모바일 네트워크 또는 해외 연결이 불안정한 경우1280 × 720적응형 압축을 우선 사용하세요. 클라이언트에서 지원하면 16비트 색상을 시도해 볼 수 있습니다.데스크톱 애니메이션 효과를 끄고 대용량 파일 동기화를 일시 중지한 뒤 입력 반응을 확인하세요.
안정적인 유선 인터넷, 코드 및 문서 작업1920 × 1080자동 화질로 시작하고 텍스트가 선명하지 않을 때 품질을 높이세요.한 번에 설정 하나만 바꾸고 스크롤, 창 이동, 키보드 입력을 비교하세요.
인터페이스 확인 및 이미지 편집1920 × 1080부터색상 디테일이 중요하면 클라이언트 지원 여부에 따라 24비트 이상의 색 심도를 사용하세요.확대 비율과 압축으로 인한 왜곡을 확인하세요. 최종 이미지 품질은 내보낸 파일에서 확인해야 합니다.

데스크톱은 조작용이며 실시간 오디오·비디오 확인용이 아닙니다

동영상 미리 보기, 빠른 애니메이션, 고주사율 상호작용은 화면 변화량을 늘립니다. 오디오·비디오 파일은 원격으로 변환할 수 있지만, 최종 결과물은 로컬에 내려받아 확인하세요. 원격 데스크톱의 프레임 저하를 내보낸 파일의 문제로 오해하지 마세요.

권장 순서: 해상도 낮추기 → 적응형 화질 사용 → 패킷 손실 확인 → 색 심도 조정

빌드와 파일 전송은 데스크톱을 계속 열어 두지 않아도 됩니다

오래 걸리는 빌드는 runner나 관리 가능한 백그라운드 작업으로 실행하고 로그를 파일에 저장하세요. 프로젝트와 빌드 결과물은 SFTP로 전송하세요. 데스크톱 연결이 끊긴 뒤에도 작업이 계속될지는 실행 방식에 따라 다르며, 터미널 명령이 모두 유지된다고 가정할 수 없습니다.

장시간 작업이 필요하다면 장기 대여를 결정하기 전에 전체 작업 과정을 한 번 테스트하세요.

실기기 디버깅의 한계

시뮬레이터가 열린다고 해서 내 주변의 휴대폰을 찾을 수 있는 것은 아닙니다

클라우드 Mac을 단독으로 사용할 수 있는지와 모바일 기기가 네트워크에서 검색되는지는 별개의 문제입니다. Xcode, 시뮬레이터, 빌드는 원격으로 실행할 수 있지만, 로컬 iPhone이나 iPad를 연결하려면 기기 페어링과 신뢰 설정, 네트워크 검색 조건이 충족되어야 합니다.

방법 1: 먼저 원격 시뮬레이터에서 확인

클라우드 Mac에서 프로젝트를 열고 Xcode, SDK, 프로젝트 설정이 서로 맞는지 확인한 뒤 시뮬레이터를 실행해 UI, 로직, 기본 회귀 테스트를 진행하세요. 컴파일 및 실행 환경 문제를 먼저 파악하는 데 적합합니다.

시뮬레이터는 실제 기기의 카메라, 센서, 셀룰러 네트워크, 성능, 발열 테스트를 대신할 수 없습니다. 이런 기능을 확인해야 한다면 별도로 실기기 테스트를 진행하세요.

제공 결과: 재현 가능한 빌드 기록, 테스트 로그, 시뮬레이터 실행 결과

방법 2: 기기 네트워크 디버깅 조건 확인

네트워크 디버깅을 하려면 일반적으로 기기와 대상 Mac을 먼저 정상적으로 페어링하고, 해당 Xcode 및 운영체제 버전 요구 사항을 충족해야 합니다. 또한 기기와 Mac이 서로를 검색할 수 있거나 검증된 네트워크 경로로 통신할 수 있어야 합니다.

SSH 터널 하나만으로 기기 검색, 최초 페어링, 신뢰 설정 문제가 해결되지는 않습니다. 공용 주소에 접속할 수 있다고 해서 무선 실기기 디버깅이 바로 가능해지는 것도 아닙니다.

주문 전 확인 사항: 페어링 방식, 네트워크 구성, 기기 운영체제 버전, 실제 작업 권한

원격 기기 연결은 별도 검증이 필요합니다.USB 포워딩이나 기타 원격 기기 연결 방식은 프로토콜 호환성, 드라이버, 기기 재연결, 네트워크 품질에 영향을 받습니다. 기본 제공 기능이 아니며 휴대폰 기기도 포함되지 않습니다. 로컬 기기를 클라우드 Xcode에 연결해야 한다면 기기 모델, 운영체제 버전, 페어링 경로, 테스트 목적을 먼저 팀에 알려 주세요. 가능 여부를 확인한 뒤 작업을 진행할 수 있습니다. 앱 설치 파일만 검증하면 된다면 서명된 빌드 결과물을 테스트 담당자에게 전달해 로컬 기기에서 테스트할 수 있으므로 원격 디버깅 세션을 계속 유지할 필요가 없습니다.

연결 후 진행할 작업

접근을 먼저 제한한 뒤 프로젝트와 키를 옮기세요

단독으로 사용하는 물리 Mac은 다른 임차인과 컴퓨팅 리소스를 공유하지 않지만 계정 보안을 대신해 주지는 않습니다. 빌드 인증서, 소스 코드, 자동화용 인증 정보를 배포하기 전에 다음 세 가지를 완료하세요.

  1. 공개 키 로그인 사용

    신뢰할 수 있는 로컬 기기에서 키를 생성하고 공개 키를 원격 시스템의 해당 사용자 인증 파일에 등록하세요. 개인 키는 로컬에 보관하고 서버나 티켓에 업로드하지 마세요. 새 터미널을 열어 공개 키 로그인이 되는지 확인하고, 복구용으로 기존 세션을 유지한 다음 비밀번호 인증 정책을 조정하세요.

  2. 제공된 비밀번호 변경

    처음 로그인한 뒤 시스템 비밀번호를 변경하고 신뢰할 수 있는 비밀번호 관리자에 저장하세요. runner 설정, 명령 기록, 프로젝트 저장소에 비밀번호를 입력하지 마세요. 팀원마다 추적 가능한 계정을 배정하고 여러 사람이 하나의 접속 정보를 장기간 공유하지 않도록 하세요.

  3. 필요한 포트만 열기

    실제로 사용하는 SSH와 데스크톱 접속 경로만 유지하고, 터널을 사용할 수 있다면 우선 사용하세요. 방화벽이나 접속 규칙을 변경하기 전에 현재 관리 접속 경로를 확인하고 복구 방법을 준비하세요. 연결 문제를 점검한다는 이유로 모든 보호 기능을 한꺼번에 끄지 마세요.

문제가 생기면 티켓에 무엇을 적어야 하나요?

인스턴스 ID, 클라이언트 운영체제와 버전, 접속 방식, 발생 시간과 시간대, 오류 메시지 원문, 그리고 ‘시간 초과 / 연결 거부 / 인증 실패’ 중 해당하는 증상을 알려 주세요. 민감 정보를 가린 화면을 첨부할 수 있지만 비밀번호, 개인 키, 전체 접속 정보는 첨부하지 마세요.

접속 전 점검

네 가지 준비를 마친 뒤 첫 로그인 시작

순서대로 확인하세요. 빠진 항목이 있으면 먼저 준비하고 반복 시도로 시간을 낭비하지 마세요. 회사 네트워크에서 필요한 아웃바운드 연결이 차단되어 있다면 먼저 접속 정책을 요청하세요.

  • 접속 정보 저장 완료
    인스턴스 주소, 시스템 사용자 이름, 인증 정보, 실제 포트를 콘솔에서 확인하고 안전한 곳에 저장했습니다.
  • 클라이언트 설치 완료
    명령줄에서 SSH를 실행할 수 있고, 그래픽 인터페이스가 필요하면 호환되는 화면 공유 또는 VNC 클라이언트를 준비했습니다.
  • 공개 키 등록 및 확인 완료
    공개 키 인증을 사용할 경우 올바른 사용자 계정에 공개 키를 등록하고 새 세션으로 로그인되는지 확인했습니다. 개인 키는 계속 로컬에만 보관합니다.
  • 로컬 네트워크의 아웃바운드 포트 확인
    실제 SSH 포트를 확인했습니다. 데스크톱에 직접 연결한다면 VNC 포트도 확인하고, 터널을 사용한다면 로컬 수신 포트를 점검하세요.

최초 점검을 마치면 클라이언트 버전, 접속 방식, 정상 작동한 설정을 기록하세요. 다음 팀원은 절차를 재사용할 수 있지만 개인 키나 비밀번호를 그대로 복사해서는 안 됩니다.

접속 경로를 확인한 뒤 작업을 옮기세요.

데스크톱, 명령줄, 실제 작업을 먼저 검증하세요. 대여를 시작하려면 작업 부하에 맞는 요금제를 선택하고, 이미 인스턴스가 있다면 콘솔에서 접속 정보를 확인하세요.