엔지니어링 지원 센터

순서대로 진단한 뒤 적절한 담당자에게 전달하세요

이곳에서는 클라우드 Mac의 배포, 원격 연결, SSH, Xcode, CI/CD, 스토리지 및 결제 문제를 다룹니다. 먼저 5가지 기본 점검을 완료하면 문제가 로컬 네트워크, 접속 정보, macOS 세션 또는 빌드 환경 중 어디에 있는지 한 번의 점검으로 판단할 수 있는 경우가 많습니다.

엔지니어의 도움이 필요하다면 콘솔 문의에 주문 번호, 대상 노드, 발생 시간, 스크린샷 및 수행한 단계를 첨부하세요. 비밀번호, 개인 키 또는 복구용 인증 정보는 제출하지 마세요.

클라우드 Mac 지금 대여하기 콘솔에 로그인해 문의 제출
7개
문제 유형
5개
기본 진단
2가지
문의 채널
OVPS / INCIDENT ROUTE 빠른 진단 등록판
권장 점검 순서 노드 → 네트워크 → 인증 정보 → 세션 → 클라이언트
  1. 01
    노드 정보 확인 주문 번호, 노드 주소, 포트 및 계정명이 동일한 호스트를 가리키는지 확인하세요.
    기본
  2. 02
    네트워크 경로 확인 네트워크를 전환해 다시 테스트하고 로컬 출구와 대상 노드 중 어디의 문제인지 구분하세요.
    네트워크
  3. 03
    접속 정보 확인 인증 정보 업데이트 시간, SSH 키 및 호스트 지문을 확인하세요.
    인증
  4. 04
    macOS 세션 점검 그래픽 세션, 화면 잠금 상태 및 백그라운드 작업이 계속 실행 중인지 확인하세요.
    세션
  5. 05
    클라이언트 차이 배제 클라이언트 버전, 디스플레이 설정, 프록시 및 오류 원문을 기록하세요.
    로컬
365일 연중 정상 운영 문제가 해결되지 않으면 콘솔 문의로 전환
문제 유형 선택

7개 유형으로 시작점을 정확히 선택하세요

현재 현상과 가장 가까운 유형을 선택하세요. 각 카드에는 첫 점검 단계와 보존해야 할 증거가 안내되어 있어 다른 문제 유형도 누락하지 않습니다.

배포

주문은 제출했지만 접속 정보가 아직 확인되지 않음

먼저 주문 상태, 선택한 모델 및 대상 노드를 확인한 다음 콘솔에 노드 주소, 포트, 계정명과 연결 안내가 생성되었는지 확인하세요.

  • 주문 번호와 제출 시간 기록
  • 선택한 노드가 주문과 일치하는지 확인
  • 동일한 주문을 반복 생성하지 않기
원격 연결

그래픽 인터페이스가 열리지 않거나 검은 화면 또는 잦은 연결 끊김

먼저 노드 주소와 포트를 확인한 뒤 다른 네트워크로 다시 테스트하세요. 클라이언트 이름, 버전, 디스플레이 설정 및 전체 오류 스크린샷을 보관하세요.

  • 세션이 잠금 화면에 멈춰 있지 않은지 확인
  • 디스플레이 해상도를 낮춘 뒤 다시 테스트
  • 로컬 프록시 및 방화벽 규칙 확인
SSH

키가 거부되거나 지문이 변경되었거나 연결 시간 초과

로컬 개인 키 권한, 공개 키 내용, 대상 계정, 포트 및 호스트 지문을 각각 확인하세요. 개인 키를 문의나 이메일에 붙여 넣지 마세요.

  • 시간이 포함된 오류 원문 보관
  • 공개 키에 줄바꿈으로 인한 손상이 없는지 확인
  • 키를 교체한 뒤 기존 세션을 먼저 유지
Xcode

버전 불일치, 빌드 실패 또는 캐시 이상

