연결 가이드 · 접속 정보부터 시작

접속 정보를 받았다면, 세 가지 방법으로 Mac mini에 연결하세요

먼저 SSH로 명령줄 접속을 확인한 다음 VNC 데스크톱을 여세요. 공용 인터넷 노출을 줄이려면 SSH 터널로 VNC를 연결하면 됩니다. 임대한 장비는 가상 머신이 아닌 전용 물리 머신입니다. 실제 주소, 포트, 계정 정보는 콘솔에 표시된 내용을 확인하세요.

Mac mini 지금 임대 콘솔 접속 정보 확인

아직 머신이 없으신가요? 먼저 모델과 노드를 선택하세요. 이미 주문하셨다면 콘솔에 로그인해 인스턴스의 접속 정보를 확인한 다음 아래 첫 단계부터 시작하세요.

접속 정보 체크리스트SSH → VNC → CI

연결을 시작하기 전에 콘솔에서 아래 네 가지 정보를 확인하세요. 비밀번호나 개인 키를 지원 티켓에 보내지 마세요.

호스트 주소: 인스턴스 접속 정보에 표시된 주소
SSH 포트: 인스턴스 접속 정보에 표시된 포트
로그인 계정: 발급받은 사용자 이름
데스크톱 연결: VNC 주소 및 인증 정보

먼저 SSH 로그인 확인그다음 데스크톱과 빌드 설정

01 / 명령줄

SSH로 연결한 뒤 키 인증으로 전환하세요

SSH는 암호화된 명령줄 연결입니다. macOS와 Linux에서는 터미널을, Windows에서는 PowerShell을 사용하세요. 예시의 주소, 포트, 사용자 이름을 콘솔에서 받은 정보로 바꾸세요.

첫 로그인 순서

01인스턴스와 포트 확인. 콘솔에서 머신이 준비된 것을 확인한 뒤 SSH 주소, 포트, 사용자 이름을 복사하세요. 호스트 지문이 처음 표시되면 접속 정보와 대조하세요.
02공개 키 준비. 사용 중인 컴퓨터에서 Ed25519 키 쌍을 생성하세요. 개인 키는 로컬에 보관하고, ssh-ed25519 로 시작하는 공개 키만 원격 계정의 ~/.ssh/authorized_keys에 추가하세요.
03새 터미널에서 로그인 확인. 첫 번째 세션은 끊지 말고 새 터미널에서 공개 키로 로그인할 수 있는지 확인하세요. 로그인이 확인된 뒤 보안 정책에 따라 해당 계정의 비밀번호 로그인을 비활성화하세요. 비밀번호 로그인을 먼저 끄고 키 인증을 나중에 테스트하지 마세요.

로컬 터미널꺾쇠 괄호 안의 값은 접속 정보로 바꾸세요

ssh -p <SSH-포트> <사용자명>@<호스트-주소>

ssh-keygen -t ed25519 -C "cloud-mac"
cat ~/.ssh/id_ed25519.pub

ssh -i ~/.ssh/id_ed25519 \
  -p <SSH-포트> <사용자명>@<호스트-주소>

로컬에 키가 이미 있다면 파일 이름부터 확인하고 기존 개인 키를 덮어쓰지 마세요. 공개 키를 붙여 넣을 때는 한 줄 전체를 유지하세요. 원격의 ~/.ssh 와 authorized_keys 권한은 각각 700 과 600으로 설정하세요.

02 / 그래픽 데스크톱

Xcode 그래픽 인터페이스가 필요하면 VNC를 사용하세요

VNC는 Mac 데스크톱 화면을 컴퓨터로 전송해 원격으로 제어하는 방식입니다. 먼저 콘솔에서 받은 데스크톱 주소, 포트, 인증 방식을 확인하세요. SSH 정보와 다를 수 있습니다.

macOS에서 연결

기본 제공 화면 공유 사용

화면 공유를 열고 발급받은 VNC 주소와 포트를 입력하세요. 아래의 SSH 터널을 이미 설정했다면 로컬 주소와 포트로 연결하세요. 인증에는 발급받은 정보를 사용하고 SSH 개인 키를 입력하지 마세요.

Xcode, Simulator, 시스템 설정을 직접 조작할 때 적합합니다.

Windows 또는 Linux에서 연결

VNC 클라이언트에 접속 정보 입력

클라이언트에 호스트, 포트, 발급받은 인증 정보를 각각 입력하세요. 주소 하나만 입력하는 클라이언트라면 안내에 따라 ‘호스트:포트’ 형식을 사용하세요. SSH 터널을 사용하는 것이 좋으며, 이때 연결 대상은 로컬 루프백 주소로 설정하세요.

클라이언트 프로토콜은 VNC로 설정하세요. 데스크톱 연결에 SSH 포트를 사용하지 마세요.

화면이 끊기면 먼저 이 두 가지를 조정하세요

화질을 최고에서 중간으로 낮추고 클라이언트의 프레임 요청률도 낮춰 보세요. 먼저 단일 모니터와 적절한 데스크톱 해상도로 연결이 안정적인지 확인하세요. 화면보다 키보드 입력이 원활하다면 개발 환경을 바로 재설치하기보다 노드까지의 네트워크 경로를 먼저 점검하세요.

