먼저 직접 확인하고, 필요하면 지원팀에 문의하세요

문제가 생겼다면 여기서 확인하세요

연결이 안 되거나 결제가 확인되지 않나요? 개발 환경을 조정해야 하나요? 증상을 검색하고 안내된 순서대로 확인하세요. 주문이나 인스턴스 관련 문제는 콘솔에 로그인해 티켓을 제출하세요.

이미 주문하셨다면 먼저 인스턴스 세부 정보에서 연결 정보, 이용 기간, 결제 상태를 확인하세요.

문제 유형별 안내

문제를 네 가지 유형으로 나눠 확인하세요

먼저 문제가 발생한 단계를 확인하세요. 연결 실패가 반드시 리전 문제를 뜻하는 것은 아니며, 결제 미확인이 곧 다시 결제해야 한다는 뜻도 아닙니다.

연결 문제 해결

인증 정보를 확인한 다음 네트워크를 점검하세요

처음부터 인스턴스를 재설치하지 마세요. 오류 원문을 기록하고 시간 초과, 연결 거부, 인증 실패를 구분하면 지원팀이 원인을 파악하기 쉽습니다.

SSH 시간 초과: 로그인 단계에 도달하지 못함

연결 시간 초과가 표시되면 비밀번호를 반복해서 입력하기보다 네트워크 경로를 먼저 확인하세요. 연결 거부가 표시되면 포트와 서비스 상태를 확인하고, 인증 실패라면 아래 인증 정보 점검으로 이동하세요.

  1. 01주소를 다시 복사하세요

    콘솔에서 인스턴스 세부 정보를 열고 현재 호스트 주소와 SSH 포트를 복사하세요. 붙여넣을 때 생긴 공백을 제거하고 이전 주문이나 리전의 연결 정보를 사용하지 마세요.

  2. 02로컬 네트워크의 외부 연결을 확인하세요

    로컬 네트워크에서 해당 포트에 연결할 수 있는지 확인하세요. 회사 네트워크, 프록시, 보안 소프트웨어가 외부 연결을 제한할 수 있습니다. 사용 권한이 있는 다른 네트워크에서도 비교해 보세요.

  3. 03인스턴스와 규칙을 확인하세요

    콘솔에서 인스턴스 상태를 확인하고 설정한 방화벽과 허용된 원본 IP 제한을 점검하세요. 문제 해결을 위해 모든 포트를 열지 마세요. 현재 외부 IP가 허용 범위에 있는지 먼저 확인하세요.

터미널에서 자세한 연결 로그를 확인하려면 대문자 항목을 바꾼 뒤 실행하세요:

ssh -vv -p SSH_PORT USER@HOST

로그를 제출하기 전에 호스트 주소, 사용자 이름, 로컬 경로 등 민감한 정보를 가리세요. 개인 키나 비밀번호는 업로드하지 마세요.

화면 공유가 검게 보이면 세션을 확인한 뒤 화질을 낮추세요

그래픽 화면의 검은 화면 문제와 SSH 연결 실패는 서로 다른 문제입니다. 먼저 SSH를 시도해 인스턴스에 연결할 수 있는지 확인하세요. 명령줄이 정상이라면 그래픽 세션과 클라이언트 설정을 점검하세요.

  1. 01연결 방식을 확인하세요

    인스턴스 세부 정보에 표시된 방식으로 연결하세요. SSH 포트를 화면 공유 포트로 사용하면 안 됩니다. 클라이언트의 프로토콜, 호스트, 인증 방식이 일치하는지도 확인하세요.

  2. 02현재 세션에 다시 연결하세요

    클라이언트 연결을 끊었다가 다시 연결한 뒤 잠금 화면이나 로그인 화면에서 멈춰 있는지 확인하세요. 여러 클라이언트에서 동시에 디스플레이 설정을 바꾸면 문제를 재현하기 어려워질 수 있습니다.

  3. 03전송 부하를 줄이세요

    먼저 해상도와 화질을 낮추고 대용량 파일 업로드를 중단한 뒤 다시 시도하세요. 특정 클라이언트에서만 검은 화면이 나타나면 클라이언트 버전과 설정을 기록하고 스크린샷과 함께 티켓을 제출하세요.