macOS, Xcode, 프로젝트 커밋 및 종속성 버전을 기록하세요. 먼저 코드를 변경하지 않고 환경을 확인한 뒤 캐시 정리 여부를 결정하세요.

  • 첫 번째 실제 실패 로그 저장
  • 환경 오류와 코드 오류 구분
  • 정리 전에 캐시 디렉터리 사용량 기록
CI/CD

runner 오프라인, 작업 멈춤 또는 작업 디렉터리 변경

runner 서비스 프로세스, 등록 범위, 작업 디렉터리, 동시 작업 및 네트워크 출구를 확인하세요. 먼저 최소 테스트 작업을 실행한 뒤 전체 파이프라인을 복구하세요.

  • 실패한 작업 번호 기록
  • runner의 마지막 온라인 시간 확인
  • 캐시로 디스크가 가득 차지 않았는지 확인
스토리지

디스크 공간 감소, 과도한 캐시 또는 쓰기 실패

먼저 디렉터리별 사용량을 집계해 프로젝트 파일, 종속성 캐시, 빌드 산출물, 로그 및 임시 파일을 구분하세요. 출처가 불명확한 시스템 디렉터리를 바로 삭제하지 마세요.

  • 사용 가능 공간과 이상 디렉터리 기록
  • 계속 증가하는 로그 파일 확인
  • 정리 후 최소 빌드 다시 실행
결제

기간, 노드, 추가 옵션 또는 결제 기록 확인 필요

달러 청구서의 모델, 대여 기간, 노드, 스토리지 확장 및 Thunderbolt 5 병렬 연결 수량을 항목별로 확인한 뒤 결제 채널 기록을 대조하세요.

  • 일·주·월·분기 기간 확인
  • 추가 옵션 수량과 단가 대조
  • 주문 번호를 첨부하고 결제 키는 제출하지 않기
현장 정보를 먼저 보존한 뒤 정리하거나 교체하세요.

빌드 로그, 오류 원문, 클라이언트 버전, 디스크 사용량 및 발생 시간을 제공하면 반복 확인을 크게 줄일 수 있습니다. 인증 정보가 관련된 경우 상태만 설명하고 비밀번호, 개인 키 또는 복구용 인증 정보는 보내지 마세요.

5가지 기본 점검

연결 불가를 검증 가능한 5단계로 나눠 보세요

각 단계를 완료할 때마다 결과를 기록하세요. 네트워크, 키 및 클라이언트를 동시에 변경하면 문제가 해결된 뒤에도 실제 원인을 확인할 수 없습니다.

CHECKLIST / 05

빠른 진단 패널

순서대로 실행
  1. 01
    노드 정보

    콘솔에서 주문 번호, 노드 코드, 노드 주소, 포트 및 계정명을 확인하세요. 정보를 복사할 때 앞뒤 공백을 확인하고 기억에 의존해 입력하지 마세요.

    출력: 노드 기록
  2. 02
    네트워크 연결 가능성

    현재 네트워크, 프록시 및 출구 환경을 기록하고 기존 네트워크와 다른 신뢰할 수 있는 네트워크에서 각각 다시 테스트하세요. 특정 네트워크에서만 실패하면 로컬 출구 제한을 우선 확인하세요.

    출력: 네트워크 비교
  3. 03
    인증 정보 상태

    임시 인증 정보가 업데이트되었는지, SSH 공개 키가 완전한지, 개인 키 권한이 적절한지 확인하고 호스트 지문이 최초 기록과 일치하는지 대조하세요.

    출력: 상태 설명
  4. 04
    macOS 세션 상태

    호스트 전체에 연결할 수 없는지, 그래픽 세션만 응답하지 않는지 판단하세요. SSH 연결이 여전히 가능하다면 먼저 세션, 화면 잠금 및 관련 프로세스를 확인하세요.

    출력: 세션 범위
  5. 05
    로컬 클라이언트 설정

    클라이언트 이름, 버전, 디스플레이 해상도, 색상 설정, 프록시 및 오류 원문을 기록하세요. 다른 호환 클라이언트로 다시 테스트할 때는 나머지 조건을 동일하게 유지하세요.

    출력: 클라이언트 비교
