엔지니어링 지원

문제가 시작된 곳에서 바로 점검을 시작하세요

주문 상태, 연결 경로, 개발 도구와 청구 항목을 순서대로 확인하세요. 그래도 복구되지 않으면 주문 ID, 발생 시각과 비식별화 로그를 첨부해 콘솔 티켓을 제출하면 반복 확인을 줄일 수 있습니다.

콘솔 티켓 제출 시작 가이드 보기
지원 경로 준비 완료 5가지 문제 유형
먼저 확인 주문 상태 및 대상 노드 싱가포르, 일본(도쿄), 한국(서울), 홍콩
다음으로 검증 로컬 네트워크, 주소, 인증 정보 및 도구 체인 명령어, 오류 원문과 발생 시각을 보관하세요
그래도 복구되지 않음 비식별화된 컨텍스트 제출 비밀번호, 개인 키 또는 전체 결제 정보를 보내지 마세요
문제 접수 5가지 지원 경로
실행 노드 365일 연중 정상 운영
문의 채널 티켓 또는 지원 이메일
문제 해결 시작점

먼저 문제 유형에 맞는 해결 경로를 선택하세요

같은 현상도 서로 다른 계층에서 발생할 수 있습니다. 먼저 주문, 연결, 환경, 청구 또는 보안 문제인지 확인한 뒤 해당 계층에 필요한 정보를 수집하세요.

주문 및 제공

결제가 완료되었지만 상태가 업데이트되지 않거나, 제공 정보가 불완전하거나, 노드 또는 이용 기간이 주문 기록과 다른 경우에 해당합니다.

주문 상태 의미 보기

원격 연결

VNC 화면이 표시되지 않거나, SSH 시간이 초과되거나, 인증 정보가 거부되거나, 호스트 지문이 변경되었거나, 재시작 후 일시적으로 다시 연결할 수 없는 경우에 해당합니다.

연결 점검 실행

개발 환경

Xcode 버전 불일치, 명령줄 도구 경로 오류, 서명 자료가 보이지 않음, Homebrew 명령어 누락 또는 runner 권한 부족에 해당합니다.

빌드 환경 확인

청구 및 갱신

기간, 기본 모델, 노드, SSD 추가 옵션 또는 Thunderbolt 5 연결 항목을 확인하거나 갱신 전 결제 금액을 확인해야 하는 경우에 해당합니다.

청구 FAQ 보기

보안 사고

계정 이상, 무단 액세스 또는 비밀 정보 노출이 의심되는 경우에 해당합니다. 먼저 액세스를 제한하고 관련 인증 정보를 교체한 뒤 필요한 비식별화 기록을 보관하세요.

보안 보고서 제출
주문 상태

상태에 따라 다음 점검 항목이 결정됩니다

콘솔에 들어간 후 주문 ID, 현재 상태, 선택한 노드와 이용 기간 만료 시각을 먼저 기록하세요. 원격 클라이언트의 메시지만으로 장치 상태를 판단하지 마세요.

  1. 01

    확인 중

    주문 정보 또는 결제 결과를 확인하는 중입니다. 모델, 기간, 노드, 추가 옵션과 USD 결제 예정 총액이 제출 내용과 일치하는지 확인하세요.

    주요 항목: 주문 ID, 결제 수단, 생성 시각
  2. 02

    구성 중

    물리 노드에 주문에 맞는 구성을 적용하는 중입니다. 이 단계에서는 연결 주소나 인증 정보가 아직 완전히 표시되지 않을 수 있으므로 기존 주소를 반복해서 사용하지 마세요.

    주요 항목: 대상 노드, 구성 상태, 최신 상태 변경
  3. 03

    연결 가능

    연결 정보가 생성되었습니다. 콘솔에 현재 표시된 주소, 계정 안내와 연결 방식을 사용하고 클라이언트가 올바른 노드를 가리키는지 확인하세요.

    주요 항목: 연결 주소, 노드, 만료 시각
  4. 04

    이용 기간 종료

    현재 이용 기간이 종료되어 기존 연결 정보는 더 이상 유효한 서비스를 나타내지 않습니다. 만료 전에 데이터를 이전하고 이후 주문은 새 콘솔 기록을 기준으로 처리하세요.

    주요 항목: 이용 기간 시작·종료 시각, 마지막 이전 기록
