1. 클라우드 서버
  2. 이용 지원
04 Support

SSH 접속, Xcode 빌드와 Runner 설정: 자가 진단 지원 문서

먼저 문서를 확인한 뒤 티켓을 남겨주세요. 접속, 서명, VNC 이 세 가지 자주 발생하는 문제는 대부분 이 페이지에서 10분 안에 직접 해결할 수 있습니다. 해결되지 않는다면 페이지 하단에서 엔지니어가 한 번에 이해할 수 있는 티켓 작성법을 안내합니다.

Quick Start

빠르게 시작하는 3단계

주문 후 평균 5분이면 접속 정보 이메일이 도착합니다. 아래 3단계만 따라 하면 첫 접속까지 3분이 채 걸리지 않습니다.

01

접속 정보 이메일 수신

이메일에는 노드 주소(예: hk1.oncemini.com), SSH 포트 22, 초기 계정 dev, 초기 비밀번호와 VNC 비밀번호가 담겨 있습니다. 메일이 오지 않았다면 먼저 스팸 메일함을 확인하고, 그다음 콘솔의 인스턴스 상세 페이지에서 확인하세요.

02

SSH 최초 로그인 후 비밀번호 변경

ssh -p 22 dev@노드 주소를 실행해 로그인한 뒤, 바로 passwd로 초기 비밀번호를 변경하세요. 이어서 ssh-copy-id로 공개 키를 업로드하고 비밀번호 로그인을 비활성화하는 것을 권장합니다.

03

VNC로 그래픽 화면 접속

macOS 기본 화면 공유 또는 원하는 VNC 클라이언트로 노드 주소:5900에 접속해 VNC 비밀번호를 입력하면 완전한 macOS 데스크톱 화면이 나타납니다. Xcode 최초 페어링, 시스템 팝업 승인 등이 모두 여기서 이루어집니다.

인도 즉시 root 권한 포함: sudo를 어디서나 사용할 수 있어 시스템 설정을 자유롭게 변경할 수 있습니다. 잘못 건드려도 걱정 없습니다 — 콘솔에서 언제든 macOS를 직접 재설치할 수 있습니다. 아래 가이드를 참고하세요.
Terminal

로그인부터 업로드까지: 한 번에 이어지는 흐름

다음은 홍콩 노드 Mini M(M4 / 24GB)에서의 실제 출력 일부입니다: SSH 로그인, Xcode 빌드, fastlane을 통한 App Store Connect 업로드까지. 오른쪽 명령어는 그대로 복사해서 사용할 수 있습니다.

dev@mini-hk1 — zsh — 96×28
ssh -p 22 dev@hk1.oncemini.com
Last login: Mon Jul 27 09:12:33 2026 from 203.0.113.24
sw_vers
ProductName:    macOS
ProductVersion: 15.5
BuildVersion:   24F74
xcodebuild -scheme App -configuration Release -destination 'generic/platform=iOS' build
▸ Compiling AppDelegate.swift
▸ Linking App
▸ Signing App.app
** BUILD SUCCEEDED ** [128.4s]
bundle exec fastlane release
[10:24:08] Login to App Store Connect (API key)
[10:26:41] Upload progress: 100%
Successfully uploaded package to App Store Connect
dev@mini-hk1 ~ % 

자주 쓰는 명령어 · 클릭해서 복사

ssh -p 22 dev@hk1.oncemini.com
passwd
ssh-copy-id -i ~/.ssh/id_ed25519.pub dev@hk1.oncemini.com
sudo xcode-select -s /Applications/Xcode_16.4.app
xcodebuild -scheme App -configuration Release build
security unlock-keychain login.keychain-db

hk1을 사용 중인 노드 접두어로 바꾸면 됩니다. 각 노드의 도메인은 노드 분포에서 확인하세요. 로컬에서 문제없이 동작하는 CI 스크립트는 그대로 올려도 그대로 실행됩니다.