직접 계속 진행

단일 단계로 원인 범위가 좁혀짐

예를 들어 특정 로컬 네트워크에서만 실패하거나, 오래된 키만 거부되거나, 특정 클라이언트에서만 화면 이상이 발생하는 경우입니다. 한 번에 변수 하나만 변경하고 다시 확인하세요.

연결 가이드 보기
엔지니어링 지원 필요

여러 네트워크와 클라이언트에서 계속 재현됨

5가지 점검 결과, 발생 시간 및 오류 스크린샷을 하나의 문의에 담으세요. 엔지니어가 증거를 바탕으로 노드와 세션을 바로 확인할 수 있습니다.

콘솔 문의 열기
용어집

대상을 먼저 구분해 프로토콜, 세션 및 호스트를 혼동하지 마세요

이 용어는 배포 자료, 연결 안내 및 문의 답변에 사용됩니다. 문제를 설명할 때 해당 용어를 사용하세요.

클라우드 Mac
네트워크를 통해 접근하는 macOS 작업 환경으로, Xcode 빌드, 자동화 테스트, 스크립트 작업 및 로컬 모델 추론에 사용할 수 있습니다. 사용 방식을 설명하는 용어이며 가상화를 의미하지 않습니다.
물리 노드
주문을 실제로 호스팅하는 Apple Silicon 호스트와 해당 호스트가 위치한 네트워크입니다. 노드 정보에는 일반적으로 주소, 포트 및 리전 코드가 포함됩니다.
전용
유효한 대여 1건은 전용 물리 호스트 1대에 해당하며 다른 임차인과 동일 호스트의 컴퓨팅 리소스를 공유하지 않습니다.
가상 머신 아님
제공 대상은 전용 물리 호스트이며 공유 호스트에서 분할된 가상 인스턴스가 아닙니다. 문제 해결 시 호스트 상태와 원격 세션 상태를 함께 구분해야 합니다.
VNC
macOS 그래픽 인터페이스에 접근하는 원격 데스크톱 프로토콜입니다. Xcode 조작, 그래픽 도구 확인 및 데스크톱 세션 검증에 적합합니다.
SSH
명령줄 로그인, 스크립트 실행, 파일 처리 및 CI/CD 관리에 사용하는 보안 연결 방식입니다. 연결할 때 주소, 포트, 계정, 키 및 호스트 지문을 확인해야 합니다.
self-hosted runner
대여한 호스트에 배포하는 지속적 통합 실행기입니다. 프로젝트 범위, 작업 디렉터리, 동시 실행 수 및 캐시 정책은 팀이 직접 구성합니다.
세션 복구
원격 데스크톱 연결이 끊긴 뒤 기존 macOS 세션으로 다시 들어가는 것입니다. 그래픽 세션을 복구하는 것이며 호스트를 재시작하거나 빌드 환경을 새로 만드는 것과는 다릅니다.
연결 문제 해결 가이드

첫 로그인, 키 교체 및 화면 이상을 각각 처리하세요

현재 현상과 일치하는 항목을 펼쳐 순서대로 실행하세요. 매번 조건 하나만 변경하고 다시 테스트한 뒤 다음 단계로 진행하세요.

첫 원격 로그인이 실패하면 무엇부터 확인해야 하나요?

먼저 콘솔에서 노드 주소, 포트 및 계정명을 다시 복사하고 이 정보가 동일한 주문에서 나온 것인지 확인하세요. 그런 다음 로컬 네트워크에서 프록시, 포트 제한 또는 추가 방화벽 규칙이 활성화되어 있는지 확인하세요.

  1. 클라이언트 이름, 버전 및 전체 오류 메시지를 기록하세요.
  2. 입력란에 불필요한 공백이 없는지 확인하고 계정명의 대소문자를 그대로 유지하세요.
  3. 신뢰할 수 있는 다른 네트워크에서 다시 테스트하되 인증 정보는 동시에 변경하지 마세요.
  4. SSH는 연결되지만 그래픽 인터페이스에 연결할 수 없다면 이 차이를 문의에 명확히 적으세요.
