작업별 문제 해결

오류 증상에서 실행 가능한 해결 단계까지

VMMini 클라우드 Mac 전용 물리 노드의 첫 연결, SSH 키, VNC, MLX 추론 서비스, CI 및 주문 문제를 다룹니다. 먼저 증상에 따라 기본 점검을 완료한 다음 로그와 시간 범위를 포함해 지원 요청을 제출하세요.

페이지에서 비밀번호, 개인 키 또는 복구 문구를 요구하지 않습니다. 기존 주문 문제는 콘솔에 로그인해 지원 요청을 제출하면 주문 및 노드 기록이 자동으로 연결됩니다.

지원 실행 흐름 먼저 확인하고, 증거를 수집한 뒤 제출하세요
명확한 경로
03 문제 해결 단계
증상 연결, 빌드, 디스크, 서비스 또는 주문
증거 시간, 명령, 종료 코드 및 비식별화 로그
처리 직접 복구하거나 주문을 연결해 지원 요청 제출
노드 범위 싱가포르 · 일본(도쿄) · 한국(서울) · 홍콩
빠른 검색

오류 메시지, 도구 이름 또는 작업 목표를 입력하세요

이 검색은 이 페이지의 가이드, 장애 분류 및 용어 설명에서 일치 항목을 찾습니다. 오류 메시지에 주문 번호, 호스트 이름 또는 주소가 포함되어 있다면 먼저 비식별화한 후 입력하세요.

연결 및 액세스

제공된 정보를 먼저 확인한 후 연결 방식을 판단하세요

연결 문제는 주소, 포트, 키 권한, 클라이언트 캐시 또는 로컬 네트워크 경로에서 발생하는 경우가 많습니다. 호스트 지문을 확인하기 전에는 검증을 건너뛰지 마세요.

SSH: 호스트 지문부터 확인

제공된 호스트 주소, SSH 포트, 사용자 이름 및 해당 공개 키의 개인 키 파일을 준비하세요. 개인 키는 관리되는 기기나 키 저장소에만 보관하고 지원 요청에 붙여 넣지 마세요.

  1. 첫 연결:콘솔에 표시된 호스트 지문과 클라이언트 안내를 구간별로 대조하세요.
  2. 권한 확인:개인 키 파일을 현재 사용자만 읽을 수 있는지, 공개 키 내용이 줄바꿈으로 손상되지 않았는지 확인하세요.
  3. 연결 끊김 점검:로컬 네트워크, DNS 또는 주소, 포트 연결 가능 여부, 사용자 이름과 키 매핑을 순서대로 확인하세요.
  4. 증거 수집:시간 정보가 포함된 verbose 출력을 보관하되 주소, 사용자 이름 및 키 경로의 민감한 부분은 삭제하세요.
ssh -vvv -p <port> <user>@<host>

VNC: 세션과 디스플레이 상태부터 확인

노드 주소, 포트, 연결 자격 증명 및 사용 가능한 그래픽 세션이 필요합니다. 연결 자격 증명은 비밀번호 관리자에 보관하고 스크립트 저장소나 빌드 로그에 기록하지 마세요.

  1. 첫 로그인:시스템 버전, 디스크 용량, 시간대, 키보드 레이아웃 및 현재 네트워크 상태를 확인하세요.
  2. 검은 화면 처리:먼저 그래픽 세션이 실행 중인지 확인한 다음 클라이언트의 색 심도와 확대/축소 설정을 점검하세요.
  3. 잦은 연결 끊김:발생 시간, 지속 시간, 로컬 네트워크 유형 및 동시에 SSH로 액세스할 수 있는지를 기록하세요.
  4. 화면 끊김:디스플레이 품질을 낮춰 비교 테스트하고, 한 번의 클라이언트 끊김만으로 노드 장애라고 판단하지 마세요.

원격 데스크톱: 클라이언트와 노드를 분리해 확인

