클라우드 Mac 도움말 센터: 연결·빌드·청구 문제 해결

01 / 최초 개통

정해진 순서대로 구성해 개통 후 재작업을 줄이세요

처음 대여할 때는 메모리와 스토리지 요구 사항을 먼저 정한 뒤 코드 저장소, 팀원 또는 출시 시장과 가까운 노드를 선택하세요. 먼저 결제한 뒤 구성을 맞추지 말고, 주문 확정 전에 모델, 노드, 기간과 추가 옵션을 함께 확인하세요.

01

세 가지 모델 중 선택

ZoneMini M4 Core M4, 16GB 메모리, 256GB SSD로 구성되어 가벼운 iOS 빌드와 단일 프로젝트 자동화에 적합합니다.ZoneMini M4 Plus M4, 24GB 메모리, 512GB SSD로 구성되어 일상적인 개발과 여러 프로젝트의 파이프라인에 적합합니다.ZoneMini M4 Pro M4 Pro, 64GB 메모리, 2TB SSD로 구성되어 대용량 메모리 추론과 고부하 병렬 작업에 적합합니다. 세 모델 모두 클라우드 기반 전용 물리 머신이며 가상 머신이 아닙니다.
02

판매 중인 다섯 개 노드에서 위치 선택

싱가포르, 일본(도쿄), 한국(서울), 홍콩, 미국 동부 중에서 선택할 수 있습니다. 코드 저장소와 주요 작업자의 위치를 우선 고려한 뒤 출시 시장과 팀의 시간대를 함께 검토하세요. 다섯 노드 모두 세 가지 모델을 지원하며, 실제 이용 가능 여부는 콘솔의 실시간 응답을 기준으로 합니다.
03

일·주·월·분기 단위 기간 선택

일시적인 호환성 테스트는 일 단위, 한 차례의 지속적인 반복 작업은 주 단위로 이용할 수 있습니다. 고정 Runner, 장기 아카이브 또는 지속적인 추론 작업에는 월 단위나 분기 단위가 일반적으로 더 적합합니다. 페이지 가격은 환산하거나 반올림하지 않으며, 주문 금액은 선택한 모델, 추가 옵션과 기간에 따라 직접 계산됩니다.
04

USD로 결제하고 주문 확인

USDT-TRC20 및 Visa / Mastercard / Amex(Stripe를 통해)만 지원합니다. 제출 전에 모델명, 노드, 기간, 추가 스토리지, Thunderbolt 5 확장 수량과 연락처를 확인하세요. 실제 이용 가능한 결제 게이트웨이는 콘솔 응답을 기준으로 합니다.
05

연결 정보를 받고 최초 인증 완료

제공받은 후 노드 주소, 사용자 이름, 임시 자격 증명과 연결 안내를 먼저 확인하세요. 최초 연결에 성공하면 임시 자격 증명을 변경하고 호스트 지문을 기록한 뒤 SSH 명령줄과 macOS 화면 공유를 각각 테스트하세요. 연결 정보는 민감한 정보이므로 공개 저장소나 일반 채팅에 붙여 넣지 마세요.

개통 전에 준비할 최소 정보

프로젝트 유형, 동시에 실행할 작업 수, Xcode 버전 범위, 1회 아카이브 소요 시간, 종속성 캐시 규모, 목표 노드와 예상 대여 기간을 정리하세요. 모델을 아직 판단하기 어렵다면 세 모델의 사양과 기간별 가격을 확인한 후 작업 데이터를 팀에 보내 검토받으세요.

구성을 선택하고 클라우드 Mac 대여 세 가지 대여 요금제 확인

02 / 연결 진단

인스턴스 상태부터 로컬 네트워크까지 단계별로 점검

연결에 실패해도 자격 증명, 포트와 방화벽을 동시에 변경하지 마세요. 상태, 인증, 네트워크, 포트, 서비스 설정 순서로 확인하고 각 결과를 보관해야 문제가 로컬 환경, 전송 경로 또는 대상 노드 중 어디에 있는지 판단할 수 있습니다.

CONNECTION CHECK 6단계 순차 점검