인증 정보 오류: 연결 문제와 인증 실패를 구분하세요

인증 실패는 대개 연결이 서버에 도달했다는 뜻입니다. 리전을 계속 바꾸기보다 로그인 사용자와 인증 방식을 확인하세요.

  1. 01현재 사용자를 확인하세요

    현재 인스턴스의 로그인 사용자 이름을 사용하세요. 시스템 재설치나 이전 후에는 연결 정보를 다시 확인하세요. 직접 비밀번호를 변경했다면 변경한 비밀번호를 사용하세요.

  2. 02키가 서로 맞는지 확인하세요

    인스턴스에 등록된 공개 키에 해당하는 개인 키를 지정하고 로컬 개인 키 파일의 권한을 확인하세요. 공개 키 파일을 개인 키로 SSH에 전달하지 마세요. 개인 키를 지원팀에 보내서도 안 됩니다.

  3. 03오류 원문을 보관하세요

    실패한 시간, 인증 방식, 오류 메시지를 기록하세요. 재설치 후 호스트 키가 바뀌었다면 먼저 콘솔에서 인스턴스가 맞는지 확인한 다음 로컬 기록을 업데이트하세요.

결제 및 청구

주문 상태부터 확인하고 중복 결제하지 마세요

USDT-TRC20 및 Visa / Mastercard / Amex(Stripe)만 지원하며 모든 금액은 USD로 결제됩니다. 실제 이용 가능한 결제 게이트웨이는 콘솔에 표시된 내용을 확인하세요.

USDT-TRC20을 전송했는데 주문은 왜 아직 확인되지 않았나요?

지갑에 전송 완료로 표시되어도 주문 확인이 끝난 것은 아닙니다. 결제 페이지에 안내된 네트워크, 수취 주소, 결제 금액을 확인한 다음 블록체인에서 거래 상태를 확인하세요. USDT-TRC20 입금 확인은 블록체인 진행 상황에 따라 달라지며, 확인에 걸리는 시간을 분 단위로 보장하지 않습니다.

콘솔로 돌아가 주문 결제 상태를 확인하세요. 종료된 결제 정보나 현재 주문에 해당하지 않는 결제 정보로 송금하지 마세요. 거래가 확인됐는데도 주문 상태가 갱신되지 않으면 주문 번호, 트랜잭션 해시, 송금 금액, 송금 시간을 시간대와 함께 제출하세요. 지갑 개인 키, 시드 구문, 비밀번호는 보내지 마세요. 기다리는 동안 중복 송금하지 마세요.

Visa / Mastercard / Amex 결제가 실패하면 어떻게 해야 하나요?

먼저 결제 페이지의 오류 메시지를 확인하세요. 카드의 온라인 및 USD 결제 허용 여부, 사용 가능 한도, 청구 정보 일치 여부, 카드 발급사가 요구한 인증 완료 여부를 확인하면 됩니다. 필요하면 카드 발급사에 거절 사유를 문의하고 짧은 간격으로 반복 결제하지 마세요.

브라우저가 중단되거나 인증 페이지가 닫혔거나 페이지가 비정상적으로 돌아갔다면 먼저 콘솔에서 주문 상태를 확인한 뒤 재시도 여부를 결정하세요. 티켓에는 주문 번호, 오류 메시지, 발생 시간을 적으세요. 스크린샷의 민감한 정보는 가려야 합니다. 전체 카드 번호와 보안 코드는 보내지 않아도 됩니다. 카드 결제 정보는 Stripe에서 처리합니다.

연장, USD 금액 확인, 청구서 다운로드는 어떻게 하나요?

콘솔에서 현재 구독의 만료일을 확인하고 연장을 선택한 다음 견적 금액을 확인하세요. 결제 전 모델, 기간, 리전, 추가 옵션을 점검하고 결제 후 새 이용 기간이 표시되는지 확인하세요. 서비스는 일·주·월·분기 단위 선결제이며 시간 단위로 청구되지 않습니다. 연장 금액과 적용 시점은 주문 확인 정보를 기준으로 합니다.