먼저 사용 중인 클라이언트가 제공된 연결 방식을 지원하는지 확인한 다음 주소, 포트 및 세션 자격 증명을 점검하세요. 만료된 이전 자격 증명을 반복 사용하면 실제 원인을 가릴 수 있습니다.

  1. 로컬 측:프록시를 끄거나 네트워크를 전환해 비교하고 클라이언트 버전과 오류 원문을 기록하세요.
  2. 노드 측:SSH를 사용할 수 있다면 그래픽 서비스 프로세스, 남은 디스크 공간 및 시스템 부하를 확인하세요.
  3. 네트워크 경로 측:서로 다른 네트워크에서 연결 결과를 비교해 문제가 하나의 경로에서만 발생하는지 확인하세요.
  4. 지원 요청 제출:주문 식별자, 노드, 발생 시간 및 비식별화 스크린샷을 제공하고 연결 비밀번호는 제공하지 마세요.
MLX 추론 지원

다섯 가지 점검 항목으로 모델 서비스 문제 해결

먼저 실행 환경과 모델 파일이 완전한지 확인한 후 리스닝 주소, 헬스 엔드포인트 및 로그를 점검하세요. 실제 업무에 필요한 포트만 열고 접근 가능한 출처를 제한하세요.

01

환경 확인

macOS 버전, Python 버전, 가상 환경 경로, MLX 관련 패키지 버전 및 현재 사용 가능한 디스크 공간을 기록하세요. 작업이 VMMini M4, M4, 16GB, 256GB SSD 전용 물리 노드에서 실행되는지 확인하고 공유 환경의 설정을 적용하지 마세요.

02

모델 준비

모델 파일 경로, 파일 수, 검증 결과 및 필요한 공간을 확인하세요. 모델과 캐시는 명확한 디렉터리에 두고 다운로드 작업과 서비스 프로세스가 같은 임시 위치에 동시에 쓰지 않도록 하세요.

03

리스닝 확인

먼저 로컬 주소에 바인딩해 검증한 다음 실제 액세스 요구에 맞춰 리스닝 범위를 조정하세요. 포트를 다른 프로세스가 사용하고 있지 않은지 확인하고 외부 액세스에는 필요한 포트와 출처만 허용하세요.

04

헬스 체크 실행

노드에서 헬스 엔드포인트를 호출하고 HTTP 상태, 응답 시간 및 반환 본문을 기록하세요. 로컬에서는 정상인데 외부에서 실패한다면 모델을 반복 재시작하지 말고 포트, 액세스 규칙 및 네트워크 경로를 확인하세요.

05

재현 가능한 로그 수집

시작 명령의 비식별화 버전, 표준 출력, 표준 오류, 종료 코드, 모델 이름 및 발생 시간을 보관하세요. 로그에 액세스 토큰, 요청 본문 또는 사용자 데이터가 있다면 제출 전에 반드시 삭제하세요.

로컬 헬스 체크

루프백 주소에서 서비스부터 확인

실제 포트와 헬스 경로를 명령에 입력하세요. 헬스 엔드포인트는 가볍고 안정적이어야 하며 전체 추론 작업을 실행해서는 안 됩니다.

curl --fail --show-error \
  --max-time 10 \
  http://127.0.0.1:<port>/health
CI 지원

runner를 취소 가능하고 정리 가능하며 재현 가능하게 운영하세요

self-hosted runner는 단순한 상주 프로세스가 아닙니다. 등록, 자격 증명, 캐시, 산출물 및 취소 작업에 명확한 담당자와 보존 범위가 필요합니다.

01

runner 등록

전용 서비스 계정과 독립 작업 디렉터리를 사용하고 runner 이름, 태그, 소속 프로젝트 및 등록 시간을 기록하세요. 태그는 실제 역량만 설명하도록 하여 여러 프로젝트가 같은 작업 디렉터리에 잘못 배정되지 않게 하세요.