임시 인증 정보를 업데이트했는데 기존 연결이 계속 실패하는 이유는 무엇인가요?

먼저 기존 인증 정보를 저장한 클라이언트를 완전히 종료한 뒤 연결을 다시 만드세요. 일부 클라이언트는 계정명이나 인증 정보를 캐시하므로 화면에서 비밀번호 필드만 수정해도 기존 기록이 삭제되지 않을 수 있습니다.

새 인증 정보가 작동하는지 확인한 뒤 기존 기록을 삭제하세요. 문의, 스크린샷 또는 이메일에 비밀번호를 표시하지 말고 업데이트 시간, 사용한 계정명 및 오류 유형만 설명하세요.

SSH 키를 안전하게 교체하면서 접속이 차단되지 않게 하려면 어떻게 해야 하나요?

현재 연결된 SSH 세션을 유지한 채 새 공개 키를 먼저 추가하고 확인하세요. 두 번째 터미널에서 새 연결을 만든 뒤 새 키가 정상 작동하는 것을 확인하고 기존 공개 키를 제거하세요.

  1. 이 호스트 전용 키를 생성하고 출처가 불명확한 키 파일을 재사용하지 마세요.
  2. 공개 키의 한 줄 내용이 완전한지 확인하고 복사 과정에서 줄바꿈이나 잘림이 발생하지 않게 하세요.
  3. 로컬 개인 키 권한과 대상 계정을 확인하세요.
  4. 호스트 지문 기록을 보관하세요. 지문이 예기치 않게 변경되면 연결을 중단하고 문의를 제출해 확인하세요.
VNC에서 검은 화면, 화면 깨짐 또는 입력 지연이 발생하면 어떻게 해야 하나요?

먼저 SSH가 여전히 사용 가능한지 판단하세요. 명령줄 연결이 정상이라면 전체 물리 노드가 오프라인이라기보다 그래픽 세션이나 클라이언트 디스플레이 설정에 문제가 있을 가능성이 높습니다.

클라이언트 해상도와 색상 품질을 낮추고 로컬 프록시를 끈 뒤 다시 테스트하세요. 문제가 전체 화면, 확대/축소 또는 다중 디스플레이 모드에서만 발생하는지 기록하세요. 여러 시스템 프로세스를 연속으로 강제 종료하지 마세요.

지연이 높다고 느껴질 때 재현 가능한 결과를 얻으려면 어떻게 해야 하나요?

로컬 네트워크 유형, 대상 노드, 테스트 시간대, 사용 프로토콜 및 클라이언트 버전을 기록하세요. 기존 네트워크와 다른 신뢰할 수 있는 네트워크에서 동일한 단계를 각각 실행하고 해상도, 프록시 및 작업 부하를 동일하게 유지하세요.

단순히 ‘매우 느리다’고만 결론 내리지 마세요. 입력 응답, 화면 새로 고침, 파일 전송 또는 명령 출력 중 어느 부분이 느려졌는지와 문제가 지속되는지를 문의에 적으세요.

빌드 문제 처리

환경을 먼저 고정한 뒤 Xcode, runner 및 디스크를 분석하세요

빌드 문제 해결의 목표는 모든 캐시를 즉시 비우는 것이 아니라 어느 계층에서 변화가 발생했는지 찾고 재현 가능한 기록을 남기는 것입니다.

01단계

Xcode 및 macOS 버전 확인

현재 Xcode 전체 버전, 명령줄 도구 경로, macOS 버전 및 프로젝트 커밋을 기록하세요. 팀에 고정 기준이 있다면 직전 성공 빌드 기록과 먼저 대조하세요.