Guides

자주 찾는 작업 가이드

가장 많이 묻는 네 가지 작업입니다. 순서대로 따라 하면 됩니다. 모든 가이드는 실제 장비에서 검증을 마쳤습니다.

다중 버전 Xcode와 전환

  1. 인도되는 이미지에는 안정 버전 Xcode 두 개가 미리 설치되어 있으며, 버전 번호에 따라 /Applications/Xcode_16.4.app, /Applications/Xcode_15.4.app에 위치합니다.
  2. 현재 활성 버전 확인: xcodebuild -version.
  3. 전역 전환: sudo xcode-select -s /Applications/Xcode_15.4.app.
  4. CI에서는 전역 설정을 바꾸지 말고, 환경 변수로 해당 작업에만 지정하세요: DEVELOPER_DIR=/Applications/Xcode_16.4.app xcodebuild ….
  5. 다른 버전(베타 포함)이 필요하면 버전 번호를 명시해 티켓을 남겨주세요. 사전 설치 라이브러리는 15.0 이후 모든 정식 버전을 포함하며, 업무 시간 내라면 보통 2시간 안에 장비에 반영됩니다.

GitHub Actions self-hosted runner 설정

  1. 저장소 Settings → Actions → Runners → New self-hosted runner에서 시스템은 macOS, 아키텍처는 ARM64를 선택하세요.
  2. 안내된 명령어로 runner 패키지를 다운로드하고 압축을 해제한 뒤 ./config.sh --url … --token …를 실행해 등록을 완료하세요.
  3. 상시 서비스로 등록: ./svc.sh install && ./svc.sh start. 재부팅 후에도 launchd가 자동으로 다시 실행합니다.
  4. 워크플로에는 runs-on: [self-hosted, macOS, ARM64]를 지정하세요. 여러 대를 운용한다면 커스텀 label로 구분하는 것을 권장합니다.
  5. 동시 실행 참고치: Mini M(24GB)은 동시 작업(job) 2개를 안정적으로 처리합니다. 더 높은 동시성이 필요하면 Mini Pro(64GB)를 선택하세요. 자세한 내용은 요금제 안내를 참고하세요.

실제 기기 원격 디버깅 연결

  1. 테스트용 iPhone과 클라우드 Mac이 같은 네트워크에 있지 않다면, WireGuard 같은 네트워킹 도구로 기기와 호스트를 같은 대역으로 묶으세요.
  2. 최초 페어링은 Xcode의 Devices and Simulators 창에서 진행하며, VNC 그래픽 화면으로 한 번만 조작하면 됩니다.
  3. 페어링 시 네트워크 디버깅을 체크하면, 이후 xcodebuild -destination 'platform=iOS,name=기기 이름'으로 실제 기기를 바로 지정할 수 있습니다.
  4. 유닛 테스트나 시뮬레이터 UI 테스트만 실행한다면 실제 기기가 필요 없으며, 인도 즉시 사용 가능하고 별도의 네트워킹 작업도 필요하지 않습니다.

macOS 재설치

  1. 콘솔 로그인 → 인스턴스 상세 → 시스템 재설치에서 macOS 14 / 15 두 가지 메이저 버전 중 선택할 수 있습니다.
  2. 재설치하면 디스크 전체가 초기화되며 복구할 수 없으니, 먼저 콘솔에서 스냅샷을 다운로드한 뒤 진행하세요.
  3. 전 과정 셀프 서비스이며 평균 10분 안에 로그인 대기 상태로 복귀합니다. 새 접속 정보는 자동으로 재발급되어 이메일로 다시 전송됩니다.
  4. 횟수 제한 없고 추가 비용도 없습니다. 시스템이 망가졌을 때, 메이저 버전을 바꾸고 싶을 때, 해지 전에 디스크를 직접 비우고 싶을 때 모두 이 방법을 사용하면 됩니다.
Glossary

용어 미니 사전

