클라우드 Mac 이용 지원

먼저 직접 확인해 보세요

연결, 툴체인, 갱신 중 어디에서 문제가 발생했는지 먼저 확인하세요.
대여 중인 노드는 콘솔에서 문의할 수 있으며, 노드 연결 불가는 긴급 장애로 우선 처리합니다.

대여 중인 노드의 문제는 문의로 접수해 주세요. 구매 전 문의, 대량 상담, 보안 제보는 연락처 페이지의 이메일을 이용하세요.

문제별 안내

알맞은 점검 방법 찾기

문제 유형에 따라 해결 방법이 다릅니다. 결제 확인 지연이 노드 장애를 뜻하는 것은 아니며, 빌드 실패 때마다 기기를 재시작할 필요도 없습니다.

연결 및 로그인

SSH 시간 초과, 원격 데스크톱 검은 화면, 화면 공유 오류를 확인합니다. 주문 정보와 네트워크를 먼저 점검해 연결 문제인지 데스크톱 세션 문제인지 구분하세요.

Xcode 및 시뮬레이터

잘못된 Xcode가 선택되거나 캐시가 디스크 공간을 차지하거나 서명 인증서가 보이지 않을 수 있습니다. 버전과 키체인 점검 결과로 환경 차이를 파악하세요.

CI runner

터미널에서는 빌드되지만 파이프라인에서 실패한다면 실행 사용자, PATH, 키체인, 시뮬레이터 상태부터 확인하세요. 먼저 동시 실행 수를 늘리지 마세요.

결제 및 갱신

온체인 송금 확인 지연, 카드 결제 실패, 만료 시각 불확실 등의 문제를 확인합니다. 주문 및 결제 상태는 콘솔에 표시되는 최신 정보를 기준으로 하세요.

연결 문제 해결

포트를 확인한 다음 세션을 점검하세요

호스트 주소, 연결 포트, 사용자 이름, 키 정보는 콘솔의 주문 상세에서 확인하세요. 아래 명령에 사용하는 변수는 해당 주문에 맞게 설정해야 합니다. 예시 별칭을 실제 노드 주소로 사용하지 마세요.

SSH 연결 시간 초과

시간 초과와 인증 실패를 구분하세요. 시간 초과는 대개 TCP 연결이 설정되기 전에 발생합니다. 주소, 포트, 로컬 네트워크의 외부 연결 및 노드 상태를 확인하세요. Permission denied 가 표시되면 인증 단계에 도달한 것입니다. 포트를 계속 바꾸기보다 사용자 이름과 키를 확인하세요.

nc -vz "$NODE_HOST" "$SSH_PORT"

로컬 터미널에서 실행하세요. 연결에 성공해도 해당 포트에 도달할 수 있다는 뜻일 뿐, 인증이 완료된 것은 아닙니다. 실패하면 사용 가능한 다른 네트워크에서 다시 확인하고 두 번의 결과를 기록하세요. 포트에는 연결되지만 로그인이 실패하면 ssh -vv 를 사용해 인증 단계 로그를 수집하세요. 제출하기 전에 로그에서 사용자 이름, 주소, 로컬 경로 등 민감한 정보를 삭제하세요.

VNC 연결 후 검은 화면

클라이언트가 연결됐지만 화면이 보이지 않는 경우와 포트에 전혀 연결되지 않는 경우는 다릅니다. 그래픽 연결이 중복되어 있다면 연결을 끊고 클라이언트의 화질 및 데스크톱 세션을 확인하세요. SSH를 사용할 수 있다면 현재 콘솔 사용자를 확인해 로그인된 그래픽 세션이 있는지 살펴보세요.

stat -f '%Su' /dev/console

노드의 SSH 세션에서 실행하세요. 출력은 참고 정보일 뿐 데스크톱 서비스가 정상임을 단독으로 입증하지는 않습니다. 정체를 알 수 없는 프로세스를 강제 종료하거나 빌드 중인 노드를 재시작하지 마세요. 검은 화면이 발생한 시각, 클라이언트 이름, SSH 사용 가능 여부, 세션 점검 결과를 문의에 적으면 지원팀에서 이어서 확인합니다.

화면 공유 해상도 문제

원격 해상도가 변경된 것인지 로컬 클라이언트의 배율 설정 때문에 글자가 흐릿한 것인지 먼저 확인하세요. 화면 공유의 배율 및 자동 화질 옵션을 확인한 다음 원격 디스플레이 정보를 조회하세요. 클라이언트 창 크기를 바꿔도 원격 디스플레이 모드가 변경되는 것은 아닙니다.

system_profiler SPDisplaysDataType

