rdp-cli
메뉴

rdp-cli

Windows, Mac, Linux의 RDP 명령줄 시작하기

한 번 연결하고 화면을 보고 조작한 뒤 확인합니다. 로컬 창은 선택 사항입니다.

내 컴퓨터에서 시작

플랫폼을 선택하고
원격 작업을 시작하세요.

rdp-cli를 실행할 컴퓨터를 선택하고
에이전트에게 원격 작업 도구를 준비해 주세요.

01 / 설치 및 확인

EXE를 준비하고 PowerShell을 여세요.

x64(64비트) 또는 x86(32비트) EXE를 선택하고, rdp-cli.exe가 있는 폴더에서 PowerShell을 엽니다.

서명된 x64 및 x86 단일 EXE입니다. 별도 런타임이 필요하지 않습니다.

PowerShell
.\rdp-cli.exe --help
2. 데스크톱 연결

대상 컴퓨터에서 RDP를 켜고 192.0.2.20과 USER를 바꾸세요. 숨김 프롬프트로 입력한 암호는 표준 입력으로 전달됩니다. JSON 응답의 data.session을 저장하세요.

PowerShell
$secret = Read-Host '암호' -AsSecureString
$savedEncoding = $OutputEncoding
try {
  $OutputEncoding = [System.Text.UTF8Encoding]::new($false)
  [System.Net.NetworkCredential]::new('', $secret).Password |
    .\rdp-cli.exe connect --host 192.0.2.20 --user USER --password-stdin
} finally {
  $OutputEncoding = $savedEncoding
  $secret.Dispose()
}
3. 먼저 화면 관찰

SESSION을 연결 결과로 바꾸고 before.png에서 대상 앱과 입력 위치를 확인하세요. 스크린샷 응답의 data.observation을 저장합니다.

PowerShell
.\rdp-cli.exe screenshot --session SESSION --out ./before.png
4. 조작 후 결과 확인

이미지에서 입력 위치를 찾고 X, Y, OBSERVATION을 바꾸세요. 클릭 후 다시 캡처하고 새 observation으로 입력합니다. after.png에서 실제 결과를 확인하세요.

PowerShell
.\rdp-cli.exe click --session SESSION --desktop --x X --y Y --observation OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out ./focused.png
.\rdp-cli.exe type --session SESSION --text "원격 작업이 완료되었습니다." --observation NEW_OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out ./after.png
5. 사람이 보고 싶을 때

필요할 때 기존 세션을 창이나 브라우저로 엽니다. 처음에는 읽기 전용입니다. 뷰어에서 중지, 인계, 반환하고 인계나 재연결 후에는 새 관찰을 얻습니다.

PowerShell
.\rdp-cli.exe watch --session SESSION --viewer window
.\rdp-cli.exe watch --session SESSION --viewer web
01 / 설치 및 확인

DMG를 열고 CLI를 활성화하세요.

rdp-cli를 응용 프로그램 폴더로 옮기고 macOS 터미널(zsh)에서 아래 명령을 실행합니다.

Mac 칩에 맞는 DMG를 선택하세요. Apple silicon은 macOS 13 이상, Intel은 macOS 12 이상이 대상입니다. 각 버전의 제공 여부는 다운로드 페이지에서 확인하세요.

zsh
/Applications/rdp-cli.app/Contents/MacOS/rdp-cli install-cli
rdp-cli --help
2. 데스크톱 연결

대상 컴퓨터에서 RDP를 켜고 192.0.2.20과 USER를 바꾸세요. 숨김 프롬프트로 입력한 암호는 표준 입력으로 전달됩니다. JSON 응답의 data.session을 저장하세요.

zsh
read -r -s "rdp_password?암호: "
printf '\n'
printf '%s' "$rdp_password" | rdp-cli connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
3. 먼저 화면 관찰

SESSION을 연결 결과로 바꾸고 before.png에서 대상 앱과 입력 위치를 확인하세요. 스크린샷 응답의 data.observation을 저장합니다.

zsh
rdp-cli screenshot --session SESSION --out ./before.png
4. 조작 후 결과 확인

이미지에서 입력 위치를 찾고 X, Y, OBSERVATION을 바꾸세요. 클릭 후 다시 캡처하고 새 observation으로 입력합니다. after.png에서 실제 결과를 확인하세요.

zsh
rdp-cli click --session SESSION --desktop --x X --y Y --observation OBSERVATION
rdp-cli screenshot --session SESSION --out ./focused.png
rdp-cli type --session SESSION --text "원격 작업이 완료되었습니다." --observation NEW_OBSERVATION
rdp-cli screenshot --session SESSION --out ./after.png
5. 사람이 보고 싶을 때

필요할 때 기존 세션을 창이나 브라우저로 엽니다. 처음에는 읽기 전용입니다. 뷰어에서 중지, 인계, 반환하고 인계나 재연결 후에는 새 관찰을 얻습니다.

zsh
rdp-cli watch --session SESSION --viewer window
rdp-cli watch --session SESSION --viewer web
01 / 설치 및 확인

파일 하나로 실행

Linux x86_64 파일을 다운로드하고 실행 권한을 부여한 뒤 터미널에서 실행하세요. 관리자 권한은 필요하지 않습니다.