문서와 티켓에서 자주 등장하는 여덟 가지 용어를 정리했습니다. 기준을 통일해 서로 다른 의미로 이해하는 일을 줄입니다.

전용 물리 서버
물리적인 Mac mini 한 대를 그대로 제공하며, OS가 실제 하드웨어에서 직접 구동됩니다. 가상화 계층이 없어 성능 손실이 전혀 없습니다.
전용(독점)
한 대의 장비는 동시에 한 명의 사용자에게만 속합니다. CPU, 메모리, SSD, 1Gbps 대역폭 모두 다른 사용자와 나눠 쓰지 않습니다.
VNC
원격 그래픽 화면 프로토콜입니다. 접속하면 완전한 macOS 데스크톱이 그대로 보이며, 기기 페어링이나 시스템 팝업 처리 모두 이를 통해 이루어집니다.
self-hosted runner
여러분의 장비에 직접 등록하는 CI 실행기입니다. GitHub Actions / GitLab CI의 macOS 작업이 이 Mac에서 바로 실행되어 공용 대기열을 거치지 않습니다.
통합 메모리(Unified Memory)
Apple Silicon의 CPU와 GPU가 하나의 메모리 풀을 공유하는 방식입니다. 64GB 모델은 별도 VRAM 제한 없이 대용량 양자화 모델을 바로 불러올 수 있습니다.
Apple Silicon
Apple이 자체 설계한 ARM 아키텍처 칩입니다(본 서비스는 M4 / M4 Pro 탑재). iOS 실기기 빌드, MLX와 CoreML 실험 모두 이 칩을 네이티브 대상으로 합니다.
스냅샷
디스크 전체 데이터를 패키징한 이미지입니다. 콘솔에서 언제든 생성해 로컬로 내려받을 수 있으며, 재설치·해지·노드 이동 전의 안전장치 역할을 합니다.
SLA
서비스 가동률 약속으로, 본 서비스는 99.9%입니다. 기준 미달 시 정해진 방식으로 보상하며 자세한 내용은 보안 및 신뢰 정책에서 확인할 수 있습니다.
Troubleshoot

장애 자가 점검 체크리스트

세 가지 유형의 문제가 전체 티켓의 약 70%를 차지합니다. 순서대로 확인하면 대부분 2~3단계에서 원인을 찾을 수 있습니다.

SSH 접속이 안 될 때

  1. 콘솔에서 인스턴스 상태가 running인지, 전원 표시가 정상인지 확인하세요.
  2. 로컬에서 ping / mtr으로 노드 도메인을 확인하세요. 패킷 손실이 크다면 먼저 네트워크를 바꿔보거나, 노드 분포 페이지의 테스트 IP로 회선을 다시 확인하세요.
  3. 포트 22와 사용자 이름 dev를 다시 확인하고, ssh -v로 핸드셰이크가 어디서 멈추는지 확인하세요.
  4. 직접 수정한 sshd_config 때문에 접속이 막혔다면, 콘솔에서 강제 재시작 후 VNC로 데스크톱에 접속해 설정을 되돌리세요.
  5. 여전히 안 된다면 ssh -vvv의 전체 출력을 티켓에 첨부해주세요.

빌드 서명 오류

  1. errSecInternalComponent 또는 키체인 접근 오류: 먼저 security unlock-keychain login.keychain-db를 실행하세요.
  2. CI 세션은 기본적으로 키체인이 잠긴 상태입니다. 스크립트 앞부분에 잠금 해제 명령을 추가하거나, fastlane match로 인증서를 관리하는 방식으로 바꾸세요.
  3. 인증서가 제대로 임포트되었는지 확인: security find-identity -v -p codesigning을 실행하면 서명 아이덴티티가 목록에 나와야 합니다.
  4. unsupported SDK 오류는 대부분 Xcode 버전이 맞지 않는 경우입니다. 위의 가이드대로 버전을 전환한 뒤 다시 시도하세요.