03 / 보안 연결

SSH 터널로 VNC 트래픽 전달

SSH 터널은 컴퓨터의 로컬 포트를 원격 데스크톱 포트로 안전하게 전달합니다. 클라이언트는 로컬에만 연결하면 되므로 편의를 위해 VNC 포트를 공용 인터넷에 추가로 열 필요가 없습니다. 실행 전에 발급된 접속 정보에서 이 연결 방식을 지원하는지 확인하세요.

세 단계로 포트 전달 설정

01포트 확인. SSH 포트와 원격 VNC 포트를 각각 확인하세요. 예시의 5901 은 로컬에서 선택한 사용 가능한 포트이며, 서버가 이 포트를 고정으로 사용한다는 뜻은 아닙니다.
02터널 유지. 로컬 터미널에서 포트 전달 명령을 실행하고 터미널을 열어 두세요.-N 은 포트 전달만 설정하고 원격 명령은 실행하지 않는다는 뜻입니다.
03로컬에서 연결. 화면 공유 또는 VNC 클라이언트에서 127.0.0.1:5901에 연결하세요. 사용을 마치면 클라이언트를 종료한 뒤 터널 터미널을 닫으세요.

로컬 터미널원격 포트는 발급된 접속 정보를 따르세요

ssh -N \
  -L 127.0.0.1:5901:127.0.0.1:<원격-VNC-포트> \
  -p <SSH-포트> \
  <사용자명>@<호스트-주소>

로컬 5901 포트가 이미 사용 중이라면 -L 의 첫 번째 포트만 바꾸고 VNC 클라이언트에도 같은 새 포트를 입력하세요. 로컬 포트 충돌을 해결하려고 원격 포트를 바꾸지 마세요.

04 / 자동 빌드

이 Mac을 self-hosted runner로 등록하세요

self-hosted runner는 사용자의 머신에서 CI 작업을 실행하는 러너입니다. 먼저 SSH로 로그인해 Xcode 명령줄 도구를 사용할 수 있는지 확인한 다음 CI 프로젝트 설정에서 등록 자격 증명을 만드세요. 일회용 토큰을 저장소나 빌드 로그에 기록하지 마세요.

GitHub Actions

저장소 또는 조직에 머신 등록

프로젝트의 runner 설정에서 macOS 실행기를 선택하고, 페이지에 표시된 최신 설치 및 구성 명령에 따라 클라우드 Mac에 등록하세요. 머신 모델, 노드, 용도를 알아보기 쉬운 레이블로 지정하세요. 예: macos、m4、ios-build。워크플로의 runs-on 값은 실제 레이블과 일치해야 합니다.

등록 후에는 xcodebuild -version 만 실행하는 간단한 작업부터 테스트한 뒤 정식 빌드를 연결하세요.

GitLab Runner

프로젝트 설정에서 러너 등록

현재 프로젝트의 등록 안내를 확인하고 클라우드 Mac에 호환되는 버전의 runner를 설치한 뒤 프로젝트 요구 사항에 따라 셸 실행 방식을 선택하세요. 노드와 빌드 용도를 알 수 있도록 명확한 레이블을 지정하세요. 보호된 작업을 해당 runner가 실행할 수 있는지 확인한 다음 테스트 파이프라인을 실행하세요.

작업이 Xcode, 서명 자료, 프로젝트 종속 항목에 접근할 수 있는지 먼저 확인한 뒤 동시 실행 수를 늘리세요.

부팅 시 자동 실행을 설정하기 전에 재시동을 테스트하세요

사용 중인 runner의 공식 서비스 설치 방법에 따라 프로세스를 macOS 백그라운드 서비스로 등록하고 어떤 계정으로 실행할지 지정하세요. 재시동 후 서비스 상태와 테스트 작업을 확인하세요. 대화형 터미널에서 빌드가 된다고 해서 백그라운드 서비스도 같은 환경 변수나 키체인에 접근할 수 있는 것은 아닙니다. 임대 기간이 끝나기 전에 등록 토큰을 폐기하고 보관할 산출물을 백업하세요.

05 / 노드 선택

원격 데스크톱 품질은 먼저 거리를 확인하세요

현재 이용 가능한 노드는 싱가포르, 일본(도쿄), 한국(서울), 홍콩입니다. 주로 작업하는 사람과 가까운 노드를 선택한 뒤 실제 사무실 네트워크에서 SSH 응답 시간과 데스크톱 조작을 테스트하세요. 국제 네트워크 경로, 패킷 손실, 로컬 네트워크도 결과에 영향을 주므로 위치만 보고 지연 시간을 판단할 수는 없습니다.

네 개 노드 중 가까운 곳을 선택하는 기준
노드	우선 고려할 팀 위치	연결 시 먼저 확인할 항목
싱가포르	동남아시아 개발 및 빌드 팀	사무실 네트워크에서 노드까지의 실제 왕복 지연 시간
일본(도쿄)	일본 및 인근 지역의 개발 팀	데스크톱 조작과 빌드 산출물 전송의 안정성
한국(서울)	한국 및 동북아시아 개발 팀	혼잡 시간대 패킷 손실 여부
홍콩	중국 남부 및 동남아시아 협업 팀	팀원별 접속 경로

