본문으로 건너뛰기
Mac mini 서버 시작 가이드

서버를 받은 후

먼저 접속 정보를 확인한 다음 키 로그인과 첫 빌드를 진행하세요. 서버를 받은 순서에 맞춰 안내하므로 클라우드 Mac을 팀의 일상 업무에 바로 연결할 수 있습니다.

콘솔에서 접속 정보 확인 Mac mini 서버 일 단위 대여

전용 물리 서버를 단독으로 사용하며 가상 머신이 아닙니다. macOS 그래픽 인터페이스와 명령줄을 모두 사용할 수 있습니다.

주문부터 첫 연결까지

먼저 서버가 준비됐는지 확인하세요

주문 당일 개통됩니다. 일반적인 진행 시간은 총 약 4분입니다. 결제 확인과 서버 상태는 콘솔에 실시간 표시되는 정보를 기준으로 확인하고, 결제 후 같은 주문을 중복 생성하지 마세요.

  1. 1

    주문: 위치와 기간 선택

    싱가포르, 도쿄, 서울, 홍콩의 4개 위치 중 하나를 선택한 다음 일·주·월·분기 단위로 대여하세요. 모델, 추가 옵션, 만료일도 함께 확인하세요.

    약 1분
  2. 2

    결제: 주문 내역 보관

    USDT-TRC20 및 Visa / Mastercard / Amex(Stripe)만 지원하며 모든 결제는 USD로 처리됩니다. 실제 사용 가능한 결제 게이트웨이는 백엔드 응답을 기준으로 합니다.

    약 1분
  3. 3

    서버 준비: 시스템 초기화 대기

    물리 서버가 할당되고 시스템 준비가 완료된 후 연결을 시도하세요. 결제는 완료됐지만 인스턴스가 아직 준비 중이라면 먼저 상태를 확인하고, 준비가 덜 된 상태를 네트워크 장애로 오인하지 마세요.

    약 2분
  4. 4

    접속 정보 확인: 해당 서버 상세 정보 열기

    콘솔에 로그인해 인스턴스 목록으로 이동한 다음 이번 주문에 해당하는 서버 상세 정보를 여세요. 호스트 주소, SSH 포트, 사용자 이름을 확인하고 상세 페이지에 표시된 실제 정보를 기준으로 접속하세요. 연결 전에 서버 번호도 확인하세요.

    준비 완료 후 확인

총 약 4분. 결제 후에도 접속 정보를 확인할 수 없다면 콘솔에서 지원 티켓을 제출하고 주문 번호와 현재 상태를 첨부하세요. 전체 접속 정보, 개인 키, 결제 카드 정보는 공개 페이지에 올리지 마세요.

첫 연결하기

연결을 확인한 뒤 툴체인을 점검하세요

아래는 도쿄 서버를 예로 들어 SSH 로그인, SDK 확인, 아카이브, 업로드 순서에 따라 명령어 일부를 보여줍니다. 호스트 이름은 변수로 표시했으며 작업 디렉터리, scheme, fastlane 플로우 이름은 프로젝트에 맞게 바꾸세요. 성능 테스트나 실제 주문 로그가 아닙니다.

도쿄 서버 · 호스트 이름 YOUR_NODE_HOST · 명령어 및 출력 예시 
$ ssh -v -i ~/.ssh/minissh_ed25519 -p "$NODE_SSH_PORT" "$NODE_USER@$NODE_HOST"
debug1: Server host key: ssh-ed25519 SHA256:…
debug1: Authentication succeeded (publickey).
Authenticated using publickey.
Welcome to your Mac mini.

$ xcodebuild -showsdks
iOS SDKs:
    iOS -sdk iphoneos

$ xcodebuild -workspace App.xcworkspace -scheme App -archivePath build/App.xcarchive archive
** ARCHIVE SUCCEEDED **

$ fastlane upload
Uploading build to App Store Connect
Upload complete

첫 SSH 연결: 먼저 NODE_HOST, NODE_USER 와 NODE_SSH_PORT 를 서버 상세 정보에 표시된 값으로 설정하세요. 처음 연결할 때는 호스트 지문을 확인하세요. 지문을 확인할 수 없다면 지원 티켓으로 먼저 문의하고 호스트 신원 확인을 무시하지 마세요.

