rdp-cli
Linux에서 Windows RDP에 연결하기
대상 버전 및 환경: 0.1.2 · Linux x86_64 / ARM64 · Windows RDP
Linux 실행 파일에서 원격 화면까지
CPU에 맞는 Linux 실행 파일을 선택하고 Windows에 RDP로 연결한 뒤 첫 원격 화면을 가져옵니다. 현재 시스템 요구 사항과 지원 아키텍처는 다운로드 페이지에서 확인하세요.
아키텍처 선택과 파일 검증
rdp-cli를 실행할 Linux 컴퓨터에서 확인합니다.
uname -m
x86_64이면 다운로드 페이지에서 Linux x86_64, aarch64이면 Linux ARM64를 선택합니다. ARM CPU라도 32비트 OS는 이 ARM64 버전 범위 밖입니다. macOS를 실행하는 Mac에는 macOS 패키지가 필요합니다. 실행에는 실행 파일만 있으면 되며 별도 소스 및 라이선스 자료는 필수 부속 파일이 아닙니다.
실행 전에 SHA-256 출력을 다운로드 페이지의 같은 아키텍처 파일 정보와 비교합니다. x86_64:
sha256sum ./rdp-cli-linux-x86_64
해시가 일치하는지 확인한 뒤 실행 권한을 부여하고 버전을 확인합니다.
chmod u+x ./rdp-cli-linux-x86_64
./rdp-cli-linux-x86_64 --version
ARM64:
sha256sum ./rdp-cli-linux-arm64
해시가 일치하는지 확인한 뒤 실행 권한을 부여하고 버전을 확인합니다.
chmod u+x ./rdp-cli-linux-arm64
./rdp-cli-linux-arm64 --version
--version은 설치된 버전을 JSON으로 반환합니다. Linux 다운로드는 일반 사용자로 실행하는 단일 정적 ELF 파일입니다. 네이티브 뷰어 창을 열려면 그래픽 데스크톱 세션이 필요합니다.
Bash에서 연결
Windows에 RDP가 이미 활성화되어 있고 계정에 원격 로그인 권한이 있으며 이 Linux 컴퓨터에서 지정한 네트워크나 VPN으로 접근할 수 있어야 합니다. 클라이언트 설치가 Windows 서비스를 켜주지는 않습니다.
실행 파일 디렉터리에서 Bash로 실행합니다. ARM64에서는 첫 줄을 rdp_cli=./rdp-cli-linux-arm64로 바꿉니다. 192.0.2.20과 USER를 허가된 대상과 계정으로 바꾸세요. 입력한 비밀번호는 표시되지 않습니다.
rdp_cli=./rdp-cli-linux-x86_64
IFS= read -r -s -p 'Password: ' rdp_password
printf '\n'
printf '%s' "$rdp_password" | "$rdp_cli" connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
계속 같은 셸을 사용하여 rdp_cli 변수를 유지합니다. 파이프는 비밀번호를 보낸 뒤 표준 입력을 닫습니다. 도메인 계정에는 --domain DOMAIN을 추가할 수 있으며 여러 비밀번호 소스를 함께 쓰면 안 됩니다. 현재 RDP 기본값은 --cert-policy ignore이므로 connect --help를 읽고 환경에 맞는 인증서 검증을 설정하세요. 인증서 정책으로 네트워크 단절이나 잘못된 자격 증명을 해결할 수는 없습니다.
JSON을 읽습니다. 실패 시 error.code, error.message를 확인하고, 성공 시 반환된 data.session을 SESSION으로 저장합니다.
상태와 첫 PNG 확인
"$rdp_cli" status --session SESSION
"$rdp_cli" screenshot --session SESSION --out first-screen.png
연결과 제어 상태를 확인합니다. 이미지 도구로 first-screen.png를 열어 실제 화면을 확인한 후 다음 작업을 결정하세요. 연결되어도 로그인, 환영 화면이나 처리 중인 앱이 보일 수 있습니다. 해당 화면에 기반한 후속 입력을 위해 응답의 data.observation을 저장합니다. 이것은 영구 세션 ID가 아닙니다.
스크린샷과 입력 명령에는 로컬 창이 필수가 아닙니다. 사람이 Linux 데스크톱에서 같은 세션을 보려면 다음을 실행합니다.
"$rdp_cli" watch --session SESSION --viewer window
창은 읽기 전용으로 시작하며 사람의 제어권 획득은 명시적으로 이뤄집니다. 읽기 전용 뷰어를 닫아도 연결은 유지됩니다. 제어권을 가진 뷰어가 사라지면 입력은 일시 중지 상태가 됩니다. 재연결이나 제어권 반환 후 새 화면을 확인하고 제어 상태를 따르세요.
구체적인 오류 해결
- 실행 형식이 맞지 않음:
uname -m과 다운로드 아키텍처를 비교합니다. x86_64와 ARM64 파일은 서로 바꿔 쓸 수 없습니다. - 권한 거부: 실행 비트와 파일시스템의 실행 허용 여부를 확인합니다. 알맞은 사용자 디렉터리를 선택하고 관리자 권한으로 대체하지 마세요.
- 연결 또는 인증 오류: 경로, 포트, Windows RDP 서비스, 계정 권한과 반환 오류를 확인합니다. 비밀번호를 반복하거나 무관한 오류 때문에 구형 TLS를 켜지 마세요.
- 데스크톱 없이
SDL_INIT_FAILED: 네이티브 뷰어에는 디스플레이 세션이 필요하지만 헤드리스 CLI 스크린샷은 사용할 수 있습니다. 뷰어 오류만으로 RDP 실패를 단정하지 마세요. CREDENTIAL_STORE_FAILED: 저장된 자격 증명은 호스트의 Secret Service를 사용합니다. 없으면--password-stdin같은 적절한 지원 소스를 쓰고 저장이 성공했다고 표시하지 않습니다.
빠른 시작, 명령 참조, RDP 파일 업로드와 다운로드로 이어갈 수 있습니다. 파일 교환에는 서버 드라이브 리디렉션과 파일 권한도 필요합니다.