VNC로 macOS 그래픽 인터페이스를 사용하고, SSH로 스크립트와 CI를 실행하세요. 가상 머신이 아닌 전용 물리 Mac에 연결하므로 Xcode 디버깅과 자동화 빌드에 각각 적합한 방법을 사용할 수 있습니다.
호스트를 개통했다면 호스트 주소, SSH 포트, 사용자 이름과 접속 정보를 준비하세요. 아래에서는 SSH 터널을 통한 VNC 연결을 권장합니다.
동일한 물리 노드의 그래픽 인터페이스와 명령줄
CONFIGURATION = Release
SDKROOT = iphoneos
DEBUG_INFORMATION_FORMAT = dwarf-with-dsym
ENABLE_TESTABILITY = NO도구 체인을 처음 설정한다면 화면 공유로 그래픽 설정을 확인해 보세요. 파이프라인이 안정되면 러너가 명령줄에서 작업하도록 구성하세요. 두 방법 모두 같은 호스트에 접속하므로 그래픽 작업을 위해 별도의 빌드 환경을 만들 필요가 없습니다.
Xcode 실행, 시뮬레이터 확인, Keychain 설정 확인, 마우스 조작이 필요한 단계의 문제 해결에 적합합니다. 원격 호스트 화면을 보는 방식이며, 컴파일 작업이 로컬에서 실행되는 것은 아닙니다.
의존성 설치, xcodebuild 실행, 로그 정리, CI 러너 등록에 적합합니다. SSH는 데스크톱 화면을 전송하지 않으므로 일상적인 스크립트 작업에는 VNC를 계속 연결해 둘 필요가 없습니다.
VNC 데스크톱 암호, SSH 로그인 암호, SSH 개인 키 암호는 서로 다른 정보입니다. 연결에 실패하면 클라이언트 설정을 바꾸기 전에 자격 증명이 해당 프로토콜에 맞는지 확인하세요.
먼저 아래 안내에 따라 SSH 터널을 설정한 다음 로컬 포워딩 주소로 연결하세요. VNC 데이터가 암호화된 채널을 통과하므로 원격 데스크톱 포트를 따로 열 필요가 없습니다.
콘솔에 로그인해 해당 인스턴스의 접속 정보를 확인하세요. 호스트 주소, SSH 포트, 사용자 이름을 기록하고 VNC 자격 증명은 별도로 확인합니다. 주소나 포트가 예시와 다르면 인스턴스에 표시된 값을 사용하세요.
이 페이지의 포워딩 명령을 로컬 터미널에서 실행하세요. 명령에 -N 을 사용하면 성공 후 대화형 명령 프롬프트가 나타나지 않는 것이 정상입니다. 터미널을 열어 두세요. 오류가 발생하면 먼저 해결하고, 데스크톱 연결은 시도하지 마세요.
Finder에서 ‘이동 → 서버에 연결’을 선택하거나 ⌘ K를 누른 뒤 vnc://127.0.0.1:15900을 입력하세요. 시스템에서 화면 공유 앱이 열리면 안내에 따라 원격 VNC 접속 정보를 입력합니다.
Finder 조작, 텍스트 입력, Xcode 실행이 가능한지 먼저 확인하세요. 조작이 필요하면 보기 전용이 아닌 제어 모드를 선택하세요. 화면이 로컬 창을 벗어나면 먼저 화면 맞춤을 켠 다음 네트워크 상태에 따라 화질을 조정하세요.
로컬 루프백 주소는 터널을 실행 중인 컴퓨터에서만 사용할 수 있습니다. 다른 컴퓨터에서 뷰어를 열려면 해당 컴퓨터에서 터널을 별도로 설정해야 합니다. 첫 번째 컴퓨터의 로컬 연결을 그대로 사용할 수는 없습니다.
TigerVNC 등 VNC 프로토콜을 지원하는 뷰어를 사용하세요. Windows에서는 OpenSSH 클라이언트, Linux에서는 터미널의 ssh로 터널을 설정한 다음 데스크톱 뷰어를 로컬 포워딩 포트에 연결하면 됩니다.
PowerShell 또는 Windows Terminal에서 터널 명령을 실행하세요. 시스템에서 ssh를 찾을 수 없다고 표시되면 OpenSSH 클라이언트 기능이 설치되어 있는지 확인하세요.
VNC 뷰어의 호스트 입력란에 127.0.0.1을, 포트 입력란에 15900을 입력하세요. 일부 클라이언트는 콜론 뒤 숫자를 디스플레이 번호로 처리합니다. 주소 입력란만 있는 경우 해당 클라이언트의 ‘명시적 포트’ 형식에 맞춰 입력하세요.
한 터미널에서 SSH 터널을 실행한 채로 두고 그래픽 VNC 뷰어를 시작하세요. 터널이 종료되었다면 뷰어가 로컬 포트에 연결되지 않는 것은 원격 데스크톱 암호 오류가 아닙니다.
패키지 관리자로 클라이언트를 설치할 때는 원격 인증 방식을 지원하는 버전을 선택하세요. ‘지원되지 않는 보안 유형’ 오류가 나타나면 먼저 호환성을 확인하고 인증을 끄거나 서버 보안을 낮추지 마세요.
| 설정 항목 | 권장 시작값 | 조정 시점 |
|---|---|---|
| 색 심도 | 자동 선택. 연결이 제한적이면 16-bit 시도 | 스크린샷, 색상, 작은 글자를 확인할 때는 트루 컬러로 변경하세요. 색상 검수에는 색 심도 낮추기가 적합하지 않습니다. |
| 인코딩 및 압축 | 자동 인코딩 유지, 적응형 압축 사용 | 창을 끌 때 크게 끊기면 압축을 조금 높이세요. 텍스트가 흐리면 손실 압축을 줄이세요. |
| 데스크톱 해상도 | 먼저 1440 × 900 또는 1600 × 900 사용 | 조작이 안정적인지 확인한 뒤 해상도를 높이세요. 처음부터 여러 개의 고해상도 화면을 전송하지 않도록 합니다. |
| 지속 업데이트 | 적응형 업데이트 사용, 불필요한 지속 업데이트 끄기 | 동적 인터페이스를 확인할 때만 업데이트 빈도를 높이세요. 코드 편집에는 동영상 수준의 화면 업데이트가 필요하지 않습니다. |
| 클립보드 | 필요할 때 사용하고 민감한 작업에서는 동기화 끄기 | 인증서 암호나 자격 증명을 복사하기 전에 로컬과 원격 간 동기화 방향을 확인하세요. |
아래 주소는 문서 예시이므로 직접 연결할 수 없습니다. 192.0.2.10와macuser 와 포트를 콘솔에 표시된 실제 접속 정보로 바꾸세요. 예시에서는 원격 VNC 서비스가 호스트 자체의 5900 포트에서 대기한다고 가정합니다.
ssh -N -T -L 127.0.0.1:15900:127.0.0.1:5900 -o ExitOnForwardFailure=yes -o ServerAliveInterval=30 -o ServerAliveCountMax=3 -p 22 macuser@192.0.2.10
-L 은 로컬 루프백 주소에서만 연결을 받습니다. 첫 번째 포트는 로컬 진입점이고 마지막 포트는 원격 VNC 서비스 포트입니다.-p 는 SSH 포트를 지정하며 VNC 포트가 아닙니다.-N -T 는 포워딩만 수행하고 원격 대화형 터미널은 열지 않는다는 뜻입니다.
처음 연결할 때 SSH 지문을 확인하세요. 연결에 성공하면 뷰어에서 로컬 포트에 접속하고 Ctrl C 를 눌러 터널을 종료하세요. 로컬 포트가 사용 중이라는 메시지가 나오면 15900 을 사용하지 않는 다른 포트로 바꾸고 뷰어 주소도 함께 수정하세요.
연결 시간 초과는 주소, SSH 포트, 접속 허용 범위를 먼저 확인하세요. 인증 실패는 사용자 이름과 키를 확인하고, 포워딩 대상의 연결 거부는 원격 VNC 서비스와 포트를 확인하세요. 모든 연결 문제를 암호를 반복해서 바꾸는 방식으로 해결하지 마세요.
이 컴퓨터 전용 Ed25519 키를 만들고 개인 키 암호를 설정하세요. 공개 키 내용만 원격 사용자의 ~/.ssh/authorized_keys에 추가하세요. 개인 키는 로컬에 보관하고 호스트, 저장소, 지원 티켓에 업로드하지 마세요.
같은 이름의 키가 이미 있다면 덮어쓰지 마세요. 새 파일 이름을 사용하고 연결할 때 -i 로 키를 지정할 수 있습니다. 공개 키 파일은 .pub 로 끝나며 개인 키 파일에는 이 확장자가 없습니다.
ssh-keygen -t ed25519 -a 64 -f ~/.ssh/armrdp_ed25519
macOS와 Linux에서는 원격 사용자의 ~/.ssh 디렉터리 권한을 일반적으로 700으로,authorized_keys 파일 권한을 600으로 설정합니다. Windows의 로컬 개인 키는 파일 액세스 권한으로 읽기를 제한하세요. Unix 권한 명령을 그대로 적용하지 마세요.
컴파일은 원격에서 실행되지만 데스크톱 반응 속도는 로컬 네트워크, 네트워크 간 경로, 해상도, 화면 변화량에도 영향을 받습니다. VNC에서 창을 한 번 끌어 본 느낌으로 호스트의 컴파일 성능을 판단하지 마세요. 지리적 거리만으로 지연 시간을 추정해서도 안 됩니다.
모니터 하나만 사용하고 고해상도 데스크톱, 움직이는 배경, 여러 창의 애니메이션을 줄이세요. 로컬 뷰어 창만 축소하는 것보다 원격 데스크톱 크기를 조정하는 편이 전송할 화면 데이터를 더 줄일 수 있습니다.
해상도, 색 심도, 압축을 차례로 테스트하세요. 같은 프로젝트를 열거나 같은 창을 끄는 등 동일한 작업으로 확인하세요. 여러 설정을 동시에 바꾸면 어떤 설정이 효과가 있었는지 알기 어렵습니다.
로컬에서 대용량 파일을 전송하지 말고 안정적인 유선 네트워크를 우선 사용하세요. SSH의 입력 응답과 VNC 화면 업데이트를 비교해 볼 수 있습니다. SSH는 빠르고 화면은 느리다면 기종을 바로 바꾸기보다 화면 설정부터 확인하세요.
| 노드 | 현지 시간대 | 선택 시 우선 고려할 사항 |
|---|---|---|
| 싱가포르 | UTC+8 | 팀의 주요 위치가 동남아시아라면 첫 연결 테스트 노드로 사용할 수 있습니다. |
| 일본(도쿄) | UTC+9 | 팀의 주요 위치가 일본이나 동아시아라면 현지 네트워크에서 이 노드까지의 실제 경로를 비교하세요. |
| 대한민국(서울) | UTC+9 | 팀의 주요 위치가 대한민국이나 동북아시아라면 통신사 라우팅을 고려해 선택하세요. |
| 홍콩 | UTC+8 | 팀의 주요 위치가 중국 남부나 동남아시아라면 조작 반응과 저장소 접속 경로를 확인하세요. |
| 미국 서부 | UTC−8 / UTC−7 | 팀의 주요 위치가 북미 서부라면 우선 검토하세요. 시간대는 현지 서머타임에 따라 달라집니다. |
데스크톱을 가끔 설정하는 용도로만 쓴다면 코드 저장소, 의존성 캐시, 빌드 산출물 업로드 경로도 고려하세요. 지속적인 빌드에서는 도구 체인과 파이프라인의 안정성이 우선이며, VNC를 밤새 연결해 둘 필요는 없습니다.
원격 보안 설정은 순서가 중요합니다. 새 방식이 작동하는지 확인한 뒤 기존 방식을 취소하세요. 키, 접속 주소, 인증 정책을 동시에 변경하면 문제 원인을 구분하기 어렵습니다.
현재 SSH 세션을 유지하고 다른 터미널을 열어 지정한 개인 키로 새 연결을 설정한 뒤 필요한 관리 권한을 확인하세요. 성공한 다음 SSH 암호 인증 정책을 조정합니다. 변경 전에 설정 문법을 확인하고 현재 시스템의 서비스 관리 방식에 따라 설정을 적용하세요.
먼저 로컬 네트워크의 공인 출구 IP가 고정되어 있는지 확인한 다음 해당 네트워크나 호스트의 접속 규칙에서 허용하세요. 가정용 네트워크의 임시 출구 IP를 고정 주소로 간주하지 마세요. 인터페이스를 확인하지 않은 상태에서 방화벽 명령을 적용해서도 안 됩니다.
구성원과 자동화 작업마다 별도의 키를 사용하세요. 구성원이 떠나거나 기기를 분실했거나 키가 유출되었을 가능성이 있다면 새 공개 키를 먼저 배포하고 테스트한 뒤 기존 키를 삭제하세요. CI에 저장된 자격 증명과 관련 접속 기록도 확인합니다.
콘솔에서 지원 티켓을 제출할 때 호스트 ID, 클라이언트 OS와 버전, 사용한 프로토콜, 오류 원문, 발생 시각과 시간대, SSH 터널 사용 여부를 포함하세요. 스크린샷에서는 암호, 토큰 및 기타 민감한 정보를 가리세요. 개인 키나 전체 인증서를 보내지 마세요.
단기 테스트는 하루 단위로 대여할 수 있으며 시작 가격은 $21.1/일입니다. SSH와 화면 공유가 모두 작동하는지 먼저 확인한 뒤 Xcode와 의존성 버전을 고정해 일상적인 빌드가 로컬 컴퓨터의 상시 접속에 의존하지 않도록 하세요.