두 가지 모델은 네 노드 모두에서 선택할 수 있습니다. 주문 시점의 실제 이용 가능 여부는 콘솔에 실시간으로 표시되는 정보를 확인하세요. 팀원이 여러 지역에 있다면 일상적으로 데스크톱을 사용하는 구성원의 위치를 우선 고려하고, CI 작업은 소스 코드와 산출물의 전송 경로를 함께 살펴보세요.

06 / 여러 머신 협업

여러 대가 필요할 때 Thunderbolt 5 연결을 고려하세요

Thunderbolt 5 연결은 같은 노드에서 여러 머신을 연동하는 빌드 작업이나 대용량 파일을 자주 주고받는 워크플로에 적합합니다. 추가 요금은 머신 한 대당$1/일입니다. 필요한지는 작업의 전송량과 동시 실행 요구 사항을 기준으로 판단하세요. VNC 연결이나 단일 CI 머신 실행에 필요한 옵션은 아닙니다.

이런 작업에 적합

작업을 여러 머신에 분산 실행

예를 들어 여러 App target, 테스트 분할 작업 또는 서로 다른 버전의 빌드를 각각 별도의 runner에 배정할 수 있습니다. 각 머신에 서로 다른 레이블을 먼저 지정해 필요한 도구가 설치되지 않은 노드로 작업이 잘못 배정되지 않도록 하세요.

먼저 단일 머신의 실행 시간을 측정한 뒤 병렬 처리의 효과를 가늠하세요.

먼저 확인

전송 효율이 설정 비용을 상쇄하는지 확인

빌드가 주로 서명, 종속 항목 다운로드, 외부 API 응답을 기다리는 경우에는 연결 대역폭이 병목이 아닐 수 있습니다. 전송할 파일의 크기와 횟수, 머신 대수를 정리한 뒤 주문 설정에서 추가 옵션을 확인하세요.

노드 간 협업은 로컬 연결만으로 구현할 수 없습니다.

요금제 기간 및 추가 옵션 확인

07 / 문제 해결

연결 문제가 생기면 증상별로 원인을 좁혀 보세요

먼저 콘솔에서 인스턴스 상태, 주소, 포트를 확인한 뒤 문제가 SSH, VNC, 로컬 네트워크 중 어디에 있는지 구분하세요. 빌드 산출물을 백업하기 전에 환경을 반복해서 초기화하지 마세요.

VNC에 연결되지만 화면이 검게 표시됩니다

먼저 SSH로 계속 로그인할 수 있는지 확인한 다음 데스크톱 세션을 끊고 다시 연결하세요. VNC 인증 정보, 터널 실행 여부, 클라이언트가 로컬 전달 포트와 발급된 직접 연결 포트 중 어디에 연결했는지 확인하세요. SSH는 정상인데 여러 클라이언트에서 계속 검은 화면이 나타나면 콘솔에서 지원 티켓을 제출하고 인스턴스 ID, 발생 시간, 스크린샷을 첨부하세요.

화면이 너무 작거나 잘리거나 해상도가 맞지 않습니다

먼저 클라이언트에서 고정 확대/축소를 끄고 macOS 디스플레이 설정을 확인하세요. 원격 데스크톱은 단일 모니터와 일반적인 해상도로 먼저 테스트하세요. 설정을 바꾼 뒤 다시 연결해 서버 디스플레이 설정과 클라이언트 확대/축소 중 어느 쪽이 원인인지 확인하세요.

키보드 기호 또는 단축키가 다르게 입력됩니다

로컬과 원격 컴퓨터의 키보드 레이아웃이 같은지 확인하세요. 특히 구두점과 Option, Command 키를 살펴보세요. 클라이언트 설정에서 보조 키 매핑을 확인한 뒤 텍스트 편집기에서 몇 글자만 테스트하고 명령을 입력하거나 서명 설정을 변경하세요.

세션이 끊긴 뒤 작업을 재개하려면 어떻게 하나요?

먼저 SSH에 다시 연결하세요. 터널을 사용 중이라면 포트 전달 명령을 다시 실행한 뒤 로컬 VNC 포트에 연결하세요. 빌드 작업은 연결을 유지해야 하는 데스크톱 터미널보다 백그라운드 runner에서 실행하는 것이 좋습니다. SSH와 VNC 모두 복구되지 않으면 주문 번호, 노드 번호, 오류 스크린샷을 준비해 콘솔에서 지원 티켓을 제출하세요.

시작할 준비가 되셨나요?

하루 먼저 임대해 연결과 빌드를 테스트하세요

SSH로 간단한 작업부터 시작하고 데스크톱과 CI가 요구 사항을 충족하는지 확인한 뒤 임대 기간을 연장하거나 머신을 추가하세요. 기존 인스턴스의 문제를 해결해야 하나요? 콘솔에 로그인해 지원 티켓을 제출하세요.

Mac mini 지금 임대 콘솔에 로그인해 지원 티켓 제출