Support

지원 센터: 접속, 문제 해결, 결제 자가 진단 가이드

6단계 접속 체크리스트를 순서대로 따라가면 대부분의 문제는 티켓을 열지 않고도 해결됩니다. 답을 찾지 못했다면 영업일 기준 티켓 첫 응답은 30분 이내, 심각 장애 채널은 연중무휴 24시간 대응합니다.

빠른 시작 연결 문제 해결 시스템 및 환경 CI/CD 연동 결제 및 요금 서비스 상태 티켓 및 SLA
Quick Start

빠른 시작: 접속 정보 수신부터 접속까지 6단계

주문 후 평균 4분이면 Portal에서 IP, 사용자명, 초기 키가 담긴 개통 메일을 발송합니다. 아래 순서를 따라가면 첫 접속은 대개 3분 안에 완료됩니다.

키 저장 및 권한 설정

메일 첨부파일에서 개인 키 m4rent_ed25519를 다운로드해 ~/.ssh/에 넣으세요. 권한은 반드시 600이어야 하며, 그렇지 않으면 SSH가 사용을 거부합니다.

chmod 600 ~/.ssh/m4rent_ed25519

첫 SSH 로그인

개통 메일에 적힌 실제 IP로 교체하세요. 기본 사용자 m4rent은 sudo 권한을 가지며, 첫 로그인 시 호스트 지문 확인을 요청합니다.

ssh -i ~/.ssh/m4rent_ed25519 m4rent@203.0.113.10

초기 비밀번호 변경

초기 랜덤 비밀번호는 화면 공유와 sudo 용도로만 사용됩니다. 로그인 후 즉시 강력한 비밀번호로 변경하고, Portal에서 "자격 증명 교체 완료"로 표시하세요.

passwd

VNC 터널 열기

화면 공유 포트 5900은 기본적으로 외부에 공개되지 않습니다. SSH 터널로 로컬에 전달한 후 연결해야 평문 노출을 막을 수 있습니다.

ssh -i ~/.ssh/m4rent_ed25519 \
  -L 5901:localhost:5900 -N m4rent@203.0.113.10

화면 공유 연결

로컬 macOS에서 "화면 공유" 또는 임의의 VNC 클라이언트를 열고, 주소에는 터널의 로컬 포트를 입력하세요. 계정은 m4rent, 비밀번호는 이전 단계에서 변경한 값을 사용합니다.

open vnc://localhost:5901

시스템 및 사전 설치 환경 확인

macOS 버전, Xcode, Homebrew가 원하는 사양인지 확인하세요. 버전이 맞지 않으면 Portal에서 원클릭 재설치가 가능하며 약 15분이면 끝납니다.

sw_vers && xcodebuild -version && brew -v

보안 기준: 모든 노드는 기본적으로 SSH 비밀번호 로그인을 차단하고 키 인증만 허용하며, fail2ban이 미리 설정되어 있습니다. sshd_config를 수정하기 전에는 Portal에서 스냅샷을 생성하세요. 설정 오류 발생 시 5분 안에 롤백할 수 있습니다.

Troubleshooting

연결 문제 해결표

"증상 → 진단 명령 → 처리 방법" 순서로 진행하세요. 이 표는 티켓 시스템에 접수되는 연결 관련 문제의 약 70%를 다룹니다.

증상 먼저 실행할 진단 명령 가장 가능성 높은 원인과 처리
SSH 연결 타임아웃 ping + nc -zv IP 22 로컬 네트워크가 22번 포트를 막고 있음: 대체 포트 2222번 사용(모든 노드가 동시 리스닝)
Permission denied (publickey) ssh -v로 핸드셰이크 로그 확인 개인 키 권한 또는 경로 오류: chmod 600 실행 후 -i로 키 파일을 명시적으로 지정
WARNING: UNPROTECTED PRIVATE KEY FILE ls -l ~/.ssh/m4rent_ed25519 권한이 너무 넓음: chmod 600 실행 후 재시도. 동기화되는 클라우드 드라이브 폴더에 두지 마세요
VNC는 연결되나 화면이 검게 나옴 SSH 로그인 후 who로 세션 확인 활성 그래픽 세션 없음: Portal에서 "화면 깨우기" 클릭 또는 sudo caffeinate -u -t 5 실행
VNC 비밀번호 오류 메시지 SSH 로그인으로 비밀번호 유효성 확인 화면 공유는 SSH 키가 아닌 시스템 비밀번호를 사용함: passwd로 재설정 후 재연결
연결이 자주 끊김 ping -c 20 IP로 패킷 손실률 확인 장거리 회선 지연: 클라이언트에 ServerAliveInterval 30 추가 또는 더 가까운 노드로 전환
REMOTE HOST IDENTIFICATION HAS CHANGED Portal 호스트 상세 페이지에서 지문 확인 최근 재설치로 지문이 갱신됨: ssh-keygen -R IP로 기존 기록 삭제 후 재연결