완료 기준 대기열에서 runner를 식별할 수 있고 테스트 작업이 명확한 종료 코드를 반환합니다.
02

프로젝트 자격 증명 격리

프로젝트와 환경별로 토큰을 분리하고 관리되는 키 저장소나 런타임 환경 변수를 우선 사용하세요. 장기 자격 증명을 저장소, runner 설정 백업 또는 다운로드 가능한 산출물에 기록하지 마세요.

완료 기준 작업 로그에 비밀 값이 출력되지 않고 한 프로젝트의 취소가 다른 프로젝트에 영향을 주지 않습니다.
03

빌드 캐시 관리

의존성 캐시, DerivedData, 임시 파일 및 아카이브에 서로 다른 디렉터리를 설정하세요. 디스크 공간이 부족하면 먼저 증가 원인을 확인한 후 프로젝트별로 정리하고 현재 실행 중인 작업이 사용하는 디렉터리는 직접 삭제하지 마세요.

완료 기준 캐시 경로를 추적할 수 있고 정리 작업으로 최종 산출물이 삭제되지 않습니다.
04

빌드 산출물 보존

산출물에 커밋 버전, 빌드 번호, 툴체인 버전 및 검증 정보를 기록하세요. 작업이 끝나면 보존할 파일을 runner 작업 디렉터리 밖으로 옮겨 캐시 정리 때 함께 삭제되지 않게 하세요.

완료 기준 실패 로그와 성공 산출물을 동일한 빌드에 연결할 수 있습니다.
05

runner 안전하게 취소

먼저 새 작업 수신을 중지하고 현재 작업이 끝날 때까지 기다린 다음 프로젝트 측에서 등록 토큰을 취소하고 서비스를 제거하세요. 마지막으로 작업 디렉터리, 캐시 및 자격 증명이 데이터 이동 계획에 따라 처리되었는지 확인하세요.

완료 기준 컨트롤러가 더 이상 작업을 배정하지 않고 노드에 재사용 가능한 등록 자격 증명이 남아 있지 않습니다.
용어집

여덟 가지 용어를 먼저 통일하세요

문제 해결 시 일관된 용어를 사용하면 노드, 소프트웨어, 네트워크 및 결제 문제를 혼동하지 않을 수 있습니다.

물리 노드
주문에 실제로 제공되는 Mac Mini M4 호스트입니다. 클라우드 Mac 하드웨어 노드이며 가상 머신 인스턴스가 아닙니다.
전용
주문에서 물리 컴퓨터 전체의 프로세서, 메모리 및 로컬 스토리지 리소스를 사용하며 다른 임대 주문과 동일한 컴퓨팅 리소스를 공유하지 않습니다.
VNC
macOS 그래픽 인터페이스에 액세스하는 원격 디스플레이 방식입니다. 문제 해결 시 그래픽 세션, 클라이언트 및 네트워크 경로를 구분해야 합니다.
self-hosted runner
팀이 등록하고 관리하는 CI 실행 환경으로, 작업을 가져와 빌드를 실행하고 로그와 산출물을 반환합니다.
MLX
Apple Silicon용 머신러닝 도구 체계로, 모델 준비, 추론 실험 및 서비스 검증에 사용할 수 있습니다.
빌드 캐시
반복적인 다운로드와 컴파일을 줄이기 위해 보관하는 데이터로, 의존성 캐시, DerivedData 및 도구가 생성한 중간 파일이 포함됩니다.
노드
물리 호스트가 위치한 서비스 지역입니다. 현재 디렉터리에는 싱가포르, 일본(도쿄), 한국(서울) 및 홍콩의 네 노드가 포함됩니다.
결제 주기
주문에서 선택한 사용 기간으로, 일간·주간·월간 또는 분기별로 생성할 수 있습니다. 주기, 시작 시간 및 만료 시간은 콘솔 주문 기록을 기준으로 합니다.
장애 분류 트리