VNC 화면이 검게 나올 때

  1. 먼저 SSH로 접속해 보세요. 로그인이 된다면 시스템은 정상이고 화면 공유 서비스만 문제인 것이니 바로 재설치하지 마세요.
  2. SSH에서 화면 공유 서비스를 재시작: sudo launchctl kickstart -k system/com.apple.screensharing.
  3. 해상도가 너무 높으면 검은 화면이나 화면 깨짐이 생길 수 있습니다. 클라이언트 해상도를 1920×1080으로 낮춰 다시 접속하세요.
  4. 그래도 안 되면 콘솔에서 인스턴스를 재시작하세요. 호스트에는 가상 디스플레이가 기본 탑재되어 있어 재시작 후 화면이 바로 복구됩니다.
Tickets

티켓과 응답 시간

지원팀은 UTC+8과 UTC-8 두 시간대로 교대 근무합니다. 채널은 콘솔 티켓과 지원 이메일 두 가지뿐이며, 전화나 실시간 채팅은 제공하지 않습니다.

콘솔 티켓(우선 권장)

경로: 콘솔 로그인 → 티켓 → 새로 만들기에서 연관된 인스턴스를 선택하세요. 티켓에 인스턴스 정보가 자동으로 첨부되어 처리 속도가 가장 빠릅니다. 적합한 경우: 인스턴스 장애, Xcode 버전 요청, 사양 변경, 재설치 지원.

  • 인스턴스 ID, 노드, 문제 발생 시각을 명확히 적어주세요
  • 전체 명령어와 오류 출력은 텍스트로 첨부하고, 스크린샷 대신 텍스트를 사용하세요
  • 이 페이지의 체크리스트대로 확인한 단계를 나열해 주고받는 시간을 줄이세요

지원 이메일

콘솔에 로그인이 안 될 때, 결제/인보이스 문제, 주문 전 기술 문의는 support@oncemini.com으로 메일을 보내주세요. 제목에 주제를 명확히 적고, 본문에 가입 이메일을 함께 적어주시면 계정 확인이 쉬워집니다.

  • 가입한 이메일로 발송하면 별도의 신원 확인 절차를 줄일 수 있습니다
  • 더 많은 문의 방법과 작성 예시는 문의하기에서 확인하세요
문제 유형 첫 응답 시간 지원 시간 권장 채널
긴급 장애(인스턴스 다운, 완전 접속 불가) 30분 7×24 콘솔 티켓, 긴급 표시
일반 기술 문제(빌드, 설정, 성능) 2시간 업무 시간(UTC+8 / UTC-8 교대) 콘솔 티켓
결제, 인보이스, 주문 전 문의 1영업일 업무 시간 support@oncemini.com
Uptime

가동 현황과 알림 정책

FAQ

결제 및 계정 관련 자주 묻는 질문

접속과 빌드 관련 문제는 위 내용을 참고하시고, 여기서는 결제와 데이터에 관한 질문에 답합니다. 가격 상세는 요금제 안내에서 확인하세요.

요금 계산은 언제부터 시작되나요?

접속 정보 이메일이 도착한 시점부터 계산되며, 주문 시점이 아닙니다. 일 단위 요금제는 24시간을 하루로 계산하며, 평균 5분 소요되는 인도 시간은 요금에 포함되지 않습니다.

갱신은 어떻게 하나요? 자동으로 결제되나요?

콘솔의 인스턴스 상세 페이지에서 언제든 직접 갱신할 수 있으며, 자동 갱신 옵션도 켤 수 있습니다. 만료 72시간 전과 24시간 전에 각각 안내 이메일이 발송됩니다. 자동 갱신이 실패하면(예: 카드 만료) 즉시 이메일로 안내드리며 72시간의 여유 시간을 드립니다.

만료 후 갱신하지 않으면 데이터가 바로 삭제되나요?