01
인스턴스 상태 확인
콘솔에 로그인해 주문에 연결된 인스턴스가 연결 가능한 상태인지 확인하고 현재 올바른 노드와 모델을 보고 있는지 점검하세요. 방금 제공이 완료됐다면 이전 이메일이나 기록의 주소가 아니라 콘솔에 표시된 정보를 기준으로 하세요.
02
액세스 자격 증명 확인
사용자 이름, 비밀번호와 SSH 키의 용도를 구분하고 키 파일 권한, 입력기 상태, 복사 시 공백 포함 여부를 확인하세요. 인증에 연속으로 실패하면 반복 시도를 멈추고 자격 증명의 출처를 다시 확인하세요.
03
로컬 네트워크 제한 배제
신뢰할 수 있는 예비 네트워크로 전환해 비교하고 회사의 외부 연결 정책, 프록시 또는 보안 소프트웨어가 대상 주소를 차단하지 않는지 확인하세요. 모든 보안 기능을 끄는 것을 장기 해결책으로 삼지 마세요.
04
SSH 포트 확인
먼저 TCP 22 포트에 연결할 수 있는지 테스트한 후 상세 SSH 로그를 실행하세요. 포트 시간 초과는 대개 네트워크 경로나 규칙 문제를 의미하며, 포트에는 연결되지만 인증에 실패한다면 사용자 이름, 키와 권한을 계속 확인하세요.
05
화면 공유 설정 확인
제공받은 연결 정보의 주소와 인증 정보를 사용하고 있는지 확인하세요. 검은 화면이나 해상도 이상이 발생하면 기존 세션을 먼저 종료한 후 다시 연결하고 클라이언트 시스템, 디스플레이 수와 배율 설정을 기록하세요.
06
방화벽 규칙 확인
로컬 방화벽, 팀의 외부 연결 규칙과 노드 측 허용 범위를 확인하세요. 규칙을 변경할 때는 최소한만 허용하는 원칙을 적용하고 출처, 포트, 시간과 변경 담당자를 기록하세요.

네트워크 및 포트 점검

nc -vz <노드 주소> 22
ssh -vvv -o ConnectTimeout=10 사용자 이름@노드 주소
route -n get <노드 주소>

자리 표시자를 제공받은 노드 주소와 사용자 이름으로 바꾸세요.

결과 해석 방법

시간 초과와 인증 실패를 먼저 구분하세요

연결 시간 초과: 로컬 외부 연결, 프록시, 방화벽과 대상 포트의 연결 가능 여부를 우선 확인하세요.
연결 거부: 시간, 노드와 전체 오류 행을 기록하고 대상 주소와 포트가 올바른지 확인하세요.
인증 실패: 사용자 이름, 키 경로, 파일 권한과 제공받은 자격 증명을 확인하고 비밀번호를 반복해서 추측하지 마세요.
호스트 지문 변경: 연결을 중지하고 지원 티켓으로 확인을 요청하세요. 기록된 지문을 바로 삭제한 뒤 계속 연결하지 마세요.

전체 연결 단계 보기

03 / 빌드 환경

빌드 실패를 도구 체인·서명·종속성·산출물의 네 단계로 나누세요

동일한 파이프라인이 대화형 세션에서는 성공하지만 CI Runner에서는 실패한다면 환경 변수, 키체인 컨텍스트, 작업 디렉터리 또는 캐시 권한이 다른 경우가 많습니다. 문제를 점검할 때는 실패한 작업과 동일한 사용자와 실행 경로를 사용하세요.

A

Xcode 및 명령줄 도구 확인

시스템 버전, Xcode 버전과 현재 개발자 디렉터리를 기록하세요. Xcode가 여러 버전 설치되어 있다면 그래픽 인터페이스에서 열린 버전만 확인하지 말고 파이프라인이 호출하는 경로가 프로젝트 요구 사항과 일치하는지 확인하세요.

xcodebuild -version 실제 빌드 도구 버전 확인
xcode-select -p 현재 개발자 디렉터리 확인
swift --version Swift 도구 체인 확인

B

인증서 및 프로비저닝 프로파일 확인

현재 실행 사용자가 서명 자료에 액세스할 수 있고 대상, 구성과 내보내기 방식이 올바른 항목을 참조하는지 확인하세요. 인증서 이름, 유효 상태와 일치 결과만 기록하고 인증서 개인 키나 전체 프로파일을 지원 티켓에 업로드하지 마세요.

프로젝트의 Team, Bundle Identifier와 서명 방식 확인
빌드 구성의 프로비저닝 프로파일이 대상과 일치하는지 확인
로컬 세션과 Runner 세션에서 보이는 서명 ID 비교

C

키체인 액세스 컨텍스트 확인

CI 작업이 비대화형 환경에서 서명 자료에 액세스해야 한다면 파이프라인 설계에 따라 키체인이 잠금 해제되어 있는지 확인하고 자동화 계정의 액세스 범위를 제한하세요. 잠금 해제 암호를 저장소 스크립트나 일반 로그에 직접 기록하지 마세요.

실행 사용자와 서명 자료를 가져온 사용자가 동일한지 확인
Runner 시작 방식이 세션 컨텍스트를 변경하는지 확인
로그에서 암호, 토큰과 개인 키 경로 삭제

D

종속성 캐시 문제 분리

먼저 잠금 파일이 변경되지 않았는지 확인한 뒤 CocoaPods, Swift Package Manager, Node.js 또는 Flutter 종속성을 각각 점검하세요. 캐시 이상이 발생하면 현재 프로젝트와 관련된 디렉터리만 정리하고 팀이 공유하는 호스트 전체 캐시를 한 번에 삭제하지 마세요.

