연결할 수 없음
먼저 주문에 표시된 주소와 접속 방식을 확인하고 로컬 네트워크와 클라이언트가 정상인지 점검하세요. 그런 다음 계정에 해당 인스턴스의 권한이 있는지 확인하세요.
클라이언트에 오류가 표시되면 원문과 발생 시간을 기록하세요. 여러 설정을 한꺼번에 바꾸면 어떤 조치가 효과가 있었는지 파악하기 어렵습니다.
문제 해결 기록 준비
사용 및 문제 해결
원격 Mac에 문제가 있나요? 여기서 먼저 확인하세요
연결, 개발 환경 또는 주문별 확인 항목을 찾아보세요. 접속 주소와 권한 정보는 콘솔의 주문 내역에서만 확인할 수 있습니다. 이 페이지에는 실제 접속 정보가 표시되지 않습니다.
관련 안내 찾기
문제를 검색하거나 주제별로 찾아보세요
검색은 이 페이지의 안내에서 주제를 찾으며, 주문이나 접속 정보는 조회하지 않습니다. 특정 인스턴스에 관한 문제는 콘솔에 로그인해 확인하세요.
연결하기 전에
먼저 네 가지를 확인한 뒤 클라이언트를 점검하세요
주문의 노드나 접속 방식이 가지고 있는 기록과 다르면 콘솔에 현재 표시된 정보를 기준으로 확인하세요. 주소와 인증 정보를 공개 게시판에 올리지 마세요.
- 01주문 및 노드대상 인스턴스의 주문을 확인하고 선택한 전용 물리 노드와 주문의 접속 안내를 확인하세요. 다른 기기의 이전 기록은 사용하지 마세요.
- 02로컬 네트워크로컬 네트워크가 작동하는지 확인하세요. 제한된 사내 네트워크를 이용 중이라면 접근 정책을 확인한 다음 허용된 네트워크에서 연결을 시도하세요.
- 03클라이언트 설정주문 안내에 맞는 원격 데스크톱 클라이언트를 선택하고 연결 방식, 주소, 입력 형식을 하나씩 확인하세요. VNC는 데스크톱을 조작하는 여러 방법 중 하나이며 모든 주문에서 사용하는 유일한 방식은 아닙니다.
- 04계정 및 권한현재 계정에 해당 인스턴스의 접근 권한이 있는지 확인하세요. 팀 구성원의 권한 범위는 관리자가 확인해야 하며, 로그인 정보를 서로 전달하지 마세요.
문제 범위 좁히기
연결 문제는 증상별로 확인하세요
문제가 어느 단계에서 시작됐는지 기록한 뒤 한 번에 한 가지 조건만 바꿔 다시 확인하세요. 네트워크 경로, 클라이언트, 작업 부하에 따라 사용 환경이 달라질 수 있으므로 이 페이지에서는 검증되지 않은 고정 지연 시간을 안내하지 않습니다.
연결은 되지만 화면에 문제가 있음
검은 화면인지, 화면 비율이 맞지 않는지, 입력이 응답하지 않는지 기록하세요. 클라이언트의 디스플레이 설정을 확인하고 세션 중 로컬 네트워크가 자주 바뀌지 않았는지도 점검하세요.
데스크톱을 조작할 수 있다면 먼저 작업을 저장한 뒤 주문 안내에 따라 세션을 다시 연결하세요. 화면에 나타난 현상만으로 노드에 문제가 있다고 단정하지 마세요.
스크린샷 민감 정보 가리기세션이 갑자기 끊김
연결이 끊긴 시간, 당시 작업, 클라이언트 메시지를 기록하세요. 로컬 네트워크가 전환되거나 끊겼는지 확인하고 다시 연결한 뒤 작업 상태를 점검하세요.
빌드나 실험 작업이 끝났는지 데스크톱 화면만 보고 판단하지 마세요. 프로젝트 로그와 결과물 디렉터리에서 결과를 확인해 작업을 중복 실행하지 않도록 하세요.
작업 및 로그 확인
개발 환경
시스템, 도구 체인, 프로젝트 의존성을 따로 확인하세요
사용 가능한 macOS 및 소프트웨어 버전은 콘솔의 물리 노드 정보에서 확인하세요. 현재 상태를 먼저 기록한 뒤 프로젝트 요구사항에 맞게 환경을 조정하세요. 프로젝트 의존성 오류를 원격 연결 문제로 오인하지 마세요.
macOS 버전
데스크톱에서 시스템 버전을 확인하고 프로젝트와 도구의 최소 요구 사항에 맞는지 비교하세요. ‘최신 버전’이라고만 적지 말고 전체 버전 정보를 기록하세요.
Xcode 버전
현재 사용하는 Xcode 버전, 프로젝트 요구사항, 필요한 SDK를 확인하세요. 여러 버전이 설치되어 있다면 빌드 작업에서 실제로 어떤 버전을 호출하는지 확인하세요.
컴파일 도구 경로
다음을 실행하세요: xcode-select -p 및 xcodebuild -version을 실행해 예상 경로와 버전을 비교하세요. 선택을 변경하기 전에 다른 작업에 미칠 영향을 먼저 확인하세요.
의존성 및 캐시
잠금 파일, 패키지 관리자 버전, 프로젝트 스크립트를 확인하세요. 재현 가능한 최소 작업으로 의존성을 먼저 검증한 다음 캐시 삭제 여부를 결정하세요.
빌드 작업이 실패하면 처음 발생한 유효한 오류부터 확인하세요
코드 체크아웃, 의존성 설치, 컴파일, 서명, 결과물 처리의 다섯 단계를 구분하세요. self-hosted runner를 사용한다면 실행 계정의 권한, 작업 디렉터리, 비밀 정보의 안전한 주입 방식도 확인하세요.
실패한 명령, 종료 상태, 민감 정보를 가린 로그를 보관하세요. 서명 정보나 환경 변수의 실제 값을 지원 티켓에 적지 마세요. 데스크톱은 정상 작동하지만 빌드가 실패한다면 프로젝트 로그부터 확인하세요.
용어 안내
먼저 용어를 정리해 문제를 정확히 설명하세요
문제를 설명할 때 용어를 일관되게 사용하면 기기, 지역, 연결 방식, 결제 옵션을 구분하기 쉽습니다.
- 물리 노드
- 클라우드 Mac 서비스를 호스팅하는 실제 장비입니다. 주문의 노드 정보에서 선택한 실행 위치를 확인할 수 있습니다.
- 전용 물리 Mac
- 주문에 따라 한 명이 전용으로 사용하는 물리 Mac으로, 다른 사용자와 공유하는 가상 머신 인스턴스가 아닙니다.
- 클라우드 Mac
- 원격 물리 노드에서 실행되며 권한이 부여된 방식으로 연결할 수 있는 macOS 작업 환경입니다.
- VNC
- 원격 그래픽 데스크톱을 보고 조작하는 연결 방식 중 하나입니다. 사용 가능한 방식은 주문 안내를 확인하세요.
- self-hosted runner
- 팀이 직접 설정하고 관리하며 자동화된 빌드 작업을 실행하는 러너입니다.
- 이용 기간
- 주문할 때 선택하는 결제 기간으로, 일·주·월·분기 단위 중 선택할 수 있습니다. 확정된 주문을 기준으로 확인하세요.
- 노드
- 주문 시 선택한 지역 위치입니다. 고정된 네트워크 속도나 클라이언트 접속 주소를 의미하지 않습니다.
- 추가 스토리지
- 기본 구성에 추가로 구매하는 스토리지 옵션입니다. 사양과 해당 이용 기간의 금액은 요금제 페이지에서 확인하세요.
주문 및 결제
금액, 이용 기간, 결제 방법은 어떻게 확인하나요?
주문에서 선택한 이용 기간과 추가 옵션을 먼저 확인한 다음 최종 USD 금액을 확인하세요. 전체 기간별 가격과 추가 옵션은 요금제 페이지에서 확인할 수 있습니다. 현재 주문 금액을 다른 기간의 가격으로 추정하지 마세요.
주문은 어떤 통화로 결제되나요?
모든 주문은 미국 달러(USD)로 결제됩니다. 주문을 확인할 때는 기기 모델, 이용 기간, 추가 옵션, 최종 금액을 같은 주문에서 함께 확인하세요. 기간별 요금은 각각 표시되며 일일 요금에 기간을 곱해 계산하지 않습니다.
어떤 결제 방법을 이용할 수 있나요?
USDT-TRC20과 Stripe를 통한 Visa / Mastercard / Amex를 지원합니다. 결제 시 선택 가능한 게이트웨이는 백엔드에 표시된 내용을 기준으로 확인하세요. 결제가 완료되지 않았다면 중복 제출을 피하기 위해 먼저 해당 주문의 상태를 확인하세요.
이용 기간과 추가 옵션은 어디서 확인하나요?
먼저 요금제 및 가격 페이지에서 요금제를 확인한 다음 콘솔 주문에서 실제로 선택한 기간, 노드, 추가 옵션을 확인하세요. 이번 구매 내역은 주문 확인 정보를 기준으로 판단해야 합니다.
지원 티켓을 제출하기 전에
재현 가능한 정보를 제공하고 비밀 정보는 보내지 마세요
기존 주문에 관한 문제는 콘솔에서 지원 티켓을 제출하세요. 이미 확인한 내용도 함께 적으면 지원팀이 아직 해결되지 않은 부분부터 살펴볼 수 있습니다.
- 01주문 및 위치주문 ID, 선택한 노드, 영향을 받은 인스턴스를 알려주세요. 접속 정보는 복사할 필요가 없습니다.
- 02시간 및 증상발생 시간과 시간대, 클라이언트 환경, 표시된 오류 메시지, 문제가 매번 발생하는지 여부를 적어주세요.
- 03재현 절차 및 확인 내용작업 단계를 순서대로 적고 네트워크, 권한, 클라이언트, 프로젝트 로그에서 확인한 내용을 함께 알려주세요. ‘연결이 안 돼요’만으로는 문제를 파악하기 어렵습니다.
- 04민감 정보 제거한 첨부 파일스크린샷이나 로그에는 문제를 파악하는 데 필요한 부분만 남기세요. 비밀번호, 비밀 키, 토큰, 서명 정보, 관련 없는 개인정보는 가리세요.
비밀번호나 비밀 키를 보내지 마세요.추가 자료가 필요하면 콘솔의 지원 티켓에서만 계속 문의하세요. 구매 전 일반 문의는 다음 주소로도 보낼 수 있습니다: support@vpspush.com。
다음 단계
아직 해결되지 않았나요? 문제 해결 기록과 함께 문의하세요
기존 주문은 콘솔에 로그인해 지원 티켓을 제출하고, 완료한 확인 절차를 첨부하세요. 구매 전 문의는 연락처 페이지에서 적절한 문의 방법을 확인하세요.