아니요. 만료되면 인스턴스는 먼저 정지되고, 데이터는 72시간 동안 보관됩니다. 이 기간 안에 갱신하면 원래 상태로 그대로 복구됩니다. 72시간이 지나면 APFS 암호화 볼륨의 키를 폐기하고 전체 덮어쓰기를 진행해 복구가 불가능해집니다. 자세한 절차는 보안 및 신뢰 정책에서 확인할 수 있습니다.

이전 장비의 데이터를 새 장비로 옮기려면 어떻게 하나요?

두 장비 모두 이용 기간 내에 있다면 장비 간 직접 동기화가 가장 빠릅니다: rsync -avz -e "ssh -p 22" ~/work/ dev@새 노드:~/work/. 같은 지역 노드 간 내부 네트워크는 기가비트 속도로 전송할 수 있습니다. 콘솔에서 스냅샷을 로컬로 먼저 내려받은 뒤 새 장비에 복원하는 방법도 가능합니다.

어떤 결제 수단을 지원하나요?

전체 사이트는 미국 달러(USD)로 결제됩니다. USDT-TRC20와 Visa / Mastercard / Amex(Stripe)를 사용할 수 있으며, 정확한 결제 수단은 portal 결제 페이지에 표시된 내용을 기준으로 합니다. 숨겨진 트래픽 요금은 없으며, 청구 금액은 요금제 표시 가격과 동일합니다.

인보이스 발급이 가능한가요?

결제할 때마다 PDF 영수증이 자동으로 생성되며, 콘솔의 결제 내역 페이지에서 언제든 다운로드할 수 있습니다. 회사명이나 사업자 등록 정보를 추가해야 한다면 support@oncemini.com으로 메일을 보내주세요. 1영업일 내에 처리됩니다.

이용 중에 사양을 업그레이드하면 요금은 어떻게 계산되나요?

업그레이드 요금은 남은 이용 기간에 대한 차액만 정산하며, 중복으로 청구하지 않습니다. 콘솔에서 업그레이드 요청을 제출하면 스냅샷을 통해 데이터가 새 사양으로 옮겨지며, 그 기간에도 기존 장비는 계속 사용할 수 있습니다. 다운그레이드는 현재 결제 주기가 끝난 뒤에 적용됩니다.

첫 주문이 마음에 들지 않으면 환불받을 수 있나요?

첫 주문은 인도 후 24시간 이내에 전액 환불을 요청할 수 있으며, 갱신된 이용 기간은 환불되지 않습니다. 먼저 일 단위 요금 $19.9로 하루 이용해 보면서 직접 빌드 스크립트를 실행해 보고 월간 이용 여부를 결정하는 것을 권장합니다.

macOS 재설치는 유료인가요? 횟수 제한이 있나요?

무료이며 횟수 제한도 없습니다. 전 과정 콘솔에서 직접 진행할 수 있고 평균 10분이면 완료됩니다. 유일하게 주의할 점은 재설치 시 디스크 전체가 초기화되므로 먼저 스냅샷을 내려받아야 한다는 것입니다.

한 계정으로 여러 대를 이용할 수 있나요? 다른 사람에게 재임대할 수 있나요?

한 계정으로 여러 대를 동시에 이용할 수 있습니다. 팀에서는 보통 프로젝트별로 한 대씩 임대하고 label로 runner를 구분하는 방식을 사용합니다. 제3자에게 재임대하거나 되파는 행위는 서비스 약관 위반이며 확인되면 서비스가 종료됩니다. 다만 팀 내부에서 같은 장비를 여러 명이 함께 쓰는 것은 제한하지 않습니다.

$ oncemini ticket new --priority normal

문서에서 해결되지 않는 문제가 있나요?

콘솔에 로그인해 티켓을 제출하시면 업무 시간 기준 2시간 안에 답변드립니다. 아직 장비가 없다면 먼저 일 단위로 한 대 대여해 사용해 보세요.