목록의 x86_64 시스템에서 동일한 정적 ELF를 사용합니다. 다른 버전과 CPU 아키텍처는 이번 출시 범위에 포함되지 않습니다.

Bash
chmod u+x ./rdp-cli-linux-x86_64
./rdp-cli-linux-x86_64 --help
2. 데스크톱 연결

대상 컴퓨터에서 RDP를 켜고 192.0.2.20과 USER를 바꾸세요. 숨김 프롬프트로 입력한 암호는 표준 입력으로 전달됩니다. JSON 응답의 data.session을 저장하세요.

Bash
IFS= read -r -s -p '암호: ' rdp_password
printf '\n'
printf '%s' "$rdp_password" | ./rdp-cli-linux-x86_64 connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
3. 먼저 화면 관찰

SESSION을 연결 결과로 바꾸고 before.png에서 대상 앱과 입력 위치를 확인하세요. 스크린샷 응답의 data.observation을 저장합니다.

Bash
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./before.png
4. 조작 후 결과 확인

이미지에서 입력 위치를 찾고 X, Y, OBSERVATION을 바꾸세요. 클릭 후 다시 캡처하고 새 observation으로 입력합니다. after.png에서 실제 결과를 확인하세요.

Bash
./rdp-cli-linux-x86_64 click --session SESSION --desktop --x X --y Y --observation OBSERVATION
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./focused.png
./rdp-cli-linux-x86_64 type --session SESSION --text "원격 작업이 완료되었습니다." --observation NEW_OBSERVATION
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./after.png
5. 사람이 보고 싶을 때

필요할 때 기존 세션을 창이나 브라우저로 엽니다. 처음에는 읽기 전용입니다. 뷰어에서 중지, 인계, 반환하고 인계나 재연결 후에는 새 관찰을 얻습니다.

Bash
./rdp-cli-linux-x86_64 watch --session SESSION --viewer window
./rdp-cli-linux-x86_64 watch --session SESSION --viewer web
01 / 설치 및 확인

파일 하나로 실행

64비트 ARM Linux용 Linux ARM64 파일을 다운로드하고 실행 권한을 부여한 뒤 일반 사용자로 실행하세요.

하나의 정적 ARM64 ELF가 명시된 Linux 시스템, Raspberry Pi 4, DGX Spark를 지원합니다. 32비트 Raspberry Pi OS는 지원하지 않습니다.

Bash
chmod u+x ./rdp-cli-linux-arm64
./rdp-cli-linux-arm64 --help
2. 데스크톱 연결

대상 컴퓨터에서 RDP를 켜고 192.0.2.20과 USER를 바꾸세요. 숨김 프롬프트로 입력한 암호는 표준 입력으로 전달됩니다. JSON 응답의 data.session을 저장하세요.

Bash
IFS= read -r -s -p '암호: ' rdp_password
printf '\n'
printf '%s' "$rdp_password" | ./rdp-cli-linux-arm64 connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
3. 먼저 화면 관찰

SESSION을 연결 결과로 바꾸고 before.png에서 대상 앱과 입력 위치를 확인하세요. 스크린샷 응답의 data.observation을 저장합니다.

Bash
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./before.png
4. 조작 후 결과 확인

이미지에서 입력 위치를 찾고 X, Y, OBSERVATION을 바꾸세요. 클릭 후 다시 캡처하고 새 observation으로 입력합니다. after.png에서 실제 결과를 확인하세요.

Bash
./rdp-cli-linux-arm64 click --session SESSION --desktop --x X --y Y --observation OBSERVATION
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./focused.png
./rdp-cli-linux-arm64 type --session SESSION --text "원격 작업이 완료되었습니다." --observation NEW_OBSERVATION
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./after.png
5. 사람이 보고 싶을 때

필요할 때 기존 세션을 창이나 브라우저로 엽니다. 처음에는 읽기 전용입니다. 뷰어에서 중지, 인계, 반환하고 인계나 재연결 후에는 새 관찰을 얻습니다.

Bash
./rdp-cli-linux-arm64 watch --session SESSION --viewer window
./rdp-cli-linux-arm64 watch --session SESSION --viewer web

예시 주소와 값을 실제 값으로 바꾸세요. 응답의 session과 observation을 사용하고, 입력 후 새 스크린샷으로 결과를 확인하세요.

Agent와 사용

프로그램 경로, 허가된 대상이나 세션, 원하는 결과를 전달하세요. 선택 사항인 rdp-cli-agent 스킬에 흐름이 있으며 SKILL.md를 직접 읽을 수 있습니다. 연결에 스킬 설치가 필수는 아닙니다.

rdp-cli-agent / SKILL.md ↓

연결 및 접근 설정

RDP 인증서 정책의 초기값은 호환성을 위한 ignore입니다. connect --help를 확인하고 환경에 맞게 검증을 설정하세요. 웹사이트는 세션을 중계하거나 암호를 수집하지 않습니다. 브라우저는 LAN/VPN 용이며 VNC에는 신뢰할 수 있는 네트워크가 필요합니다.

rdp-cli@weerocks.com