가격표의 모든 금액은 USD입니다. XN Core M4: 일 $21.4, 주 $57.7, 월 $106.8, 분기 $290.5; XN Pro M4P: 일 $59.3, 주 $160.1, 월 $296.4, 분기 $806.2. 청구서를 확인할 때 기본 이용료와 선택한 추가 옵션을 각각 확인하세요. 청구서와 다운로드 가능한 파일은 콘솔의 청구 내역에서 확인할 수 있습니다. 다운로드에 실패하면 청구서 번호와 함께 티켓을 제출하세요.

만료 전에 연장 알림이 발송되지만 알림을 백업 계획으로 대신할 수는 없습니다. 개인 캘린더에 알림을 설정하고 미리 결제와 이용 기간을 확인하세요. 중요한 작업 결과물은 본인 스토리지에 꾸준히 동기화하세요.

시스템 및 개발 환경

작업물을 먼저 보존한 뒤 환경을 조정하세요

전용 물리 머신이며 가상 머신이 아닙니다. macOS 그래픽 인터페이스와 명령줄을 사용할 수 있습니다. 도구 설치, 버전 전환, 재설치 전에 백업과 프로젝트 의존성을 확인하세요.

macOS를 재설치하기 전에 무엇을 준비해야 하나요?

실행 중인 빌드, 전송, 실험 작업을 먼저 중지한 다음 코드, 결과물, 환경 설정, 보관할 인증서를 백업하세요. 재설치하면 시스템 환경이 바뀌고 로컬 데이터가 삭제될 수 있으므로 연결 문제 해결의 첫 단계로 진행하면 안 됩니다.

콘솔에 로그인해 현재 인스턴스의 재설치 옵션과 확인 안내를 살펴보세요. 도움이 필요하면 해당 주문에서 티켓을 제출하고 재설치할 인스턴스와 백업 완료 여부를 알려주세요. 완료 후 연결 인증 정보를 다시 확인하고 macOS 버전, 도구 경로, 디스크를 점검한 다음 프로젝트를 복원하세요. 이전 연결 정보만으로 새 환경의 이상 여부를 판단하지 마세요.

Xcode 및 명령줄 도구를 확인하고 전환하려면 어떻게 하나요?

먼저 프로젝트에 필요한 Xcode, SDK, macOS 버전을 확인한 다음 현재 선택된 개발자 디렉터리를 점검하세요. Xcode 버전이 여러 개 설치되어 있으면 그래픽 인터페이스에서 연 버전과 명령줄 빌드에서 사용하는 버전이 다를 수 있습니다.

xcode-select -p
xcodebuild -version
uname -m
df -h

앞의 세 명령은 각각 개발자 디렉터리, Xcode 버전, 아키텍처를 확인하고 마지막 명령은 디스크 여유 공간을 확인합니다. Apple Silicon의 기본 아키텍처 출력은 arm64입니다. 전환하려면 대상 앱 경로가 실제로 존재하는지 먼저 확인한 다음 sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer 를 사용해 해당 디렉터리를 선택하세요. 이 명령은 이후 명령줄 빌드에 영향을 줍니다.

Homebrew를 사용하기 전에 command -v brew 와 brew --version을 확인해 명령이 예상한 환경에서 실행되는지 확인하세요. 의존성을 설치할 때는 프로젝트에서 고정한 버전을 사용하고 도구 체인, 의존성, 빌드 스크립트를 동시에 변경하지 마세요. 실패하면 도구 버전, 실행한 명령, 오류의 마지막 부분을 제출하세요. 단순히 “빌드가 안 돼요”라고 쓰는 것보다 원인을 찾기 쉽습니다.

만료 전에 어떤 파일을 백업하고 어떻게 확인해야 하나요?

최소한 세 가지를 정리하세요. 아직 푸시하지 않은 코드와 프로젝트 설정, 빌드 결과물과 실험 결과, 환경 복원에 필요한 의존성 목록과 라이선스 파일입니다. 인증서와 키는 암호화해 보관하고 팀 권한에 따라 공유하세요. 공개 저장소나 티켓 첨부 파일에는 넣지 마세요.