xcodebuild -version
xcode-select -p
sw_vers
02단계

서명 환경 범위 확인

프로젝트 설정, 인증서 파일, 프로비저닝 프로파일 및 빌드 스크립트의 참조 관계를 확인하세요. 민감한 필드를 가린 오류 스크린샷은 문의에 제출할 수 있지만 서명 개인 키나 비밀번호는 업로드하지 마세요.

  • 첫 번째 서명 오류 원문 보관
  • 실패한 target과 빌드 구성 기록
  • 로컬 스크립트 오류와 프로젝트 설정 오류 구분
03단계

근거를 남기고 캐시 정리

먼저 DerivedData, 종속성 캐시 및 작업 디렉터리 사용량을 기록한 다음 실패한 프로젝트와 관련된 디렉터리만 정리하세요. 정리 후 최소 빌드를 한 번 실행해 동시 작업이 결과를 덮어쓰지 않게 하세요.

du -sh ~/Library/Developer/Xcode/DerivedData
df -h
04단계

CI runner 재연결

runner 서비스 프로세스, 등록 범위, 작업 디렉터리 및 마지막 온라인 시간을 확인하세요. 배포 작업이 없는 최소 테스트 작업으로 네트워크, 권한 및 실행 환경을 검증하세요.

  • 실패한 작업 번호와 시간 기록
  • 동일 실행기가 중복 등록되지 않았는지 확인
  • 작업 디렉터리 소유권과 남은 공간 확인
05단계

디스크 증가 원인 확인

프로젝트 파일, 종속성, 빌드 산출물, 로그 및 임시 파일로 분류해 사용량을 집계하세요. 공간이 계속 줄어들면 증가하는 디렉터리와 관찰 간격을 기록한 뒤 문의를 제출하세요.