첫 빌드: 먼저 xcodebuild -version 및 xcodebuild -showsdks를 실행해 현재 툴체인을 기록하세요. 프로젝트 종속성, 서명 자료, 빌드 설정을 준비한 뒤 아카이브를 실행하세요. fastlane upload 는 프로젝트에 해당 플로우가 정의되어 있고 업로드 권한이 설정된 경우에만 사용할 수 있습니다.

완료 지점 확인: SSH 연결에 성공했다고 프로젝트를 빌드할 수 있는 것은 아니며, 아카이브에 성공했다고 업로드까지 완료된 것도 아닙니다. 연결, 아카이브, 업로드 각 단계의 결과를 따로 저장하면 문제 해결 시 어느 단계에서 멈췄는지 파악하기 쉽습니다.

연결 보안

키를 먼저 확인하고 비밀번호 인증은 끄세요

각 사용자에게 개별 공개 키를 할당하고 팀 전체에 같은 개인 키를 공유하지 마세요. 인증 설정을 변경할 때는 현재 세션을 유지하고, 두 번째 터미널에서 새 연결이 되는지 확인한 뒤 기존 세션을 종료하세요.

  1. 01

    로컬에서 키 생성

    내 컴퓨터에서 아래 명령어를 실행하고 개인 키에 암호를 설정하세요. 업로드하거나 배포할 수 있는 것은 .pub 공개 키 파일뿐입니다. 확장자가 없는 개인 키는 항상 로컬에 보관하세요.

    ssh-keygen -t ed25519 -f ~/.ssh/minissh_ed25519
  2. 02

    공개 키 업로드 및 테스트

    공개 키를 서버의 대상 사용자 계정에 있는 ~/.ssh/authorized_keys에 추가하세요. 키마다 한 줄씩 입력합니다. 이미 검증된 연결을 통해 전송한 다음 디렉터리와 파일 권한을 확인할 수 있습니다.

    chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

    다른 터미널을 열고 개인 키를 명시해 로그인을 테스트하세요. 올바른 사용자와 서버에 접속했는지 확인한 뒤 인증 설정을 변경하세요.

  3. 03

    비밀번호 인증 끄기

    관리 권한이 있는 담당자가 SSH 서비스의 유효 설정을 확인하고 PasswordAuthentication 와 KbdInteractiveAuthentication 을 no로 설정해야 합니다. 변경 후 구문과 최종 적용값을 확인해 다른 설정이 덮어쓰지 않았는지 점검하세요.

    sudo /usr/sbin/sshd -t
sudo /usr/sbin/sshd -T | grep -E 'passwordauthentication|kbdinteractiveauthentication'

    현재 시스템의 서비스 관리 방식에 따라 설정을 적용한 뒤 새 연결을 다시 테스트하세요. 설정이 확실하지 않다면 지원 티켓을 먼저 제출하고, 유일하게 사용할 수 있는 세션에서 바로 서비스를 재시작하거나 원격 로그인을 끄지 마세요.

  4. 04

    터널을 통한 데스크톱 연결

    서버의 화면 공유 서비스와 해당 사용자 권한이 설정됐는지 확인한 뒤 로컬에서 SSH 터널을 만드세요. 예시에서는 로컬 15900 포트를 서버의 루프백 주소에 있는 5900 포트로 전달합니다. 로컬 네트워크에는 리스닝 포트를 열지 않습니다.

    ssh -N -o ExitOnForwardFailure=yes -L 127.0.0.1:15900:127.0.0.1:5900 -i ~/.ssh/minissh_ed25519 -p "$NODE_SSH_PORT" "$NODE_USER@$NODE_HOST"

    그런 다음 로컬 데스크톱 클라이언트에서 127.0.0.1:15900에 연결하세요. 터널을 실행한 터미널을 닫으면 연결도 끊깁니다. SSH는 연결되지만 데스크톱 연결에 실패하면 데스크톱 포트를 직접 공개하지 말고 서버의 화면 공유 서비스를 먼저 확인하세요.

시차 협업

한 대를 함께 써도 계정은 공유하지 마세요