문제 해결 전에 Portal 호스트 상세 페이지의 전원 및 네트워크 표시를 먼저 확인하세요. 호스트가 "재설치 중" 상태일 때는 위의 모든 접속 방식이 일시적으로 사용 불가한 것이 정상입니다.

System

시스템 및 환경: 재설치, 버전 전환, 사전 설치 목록

macOS 재설치

Portal → 호스트 상세 → "시스템 재설치"로 이동해 이미지를 선택한 후 확인하세요. 재설치는 전체 디스크를 포맷하며 평균 15분이 소요됩니다. 완료 후 새 호스트 지문과 초기 비밀번호가 메일로 발송됩니다. 재설치해도 IP는 변경되지 않고 추가 요금도 없습니다.

재설치 전에 데이터를 내보내거나 스냅샷을 만들어 두세요.

시스템 버전 전환

M4 기종은 macOS 13 / 14 / 15 세 가지 이미지를 제공합니다. M4 및 M4 Pro 기종은 하드웨어 제약으로 macOS 15 이상 이미지만 제공됩니다. 하드웨어가 지원하지 않는 버전으로는 재설치로도 다운그레이드할 수 없으니, 기종 선택 시 목표 Xcode의 시스템 요구 사항을 먼저 확인하세요.

기종별 사용 가능한 이미지 보기 →

Xcode 및 Homebrew 사전 설치

모든 이미지에는 Homebrew, Git, Xcode Command Line Tools가 기본 설치되어 있습니다. "개발 이미지"에는 최근 정식 버전 Xcode 두 개가 추가로 설치되어 있으며 xcode-select -s로 전환할 수 있습니다. 이전 버전이 필요하면 xcodes install로 직접 설치하세요. 데이터센터에서 이미지 소스까지 대역폭이 1Gbps라 Xcode 패키지 하나를 약 8분 안에 다운로드할 수 있습니다.

Xcode 라이선스 계약은 최초 사용 시 직접 동의해야 합니다.

CI/CD

CI/CD 연동: self-hosted 러너 등록

독점 전용 물리 서버은 가상화를 사용하지 않으며, 빌드 캐시와 시뮬레이터 상태가 작업 사이에도 유지되어 iOS 증분 빌드가 호스팅형 러너보다 보통 30% 이상 빠릅니다. 아래는 두 주요 플랫폼의 등록 요점입니다.

GitHub Actions

저장소 Settings → Actions → Runners에서 토큰을 발급받은 후, 호스트에 SSH로 접속해 아래 명령을 실행하세요:

mkdir actions-runner && cd actions-runner
curl -o runner.tar.gz -L \
  "$(gh api /repos/OWNER/REPO/actions/runners/downloads \
  --jq '.[]|select(.os=="osx" and .architecture=="arm64").download_url')"
tar xzf runner.tar.gz
./config.sh --url REPO_URL --token YOUR_TOKEN --labels macos,arm64
./svc.sh install && ./svc.sh start
  • ./svc.sh install로 LaunchDaemon으로 등록하면 재부팅 후 자동으로 다시 시작됩니다.
  • 워크플로에는 runs-on: [self-hosted, macos, arm64]를 지정하세요.
  • 단일 호스트는 동시 실행 1을 권장합니다. Xcode 빌드가 모든 코어를 사용할 때는 동시 실행이 오히려 느려집니다.

GitLab Runner

Homebrew로 설치한 후 프로젝트의 registration token으로 등록하세요. executor는 shell을 선택합니다:

brew install gitlab-runner
gitlab-runner register \
  --executor shell \
  --url GITLAB_URL --token YOUR_TOKEN \
  --tag-list "macos,arm64"
brew services start gitlab-runner
  • shell executor는 호스트에 설치된 Xcode와 서명 인증서를 그대로 사용하므로 컨테이너 오버헤드가 없습니다.
  • concurrent는 1로 유지하고, job에는 timeout을 설정해 멈춤 현상을 방지하세요.
  • 인증서와 provisioning profile은 CI 변수에 저장하고, 빌드 시 임시 키체인에 주입하는 것을 권장합니다.

빌드 팜 규모가 5대를 넘으면 대량 구매 할인가와 통합 관리 대시보드를 신청할 수 있습니다. 자세한 내용은 기업 및 대량 구매 채널을 참고하세요.

Billing

결제 및 요금 규정

결제 주기는 어떻게 계산되나요?

