작업별 문제 해결 가이드

오류 메시지에서 실행 가능한 점검 항목까지

개통, 연결, 개발 툴체인, 스토리지 및 청구 작업별로 문제를 찾아보세요. 각 경로에는 점검 순서, 검증 명령 및 보관해야 할 진단 정보가 포함되어 있으며, HireAMac 전용 Apple Silicon 물리 노드에 적용됩니다.

콘솔에서 지원 요청 제출 원격 액세스 가이드 보기

진단 흐름 준비 완료

01 문제 범위 확인 연결 / 빌드 / 스토리지 / 청구

02 검증 결과 기록 노드, 시간, 명령 및 비식별화 로그

03 단일 변수 재테스트 실행 한 번에 하나의 조건만 변경

빠른 검색

오류 메시지, 명령 또는 청구 항목을 입력하세요.

연결 시간 초과, 인증 정보, Xcode, Swift, CI Runner, SSD, 주문 기간 등의 키워드를 검색할 수 있습니다. 검색은 이 페이지의 가이드만 필터링하며 입력 내용은 업로드하지 않습니다.

문제 키워드

현재 6개의 도움말 주제가 표시됩니다.

인기 작업 첫 개통 연결 시간 초과 Xcode 검증 데이터 내보내기 청구서 확인 지원 요청 준비

처음 사용하기

4가지 점검 항목으로 첫 빌드를 완료하세요.

먼저 노드와 액세스 조건을 확인한 다음 시스템과 빌드 도구를 검증하세요. 연결이 안정되기 전에 인증 정보, 클라이언트 및 툴체인을 동시에 변경하지 마세요.

01
콘솔에서 노드 정보 확인

주문에 해당하는 인스턴스 세부 정보에서 모델, 리전, 연결 주소 및 현재 세션 상태를 기록하세요. 판매 중인 세 가지 구성은 HireAMac M4 S（M4、16GB、256GB）, HireAMac M4 M（M4、24GB、512GB）및 HireAMac M4 Pro L（M4 Pro、64GB、2TB）입니다. 리전은 싱가포르, 일본（도쿄）, 한국（서울）, 홍콩 또는 미국 동부 중 하나여야 합니다.
- 주문 식별자와 인스턴스 세부 정보가 일치합니다.
- 연결 주소는 현재 인스턴스에서 확인하고 이전 주문 기록을 재사용하지 않습니다.
- 지원 요청이 필요한 경우 필요한 항목만 기록하고 액세스 키는 복사하지 않습니다.
02

액세스 인증 정보 설정 및 별도 검증

콘솔에서 제공하는 방법으로 강력한 인증 정보를 설정하고, 관리되는 비밀번호 관리자나 보안 키 저장소에 보관하세요. 처음 연결할 때는 로그인만 확인하고 프로젝트 업로드, 의존성 설치 또는 장시간 작업 실행은 나중에 진행하세요. 팀으로 작업할 때는 구성원에게 꼭 필요한 최소 권한만 부여하고 프로젝트에서 나간 구성원의 액세스 권한은 즉시 취소하세요.
03
macOS 및 명령줄 환경 검증

그래픽 데스크톱에 정상적으로 접속한 후 터미널에서 다음 읽기 전용 명령을 실행하세요. 민감한 디렉터리나 인증 정보가 포함된 전체 데스크톱을 캡처할 필요 없이 텍스트 출력만 보관하면 됩니다.
```
sw_vers
uname -m
xcode-select -p
xcrun swift --version
xcodebuild -version
```
예상 아키텍처는 Apple Silicon에 해당하는 arm64입니다. xcode-select -p 유효한 개발자 디렉터리를 반환하지 않으면 먼저 명령줄 도구 경로를 설정한 다음 빌드 검증을 계속하세요.
04
폐기 가능한 최소 빌드 작업 실행

프로덕션 인증 정보가 없는 소규모 프로젝트를 선택해 먼저 의존성을 해결한 다음 클린 빌드를 한 번 실행하세요. 종료 코드, 산출물 디렉터리, 남은 디스크 공간 및 빌드 로그를 확인하세요. 최소 작업이 성공한 후 대규모 저장소, 캐시 및 자동화 흐름을 마이그레이션하면 환경 문제와 프로젝트 문제를 분리하기 쉽습니다.
```
df -h /
xcodebuild -project Sample.xcodeproj -scheme Sample -showBuildSettings
xcodebuild -project Sample.xcodeproj -scheme Sample clean build
```

완료 기준: 노드 정보 확인, 인증 정보 사용 가능, 시스템 및 도구 버전 조회, 최소 빌드의 명확한 결과 반환이 모두 완료되어야 합니다. 어느 단계에서든 실패하면 해당 계층에서 문제를 해결하고 이후 설정을 동시에 변경하지 마세요.