증상에 따라 다음 단계를 선택하고 여러 설정을 동시에 변경하지 마세요

한 번에 하나의 조건만 변경하고 결과를 기록하세요. 여러 설정을 한꺼번에 초기화하면 장애 범위를 파악할 수 없고 지원 팀도 재현하기 어려워집니다.

NET 노드에 연결할 수 없음 시간 초과, 연결 거부, 지문 변경 또는 자격 증명 불일치
먼저 확인

주문이 유효한지, 주소와 포트가 현재 노드에 해당하는지, 로컬 네트워크가 대상 포트에 도달할 수 있는지, 사용자 이름과 키가 일치하는지 확인하세요.

정보 수집

발생 시간, 클라이언트 버전, 오류 원문, 비식별화된 상세 연결 출력 및 네트워크 전환 후 비교 결과를 수집하세요.

지원 요청 시점

서로 독립된 두 네트워크에서 모두 연결할 수 없거나 호스트 지문이 콘솔 기록과 다르면 더 시도하지 말고 지원 요청을 제출하세요.

BLD 빌드 실패 의존성 확인, 컴파일, 서명 단계 또는 runner 작업 이상
먼저 확인

커밋 버전, 잠금 파일, 툴체인 버전, 환경 변수, runner 태그 및 작업 디렉터리가 최근 성공한 빌드와 동일한지 확인하세요.

정보 수집

전체 종료 코드, 실패 단계 전후의 로그, 빌드 명령, 도구 버전 및 캐시 정리 후 비교 결과를 수집하세요.

지원 요청 시점

동일한 커밋과 설정이 깨끗한 작업 디렉터리에서도 계속 실패하고 로그가 노드 시스템 또는 디스크 이상을 가리킬 때 지원 요청을 제출하세요.

DSK 디스크 공간 부족 모델, 빌드 캐시, 로그 또는 아카이브가 계속 증가
먼저 확인

디렉터리별 사용량을 집계하고 모델, 의존성 캐시, DerivedData, 로그, 임시 파일 및 이동해야 할 최종 산출물을 구분하세요.

정보 수집

파일 시스템 여유 공간, 가장 많은 공간을 차지하는 디렉터리, 증가 시작 시간, 실행 중인 작업 및 최근 정리 기록을 수집하세요.

지원 요청 시점

파일 시스템 보고와 디렉터리 집계가 크게 다르거나 정리 가능한 항목을 삭제한 후에도 공간이 확보되지 않을 때 지원 요청을 제출하세요.

SRV 서비스 응답 없음 프로세스는 존재하지만 헬스 엔드포인트가 시간 초과되거나 외부에서 액세스할 수 없음
먼저 확인

프로세스 상태, 리스닝 주소, 포트 사용 여부, 로컬 헬스 체크, 사용 가능한 메모리 및 최근 표준 오류 출력을 확인하세요.

정보 수집

시작 명령의 비식별화 버전, 프로세스 종료 코드, 로컬 및 외부 요청 결과, 응답 시간 및 서비스 로그 시간대를 수집하세요.

지원 요청 시점

로컬 요청도 실패하고 서비스 로그에 시스템 수준 이상이 표시되거나 여러 서비스가 동시에 응답하지 않을 때 지원 요청을 제출하세요.

ORD 콘솔 주문 이상 주문 상태, 주기, 노드 또는 청구 기록이 예상과 다름
먼저 확인

주문 식별자, 선택한 VMMini M4 구성, 노드, 결제 주기, 추가 항목 및 결제 기록이 동일한 주문에 속하는지 확인하세요.

정보 수집

주문 식별자, 페이지에 표시된 상태, 발생 시간, 작업 단계 및 비식별화 스크린샷을 수집하세요. 전체 결제 자격 증명은 제출하지 마세요.

지원 요청 시점