일일 결제는 개통 시점부터 시작되며 24시간마다 하루로 계산됩니다. 주/월/분기 결제는 선불 전체 기간으로 처리됩니다. 같은 달 내에서 일일 결제 누적 금액이 해당 기종의 월 요금(예: M4R M은 $99)에 도달하면 자동으로 상한이 적용되어 초과분은 청구되지 않습니다. 청구서와 사용 내역은 Portal → 결제 페이지에서 실시간으로 확인할 수 있습니다.

인보이스는 어떻게 발급받나요?

Portal → 결제 → "인보이스 신청"에서 상호명과 세금 정보를 입력해 제출하면, 전자 인보이스가 영업일 기준 3일 내 계정 이메일로 발송됩니다. 건별 또는 월별 통합 발행을 지원합니다. 종이 인보이스나 날인된 계약서가 필요한 기업 고객은 기업 채널을 이용하세요.

환불 조건은 무엇인가요?

일일 결제 주문은 개통 후 환불되지 않습니다. 월 이상 주기의 주문은 개통 72시간 이내에 전액 환불을 신청할 수 있습니다(악용 사례가 없어야 함). 72시간이 지나면 남은 전체 월 단위로 환산해 환불하며, 이미 사용한 월은 월 결제 단가로 계산합니다. M4Rent 측 장애로 인한 서비스 불가는 SLA 기준 크레딧으로 보상되며 환불 한도에 포함되지 않습니다.

만료 후 데이터는 얼마나 보관되나요?

주문 만료 후 호스트는 정지되며 데이터는 72시간 동안 보관됩니다. 이 기간 내에 재결제하면 그대로 복원됩니다. 72시간이 지나면 전체 디스크가 완전히 삭제되어 복구할 수 없습니다. 스냅샷도 호스트와 함께 보관되며 삭제 시 함께 제거됩니다. 중요한 데이터는 만료 전에 직접 내보내세요. 스냅샷은 보조 수단일 뿐 개인 백업을 대체할 수 없습니다.

업그레이드 시 차액은 어떻게 계산되나요?

Portal에서 업그레이드를 신청하면 목표 기종과 현재 기종의 일 평균 요금 차이 × 남은 일수로 차액이 청구되며, 데이터는 전체 디스크가 새 호스트로 마이그레이션됩니다. 마이그레이션 과정은 약 20분이면 다시 온라인 상태가 됩니다. 업그레이드만 지원하며, 다운그레이드는 만료 후 새로 주문해야 합니다. 요금대별 가격은 요금제 및 가격 페이지를 참고하세요.

Status

서비스 상태 및 최근 90일 가동률

실시간 상태는 5분마다 갱신되며, 상세 이벤트 타임라인은 Portal 상태 페이지에서 확인할 수 있습니다.

노드 지역 코드 현재 상태 최근 90일 가동률 모니터링 프로브 지연 중앙값
도쿄 JP 정상 운영 중 99.98% 34 ms
싱가포르 SG 정상 운영 중 99.97% 68 ms
홍콩 HK 정상 운영 중 99.95% 21 ms
실리콘밸리 US-W 정상 운영 중 99.99% 128 ms

가동률은 분 단위로 집계되며, 노드는 연중 365일 무중단 운영되고 계획된 정지는 없습니다. 월간 가동률 목표는 99.9%이며, 보상 규정은 서비스 약관을 참고하세요. 지연 시간은 전 세계 여러 지점 모니터링 프로브에서 해당 노드까지의 중앙값입니다.

SLA

티켓 및 응답 시간

30 min
영업일 티켓 첫 응답(GMT+8 9:00–24:00)
7×24
심각 장애 채널: 호스트 접속 불가, 노드 단위 중단, 연중무휴 접수
4 h
하드웨어 장애 복구 목표 시간, 전체 교체 및 데이터 마이그레이션 포함
등급 정의 첫 응답 시한 접수 시간대
P1 심각 호스트 접속 불가, 노드 단위 네트워크 중단, 데이터 위험 15 min 7×24
P2 높음 성능 저하가 뚜렷함, 특정 기능 사용 불가 30 min 근무 시간
P3 일반 이용 문의, 설정 지원, 결제 관련 문의 2 h 근무 시간

접수 방법: Portal 티켓 시스템(추천, 호스트 컨텍스트 자동 연결) 또는 이메일 support@m4rent.com. 세일즈 문의 및 기업 구매 관련 문의는 문의 페이지의 단계별 채널을 이용하면 더 빠른 응답을 받을 수 있습니다.

Docs

이 페이지에서 다루지 않은 내용이 있나요? 지식 베이스에 80개 이상의 문서가 있습니다

Portal에 로그인해 전체 지식 베이스를 확인하세요: 버전별 Xcode 호환성 매트릭스, 언어별 런타임 설치 가이드, 네트워크 및 보안 강화 매뉴얼까지 제품과 함께 실시간으로 업데이트됩니다.

Portal 지식 베이스 열기 Mac mini 바로 대여하기