scp 또는 rsync로 파일을 본인 스토리지에 동기화할 수 있습니다. 먼저 소량의 파일을 전송해 경로, 권한, 읽기 가능 여부를 확인한 뒤 전체 디렉터리를 전송하세요. 완료 후 파일 수, 크기 또는 체크섬을 비교하고 중요한 결과물을 직접 열어 확인하세요. 추가 SSD는 외장 확장 스토리지이며 독립적인 백업이 아닙니다. 리전 간 자동 동기화를 의미하지도 않습니다.

만료 후 데이터 복구에 의존하지 마세요. 보관 및 삭제 방식은 콘솔 안내와 적용되는 규칙을 확인하세요. 특별한 이전이 필요하다면 이용 기간이 끝나기 전에 티켓을 제출하고 백업을 완료하세요.

네트워크 및 리전

작업 방식에 맞는 리전을 고른 뒤 직접 연결을 확인하세요

6개 리전 모두 두 가지 모델을 제공합니다. 선택할 때는 사용자의 위치, 코드와 결과물의 전송 방향, 평소 SSH와 그래픽 인터페이스 중 무엇을 사용하는지 함께 고려하세요.

6개 리전은 어떻게 선택하고 지연 시간은 어떻게 판단하나요?

먼저 지리적 위치를 기준으로 후보를 좁힌 다음 사용 중인 네트워크에서 직접 확인하세요. 아래 표는 리전 선택을 위한 참고 정보이며 측정 지연 시간을 보장하지 않습니다. 통신사 경로와 로컬 네트워크에 따라 사용 경험은 달라질 수 있습니다. SSH는 연속적인 화면 전송이 필요하지 않지만, 화면 공유는 왕복 지연 시간과 대역폭의 영향을 더 크게 받습니다.

6개 리전의 권장 대상 지역 및 연결 점검 안내
리전우선 고려할 사용자 지역연결 시 먼저 확인할 항목
싱가포르동남아시아평소 사용하는 네트워크에서 응답 속도와 코드 동기화 속도를 비교하세요.
일본(도쿄)동아시아주로 사용하는 화면 공유 클라이언트로 연결하고 화질을 낮게 설정해 먼저 확인하세요.
한국(서울)동북아시아지도상의 거리뿐 아니라 로컬 네트워크의 외부 경로도 비교하세요.
홍콩중국 남부 및 동남아시아로컬 네트워크 제한과 대용량 파일 업로드 중 응답 변화 여부를 확인하세요.
미국 동부북미 동부 및 서유럽빌드 결과물 전송과 대화형 연결 상태를 함께 확인하세요.
미국 서부북미 서부팀, 코드 저장소, 결과물 수신 위치를 확인하세요.

사용 중 끊김이 발생하면 먼저 대용량 파일 전송을 멈추고 화면 공유 해상도를 낮춰 비교해 보세요. 문제가 계속되면 로컬 네트워크 유형, 리전, 클라이언트 버전, 발생 시간을 기록하세요. 한 번의 테스트만으로 리전 전체를 사용할 수 없다고 판단하지 마세요.

다른 리전으로 이전하려면 어떻게 하나요?

먼저 기존 인스턴스의 데이터를 백업하고 도구 버전, 환경 변수, 작업 설정, 네트워크 허용 규칙을 기록하세요. 그런 다음 콘솔에서 대상 리전의 주문 가능 여부를 확인하세요. 기존 구독 조정이 필요하면 티켓을 먼저 제출해 비용과 적용 방식을 확인하세요. 리전을 바꾼다고 디스크가 자동 이전된다고 가정하지 마세요.

대상 인스턴스에 연결할 수 있으면 파일을 복원하고 빌드, 서명, 결과물 업로드, 예약 작업을 확인하세요. 팀에서 사용하는 호스트 주소와 허용된 원본 IP 규칙을 업데이트하세요. 새 인스턴스가 정상 작동하는지 확인한 뒤 기존 인스턴스를 처리하세요. 이전 중에는 동일한 결과를 중복 생성할 수 있는 배포 작업을 두 인스턴스에서 동시에 실행하지 마세요.