연결 진단

네트워크, 노드, 인증 정보, 세션, 클라이언트 순서로 확인하세요.

순서가 중요합니다. 먼저 연결 경로에 도달할 수 있음을 확인한 다음 인증 및 클라이언트 표시 문제를 처리하면 네트워크 장애를 인증 정보 오류로 오판하는 일을 피할 수 있습니다.

로컬 네트워크

현재 로컬 네트워크에 프록시 규칙, 기업 방화벽 또는 임시 핫스팟 제한이 없는지 확인하세요. 현재 네트워크와 신뢰할 수 있는 다른 네트워크에서 각각 재테스트하고 어느 경로에서만 실패하는지 기록하세요.

검증 항목 DNS 확인, 라우팅 도달성, 포트 정책, 패킷 손실 상태

대상 노드

콘솔로 돌아가 인스턴스 주소, 리전 및 상태를 확인하고 이전 세션에 저장된 주소를 사용하지 마세요. 여러 리전에서 협업하는 팀은 구성원이 동일한 주문에 연결된 물리 노드에 접속하는지 확인해야 합니다.

검증 항목 주문 식별자, 노드 리전, 연결 주소, 상태 업데이트 시간

액세스 인증 정보

사용자 이름, 키 파일 권한 및 최근 인증 정보 교체 내역을 확인하세요. 인증에 실패해도 확인되지 않은 인증 정보를 연속으로 시도하지 말고 먼저 신뢰할 수 있는 단일 출처를 확인하세요.

검증 항목 사용자 이름, 키 권한, 인증 정보 버전, 인증 오류 원문

세션 상태

남아 있는 전체 화면 세션, 로그아웃하지 않은 원격 데스크톱 또는 사용 중인 자동화 작업이 없는지 확인하세요. 세션을 다시 만들기 전에 기존 연결을 안전하게 종료하고 데이터를 쓰는 프로세스를 바로 종료하지 마세요.

검증 항목 기존 세션, 활성 프로세스, 데스크톱 잠금, 최근 연결 해제 시간

클라이언트 설정

클라이언트 버전, 해상도, 색상 및 클립보드 정책을 확인하세요. 터미널에는 연결되지만 그래픽 데스크톱에 문제가 있다면 문제 범위는 대개 세션 또는 클라이언트 계층으로 좁혀집니다.

검증 항목 클라이언트 버전, 디스플레이 설정, 입력기, 파일 전송 정책

복사 가능한 진단 목록

지원 요청을 제출하기 전에 다음 항목을 빠짐없이 작성하세요.

시간에는 시간대를 포함하세요. 로그는 오류 전후의 필수 행만 남기고 사용자 이름, 개인 경로, 토큰, 키 및 프로젝트 기밀을 대체하세요.

문제 유형:
주문 식별자:
모델:
노드 리전:
발생 시간 및 시간대:
로컬 네트워크 유형:
연결 방식 및 클라이언트 버전:
오류 메시지 원문:
최초 발생 또는 재현 가능 여부:
완료한 점검:
비식별화 로그 발췌:

개발 툴체인

설치, 경로, 버전 및 작업 실행을 각각 검증하세요.

도구가 존재한다고 해서 작업을 사용할 수 있는 것은 아닙니다. 검증할 때 실행 파일 경로, 실제 버전, 선택된 개발자 디렉터리 및 최소 작업 종료 코드를 함께 기록하세요.

Xcode 및 개발자 디렉터리

먼저 Xcode 버전과 현재 개발자 디렉터리를 확인한 다음 xcrun 을 통해 도구를 확인하세요. 여러 버전 환경을 전환한 후에는 터미널을 다시 열고 동일한 사용자로 빌드 작업을 실행하여 대화형 세션과 자동화 작업이 서로 다른 경로를 가리키지 않도록 하세요.

xcodebuild -version
xcode-select -p
xcrun --find xcodebuild
xcrun simctl list runtimes

Swift 및 명령줄 도구

Swift 컴파일러, 시스템 아키텍처 및 기본 빌드 도구를 각각 확인하세요. 대화형 터미널에서는 성공하지만 자동화 작업에서 실패한다면 두 환경의 PATH、작업 디렉터리, 사용자 ID 및 환경 변수를 비교하고 도구를 바로 다시 설치하지 마세요.

xcrun swift --version
clang --version
uname -m
pwd
printf '%s\n' "$PATH"

인증서 파일 및 민감한 자료

인증서 파일은 관리되는 경로를 통해 전달하고 파일 권한을 제한하며 가져오기 전에 용도와 유효 상태를 확인하세요. 진단할 때는 파일 이름, 용도, 권한 및 검증 결과만 기록하고 스크린샷, 빌드 로그 또는 지원 요청 첨부 파일에 비밀번호, 개인 키 또는 유효한 액세스 토큰을 보내지 마세요.

