상태 확인부터 시작

먼저 문제를 파악하고, 바로 처리할 수 있는 자료를 제출하세요.

MiniDebug 클라우드 Mac의 이용 시작, 연결, 시스템 로그인, Xcode 빌드, 스토리지 추가, 갱신 및 해지 절차를 안내합니다. 페이지에서 로컬 점검을 마친 뒤 콘솔 문의로 주문 정보와 비식별화 로그를 제출하세요.

지원 범위

먼저 문제가 어느 계층에 있는지 확인하세요.

원격 연결 실패, 빌드 실패, 주문 상태 이상은 비슷하게 보일 수 있지만 점검 방법은 다릅니다. 다음 여섯 가지 문제는 모두 콘솔 문의로 접수할 수 있습니다.

주문 및 호스트 상태

주문 ID, 이용 기간, 호스트 상태와 제공 정보를 확인하세요. 신규 구매, 갱신, 호스트 관리는 콘솔에서 진행하며 실제 사용 가능 상태는 콘솔의 최신 표시를 기준으로 합니다.

노드 및 원격 연결

싱가포르, 일본(도쿄), 한국(서울), 홍콩, 미국 동부 등 다섯 노드의 주소, 포트, 네트워크 경로와 원격 세션을 점검합니다.

시스템 로그인 및 권한

첫 로그인, 인증 정보 변경, SSH 키, 그래픽 세션 권한과 계정 접근 범위를 확인하세요. 공동 작업에는 추적 가능한 개인별 인증 정보를 사용하세요.

빌드 환경

Xcode 버전, 명령줄 도구, 의존성 캐시, 서명 자료, 디스크 공간과 빌드 로그를 기준으로 xcodebuild 또는 fastlane 작업을 확인합니다.

스토리지 추가 옵션

주문한 저장 용량, 마운트 상태, 여유 공간과 작업 디렉터리를 확인하세요. 공간이 부족하면 재생성 가능한 캐시를 먼저 정리한 뒤 구성을 조정할지 판단하세요.

갱신 및 해지

갱신 전 이용 기간과 추가 옵션을 확인하세요. 해지 전 코드, 인증서, 모델, 리소스와 빌드 산출물을 백업하고 자동화 작업이 더 이상 기록하지 않는지 확인하세요.

첫 이용 절차

다섯 단계로 첫 연결을 확인하세요.

저장된 이전 주소로 시작하지 마세요. 모든 주문은 콘솔에 표시된 호스트 상태와 연결 정보를 기준으로 확인해야 합니다.

  1. 01

    주문 및 호스트 상태 확인

    콘솔에 로그인해 해당 주문을 열고 모델이 MiniDebug M4인지, 구성이 M4, 16GB RAM, 256GB SSD인지 확인한 뒤 선택한 노드를 기록하세요. 호스트가 연결 가능한 상태가 아니면 원격 로그인을 반복하지 마세요.

    입력: 주문 ID
  2. 02

    이번 주문의 연결 정보 가져오기

    대상 주소, 포트, 계정과 지원되는 연결 방식을 복사하세요. 주소와 포트는 한 세트로 보관하고 SSH 정보와 VNC 또는 화면 공유 정보를 섞지 마세요.

    출력: 연결 정보
  3. 03

    첫 시스템 로그인 완료

    신뢰할 수 있는 로컬 기기에서 연결을 시작하세요. 첫 SSH 연결에서는 호스트 지문을 확인하고, 그래픽 연결에서는 대상 노드와 주문이 일치하는지 확인하세요. 공유 기기에 인증 정보를 저장하지 마세요.

    확인: 호스트 신원
  4. 04

    인증 정보 및 접근 범위 변경

    로그인 직후 초기 인증 정보를 변경하고 SSH 자동화에는 우선 키를 사용하세요. 팀에서 사용할 때는 승인된 구성원만 접근하도록 제한하고 계정을 장기간 공유하거나 스크립트에 평문 비밀번호를 넣지 마세요.

    작업: 인증 정보 변경
  5. 05

    네트워크 및 빌드 기본 환경 확인

    코드 저장소 접근, DNS 확인, 디스크 공간, Xcode 경로와 명령줄 도구를 점검하세요. 먼저 간단한 확인 명령을 실행한 뒤 전체 의존성을 내려받거나 오래 걸리는 빌드를 시작하세요.

    결과: 기본 환경 사용 가능
빌드 오류 분류

안정적으로 재현되는 첫 오류부터 확인하세요.

로그 마지막 부분은 대개 작업이 종료되었다는 결과일 뿐입니다. 위로 올라가 처음으로 반복되는 오류를 찾고 다음 여섯 범주 중 하나로 분류한 뒤 프로젝트를 수정할지 인프라 문의를 제출할지 결정하세요.

코드 서명

신원, 대상, 내보내기 단계를 먼저 구분하세요

  • 빌드 대상, Bundle Identifier와 서명 설정이 일치하는지 확인하세요.
  • archive 성공 후 export 단계에서 실패하는지 확인하세요.
  • 첫 서명 오류와 앞뒤 20줄의 로그를 기록하세요.