전용 서버란 물리 서버를 단독으로 사용한다는 뜻이지, 여러 사용자의 작업이 자동으로 격리된다는 의미는 아닙니다. 북미와 아시아·태평양 팀원이 Mac mini 서버를 함께 쓴다면 계정을 분리하고 빌드 시간을 조율한 뒤 인수인계 내용을 명확히 기록하세요.

팀원별 계정 사용

팀원마다 macOS 사용자를 만들고 각자의 공개 키만 등록하세요. 일상적인 개발에는 일반 권한을 사용하고 시스템 수준 변경은 지정된 관리자가 처리하세요.

팀원이 팀을 떠나면 해당 권한을 삭제하고 빌드 도구에 저장된 액세스 토큰도 확인하세요. 공유 비밀번호만 바꾸는 것으로 끝내지 마세요.

인수인계 항목: 사용자, 키, 관리자 담당자

대규모 작업은 시간대를 나눠 실행

빌드 시간에 사용할 시간대를 먼저 정하세요. 아시아·태평양 팀원이 아카이브를 시작하기 전에 북미 동료의 작업이 아직 실행 중인지 확인하세요. 대규모 아카이브, 종속성 설치, 시스템 업그레이드를 동시에 진행하지 않는 것이 좋습니다.

프로젝트 디렉터리와 출력 디렉터리를 사용자별 또는 브랜치별로 분리해 두 사람이 같은 빌드 결과물을 삭제하지 않도록 하세요.

인수인계 항목: 작업 담당자, 시작·종료 시간, 출력 경로

환경과 작업 결과 기록

교대 전에 코드 버전, Xcode 버전, 실행한 명령어와 종료 결과를 기록하세요. 툴체인을 변경해야 한다면 다음 시간대 팀원에게 미리 알려 교대 후 환경이 바뀐 사실을 뒤늦게 알지 않도록 하세요.

지역 간 데스크톱 연결은 각자의 네트워크 환경에 영향을 받습니다. 장시간 작업은 SSH로 실행하고 다시 확인할 수 있는 빌드 로그를 보관하세요.

인수인계 항목: 버전, 명령어, 로그, 미해결 문제
대여 기간을 프로젝트 일정에 반영

성수기에는 한 대 더, 종료 전에 데이터 백업

상시 작업과 임시 작업은 나눠 진행할 수 있습니다. 새 서버는 별도의 대여 건이므로 기존 서버의 코드, 종속성, 키, 빌드 결과물이 자동으로 복사되지 않습니다. 먼저 환경을 준비한 뒤 작업을 분산하세요.

  1. 01

    같은 프로젝트용 서버 추가 대여

    주문 페이지에서 서버를 추가하고 실제 작업 기간에 맞춰 일·주·월·분기 단위로 선택하세요. 두 가지 모델은 MiniSSH M4 Core(M4 / 16GB RAM / 256GB SSD)와 MiniSSH M4 Plus(M4 / 24GB RAM / 512GB SSD)입니다. 전체 가격과 추가 옵션은 요금제 페이지에서 확인하세요.

  2. 02

    임시 작업을 새 서버로 이전

    프로젝트에 필요한 코드와 종속성을 동기화하고 새 서버의 접근 권한을 별도로 설정하세요. 반복 가능한 빌드를 한 번 실행해 결과물을 가져올 수 있는지 확인한 후 브랜치나 일괄 작업을 추가하세요. 유일한 백업을 임시 서버에만 보관하지 마세요.

  3. 03

    만료 후 자동 갱신되지 않도록 확인

    콘솔에서 임시 서버의 만료일을 확인하고 해당 서버를 갱신하지 마세요. 자동 갱신 설정이 표시된다면 꺼져 있는지 확인하세요. 만료 후에는 자동으로 서비스가 중단되며 별도의 해지 수수료는 없습니다. 만료 전에 결과물과 로그를 내보내고 액세스 토큰을 폐기해 서버 회수 후 파일을 찾느라 애쓰지 않도록 하세요.

프로젝트용 서버 추가 대여 모델 및 기간별 요금 확인
문제 해결

상태를 보존한 뒤 지원 티켓 제출

서버는 연중 365일 운영됩니다. 문제가 발생하면 콘솔에서 지원 티켓을 제출하고 같은 티켓에 진행 상황을 추가하세요. 연속으로 재설치하거나 설정을 반복해서 바꾸거나 다시 결제하면 문제 상황을 파악하기 더 어려워질 수 있습니다.