노드에서 실행해 디스플레이 정보를 확인하세요. 원하는 모드가 없다면 현재 해상도, 클라이언트 창 크기, 선택 가능한 디스플레이 모드를 기록하세요. 스크린샷에는 디스플레이 설정만 포함하고 프로젝트, 인증 정보, 업무 데이터는 제외하세요. 출처가 불분명한 디스플레이 드라이버를 우선 해결책으로 설치하지 마세요.

SSH와 그래픽 연결이 모두 되지 않고 네트워크를 바꿔도 해결되지 않으면 노드 연결 불가 문의를 제출하세요. 클라이언트를 반복해서 재설치하는 것으로 장애 신고를 대신하지 마세요.

개발 환경

터미널과 빌드에 같은 툴체인 사용하기

오류 로그를 보존한 다음 환경을 변경하세요. 아래 작업은 전용 물리 노드에서 진행합니다. 권한이 필요한 명령을 실행하기 전에 다른 팀의 작업이 해당 환경을 사용 중인지 확인하세요.

Xcode 버전을 바꾸고 파이프라인에서 실제 사용하는 버전을 확인하려면 어떻게 하나요?

먼저 다음 명령을 실행해 xcode-select -p 및 xcodebuild -version을 확인하고 현재 개발자 디렉터리와 버전을 기록하세요. 대상 Xcode가 설치되어 있는지 확인한 뒤 개발자 디렉터리를 해당 버전의 Contents/Developer로 변경하세요. 아래 경로는 앱 이름이 Xcode.app인 경우에 해당합니다. 노드에서 버전이 포함된 앱 이름을 사용한다면 실제 경로에 맞게 바꾸세요.

xcode-select -p
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
xcodebuild -version

CI 프로세스는 DEVELOPER_DIR 로 시스템 선택을 덮어쓸 수 있습니다. 터미널과 파이프라인의 버전이 다르면 시스템 설정만 보지 말고 job의 환경 변수와 runner 서비스 사용자를 확인하세요. 특정 작업에서 다른 버전이 필요하다면 해당 작업에 개발자 디렉터리를 명시적으로 지정해 같은 노드의 다른 빌드에 영향을 주지 않도록 하세요.

DerivedData는 언제 정리해야 하며 프로젝트를 잘못 삭제하지 않으려면 어떻게 해야 하나요?

사용량을 확인한 다음 정리 여부를 결정하세요. 툴체인 변경 후 캐시 관련 오류나 인덱스 문제가 발생하거나 디스크 공간이 부족할 때 DerivedData를 정리할 수 있습니다. 일반적인 컴파일 오류를 무조건 캐시 문제로 보지는 마세요. 관련 빌드 작업을 종료한 후 캐시 디렉터리 이름을 바꿔 보관하면 바로 재귀 삭제하는 것보다 복구하기 쉽습니다.

du -sh "$HOME/Library/Developer/Xcode/DerivedData"
mv "$HOME/Library/Developer/Xcode/DerivedData" "$HOME/Library/Developer/Xcode/DerivedData.backup.$(date +%s)"

디렉터리가 있을 때만 이름을 바꾸세요. Xcode는 다음 빌드에서 캐시를 다시 생성합니다. 이름을 바꿔도 디스크 공간은 확보되지 않습니다. 새 빌드가 정상인지 확인한 다음 실제 백업 경로의 이전 캐시를 삭제하세요. 필요한 아카이브는 보관하고 Archives, 프로젝트 디렉터리, 서명 자료를 함께 지우지 마세요. CI에서 사용자 지정 -derivedDataPath를 사용한다면 현재 사용자의 기본 디렉터리가 아니라 지정된 경로를 확인해야 합니다.

서명 인증서를 가져왔는데도 빌드에서 서명 ID를 찾지 못하는 이유는 무엇인가요?

서명하려면 유효한 인증서와 이에 대응하는 개인 키가 필요합니다. 인증서 파일만으로는 보통 서명을 완료할 수 없습니다. 키체인 접근을 통해 사용할 권한이 있는 서명 자료를 가져온 다음 실제 빌드를 실행하는 사용자 계정에서 사용 가능한 ID를 확인하세요. 문의에 인증서 파일이나 가져오기 암호를 첨부하지 마세요.

security find-identity -v -p codesigning
security list-keychains -d user

대화형 사용자에게 ID가 보인다고 해서 runner 서비스 사용자에게도 보이는 것은 아닙니다. 서비스 실행 계정, 키체인 검색 목록, 잠금 해제 상태, 접근 권한을 확인하세요. 키체인 접근 제어를 조정해야 한다면 필요한 서명 도구에만 권한을 부여하세요. 오류를 없애려고 모든 앱에 개인 키 접근을 허용하지 마세요. 문의 시 민감한 정보를 제거한 ID 점검 결과, 오류 코드, 실행 사용자 유형을 알려 주세요.