노드 목록 및 실시간 결과 ZoomMini M4 Core와 ZoomMini M4 Plus는 싱가포르, 일본(도쿄), 한국(서울), 홍콩의 네 가지 노드를 제공합니다. 실제 이용 가능 여부와 주문 결과는 콘솔의 실시간 응답을 기준으로 합니다.
연결 문제 해결

네트워크 연결성부터 세션 복구까지

순서대로 점검하면 로컬 네트워크 문제를 장치 문제로 잘못 판단하는 일을 줄일 수 있습니다. 각 단계에서 발생 시각, 대상 주소와 오류 원문을 보관하세요.

connection-check.sh 
$ ping -c 4 <host>
4 packets transmitted, 4 received

$ ssh -vvv user@<host>
debug1: Connecting to <host>
debug1: Server host key verified

$ nc -vz <host> <port>
Connection succeeded
VNC 및 화면

주소에는 연결되지만 화면이 표시되지 않음

콘솔 상태가 연결 가능인지 확인하고 클라이언트에서 현재 주소와 할당된 인증 정보를 사용하세요. 기존 세션을 종료한 후 다시 연결하고, 해상도·색상 품질·애니메이션 효과를 낮춰 불안정한 네트워크의 영향을 배제하세요.

원격 연결 방법 보기
재시작 후 복구

재시작 후 일시적으로 연결할 수 없음

먼저 시스템 부팅이 완료될 때까지 기다린 다음 콘솔에서 장치 상태를 새로 고치세요. 연결 주소를 다시 확인하고 클라이언트에 저장된 기존 세션을 삭제한 뒤 VNC와 SSH를 각각 테스트하여 그래픽 세션 문제인지 네트워크 계층 문제인지 확인하세요.

장치 상태 보기
01

네트워크 연결성 확인

안정적인 다른 로컬 네트워크로 바꾸고 대상 주소, 포트와 시간 초과 결과를 기록하세요. 브라우저로 다른 사이트에 접속되는지만으로 판단하지 마세요.

02

계정 인증 정보 확인

사용자 이름, 비밀번호 또는 SSH 키가 현재 주문 안내에서 제공된 것인지 확인하고 복사할 때 공백이 포함되지 않았는지 점검하세요. 잘못된 인증 정보를 연속해서 제출하지 마세요.

03

SSH 지문 변경 처리

먼저 콘솔에서 대상 주소가 변경되었는지 확인하세요. 대상이 올바른지 확인한 후 해당 기존 known_hosts 항목만 삭제하고 파일 전체를 비우지는 마세요.

04

클라이언트 문제와 노드 문제 구분

신뢰할 수 있는 다른 장치나 다른 연결 방식으로 다시 테스트하세요. SSH는 되지만 VNC가 되지 않는다면 그래픽 클라이언트 버전과 세션 동작을 우선 기록하세요.

빌드 환경

도구 체인 의존성 순서대로 점검하세요

시스템에서 실제로 선택한 Xcode를 먼저 확인한 다음 서명, 패키지 관리자와 runner 권한을 점검하세요. 사전 점검을 건너뛰면 이후 오류의 참고 가치가 떨어집니다.

  1. 01

    Xcode 버전 및 선택 경로 확인

    다음을 실행하세요: xcodebuild -version 및 xcode-select -p을 실행하고 프로젝트 요구 버전과 현재 개발자 디렉터리가 일치하는지 확인하세요.

  2. 02

    명령줄 도구 확인

    다음을 실행하세요: clang --version 및 swift --version을 실행하세요. 도구가 없거나 버전이 일치하지 않으면 먼저 Xcode 선택 경로를 수정한 후 다시 테스트하세요.

  3. 03

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

    빌드 사용자가 필요한 서명 자료를 읽을 수 있는지 확인하고 인증서 유효성, 프로비저닝 프로파일 식별자와 프로젝트 설정을 점검하세요. 로그에는 이름과 오류 유형만 남기고 비밀 내용은 첨부하지 마세요.

  4. 04

    Homebrew 경로 확인

    Apple Silicon 환경에서는 일반적으로 /opt/homebrew/bin 이 비대화형 셸의 PATH에 포함되어 있는지 확인하고 runner 시작 환경과 터미널 환경이 일치하는지 검증해야 합니다.

  5. 05

    runner 최소 권한 확인

    self-hosted runner가 작업 디렉터리, 캐시 디렉터리와 빌드 산출물 디렉터리에 필요한 권한을 갖는지 확인하세요. 단일 경로 문제를 숨기기 위해 시스템 전체 권한을 확대하지 마세요.