문제 상황 먼저 확인할 항목 티켓에 첨부할 내용
SSH에 연결할 수 없음 서버가 준비됐는지, 주소·포트·사용자 이름이 상세 정보와 일치하는지, 오류가 시간 초과·연결 거부·인증 실패 중 무엇인지 확인하세요. 전체 오류 유형을 기록해 두세요. 서버 번호, 위치, 문제 시작 시각과 시간대, 접속한 네트워크, 민감한 정보를 제거한 SSH 오류 출력
빌드가 멈추거나 실패함 디스크 공간, 같은 서버에서 실행 중인 다른 작업, 최근 툴체인이나 종속성을 변경했는지 확인하세요. 새 로그가 없는 상태와 프로세스가 실제로 종료된 상태를 구분하세요. 실행 명령어, Xcode 버전, 시작 시각, 마지막 로그 일부, 종료 코드, 문제가 안정적으로 재현되는지 여부
시스템 재설치가 필요함 먼저 코드, 빌드 결과물, 필요한 설정을 백업하고 유지하거나 다시 준비할 환경을 기록하세요. 재설치하면 서버에 있는 기존 데이터에 영향을 줍니다. 서버 번호, 재설치 사유, 백업 완료 여부, 작업 가능한 시간대. 티켓에서 작업 범위를 확인한 뒤 일정을 잡으세요.
결제 또는 갱신 관련 문의 먼저 해당 주문과 청구 상태를 확인하고 이번 작업이 어느 서버에 해당하는지 살펴 중복 결제를 피하세요. 주문 번호. USDT-TRC20 결제는 거래 해시를 첨부하고, Stripe 카드 결제는 주문 번호와 화면에 표시된 오류를 첨부하세요. 전체 카드 번호는 보내지 마세요.

시간대를 명확히 적으세요: “현지 시각 14:30, UTC+8”처럼 작성하면 “오후에 연결이 안 됨”이라고만 쓰는 것보다 확인하기 쉽습니다. 아시아·태평양과 북미에 걸쳐 있는 팀이라면 연락하기 편한 시간대도 알려주세요.

진행 상황은 기존 티켓에서 확인하세요: 콘솔에 로그인해 티켓 목록으로 이동한 뒤 해당 기록을 열어 답변을 확인하고 자료를 추가하세요. 로그인할 수 없다면 support@minissh.com으로 이메일을 보내 계정 이메일과 관련 주문 번호를 알려주세요. 비밀번호나 개인 키는 보내지 마세요.

콘솔에 로그인해 지원 티켓 제출 문의 방법 및 제출 자료 안내
계속 읽기

현재 작업에 필요한 다음 단계

자세한 안내가 필요하다면 기술 문서 목록에서 아래 세 가지 주제를 확인하세요. 이 페이지의 명령어는 작업 순서를 설명하기 위한 예시이며 실제 프로젝트의 디렉터리, 권한, 도구 버전은 사용 환경에 맞게 확인해야 합니다.

  • 원격 개발 환경 설정

    계정 분리, 프로젝트 디렉터리, 종속성 준비, 시차 인수인계를 확인하세요. 먼저 반복 가능한 개발 환경을 만든 뒤 다른 팀원을 연결하세요.

  • SSH 터널 및 접속 보안

    공개 키 인증, 비밀번호 인증 설정 변경, 로컬 포트 포워딩을 확인하세요. 보안 설정을 변경하기 전에는 검증된 연결을 항상 하나 유지하세요.

  • Xcode 클라우드 빌드

    SDK 확인, archive 옵션, fastlane 플로우를 확인하세요. 아카이브와 업로드를 각각 검증하고 한 번의 성공으로 전체 과정이 안정적이라고 판단하지 마세요.

기술 문서 목록에서 더 읽기

준비가 끝났다면 첫 서버부터 시작하세요

일 단위로 대여할 수 있으며 시작 가격은 하루 $20.8입니다. 이미 서버를 사용 중이라면 콘솔로 돌아가 접속 정보를 확인하세요. 아직 주문하지 않았다면 프로젝트 기간에 맞춰 서버를 선택하세요.

Mac mini 서버 일 단위 대여 콘솔에 로그인해 서버 확인