새로고침하고 다시 로그인한 후에도 기록이 일치하지 않거나 주문 작업을 계속할 수 없다면 콘솔에서 연결된 지원 요청을 제출하세요.

서비스 운영 기준

노드는 연중 운영되며 이벤트는 주문 기록으로 확인합니다

VMMini 노드는 연중 365일 정상 운영되도록 설계되었으며 정기적인 중단 없이 계속 운영됩니다. 개별 주문의 가용성과 이벤트 기록은 콘솔의 실시간 응답 및 연결된 기록을 기준으로 합니다.

네 개 노드 운영 범위 디렉터리의 모든 노드에서 VMMini M4를 주문할 수 있으며 실제 이용 가능 여부는 콘솔에서 실시간으로 확인됩니다.
주문 이벤트 확인

싱가포르

동남아 팀과 워크로드는 이 경로를 우선 테스트할 수 있습니다.

일본(도쿄)

일본 또는 동아시아 코드 소스와의 실측 비교에 적합합니다.

한국(서울)

동북아 액세스 경로의 연결 테스트에 적합합니다.

홍콩

중국 남부 및 동남아 네트워크 경로의 실측 비교에 사용할 수 있습니다.

서비스 이벤트인지 판단하는 방법: 먼저 서로 독립된 두 네트워크에서 연결을 재현한 다음 노드 로컬 서비스와 사용자 소프트웨어 상태를 확인하세요. 외부 네트워크 경로, 사용자 설정 또는 단일 프로세스 실패를 물리 노드 사용 불가로 바로 간주해서는 안 됩니다.
지원 요청 제출

바로 문제 해결을 시작할 수 있는 지원 요청에는 무엇이 포함되어야 하나요?

기존 주문은 노드, 주기 및 이벤트 기록을 연결할 수 있도록 콘솔 지원 요청을 우선 사용하세요. 로그인할 수 없다면 support@vmmini.com으로 서비스 팀에 문의할 수 있습니다.

요청 정보 목록

필수 정보 여섯 가지

계정 키 제외
  1. 01
    주문 식별자

    콘솔의 주문 식별자를 제공하고 스크린샷에 있는 다른 개인 정보로 대신하지 마세요.

  2. 02
    관련 노드

    싱가포르, 일본(도쿄), 한국(서울) 또는 홍콩과 해당 호스트를 명시하세요.

  3. 03
    발생 시간

    시간대, 최초 발생 시간, 마지막 재현 시간 및 현재도 계속 발생하는지를 제공하세요.

  4. 04
    재현 단계

    명령, 입력 조건, 예상 결과 및 실제 결과를 작업 순서대로 나열하세요.

  5. 05
    오류 원문

    종료 코드와 핵심 맥락을 유지하고 “사용할 수 없음” 또는 “빌드 실패”라고만 쓰지 마세요.

  6. 06
    비식별화 로그

    비밀번호, 개인 키, 액세스 토큰, 사용자 데이터 및 불필요한 전체 주소를 삭제한 후 첨부하세요.

주문이 없거나 로그인할 수 없음

다음 주소로 이메일을 보내세요 support@vmmini.com제목에 문제 유형을 명시하세요. 이메일에는 노드, 시간, 재현 단계 및 비식별화 로그도 포함해야 합니다.

연락처 확인

다음 내용은 제출하지 마세요

비밀번호, 개인 키, 액세스 토큰, 복구 문구, 전체 결제 자격 증명, 비식별화하지 않은 사용자 데이터 및 문제와 관련 없는 코드 저장소 내용

데이터 개인정보 보호 안내 읽기
증거를 지원 요청에 포함하세요

기존 주문은 노드 기록을 바로 연결해 계속 문제를 해결하세요

주문 식별자, 노드, 발생 시간, 재현 단계 및 비식별화 로그를 준비하세요. 콘솔 지원 요청은 기술 및 주문 문제에 사용하며, 구매 전 문의는 전용 지원 이메일로도 연락할 수 있습니다.