toolchain-check 
$ xcodebuild -version
Xcode <required-version>
Build version <build-version>

$ xcode-select -p
/Applications/Xcode.app/Contents/Developer

$ command -v brew
/opt/homebrew/bin/brew

$ test -w "$RUNNER_WORKDIR"
$ echo $?
0

$ xcodebuild -scheme App build
** BUILD SUCCEEDED **
성공 여부를 마지막 줄만 보고 판단하지 마세요 명령어 종료 코드, 실제 산출물 경로, 테스트 보고서와 서명 단계를 함께 확인하세요. 캐시 적중은 빌드 성공을 의미하지 않으며 runner가 온라인이어도 작업 디렉터리 권한이 있다는 뜻은 아닙니다.
용어 미니 사전

자주 쓰이는 8가지 용어의 정확한 의미

이 용어들은 하드웨어 소유, 연결 방식, 자동화 역할과 주문 범위를 설명합니다. 문제를 제출할 때 정확한 용어를 사용하면 문제 범위의 혼동을 줄일 수 있습니다.

물리 노드
실제로 macOS 워크로드를 실행하는 Apple Silicon 하드웨어 장치이며, 주문의 연결 주소와 실행 상태가 연결되는 기본 리소스입니다.
단독 사용
유효한 주문 하나가 단독 사용 물리 장치 한 대에 대응하며, 컴퓨팅 리소스·메모리·로컬 스토리지는 다른 고객 세션과 공유되지 않습니다.
비가상 머신
워크로드는 주문에 대응하는 실제 Mac mini에서 직접 실행되며, 공유 호스트에서 분할된 가상 컴퓨팅 인스턴스가 아닙니다.
VNC
macOS 그래픽 인터페이스에 액세스하기 위한 원격 디스플레이 프로토콜로, 창 작업·UI 테스트·시각적 구성에 적합합니다.
SSH
명령줄 작업, 자동화 실행, 파일 전송과 진단에 사용하는 암호화 연결 방식으로, 지속적 통합과 스크립트 기반 워크플로에 적합합니다.
self-hosted runner
단독 사용 클라우드 Mac에 배포되어 팀이 권한과 도구 체인을 직접 구성하는 자동화 실행기로, 파이프라인 작업을 수신하고 실행합니다.
이용 기간
주문으로 정한 서비스 시작·종료 구간이며 일·주·월·분기 단위로 선택할 수 있습니다. 연결 정보, 갱신 확인과 데이터 이전은 이 구간을 기준으로 처리하세요.
노드
장치가 위치한 서비스 지역입니다. 현재 목록에는 싱가포르, 일본(도쿄), 한국(서울), 홍콩의 네 노드가 포함됩니다.
청구 FAQ

갱신 전 청구 구조를 먼저 확인하세요

청구서에는 기본 모델, 기간, 노드와 추가 옵션을 구분해 표시해야 합니다. 결제 게이트웨이의 실제 이용 가능 여부는 콘솔 응답을 기준으로 합니다.

일·주·월·분기 요금은 어떻게 계산되나요?

주문은 결제 시 선택한 단일 기간을 기준으로 청구되며 서로 다른 기간을 조합하지 않습니다. 갱신 전에 모델, 기간, 노드, 이용 기간 시작·종료 시각과 결제 예정 총액을 다시 확인하세요.