잠금 파일 해시와 종속성 해석 출력 저장
실패 브랜치와 성공 브랜치의 종속성 버전 비교
캐시 디렉터리 소유자, 권한과 현재 용량 기록

E

재현 가능한 아카이브 로그 수집

전체 명령어, 작업 디렉터리, Scheme, Configuration, SDK, Destination과 종료 코드를 보관하세요. 로그는 마지막 한 줄만 잘라내지 말고 최초 오류 전후의 컨텍스트를 포함해야 합니다.

이번 빌드 출력을 별도 결과 디렉터리에 저장
트리거 방식, 커밋 식별자와 Runner 태그 기록
민감 정보를 삭제한 뒤 핵심 내용을 콘솔 지원 티켓에 첨부

F

최소 명령어부터 검증

전체 아카이브 전에 버전, 프로젝트 구조와 Scheme 표시 여부를 먼저 확인하세요. 최소 명령어가 실패하면 도구 체인을 계속 점검하고, 최소 명령어는 성공하지만 아카이브가 실패하면 서명, 종속성과 내보내기 구성을 확인하세요.

빌드 구성 상담

빌드 환경 정보 수집

sw_vers
xcodebuild -version
xcode-select -p
swift --version
xcodebuild -list -workspace <프로젝트 작업 공간>

명령어는 프로젝트 키를 읽지 않지만 결과를 제출하기 전에 내부 경로나 저장소 이름이 포함되어 있지 않은지 확인하세요.

04 / 스토리지 및 확장

먼저 용량 용도를 확인한 뒤 마운트와 작업 경계를 점검하세요

추가 스토리지는 종속성 캐시, 빌드 중간 파일, 모델 파일과 단기 자료 처리에 적합합니다. 프로젝트 자체의 버전 관리와 장기 아카이브 전략을 대체해서는 안 됩니다. Thunderbolt 5 확장은 장비별로 과금되며 여러 장비 협업을 전제로 설계된 작업에 적합합니다. 서로 독립적인 두 작업을 자동으로 하나의 병렬 작업으로 만들지는 않습니다.

스토리지 및 확장 추가 옵션 공개 가격
추가 옵션	일 단위	주 단위	월 단위	분기 단위	적합한 용도
+1TB SSD	$2	$5.5	$10.1	$27.5	종속성 캐시, 빌드 산출물과 중간 규모 자료
+2TB SSD	$4	$11	$20.2	$55	모델 파일, 배치 자료와 대규모 아카이브 작업 세트
Thunderbolt 5 확장(장비별)	$1.7	$4.6	$8.6	$23.4	다중 장비 작업 분할, 노드 간 고속 데이터 협업

마운트 점검

시스템이 대상 디스크를 인식했는지 확인

다음 명령어로 diskutil list 디스크와 파티션을 확인한 다음 df -h 실제 마운트 지점과 사용 가능한 공간을 확인하세요. 장치는 보이지만 올바른 마운트 지점이 없다면 명령어 출력을 기록해 지원 티켓을 제출하고, 알 수 없는 디스크를 바로 포맷하지 마세요.

공간 모니터링

전체 용량과 증가하는 디렉터리를 함께 확인

아카이브가 실패하기 전에 작업 공간, DerivedData, 종속성 캐시와 임시 디렉터리를 확인하세요. 빌드 로그의 “공간 부족”은 프로젝트 디렉터리가 있는 볼륨이 아니라 시스템 볼륨이나 임시 디렉터리에서 발생할 수도 있습니다.

작업 분할

입력·실행·산출물 기준으로 호스트 역할 정의

다중 호스트 워크플로에서는 코드 가져오기, 빌드 또는 추론 실행, 산출물 저장 위치와 실패 시 재시도 방식을 명확히 정해야 합니다. 여러 호스트가 동일한 작업 디렉터리를 동시에 수정하거나 변경 가능한 캐시를 공유하지 않도록 하세요.

디스크 및 캐시 점검

diskutil list
df -h
du -sh ~/Library/Developer/Xcode/DerivedData
du -sh ~/Library/Caches

대용량 디렉터리 통계에는 시간이 걸릴 수 있습니다. 먼저 출력을 확인하고 용도를 확인하기 전에는 디렉터리를 삭제하지 마세요.

05 / 청구 및 결제

주문 번호로 모델·기간·추가 옵션 확인

ZoneMini의 모든 주문은 USD로 결제되며 USDT-TRC20 및 Visa / Mastercard / Amex(Stripe를 통해)만 지원합니다. 실제 이용 가능한 결제 게이트웨이는 콘솔 응답을 기준으로 합니다. 청구 문제는 구체적인 주문을 기준으로 확인하고 결제 화면 캡처나 불명확한 거래 시간만 보내지 마세요.

