연결
SSH 또는 VNC 세션을 만들 수 없음
연결 시간 초과, 호스트 지문 변경, 자격 증명 거부, 그래픽 세션 중단 또는 재연결 후 화면 이상에 해당합니다.
연결 진단 보기
지원 센터
문제를 먼저 찾고, 다음 단계를 결정하세요
RunnerVPS 클라우드 Mac의 연결, 시스템, 네트워크, 저장 공간, 빌드 및 계정 문제를 한곳에 정리했습니다. 증상으로 검색한 뒤 진단 경로를 따라 하나씩 확인해 여러 변수를 동시에 바꾸는 시행착오를 줄이세요.
문서 버전 2026.09판매 중인 노드 5개 지원
RUNNER SUPPORT
연결 진단 기록
순서대로 확인
A
장치 상태 확인
장치 식별자, 리전 및 현재 접속 상태 확인
시작
B
접속 경로 구분
SSH와 그래픽 인터페이스 연결을 각각 테스트
분기
C
재현 가능한 증거 수집
시간, 오류, 네트워크 환경 및 비식별화 로그 기록
인계
- 처리 원칙
- 한 번에 변수 하나만 변경
- 지원 요청
- 장치를 연결한 뒤 문의 제출
문제 분류
증상에 맞는 점검 항목 찾기
여섯 가지 문제 유형을 한 화면에서 확인할 수 있습니다. 각 카드에 대표 증상, 우선 점검 항목 및 이 페이지의 관련 위치를 담았습니다.
시스템
도구 체인 버전이 변경됨
잘못된 Xcode 선택, 명령줄 도구 경로 변경, 시스템 업데이트 후 의존성 충돌 또는 환경 변수 오류에 해당합니다.
관리 방법 보기
네트워크
가져오기, 업로드 또는 포트 포워딩 실패
Git 가져오기 중단, SFTP 전송 실패, SSH 터널 접속 불가, DNS 확인 오류 또는 로컬 네트워크 제한에 해당합니다.
전송 권장 사항 보기
저장 공간
빌드 캐시가 로컬 디스크를 가득 채움
DerivedData, 아카이브, 의존성 캐시 또는 로그가 계속 증가해 빌드 실패, 내보내기 중단 또는 쓰기 속도 저하가 발생한 경우입니다.
공간 점검 보기
빌드
서명, 아카이브 또는 자동화 작업 실패
인증서와 서명 파일 불일치, runner 환경 차이, 의존성 캐시 오염 또는 아카이브 산출물 미생성에 해당합니다.
빌드 관리 보기
계정
주문 또는 장치 기록 확인 필요
대여 기간 상태, 장치 식별자, 주문 기록, 알림 이메일 또는 문의 연결 대상을 확인해야 하는 경우입니다.
콘솔 열기
연결 진단
같은 순서로 문제 범위 좁히기
자격 증명 재설정, 네트워크 전환 및 시스템 설정 변경을 동시에 하지 마세요. 먼저 원본 오류를 보존하고 한 번에 하나씩 점검해야 결과를 비교할 수 있습니다.
01
노드 상태
콘솔에서 장치 식별자, 리전, 대여 기간 및 접속 상태를 확인하세요. 대상 장치를 정확히 조작하고 있는지 확인한 뒤 상태가 바뀐 시간을 기록하세요.
02
접속 자격 증명
사용자 이름, SSH 개인 키 경로 및 파일 권한을 확인하세요. 개인 키, 비밀번호 또는 전체 접속 자격 증명을 이메일, 채팅 기록이나 일반 로그에 붙여 넣지 마세요.
03
SSH 채널
먼저 호스트 지문을 확인한 뒤 상세 출력으로 실패 단계를 찾으세요. DNS, TCP 연결, 키 교환 및 사용자 인증을 구분해야 단순히 “연결 실패”로 원인을 단정하지 않을 수 있습니다.
04
그래픽 세션
SSH는 정상인데 VNC에 문제가 있으면 클라이언트 주소, 세션 상태 및 해상도 설정을 확인하세요. 연결이 끊긴 뒤에는 기존 세션이 해제될 때까지 기다렸다가 같은 장치 기록으로 다시 연결하세요.
05
시스템 방화벽
원격 접속에 필요한 프로세스가 실행 중이고 관련 포트가 예상대로 수신 대기 중인지 확인하세요. 규칙을 변경하기 전에 현재 설정을 저장해 문제가 커질 때 되돌릴 수 있도록 하세요.
06
로컬 네트워크
마지막으로 로컬 네트워크를 바꿔 비교하세요. 라우팅을 변경할 수 있는 프록시나 VPN을 일시적으로 끄고 회사 네트워크, 가정용 네트워크 및 모바일 핫스팟의 결과를 비교하세요.
원격 데스크톱
복구와 인계가 쉬운 그래픽 세션 만들기
VNC는 Xcode, 미리보기 및 그래픽 도구가 필요한 작업에 적합합니다. 연결 전에 SSH 채널이 작동하는지 확인하면 그래픽 세션에 문제가 생겨도 명령줄 점검을 계속할 수 있습니다.
신뢰할 수 있는 VNC 클라이언트 준비
신뢰할 수 있는 출처에서 클라이언트를 설치하고 전체 자격 증명 대신 장치 이름을 저장하세요. 처음 연결할 때는 대상 리전과 장치 식별자를 확인한 뒤 암호화 및 키보드 매핑 설정을 점검하세요.
- 장치 이름과 접속 주소를 별도로 저장
- 팀원은 각자 관리되는 접속 방식을 사용
- 관리되는 네트워크 또는 SSH 터널을 통한 연결 우선
먼저 해상도를 조정한 뒤 성능을 판단하세요
원격 화면은 해상도, 색 심도 및 로컬 네트워크의 영향을 함께 받습니다. 먼저 표시 영역을 줄여 비교하고 클라이언트, 네트워크 및 시스템 디스플레이 설정을 동시에 바꾸지 마세요.
- 낮은 해상도부터 입력 반응 확인
- 대용량 파일을 전송하는 동안 화면 성능을 함께 평가하지 않기
- 이상이 발생하기 전 마지막 설정 변경 기록
세션을 잠그고 프로세스를 강제 종료하지 마세요
잠시 자리를 비울 때는 그래픽 세션을 잠가 아직 빌드 중인 앱을 바로 닫지 않도록 하세요. 연결이 끊겼다가 다시 연결되면 먼저 기존 작업 상태를 확인한 뒤 도구를 다시 시작할지 결정하세요.
- 자리를 비우기 전에 프로젝트와 미커밋 변경 사항 저장
- 화면이 멈췄다고 바로 작업을 다시 시작하지 않기
- 팀원이 떠나면 해당 접속 방식 즉시 철회
빌드 환경
도구 체인을 고정한 뒤 재생성 가능한 데이터 정리
지속적인 빌드에서는 작업 사이에 환경이 기록 없이 바뀌는 것이 가장 위험합니다. 버전 선택, 서명 자료 및 캐시 정리를 팀 운영 매뉴얼에 기록하세요.
Xcode 및 명령줄 도구 고정
프로젝트 설정과 runner 초기화 스크립트에 Xcode 버전을 기록하고 작업 전에 현재 개발자 디렉터리를 확인하세요. 시스템이나 Xcode가 변경되면 먼저 최소 테스트 작업을 실행한 뒤 전체 파이프라인을 재개하세요.
인증서, 서명 파일 및 코드 저장소 분리
인증서, 서명 파일, 토큰 및 환경 변수는 팀의 비밀 관리 절차를 통해 주입해야 합니다. 장기 자격 증명을 Git에 커밋하거나 민감한 필드가 포함된 원본 로그를 일반 첨부 파일로 전달하지 마세요.
출처별 캐시 정리
공간을 차지하는 항목이 DerivedData, 의존성 캐시, 아카이브, 시뮬레이터 데이터 또는 프로젝트 리소스인지 먼저 확인하세요. 다시 생성할 수 있는 데이터부터 삭제하고, 반환이 필요한 빌드 산출물과 문제 현장은 보존하세요.
환경 점검표
작업 실행 전
- Xcode
- 버전이 프로젝트 요구 사항과 일치
- 개발자 디렉터리
- 대상 도구 체인을 가리킴
- 서명 자료
- 작업별로 임시 주입
- 디스크 공간
- 캐시, 아카이브 및 내보내기 포함
- 최소 테스트
- 가져오기, 컴파일 및 산출물 생성부터 확인
한 번에 하나씩 변경
결과를 빌드 로그에 기록
네트워크 및 파일
연결 채널과 파일 채널을 분리해 확인
먼저 작은 파일로 경로와 권한을 확인한 뒤 전체 저장소, 리소스 또는 빌드 산출물을 전송하세요. 실패하면 방향, 크기, 시간 및 구체적인 단계를 기록하세요.
필요한 포트만 포워딩
로컬 포트, 대상 주소 및 용도를 명확히 해 광범위한 수신 대기를 피하세요. 터널을 만든 뒤 SSH 자체와 포워딩된 서비스를 각각 확인하면 인증 문제와 애플리케이션 문제를 구분하기 쉽습니다.
먼저 디렉터리 권한 확인
전용 프로젝트 디렉터리로 파일을 받고, 먼저 작은 샘플을 업로드해 읽기 및 쓰기 권한을 확인하세요. 대용량 파일이 완료되면 크기나 체크섬을 확인하고 클라이언트 진행률만으로 성공을 판단하지 마세요.
저장소 자격 증명 범위 제한
자동화 작업에는 최소 권한 자격 증명을 사용하고 필요한 저장소로 제한하세요. 가져오기에 실패하면 DNS, 원격 접속 가능 여부, 호스트 지문, 자격 증명 권한 및 저장소 주소를 각각 확인하세요.
반환을 확인한 뒤 원본 파일 정리
산출물에 작업 식별자, 버전 및 검증 정보를 추가하세요. 대상에서 완전히 수신한 것을 확인한 뒤 노드의 중간 파일을 정리해야 재빌드와 원본 결과 복원이 필요해지는 상황을 피할 수 있습니다.
지식 문서
작업 절차에서 팀 전략까지
다음 문서는 게시 날짜의 내림차순으로 정렬되어 있으며 시스템 업그레이드, 연결 보안, 서비스 선택, 오디오·비디오, Unity iOS 빌드 및 M4 개발 작업 관찰을 다룹니다.
지식 문서 준비 중
전체 문서가 게시되기 전에는 이 페이지의 연결 진단, 시스템 관리, 네트워크 전송 및 빌드 환경 점검표를 사용하세요.
인적 지원
문의가 바로 진단 가능한 상태가 되도록
기술 문제는 구체적인 장치와 주문을 연결할 수 있도록 콘솔에서 제출하는 것이 우선입니다. 로그인할 수 없는 경우 다음 주소로 이메일을 보내세요 support@runnervps.com. 단, 비밀번호, 개인 키 또는 전체 결제 자격 증명은 첨부하지 마세요.
장치 식별자
콘솔에 표시된 장치 이름만 보내고 접속 비밀번호는 보내지 않기
리전
싱가포르, 일본(도쿄), 한국(서울), 홍콩 또는 미국 동부
문제 발생 시간
시간대를 포함하고 마지막으로 정상 작동한 시간 범위를 명시
재현 단계
실행 순서에 따라 명령, 작업 및 실제 결과 작성
비식별화 로그
토큰, 키, 비밀번호, 저장소 자격 증명 및 개인 데이터 제거
문제 재현에 전용 M4가 필요하신가요?
Runner M4와 Runner M4 Plus는 모두 전용 물리 머신이며 가상 머신이 아닙니다. 일, 주, 월 또는 분기 단위로 대여할 수 있습니다. 실제 이용 가능 여부는 콘솔의 실시간 응답을 기준으로 합니다.