SSD와 Thunderbolt 5 연결은 어떻게 표시되나요?

+1TB SSD, +2TB SSD와 Thunderbolt 5 연결은 선택한 기간에 따라 별도로 표시하며 기본 모델명에 합쳐지지 않습니다. Thunderbolt 5 연결은 장치당 계산되므로 수량 확인 시 연결된 장치도 함께 확인하세요.

어떤 통화와 결제 수단을 사용할 수 있나요?

모든 주문은 미국 달러(USD)로 결제됩니다. USDT-TRC20과 Visa / Mastercard / Amex(Stripe 결제)만 지원하며, 실제 이용 가능한 게이트웨이는 콘솔의 실시간 응답을 기준으로 합니다.

갱신 전에 반드시 확인해야 할 항목은 무엇인가요?

주문 ID, 기본 모델, 선택 기간, 대상 노드, SSD 추가 옵션, Thunderbolt 5 연결 수량, USD 소계, 결제 예정 총액과 새 이용 기간 종료 시각을 순서대로 확인하세요. 항목이 일치하지 않으면 결제 전에 티켓을 제출하세요.

결제 후 상태가 업데이트되지 않으면 무엇을 제공해야 하나요?

주문 ID, 결제 수단, 결제 시각, 콘솔의 현재 상태와 비식별화된 거래 참조 정보를 제공하세요. 전체 카드 정보, 전체 결제 정보 또는 계정 비밀번호는 보내지 마세요.

티켓 체크리스트

바로 문제 해결을 시작할 수 있는 정보 제출

효과적인 티켓은 ‘어떤 주문인지, 어느 노드인지, 언제 발생했는지, 어떻게 재현되는지, 무엇이 표시되었는지’에 답해야 합니다. 민감한 정보는 먼저 비식별화하세요.

필수 컨텍스트

다음 순서로 티켓 본문을 작성하세요

  1. 01
    주문 ID 및 노드

    콘솔의 주문 ID와 싱가포르, 일본(도쿄), 한국(서울) 또는 홍콩 중 대상 노드를 명시하세요.

  2. 02
    문제 발생 시각

    시간대가 포함된 최초 발생 시각과 최근 재현 시각, 문제가 지속적인지 간헐적인지 제공하세요.

  3. 03
    재현 단계 및 예상 결과

    콘솔에 들어가거나 명령어를 실행하는 단계부터 순서대로 설명하고 실제 결과와 예상 결과를 각각 작성하세요.

  4. 04
    환경 및 연결 방식

    로컬 시스템, 클라이언트 버전, VNC 또는 SSH, macOS 및 Xcode 버전과 프록시 네트워크 사용 여부를 명시하세요.

  5. 05
    비식별화 로그

    오류 코드, 명령어, 종료 코드와 필요한 컨텍스트는 보존하되 사용자 이름, 주소, 토큰, 저장소 경로와 결제 참조 정보의 민감한 부분은 바꾸세요.

보내지 말아야 할 정보

비밀 정보는 문제 해결 자료가 아닙니다

비밀번호, 개인 키, 복구 코드, 저장소 토큰, 서명 비밀, 전체 결제 정보 또는 비식별화되지 않은 고객 데이터를 제출하지 마세요. 비밀 정보가 노출된 것으로 의심되면 즉시 교체하세요.

데이터 보호 범위 보기
제출 채널

콘솔 티켓으로 컨텍스트를 유지하세요

기존 주문 문제는 주문 상태를 연결할 수 있도록 우선 콘솔에서 티켓을 제출하세요. 로그인할 수 없다면 support@zoommini.com을 사용하고 제목에 문제 유형을 명시하세요.

콘솔 티켓 생성
제출 준비

주문 컨텍스트를 포함해 유효한 정보로 문제 해결을 시작하세요

처리 시간은 문제의 복잡도와 필요한 확인 절차에 따라 달라집니다. 제출 후 콘솔에서 요청 상태를 확인할 수 있으며, 로그인할 수 없다면 지원 이메일을 사용하세요.

콘솔 티켓 제출 지원 이메일 보내기