처리 방향:프로젝트 서명 설정은 사용자가 확인하세요. 서명 자료를 읽을 수 없으면 파일 권한과 자동화 주입 경로를 점검하세요.

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

유효성, 일치 여부와 읽기 권한을 확인하세요

  • 필요한 파일이 현재 작업에서 실제로 사용하는 위치에 있는지 확인하세요.
  • 인증서, 프로비저닝 프로파일과 대상 환경이 일치하는지 확인하세요.
  • 비밀번호, 인증서 원본 파일 또는 전체 키를 문의에 입력하지 마세요.

처리 방향:먼저 대화형 세션에서 읽기를 확인한 뒤 자동화 작업을 재현하고 두 환경의 변수와 실행 계정을 비교하세요.

Xcode 버전

그래픽 인터페이스와 명령줄이 같은 툴체인을 사용하게 하세요

  • Xcode 버전, SDK 버전과 대상 플랫폼을 기록하세요.
  • 실행 xcode-select -p 현재 경로를 확인하세요.
  • CI 프로세스가 예상한 개발자 디렉터리를 상속했는지 확인하세요.

처리 방향:먼저 버전과 경로를 고정한 뒤 새 버전과 호환되지 않는 파생 데이터를 정리하세요. 여러 변수를 동시에 바꾸지 마세요.

의존성 캐시

잠금 파일을 먼저 확인한 뒤 캐시 삭제 여부를 판단하세요

  • 의존성 잠금 파일을 보존하고 패키지 관리 도구 버전을 기록하세요.
  • 깨끗한 디렉터리 빌드와 캐시 적중 빌드의 차이를 비교하세요.
  • 재생성 가능한 디렉터리만 정리하고 백업하지 않은 프로젝트 파일은 삭제하지 마세요.

처리 방향:캐시 문제는 빈 캐시 상태에서 비교 재현해 확인해야 합니다. 네트워크 다운로드 실패는 대상, 시각과 오류 코드를 별도로 기록하세요.

디스크 공간

전체 용량, 사용 가능 공간과 큰 디렉터리를 함께 확인하세요

  • 작업 디렉터리, 파생 데이터, 아카이브와 의존성 캐시의 사용량을 확인하세요.
  • 로그와 임시 파일이 계속 증가하는지 확인하세요.
  • 정리하기 전에 산출물이 보관되었고 다른 위치에서 복구 가능한지 확인하세요.

처리 방향:재생성 가능한 캐시를 먼저 삭제하세요. 장기적인 용량이 필요하면 이후 주문에서 스토리지 추가 옵션을 확인하세요.

빌드 로그

명령, 시각과 첫 오류를 보존하세요

  • 트리거 방식, 실행 디렉터리와 비식별화한 전체 명령을 첨부하세요.
  • 문제 발생 시각을 기록하고 시간대를 명시하세요.
  • 예상 결과, 실제 결과와 재현 빈도도 함께 제공하세요.

처리 방향:스크린샷만 제출하지 말고 텍스트 로그를 우선 제출하세요. 저장소 토큰, 업로드 키, 비밀번호와 소스 코드 일부는 삭제하세요.

연결 문제 해결 트리

순서대로 확인하고 상위 조건을 건너뛰지 마세요.

다음 일곱 항목은 하나의 의존 체인을 이룹니다. 상위 항목을 통과하지 못하면 하위 클라이언트 설정을 바꿔도 결과가 달라지지 않는 경우가 많습니다.

  1. 01

    호스트 상태

    콘솔에서 주문과 호스트 상태를 확인하세요. 예상과 다르면 주문 ID와 페이지 표시 결과를 기록한 뒤 문의를 제출하세요.

    통과 후 계속
  2. 02

    대상 주소

    현재 주문의 연결 주소를 그대로 복사하고 불필요한 공백, 이전 주소와 로컬 hosts 재정의를 배제하세요. 다른 주문에 연결되지 않았는지도 확인하세요.

    대상 일치 확인
  3. 03

    포트 및 연결 방식

    SSH, VNC 또는 화면 공유에 맞는 포트와 클라이언트를 사용하세요. 연결 시간 초과, 연결 거부와 인증 실패를 각각 기록하세요.

    오류 유형 기록
  4. 04

    로컬 네트워크

    같은 정보로 신뢰할 수 있는 다른 네트워크에서도 테스트해 회사 출구, 프록시 또는 통신사 경로의 영향을 확인하세요. 테스트 중 인증 정보를 노출하지 마세요.

    네트워크 비교 완료
  5. 05

    방화벽 규칙

    로컬 기기와 조직 네트워크가 대상 포트의 아웃바운드 연결을 허용하는지 확인하세요. 문제 해결을 위해 모든 보호 기능을 끄지 말고 최소 범위로 검증하세요.

    아웃바운드 규칙 확인
  6. 06

    계정 권한

    네트워크 연결 성공과 계정 인증 성공을 구분하세요. 계정명, 키 권한, 그래픽 로그인 권한과 인증 정보가 변경되었는지 확인하세요.

    인증 결과 확인
  7. 07

    세션 점유

    종료되지 않은 그래픽 세션, 중복 자동화 작업 또는 리소스 점유가 있는지 확인하세요. 이전 세션을 안전하게 종료한 뒤 제어된 재시도를 한 번만 실행하세요.

    재시도 결과 보존