결제 통화 USD

모델, 기간과 추가 옵션은 페이지에 표시된 USD 가격으로 계산되며 페이지에서 통화를 환산하지 않습니다.

디지털 자산 결제 USDT-TRC20

결제 전에 콘솔에 표시된 네트워크, 금액과 주문 정보를 확인하세요. 문의할 때는 주문 번호와 민감 정보가 삭제된 거래 ID를 제공하세요.

카드 결제 Visa / Mastercard / Amex

카드 거래는 Stripe를 통해 처리됩니다. 실패하면 콘솔 오류 메시지, 발생 시간과 주문 번호를 기록하고 전체 카드 정보를 제출하지 마세요.

최종 금액을 모델, 기간과 추가 옵션으로 함께 확인해야 하는 이유는 무엇인가요?

주문 금액은 선택한 모델의 기간별 가격에 같은 기간의 스토리지 또는 Thunderbolt 5 확장 옵션을 더해 계산합니다. 모델명, 노드, 일·주·월·분기 기간, 추가 용량과 확장 장비 수를 주문서에서 항목별로 비교하세요.

결제가 완료되지 않았을 때 어떤 정보를 보관해야 하나요?

주문 번호, 결제 수단, 발생 시간, 콘솔에 표시된 전체 오류 문구와 민감 정보가 삭제된 거래 ID를 보관하세요. 전체 카드 번호, 인증 코드, 지갑 개인 키, 시드 문구 또는 전체 계정 비밀번호는 보내지 마세요.

기존 주문은 어떤 경로에서 조회하나요?

콘솔에 로그인해 주문, 인스턴스와 청구 상태를 확인하세요. 표시 내용이 결제 기록과 다르면 해당 주문의 컨텍스트에서 주문 번호를 첨부해 지원 티켓을 제출하세요. 같은 문제에 관련 정보가 빠진 요청을 여러 개 만들지 마세요.

06 / 지원 티켓 제출

처리 가능한 지원 티켓에는 여섯 가지 컨텍스트가 필요합니다

지원 티켓의 목적은 ‘문제가 있다’는 사실을 증명하는 것이 아니라 영향 범위, 재현 경로와 원하는 결과를 지원 담당자가 파악하도록 하는 것입니다. 핵심 정보를 하나의 요청에 모으면 추가 문의를 줄일 수 있습니다.

01

노드

싱가포르, 일본(도쿄), 한국(서울), 홍콩 또는 미국 동부를 명시하고 콘솔의 인스턴스 ID를 첨부하세요.

02

모델

ZoneMini M4 Core, ZoneMini M4 Plus 또는 ZoneMini M4 Pro를 명시하고 단순히 “M4 호스트”라고만 쓰지 마세요.

03

발생 시간

시간대를 포함한 시간 범위를 제공하고 문제가 처음 발생했는지, 지속적으로 재현되는지 또는 간헐적인지 설명하세요.

04

재현 단계

작업 디렉터리에 들어가거나 연결을 시작한 시점부터 명령어, 입력 조건, 실제 결과와 종료 코드를 단계별로 작성하세요.

05

민감 정보가 삭제된 로그

오류 전후의 컨텍스트를 보관하되 저장소 토큰, 서명 자료, 내부 주소와 개인 식별 정보를 삭제하세요.

06

원하는 결과

정상 동작이 무엇인지, 문제가 연결·테스트·아카이브·결제 또는 산출물 전달 중 무엇을 막고 있는지 설명하세요.

제출 전에 민감한 정보 삭제

인증서 개인 키, 저장소 토큰 또는 전체 비밀번호를 업로드하지 마세요

서명 인증서는 이름과 유효 상태만 제공하고, 토큰은 유형과 권한 범위만 설명하세요. 자격 증명 문제에는 오류 메시지와 민감 정보가 삭제된 식별자만 제공하세요. 로그의 이메일, 저장소 주소, 내부 호스트명과 파일 경로도 필요한 범위에서 익명화해야 합니다.

청구 문제에는 주문 번호 첨부
연결 문제에는 명령어 출력과 클라이언트 환경 첨부
빌드 문제에는 Xcode 버전, Scheme, 종료 코드와 핵심 로그 첨부
스토리지 문제에는 마운트 지점, 용량과 관련 디렉터리 증가 현황 첨부

먼저 단계를 파악한 뒤 클라우드 Mac 문제를 해결하세요

정해진 순서대로 구성해 개통 후 재작업을 줄이세요

세 가지 모델 중 선택

판매 중인 다섯 개 노드에서 위치 선택

일·주·월·분기 단위 기간 선택

USD로 결제하고 주문 확인

연결 정보를 받고 최초 인증 완료