ls -l /path/to/certificate
file /path/to/certificate
security find-identity -v -p codesigning

CI Runner 상태 검증

어떤 저장소 플랫폼을 사용하든 Runner 프로세스 사용자, 작업 디렉터리, 디스크 여유 공간, 툴체인 경로 및 작업 종료 코드를 검증해야 합니다. 먼저 프로덕션 리소스에 액세스하지 않는 프로브 작업을 실행한 후 전체 파이프라인을 연결하세요. 실패 로그에는 단계 이름과 명령 결과가 포함되어야 합니다.

whoami
pwd
df -h /
xcode-select -p
xcodebuild -version
xcrun swift --version

툴체인 상태는 다음 5가지 질문에 답할 수 있어야 합니다

어디에 설치되어 있나요: 실행 파일과 개발자 디렉터리 경로를 확인할 수 있습니다.
어떤 버전을 실행하나요: Xcode, Swift 및 명령줄 도구 버전이 기록되어 있습니다.
누가 실행하나요: 대화형 사용자와 자동화 프로세스 사용자를 구분했습니다.
어디에서 실행하나요: 작업 디렉터리, 프로젝트 파일 및 출력 디렉터리를 확인할 수 있습니다.
결과를 어떻게 판단하나요: 종료 코드, 산출물 위치 및 오류 로그를 대조할 수 있습니다.

스토리지 및 데이터

용량 선택은 저장소 크기만이 아니라 최대 작업 세트에 따라 결정됩니다.

소스 코드, 의존성 캐시, 빌드 중간 파일, 아카이브 산출물, 실험 데이터 및 내보낸 복사본의 동시 사용량을 평가하고 정리 작업을 위한 여유 공간을 확보하세요.

기본 SSD

랜덤형에서 제공하는 기본 용량

HireAMac M4 S: 256GB
HireAMac M4 M: 512GB
HireAMac M4 Pro L: 2TB

용량을 예측할 수 있고 의존성을 반복 다운로드하며 산출물을 제때 내보내는 워크플로에 적합합니다. 대형 시뮬레이터 런타임, 아카이브 및 캐시는 소스 코드 자체보다 훨씬 많은 공간을 사용할 수 있으므로 초기 사용량이 아니라 최대 사용량을 기준으로 판단하세요.

+1TB SSD

지속적인 빌드와 여러 브랜치 캐시를 위한 여유 공간

일일: $2.9
주간: $7.7
월간: $14.3
분기: $38.9

여러 브랜치를 병렬로 유지하거나 의존성 캐시를 보관하거나 계속 증가하는 빌드 산출물을 처리하는 데 적합합니다. 주문 전에 추가 용량이 작업 세트와 내보낸 복사본이 동시에 존재하는 단계까지 감당할 수 있는지 확인하세요.

+2TB SSD

대규모 데이터 세트 및 다중 작업 병렬 처리용

일일: $5.8
주간: $15.4
월간: $28.6
분기: $77.8

대용량 실험 데이터, 여러 대형 프로젝트 또는 많은 중간 산출물을 보관해야 하는 작업에 적합합니다. 용량 확장은 백업 전략을 대신할 수 없으므로 중요한 데이터는 임대 기간이 끝나기 전에 별도로 내보내고 검증해야 합니다.

INPUT

업로드

먼저 최소 실행 세트를 업로드해 권한, 파일 무결성 및 디렉터리 구조를 확인한 다음 대형 리소스를 나누어 업로드하세요. 저장소 압축 파일이나 일반 데이터 패키지에 키를 포함하지 마세요.

MOVE

마이그레이션

원본 경로, 대상 경로, 파일 수 및 검증 결과를 기록하세요. 마이그레이션 중에는 동일한 디렉터리를 계속 변경하는 작업을 일시 중지하여 원본과 대상의 상태가 달라지지 않도록 하세요.

CLEAN

정리

다시 생성할 수 있는 캐시와 임시 산출물부터 삭제하세요. 정리 전에 활성 작업이 대상 디렉터리를 참조하지 않는지 확인하고 삭제 범위와 확보된 용량을 기록하세요.

EXPORT

내보내기

임대 기간이 끝나기 전에 소스 코드, 구성, 산출물 및 필요한 로그를 내보내고 파일 수 또는 체크섬을 확인하세요. 외부 복사본을 열 수 있는지 확인한 후 노드의 작업 데이터를 처리하세요.

df -h /
du -sh ~/Projects
du -sh ~/Library/Developer/Xcode/DerivedData
find ~/Projects -type f | wc -l