문의 자료 템플릿

한 번에 재현 가능한 맥락을 충분히 제출하세요.

콘솔 문의는 기존 주문 문제에 적합합니다. 콘솔에 로그인할 수 없다면 유일한 지원 이메일 support@minidebug.com을 사용하고 필요한 계정 확인 정보를 제공하세요.

권장 문의 구조 필드명을 복사해 항목별로 작성하세요
주문 ID
콘솔의 주문 ID를 입력하고 결제 인증 정보는 제출하지 마세요.
노드
싱가포르, 일본(도쿄), 한국(서울), 홍콩 또는 미국 동부
발생 시각
날짜, 시각과 시간대를 적고 처음 발생했는지 계속 재현되는지 명시하세요.
재현 단계
콘솔을 연 시점, 명령 실행 또는 클라이언트 시작부터 실제 순서대로 번호를 매기세요.
비식별화 로그
첫 오류와 주변 맥락을 포함하고 비밀번호, 토큰, 개인 키와 프로젝트 민감 정보는 삭제하세요.
예상 결과 및 실제 결과
예상 결과, 실제 결과와 안정적으로 재현되는지 여부를 각각 설명하세요.
기존 주문

콘솔 문의 사용

문의에는 주문 정보가 함께 보존되므로 호스트 상태, 노드 연결, 추가 옵션, 갱신과 해지 문제에 적합합니다. 제출 전에 해당 점검 단계를 먼저 완료하세요.

콘솔 문의 생성
로그인할 수 없음

지원 이메일 보내기

메일 제목에 문제 유형과 주문 ID를 적고 본문은 왼쪽 필드 구조를 사용하세요. 이메일 주소가 길면 그대로 복사해도 됩니다.

support@minidebug.com
처리 범위

문제의 담당 영역에 따라 처리 방향이 달라집니다.

문의 자료를 바탕으로 문제가 물리 노드, macOS 사용, 프로젝트 코드 또는 외부 의존성 중 어디에 있는지 판단하고 다음 확인 방향을 안내합니다.

MiniDebug 처리

노드 인프라 문제

콘솔에 표시된 호스트 상태 이상, 주문과 연결 정보 불일치, 노드 네트워크 도달성 이상, 주문 구성이 선택 내용과 다르게 표시되는 문제를 포함합니다.

  • 주문 ID, 노드와 발생 시각을 제공하세요.
  • 서로 다른 로컬 네트워크의 연결 비교 결과를 첨부하세요.
  • 콘솔 상태와 클라이언트 오류 유형을 기록하세요.
사용자 우선 확인

macOS 사용 문제

시스템 설정, 파일 권한, 셸 환경, 디스크 정리, 원격 클라이언트 정보와 로컬 계정 권한 등 조작 계층의 문제를 포함합니다.

  • 제어된 세션에서 먼저 작업을 재현하세요.
  • 시스템 버전, 실행 계정과 대상 경로를 기록하세요.
  • 화면 캡처만 제출하지 말고 오류 텍스트를 제출하세요.
프로젝트 측 처리

프로젝트 코드 및 빌드 구성

컴파일 오류, 테스트 실패, 서명 설정, 의존성 버전 충돌, 스크립트 경로, 환경 변수와 앱 실행 로직을 포함합니다.

  • 최소한의 변경으로 첫 오류를 재현하세요.
  • 로컬 Mac과 클라우드 Mac의 툴체인 차이를 비교하세요.
  • 프로젝트 관리자가 코드 또는 파이프라인 구성을 수정합니다.
외부 서비스 처리

타사 서비스 문제

코드 호스팅, 의존성 미러, 패키지 저장소, 알림 시스템과 업로드 대상에서 반환되는 인증, 요청 제한 또는 서버 오류를 포함합니다.

  • 대상 서비스 상태와 계정 권한을 확인하세요.
  • 응답 코드, 요청 시각과 재시도 결과를 기록하세요.
  • 해당 서비스 제공업체에 비식별화한 로그를 제출하세요.

주문 정보를 준비한 뒤 다음 단계로 이동하세요.

신규 구매, 갱신과 호스트 관리는 콘솔에서 진행하며 기존 주문 문제는 콘솔 문의를 우선 이용하세요. 결제는 USDT-TRC20 및 Visa / Mastercard / Amex(Stripe)만 지원하며 모든 주문은 USD로 결제됩니다. 실제 이용 가능한 결제 게이트웨이는 백엔드 응답을 기준으로 합니다.