로컬 터미널에서는 빌드되지만 CI runner 또는 시뮬레이터 작업이 실패한다면 무엇부터 확인해야 하나요?

SSH 터미널에서만 확인하지 말고 실패한 job에서 같은 환경 점검을 실행하세요. 실행 사용자, 개발자 디렉터리, Xcode 버전, PATH, 사용 가능한 시뮬레이터를 비교하세요. 서비스 프로세스가 대화형 셸 설정을 불러오지 않을 수 있으므로 직접 실행에 성공해도 서비스 환경이 같다는 뜻은 아닙니다.

whoami
xcode-select -p
xcodebuild -version
printf '%s\n' "$PATH"
xcrun simctl list devices available

시뮬레이터 목록에 대상 기기가 없다면 필요한 런타임이 설치되어 있는지, 테스트 작업의 destination이 일치하는지 확인하세요. runner가 오프라인으로 표시되면 서비스 시작 상태와 작업 로그를 확인한 다음 네트워크 연결과 등록 정보를 점검하세요. 기준 데이터가 없다면 빌드 작업 하나로 먼저 검증하고 동시 실행 수를 단계적으로 늘리면서 통합 메모리와 디스크 사용량을 살펴보세요.

전용 노드란 물리 리소스를 다른 임차인과 나누어 쓰지 않는다는 뜻이지, 같은 노드의 여러 작업이 서로 영향을 주지 않는다는 뜻은 아닙니다. GitHub Actions와 GitLab CI의 전체 설정 방법은 연결 가이드에서 확인하세요.

결제 및 대여 기간

주문 상태를 확인한 뒤 다음 단계를 진행하세요

모든 요금은 USD로 결제됩니다. USDT-TRC20 및 Visa / Mastercard / Amex(Stripe)만 지원합니다. 실제 이용 가능한 결제 게이트웨이는 콘솔에 표시되는 최신 정보를 확인하세요.

USDT-TRC20을 송금했는데 주문에 결제 완료로 표시되지 않는 이유는 무엇인가요?

지갑의 송금 완료, 온체인 확인, 주문 확인은 서로 다른 단계입니다. 확인 시간은 온체인 처리와 결제 게이트웨이 상태에 따라 달라지므로 이 페이지에서는 일정한 소요 시간을 안내하지 않습니다. 먼저 결제 페이지에 표시된 네트워크, 수취 주소, 금액이 맞는지 확인하세요. 그런 다음 해당 거래의 성공 여부와 콘솔의 주문 상태를 확인하세요.

주문이 아직 갱신되지 않았다고 해서 결제를 반복하지 마세요. 수동 확인이 필요하면 주문 번호, 트랜잭션 해시, 송금 금액과 시각을 제출하고 시간대를 명시하세요. 트랜잭션 해시로 거래를 조회할 수 있습니다. 시드 구문, 지갑 개인 키, 암호는 필요하지 않으며 보내서도 안 됩니다. 네트워크나 금액이 결제 안내와 다르다면 거래 기록을 보관하고 문의에 사실대로 적어 주세요.

카드 결제가 실패했거나 명세서에 승인 대기 내역이 표시되면 어떻게 확인해야 하나요?

먼저 결제 페이지의 오류 안내와 주문 상태를 확인한 다음 카드 발급사가 해당 USD 거래를 허용하는지, 추가 인증이 필요한지 확인하세요. 발급사의 승인 대기 내역이 주문 결제 완료를 의미하지는 않습니다. 카드 알림만으로 서비스 제공 여부를 판단하지 마세요.

여러 번 실패했다면 빠르게 연속 재시도하지 말고 카드 발급사에 거절 사유를 확인하세요. 콘솔에는 결제가 확인되지 않지만 은행에 청구 내역이 표시된다면 주문 번호, 결제 시각, 금액, 민감한 정보를 가린 오류 메시지를 알려 주세요. 결제 거래 ID가 있다면 함께 제출하세요. 전체 카드 번호, 보안 코드, 인증 문자는 보내지 마세요. 지원팀은 주문 및 결제 기록을 확인하며, 환불 또는 승인 취소 여부는 게이트웨이와 카드 발급사의 결과에 따라 확인됩니다.

갱신 알림은 언제 발송되며 만료 시 프로젝트 중단을 어떻게 방지할 수 있나요?