6개 리전에서 어떤 모델을 이용할 수 있나요?

싱가포르, 일본(도쿄), 한국(서울), 홍콩, 미국 동부, 미국 서부에서 XN Core M4(M4 / 16GB / 256GB SSD)와 XN Pro M4P(M4 Pro / 64GB / 2TB SSD)를 이용할 수 있습니다. 카탈로그에 등록된 구성은 모두 충분한 재고가 있으며, 실제 이용 가능 여부는 콘솔에 실시간으로 표시되는 정보를 확인하세요.

일반적인 앱 빌드와 CI에는 XN Core M4를 고려하세요. 대규모 병렬 빌드나 더 큰 통합 메모리가 필요한 실험에는 XN Pro M4P가 적합할 수 있습니다. 외장 +1TB SSD 또는 +2TB SSD를 추가할 수 있으며 모델의 기본 스토리지 사양은 바뀌지 않습니다. 리전은 365일 연중 운영됩니다. 연결에 문제가 생기면 네트워크, 인증, 시스템을 차례로 점검하세요.

티켓 제출 준비

이미 점검한 내용을 한 번에 명확히 전달하세요

콘솔에 로그인한 뒤 티켓 메뉴에서 관련 주문을 선택하고 문제를 설명하세요. 주문 정보는 티켓으로 전달하고, 공개 문의에는 연결 비밀번호나 전체 결제 정보를 보내지 마세요.

제출 전에 다음 네 가지를 준비하세요

  1. 01주문 및 인스턴스

    주문 번호, 리전, 모델명을 적으세요. 인스턴스가 여러 대라면 대상 인스턴스를 명확히 지정해 다른 머신의 로그와 섞이지 않게 하세요.

  2. 02시간 및 증상

    처음 발생한 시간과 시간대를 적고, 계속 실패하는지 간헐적으로 발생하는지 설명하세요. 마지막으로 정상 작동한 시점과 문제 발생 전에 변경한 설정도 알려주세요.

  3. 03재현 단계 및 점검 결과

    실행 단계, 클라이언트 또는 도구 버전, 오류 원문, 완료한 점검을 적으세요. 다른 네트워크나 클라이언트에서 비교한 결과도 알려줄 수 있습니다.

  4. 04민감 정보를 가린 첨부 파일

    필요한 스크린샷이나 로그 일부를 첨부하세요. 비밀번호, 개인 키, 인증서의 민감한 내용, 결제 보안 정보는 제거하고 문제와 관련된 오류 코드는 남겨 두세요.

다음 순서로 작성해 보세요

리전 및 모델 → 주문 번호 → 문제 발생 시간과 시간대 → 기대한 결과 → 실제 오류 → 시도한 점검. 빌드나 배포에 영향을 주는 경우 현재 영향을 받는 작업을 추가하세요. “급합니다”라고만 적지는 마세요.

티켓을 제출한 뒤에는 같은 티켓에 새 결과를 추가해 전체 맥락을 유지하세요. 지원 가능 시간, 처리 진행 상황, 예상 답변은 콘솔에 표시된 내용과 티켓 답변을 확인하세요. 확인되지 않은 고정 응답 시간을 약속하지 않습니다. 리전 가동 시간과 담당자의 답변 시간은 별개입니다.

답을 찾지 못하셨나요?

도입 상담은 이메일로, 인스턴스 문제는 티켓으로

아직 주문 전이라면 사용 목적, 예상 이용 기간, 지역을 알려 모델과 리전에 대해 문의하세요. 이미 주문하셨다면 인스턴스와 문의를 연결할 수 있도록 콘솔에서 티켓을 제출하세요.

구매 전 문의, 팀 단위 구매 및 기타 문의는 support@xcodenet.com으로 연락하세요. 이메일로 비밀번호, 개인 키, 전체 카드 정보를 보내지 않아도 됩니다.