청구 문제 색인

먼저 기간을 확인한 다음 모델, 노드 및 추가 항목을 대조하세요.

모든 주문은 USD로 결제됩니다. 실제 사용 가능한 결제 게이트웨이는 콘솔에 실시간으로 표시되는 내용을 기준으로 하며, USDT-TRC20 및 Visa / Mastercard / Amex（Stripe 경유）를 지원합니다.

세 가지 모델의 일일·주간·월간·분기 가격
모델	구성	일일	주간	월간	분기
HireAMac M4 S	M4 / 16GB / 256GB	$20.9	$56.4	$104.4	$284
HireAMac M4 M	M4 / 24GB / 512GB	$41.2	$111.2	$205.9	$560
HireAMac M4 Pro L	M4 Pro / 64GB / 2TB	$59.9	$161.8	$299.6	$814.9

스토리지 확장 및 Thunderbolt 5 병렬 연결 가격
추가 항목	일일	주간	월간	분기
+1TB SSD	$2.9	$7.7	$14.3	$38.9
+2TB SSD	$5.8	$15.4	$28.6	$77.8
Thunderbolt 5 병렬 연결（대당）	$1.3	$3.6	$6.7	$18.2

DAY

일일 주문

임시 빌드, 장애 재현 및 단기 작업 검증에 적합합니다. 주문의 일수, 모델 일일 요금, 추가 항목 일일 요금 및 노드 항목을 확인하세요.

WEEK

주간 주문

버전 집중 개발이나 연속 테스트에 적합합니다. 청구서에는 선택한 모델의 주간 요금과 주간으로 청구되는 스토리지 또는 병렬 연결 추가 항목이 표시되어야 합니다.

MONTH

월간 주문

일상적인 개발과 안정적인 CI 워크플로에 적합합니다. 월간 기간 경계, 모델 월간 요금, 노드 및 각 월간 추가 요금을 확인하세요.

QUARTER

분기 주문

요구 사항이 안정적인 연속 작업에 적합합니다. 모델 분기 요금, 추가 항목 분기 요금 및 주문 기간이 모두 동일한 기간으로 기록되었는지 확인하세요.

청구 금액은 어떤 순서로 확인해야 하나요?

먼저 모델과 청구 기간을 확인한 다음 노드, 스토리지 확장 및 Thunderbolt 5 병렬 연결 수를 확인하고 마지막으로 USD 결제 항목과 결제 처리 결과를 대조하세요. 서로 다른 기간의 단가를 섞어 계산하지 마세요.

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

USDT-TRC20 및 Visa / Mastercard / Amex（Stripe 경유）만 지원하며 모든 주문은 USD로 결제됩니다. 실제 사용 가능한 게이트웨이는 콘솔에 실시간으로 표시되는 내용을 기준으로 합니다.

노드와 모델 조합은 어떻게 확인하나요?

세 가지 모델 모두 싱가포르, 일본（도쿄）, 한국（서울）, 홍콩 또는 미국 동부를 선택할 수 있습니다. 주문 시 실제 이용 가능 여부는 콘솔에 실시간으로 표시되는 내용을 기준으로 합니다.

지원 요청 준비 양식

지원 요청을 바로 재현할 수 있도록 준비하세요.

콘솔에서 지원 요청을 제출하거나 support@hireamac.com으로 이메일을 보내세요. 액세스 키, 비밀번호, 유효한 토큰 또는 비식별화하지 않은 프로젝트 데이터를 보내지 마세요.

노드 및 모델

싱가포르, 일본（도쿄）, 한국（서울）, 홍콩 또는 미국 동부와 해당 HireAMac 판매 모델명을 명시하세요.

주문 식별자 및 발생 시간

콘솔의 주문 식별자를 제공하세요. 문제 발생 시간에는 날짜, 시각 및 시간대를 포함하고 반복되는 경우 시작과 종료 범위를 제시하세요.

최단 재현 단계

정상적으로 작동하는 상태에서 시작해 작업, 입력, 예상 결과 및 실제 결과를 순서대로 나열하세요. 문제가 매번 발생하는지도 명시하세요.

비식별화 로그 및 시도한 작업

오류 원문, 명령 종료 코드 및 필요한 맥락을 남기세요. 사용자 이름, 개인 경로, 키, 토큰, 인증서 내용 및 비즈니스 데이터를 대체하세요.

다음 단계

문제를 찾았다면 워크플로로 돌아가세요.

새 노드가 필요하면 세 가지 구성과 네 가지 임대 기간을 비교하고, 기존 인스턴스 문제는 진단 결과가 포함된 지원 요청을 콘솔에서 제출하세요.

세 가지 임대 요금제 보기 지금 클라우드 Mac 임대하기