df -h
du -sh ~/Library/Developer/*
du -sh ~/Library/Caches/*
환경 초기화를 첫 단계로 삼지 마세요.

먼저 로그, 버전, 디스크 사용량 및 실패한 작업 번호를 보존하세요. 모든 캐시를 바로 비우거나 설정을 덮어쓰면 문제가 일시적으로 사라질 수 있지만 원인을 확인할 근거도 함께 사라집니다.

결제 지원

기간, 구성, 노드 및 추가 옵션을 항목별로 대조하세요

모든 주문은 달러로 가격이 책정되고 결제됩니다. 실제 사용 가능한 결제 게이트웨이는 콘솔에 실시간으로 표시되는 내용을 기준으로 합니다.

달러 결제

먼저 대여 기간 확인

결제 기간은 일, 주, 월 또는 분기일 수 있습니다. 일일 가격으로 다른 기간을 직접 계산하지 말고 선택한 모델의 카탈로그 가격을 기준으로 주문을 확인하세요.

결제 기록

지원되는 결제 방식은 두 가지입니다

USDT-TRC20 및 Visa / Mastercard / Amex(Stripe 경유)를 지원합니다. 문의에는 주문 번호와 거래 기록의 민감하지 않은 식별자만 제공하면 됩니다.

노드 및 확장 옵션

청구 구성 항목별 확인

모델, 대여 기간, 대상 노드, 추가 스토리지 유형 및 Thunderbolt 5 병렬 연결 수량을 확인하세요. 사용 가능 상태는 콘솔에 실시간으로 표시되는 내용을 기준으로 합니다.

추가 옵션 4가지 대여 기간별 가격
추가 옵션 일일 주간 월간 분기
+1TB SSD $2.6 $7.1 $13.2 $35.9
+2TB SSD $5.2 $14.2 $26.4 $71.8
Thunderbolt 5 병렬 연결(대당) $2 $5.3 $9.9 $26.9
결제 문의에 무엇을 첨부해야 하나요?

주문 번호, 모델, 대여 기간, 대상 노드, 추가 옵션 이름과 수량 및 결제 기록의 민감하지 않은 거래 식별자를 제공하세요. 카드 전체 번호, 인증 코드, 지갑 개인 키 또는 비밀번호는 보내지 마세요.

문의 제출

엔지니어링 지원팀이 바로 문제를 확인할 수 있는 정보를 제공하세요

사용 중인 노드 문제는 콘솔 문의로 제출하는 것이 우선입니다. 콘솔에 로그인할 수 없다면 support@officevps.com으로 이메일을 보낼 수 있습니다.

SUPPORT PACKET

완전한 문의에는 6가지 정보가 포함되어야 합니다

민감한 인증 정보 제외
01
주문 번호

콘솔에서 전체 번호를 복사하고 모델명이나 노드 도시만 적지 마세요.

02
대상 노드

실제 주문 노드가 싱가포르, 일본(도쿄), 한국(서울), 홍콩, 미국 동부 또는 미국 서부 중 어디인지 명시하세요.

03
발생 시간

현지 시간과 시간대를 적고 문제가 지속적으로 발생하는지 간헐적으로 재현되는지 설명하세요.

04
오류 스크린샷 또는 로그

오류 원문과 앞뒤 맥락을 보존하되 계정 인증 정보, 개인 키, 서명 자료 및 기타 민감한 내용을 가리세요.

05
수행한 단계

테스트한 네트워크, 클라이언트, 명령 및 각 단계의 결과를 순서대로 나열하세요. ‘전부 해봤다’고만 적지 마세요.

06
기대 결과

연결 복구, 결제 확인, runner 재연결 또는 특정 빌드 실패 원인 파악 중 무엇을 원하는지 설명하세요.

사용 중인 문제

콘솔 문의

노드, 연결, 빌드, 스토리지 및 결제 문제에 적합합니다. 주문 정보는 동일 계정의 문의에서 함께 확인할 수 있습니다.

콘솔 로그인
로그인할 수 없음

지원 이메일

이메일을 보낼 때 계정 이메일, 주문 번호 및 문제 요약을 적으세요. 비밀번호, 개인 키 또는 복구용 인증 정보는 첨부하지 마세요.

support@officevps.com에 문의
지원 절차

지식 문서로 해결되지 않으면 상태에 따라 계속 진행하세요

문의 상태는 현재 담당자와 다음 조치를 나타냅니다. 답변할 때 기존 문의에 자료를 추가하고 동일한 문제로 여러 문의를 반복 생성하지 마세요.

01
제출됨

자료가 대기열에 들어감

주문 번호, 노드, 발생 시간, 오류 기록 및 수행한 단계가 모두 포함되어 있는지 확인하세요. 정보가 부족하면 기존 문의에 계속 추가할 수 있습니다.

02
처리 중

엔지니어가 검토 중

노드 연결, 세션 상태, 배포 기록 또는 결제 내역을 확인할 수 있습니다. 새로운 변수가 현장 상태를 덮어쓰지 않도록 이때는 환경을 반복해서 변경하지 마세요.

03
추가 정보 필요

추가로 재현 가능한 정보 필요

문의 내용에 따라 로그, 스크린샷, 네트워크 비교 또는 클라이언트 버전을 추가하세요. 관련 부분만 제출하고 민감한 필드는 계속 가리세요.

04
해결됨

복구를 확인하고 결과 기록

기존 작업 흐름으로 한 번 재테스트하고 실제 원인, 유효한 단계 및 환경 버전을 기록해 팀의 후속 대응을 위한 기준으로 남기세요.

콘솔 문의로 이동 최초 활성화 단계 보기
배포 준비

전용 물리 호스트를 선택해 적합한 노드에 빌드 환경을 배포하세요

3가지 Apple Silicon 구성으로 경량 빌드, 일상 개발, 병렬 CI 및 로컬 모델 추론을 지원합니다. USDT-TRC20 및 Visa / Mastercard / Amex(Stripe 경유)만 지원하며 모든 결제는 달러(USD)로 처리됩니다.

클라우드 Mac 지금 대여하기 3가지 요금제 보기