그래픽 인터페이스가 필요하면 VNC나 macOS 화면 공유를, 빌드와 스크립트 실행만 필요하면 SSH를 사용하세요. 가상 머신이 아닌 전용 Apple Silicon 물리 노드에 접속합니다.
이미 주문하셨나요? 콘솔의 인스턴스 상세 정보에서 IP, 사용자 이름, 접속 포트를 확인한 뒤 아래 안내에 따라 연결하세요. 여기에 나온 호스트 주소와 포트는 설정 예시입니다.
로컬 VNC 클라이언트 또는 macOS 화면 공유
SSH 터널 → 노드의 그래픽 데스크톱로컬 터미널 또는 CI 러너
SSH → 명령줄 및 빌드 프로세스포트는 인스턴스에 실제로 제공된 정보를 기준으로 확인하세요. VNC와 화면 공유는 대개 같은 그래픽 서비스를 사용하며, 별도의 데스크톱 두 개를 뜻하지 않습니다.
Windows, Linux, iPad 사용자에게 적합합니다. 원격으로 Xcode를 열고 빌드 설정을 확인하거나 클릭해야 하는 시스템 대화상자를 처리할 수 있습니다.
추천 상황: 로컬 컴퓨터는 Mac이 아니지만 전체 macOS 그래픽 인터페이스가 필요한 경우.
로컬에서 Mac을 사용할 때 가장 간편한 방법입니다. macOS에 기본 제공되는 화면 공유 클라이언트를 사용하므로 별도의 데스크톱 뷰어를 설치할 필요가 없습니다.
추천 상황: 로컬에서도 Mac을 사용하며 클라이언트 설정을 간소화하고 싶은 경우.
xcodebuild 실행, 로그 확인, 프로젝트 동기화, 러너 관리에 적합합니다. 데스크톱 화면을 계속 전송하지 않으므로 장시간 빌드에 더 알맞습니다.
추천 상황: 작업을 명령으로 실행할 수 있거나 CI 파이프라인에 연결해야 하는 경우.
아래 표는 SSH 포트 22, VNC 서비스 포트 5900을 예로 듭니다. 실제 포트가 다르면 해당 숫자를 바꿔 입력하세요. 그래픽 서비스 암호와 SSH 사용자 암호가 같은지는 제공 안내와 노드의 현재 설정을 확인하고, 두 암호를 임의로 바꿔 사용하지 마세요.
| 로컬 운영체제 | 권장 그래픽 클라이언트 | 그래픽 주소 및 포트 입력 | SSH 접속 |
|---|---|---|---|
| Windows | TigerVNC Viewer를 사용하되, 노드에서 현재 사용하는 VNC 인증 방식을 지원하는지 먼저 확인하세요. | 직접 연결할 때는 클라이언트의 Host / Port 입력란을 사용하세요. 아래 안내대로 터널을 만든 뒤에는 Host에 127.0.0.1을, Port에 15900을 입력합니다. |
Windows Terminal에서 OpenSSH 클라이언트를 사용해 다음 명령을 실행합니다: ssh -p 22 build@HOST_IP. |
| Linux | Remmina의 VNC 모드 또는 호환되는 인증 방식을 지원하는 TigerVNC Viewer를 사용하세요. | 터널을 통해 127.0.0.1:15900에 연결하세요. 클라이언트에 별도의 포트 입력란이 있으면 주소와 포트를 각각 입력하고, 디스플레이 번호는 입력하지 마세요. |
터미널에서 OpenSSH를 사용합니다. 먼저 일반 SSH 로그인을 완료한 다음 로컬 포트 포워딩을 설정하세요. |
| macOS | macOS 기본 앱인 ‘화면 공유’를 사용합니다. | 직접 연결 주소는 vnc://HOST_IP:5900이고, 터널을 사용할 때는 vnc://127.0.0.1:15900입니다. |
터미널에서 ssh를 사용합니다. 화면 공유 주소를 여는 명령은 open 입니다. |
| iPad | macOS 인증 및 SSH 터널을 지원하는 VNC 클라이언트를 사용하세요. | 클라이언트에서 SSH 호스트와 인증을 설정한 다음, 그래픽 연결 대상에 노드의 127.0.0.1:5900을 입력하세요. 구체적인 입력란 이름은 클라이언트에 따라 다릅니다. |
키 가져오기를 지원하는 SSH 클라이언트를 사용하세요. 먼저 키 로그인 여부를 확인한 다음 클라이언트의 내장 포워딩 기능을 켭니다. |
콘솔에서 노드 IP, SSH 포트, 사용자 이름을 확인합니다. 처음 연결할 때 호스트 지문을 검증하세요. 콘솔에 지문이 표시되지 않으면 지원 티켓으로 문의하세요. 재설치 후에는 지문이 바뀔 수 있으므로 로컬 기록을 갱신하기 전에 먼저 확인하세요. 호스트 검증을 끄는 옵션으로 경고를 우회하지 마세요.
처음 접속한 뒤 passwd 를 실행해 현재 사용자 암호를 바꾸고, 그래픽 서비스의 인증 방식을 확인하세요. 별도의 VNC 암호를 사용한다면 그것도 따로 변경합니다. 암호를 저장소, 빌드 로그, 공유 스크립트에 기록하지 마세요.
로컬에서 생성한 공개 키를 노드의 ~/.ssh/authorized_keys에 추가하고 개인 키는 신뢰할 수 있는 클라이언트에만 보관하세요. 새 터미널을 열어 로그인이 되는지 확인한 뒤 암호 인증을 제한하는 것을 고려하세요. 변경 중 노드에 접속하지 못하는 일이 없도록 기존 연결은 유지하세요.
데스크톱 작업이 필요할 때만 그래픽 서비스를 켜세요. macOS에서 ‘시스템 설정 → 일반 → 공유 → 화면 공유’를 확인하고 접근 가능한 사용자를 제한합니다. 서비스를 끄거나 조정하기 전에 SSH 접속이 가능한지 확인하세요. 터널 암호화만으로 원격 포트의 공용 네트워크 수신이 자동으로 중단되는 것은 아닙니다.
아래 명령은 로컬에서 실행합니다.build 와 HOST_IP 는 제공된 값으로 바꾸세요. 키를 생성할 때는 개인 키에 암호를 설정합니다.
ssh-keygen -t ed25519 -f ~/.ssh/armvnc_build
cat ~/.ssh/armvnc_build.pub
ssh -p 22 build@HOST_IP노드에 로그인한 뒤 디렉터리를 만들고 공개 키 파일을 편집한 다음 권한을 설정하세요. 앞 명령의 출력에서 공개 키 전체를 한 줄로 붙여 넣으세요. 개인 키는 붙여 넣지 마세요.
mkdir -p ~/.ssh
chmod 700 ~/.ssh
nano ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys로컬로 돌아와 다음 명령으로 확인합니다:ssh -i ~/.ssh/armvnc_build -p 22 build@HOST_IP
로컬 포트는 15900, 원격 대상 포트는 5900을 사용합니다. 포워딩은 로컬 루프백 주소에만 바인딩되므로 같은 네트워크의 다른 기기에서는 접속할 수 없습니다.
ssh -i ~/.ssh/armvnc_build -p 22 \
-N -T \
-o ExitOnForwardFailure=yes \
-o ServerAliveInterval=30 \
-o ServerAliveCountMax=3 \
-L 127.0.0.1:15900:127.0.0.1:5900 \
build@HOST_IP명령이 오류 없이 계속 실행되면 그래픽 클라이언트에서 로컬 15900 포트로 접속하세요. macOS에서는 새 터미널을 열어 다음을 실행할 수 있습니다:
open 'vnc://127.0.0.1:15900'터널은 VNC 인증을 건너뛰지 않습니다. 사용을 마치면 그래픽 클라이언트를 종료한 뒤 터널 터미널에서 Ctrl + C 를 눌러 포워딩을 종료하세요.
아래는 문제 해결을 위한 시작 설정이지, 대역폭이나 지연 시간을 보장하는 값은 아닙니다. 색 심도와 압축을 조정할 수 있는지는 클라이언트의 프로토콜 구현에 따라 다릅니다. 한 번에 하나씩 설정을 바꾸고 Xcode 창 이동, 로그 스크롤, 텍스트 입력처럼 같은 작업으로 비교하세요.
텍스트를 선명하게 표시하는 것을 우선하세요. 클라이언트 창이 너무 작다면 먼저 비율 유지 확대를 켜세요. 원격 해상도와 로컬 확대 배율을 동시에 높이지 마세요.
적합한 작업: Xcode 설정, 로그 확인, 가끔 필요한 그래픽 인터페이스 조작.
먼저 데스크톱 애니메이션과 불필요한 미리보기를 끄세요. 압축률을 높이면 화면 세부 정보가 줄어들 수 있습니다. 전송량은 줄일 수 있지만 네트워크 왕복 시간까지 없애지는 못합니다.
적합한 상황: 노드가 멀리 있거나 모바일 네트워크를 사용하거나 가끔 패킷 손실이 발생할 때 임시로 조작하는 경우.
화면을 볼 필요가 없다면 빌드 로그와 결과물을 바로 저장하세요. 그래픽 클라이언트 연결이 끊겨도 macOS에서 로그아웃되는 것은 아니며, 작업을 중단하는 방법으로 사용해서도 안 됩니다.
적합한 작업: 상시 실행 CI, 무인 스크립트, 반복 빌드 작업.
노드를 선택할 때도 용도를 구분하세요. 데스크톱을 조작할 때는 사용자와 노드 사이의 네트워크 경로가 중요하고, 빌드만 할 때는 저장소와 의존성 다운로드, 결과물 업로드 경로도 고려해야 합니다. 한 번의 마우스 조작이 부드럽다고 컴파일 성능까지 좋다고 판단하지 마세요.
먼저 SSH를 테스트한 다음 그래픽 연결을 확인하세요. SSH는 되지만 VNC가 실패하면 그래픽 서비스와 터널 대상을 중점적으로 확인합니다. 둘 다 실패하면 인스턴스 상태, 주소, 로컬 네트워크, 포트를 먼저 확인하세요. 처음부터 시스템을 재설치하지 마세요.
먼저 연결이 끊긴 것인지 작업이 끝난 것인지 확인하세요. SSH나 그래픽 연결을 다시 설정한 뒤 기존 프로세스와 로그를 확인합니다. archive를 바로 다시 실행하면 작업끼리 리소스를 두고 경쟁하거나 결과물을 중복 배포할 수 있습니다.
위에서 안내한 SSH 연결 유지 옵션은 연결 경로가 끊겼는지 파악하는 데 도움이 되지만 지속적인 패킷 손실을 해결하지는 않습니다. 로컬 유선 네트워크나 다른 신뢰할 수 있는 네트워크를 테스트해 동일한 노드와 비교하세요. 장시간 작업은 계속 켜 둔 터미널에 의존하지 말고 러너 서비스나 관리형 백그라운드 프로세스로 실행하세요.
pgrep -fl xcodebuild
tail -n 80 ~/build.log두 번째 명령은 로그를 해당 경로에 저장한 경우에만 사용할 수 있습니다. 파일이 없다면 빌드 스크립트에서 설정한 로그 위치를 확인하세요.
먼저 그래픽 클라이언트 연결을 종료한 다음 다시 연결하고 ‘보기 전용’ 모드가 켜져 있지 않은지 확인하세요. 클라이언트에 인증 화면이 표시되는지도 살펴보세요. 인증을 마친 뒤 화면이 검게 되는 문제와 아예 연결할 수 없는 문제는 서로 다릅니다.
SSH가 가능하다면 연결을 유지한 채 화면 공유 설정, 접근 가능한 사용자, 현재 세션을 확인하세요. 시스템 그래픽 프로세스를 반복해서 강제 종료하거나 빌드가 실행 중인데 노드를 재시작하지 마세요. 문제가 해결되지 않으면 콘솔에서 지원 티켓을 제출하고, 화면이 잠기기 전과 후 중 언제 검게 변했는지와 클라이언트 이름 및 버전을 알려 주세요.
클라이언트에서 클립보드 공유가 허용되어 있는지 확인하고 ‘보기 전용’ 제한을 해제하세요. 짧은 일반 텍스트로 양방향 복사를 테스트하세요. 이미지, 파일, 서식 있는 텍스트는 동일한 클립보드 채널로 전송되지 않을 수 있습니다.
클라이언트에서 클립보드를 별도로 전송해야 하는지 확인하고, 필요하면 연결을 끊었다가 세션을 다시 설정하세요. 프로젝트 파일은 SCP나 SFTP로 전송하세요. 기능 테스트를 위해 암호, 개인 키, 서명 자료 전체를 공유 클립보드에 넣지 마세요.
시간 초과는 대개 인증 전에 발생합니다. IP와 포트를 확인하고 로컬 네트워크에서 해당 포트를 제한하는지 살펴본 다음, 상세 로그로 연결이 어느 단계에서 멈추는지 확인하세요. 다음 오류가 표시되면 Permission denied 사용자 이름, 공개 키 내용, 파일 권한, 클라이언트에서 선택한 개인 키를 중점적으로 확인하세요.
ssh -v -i ~/.ssh/armvnc_build -p 22 build@HOST_IP로그를 제출하기 전에 사용자 이름, IP, 로컬의 민감한 경로 등 불필요한 정보를 삭제하세요. 개인 키나 암호는 절대 보내지 마세요. 호스트 지문이 바뀌었다면 재설치나 인스턴스 변경이 있었는지 먼저 확인하고, 검증 기록을 바로 삭제하지 마세요.
화면이 잘리면 먼저 클라이언트의 창 맞춤이나 확대 설정을 확인한 다음 노드의 ‘시스템 설정 → 디스플레이’를 살펴보세요. 클라이언트 창 크기만 조정해도 원격 데스크톱 해상도는 바뀌지 않을 수 있습니다.
키 입력이 다르게 작동하면 로컬 키보드 배열, 클라이언트의 키 매핑, 원격 입력기를 확인하세요. 암호나 명령을 입력하기 전에 일반 텍스트 편집기에서 문자, 숫자, 기호를 테스트하세요. Windows의 Ctrl / Alt와 macOS의 Command / Option은 별도로 매핑해야 할 수 있습니다.
사용 가이드에 따라 환경을 준비하고, 개통·접속·결제 문제는 도움말 센터에서 확인하세요. 아직 대여하지 않았다면 주문 페이지에서 머신 유형과 노드를 선택할 수 있습니다.
USDT-TRC20 및 Visa / Mastercard / Amex(Stripe)만 지원하며 USD로 결제됩니다. 실제 이용 가능한 결제 게이트웨이는 결제 시 표시되는 내용을 기준으로 확인하세요.