콘솔에 표시된 만료 시각을 기준으로 확인하세요. 알림 발송 시각과 전송 상태는 콘솔에서 확인해야 합니다. 이 페이지에서는 일정한 사전 알림 일수를 보장하지 않으므로 알림 수신 여부만으로 사용 가능 여부를 판단하지 마세요. 팀 일정에 만료 시각을 별도로 등록하고 갱신 결과를 확인할 담당자를 지정하는 것이 좋습니다.

일, 주, 월, 분기 중 주기를 선택한 뒤 갱신 청구서의 기기 모델, 추가 항목, 대여 기간이 맞는지 확인하세요. 결제 후에는 결제 페이지 스크린샷에만 의존하지 말고 주문 상태가 갱신됐는지 확인하세요. 만료 후에는 노드를 사용할 수 없으므로 프로젝트, 산출물, 필요한 설정을 만료 전에 백업하세요. 콘솔의 시각이나 금액이 예상과 다르면 청구서 번호를 보관해 문의한 뒤 결제를 진행할지 결정하세요.

전체 이용 주기 요금과 스토리지 확장 비용은 요금제 페이지에서 확인하세요. 기존 주문의 결제 문제는 콘솔 문의로 확인해야 하며, 이메일에 기기 암호를 첨부하지 마세요.

문의 준비

재현 가능한 문제를 한 번에 설명하세요

대여 중인 사용자는 콘솔의 문의 기능을 이용하세요. 영향 범위에 따라 분류해 노드 연결 불가 문제를 우선 처리하고, 환경 설정 및 결제 문의는 유형에 따라 확인합니다.

일반 문의: 예상 결과와 실제 결과 설명

개발 환경, 설정 방법, 갱신 확인은 문의로 처리할 수 있습니다. 안내 기준 시간대는 UTC+8이며 아시아·태평양 업무 시간대를 지원합니다. 구체적인 응답 시간과 진행 상황은 콘솔의 문의 안내 및 답변을 확인하세요. 이 페이지에서는 일정한 응답 시간을 보장하지 않습니다.

수행하려는 작업, 실제 결과, 이미 시도한 방법을 적고 재현 가능한 최소 명령을 첨부하세요. 여러 사람이 교대로 노드를 사용한다면 문제가 발생했을 때 병렬 빌드나 그래픽 세션이 실행 중이었는지도 알려 주세요. 작업 충돌을 노드 장애로 오인하지 않도록 하는 데 도움이 됩니다.

긴급 장애: 노드 연결 불가 우선 처리

SSH와 그래픽 연결이 모두 실패해 진행 중인 작업에 노드를 사용할 수 없다면 제목에 ‘노드 연결 불가’라고 적고 마지막으로 정상 연결된 시각을 알려 주세요. 네트워크를 바꾼 뒤 확인한 포트 점검 결과도 첨부하면 로컬 네트워크와 노드 측 문제를 구분하는 데 도움이 됩니다.

긴급 우선순위는 점검 순서를 정하기 위한 것이며 복구 시간을 보장하지는 않습니다. SSH 접속이 가능하다면 영향을 받는 기능을 설명하세요. 디스크 삭제, 재설치, 반복적인 전원 차단은 영향이 커지고 진단 정보가 사라질 수 있으므로 먼저 실행하지 마세요.

제출 전에 다음 세 가지 정보를 준비하세요

  1. 주문 및 노드

    주문 번호, 기기 모델, 노드 식별 정보를 알려 주세요. 선택 가능한 노드는 싱가포르, 도쿄, 서울, 홍콩입니다. 기기 암호, SSH 개인 키, 결제 인증 정보는 보내지 마세요.

  2. 시각 및 영향

    장애가 시작된 시각과 시간대를 기록하세요. SSH, 그래픽 데스크톱, 빌드 작업, 결제 확인 중 어떤 기능에 영향을 주는지와 마지막 정상 사용 시각도 알려 주세요.

  3. 결과 및 증거

    민감한 정보를 가린 명령 출력, 오류 코드, 최소 재현 절차를 붙여넣으세요. 스크린샷에서 프로젝트 내용과 인증 정보를 잘라내세요. 같은 문제는 새 문의 대신 기존 문의에 추가해 처리 맥락을 유지하세요.

콘솔에 로그인할 수 없거나 구매 전 문의, 대량 상담, 보안 제보가 필요하면 다음 이메일로 보내세요: support@xcodenode.com. 이메일에도 암호, 개인 키, 서명 자료, 전체 카드 정보를 포함하지 마세요.

마지막 단계가 남았나요? 연결 과정을 끝까지 확인하세요

연결 가이드에서 SSH, 그래픽 데스크톱, CI 설정 방법을 확인할 수 있습니다. 주문 관련 문의 외의 요청은 연락처 페이지에서 필요한 정보와 적절한 문의 채널을 확인하세요.