Windows에서 연결하기: 터미널과 OpenSSH

Windows 10과 11에 내장된 SSH 클라이언트를 다뤄요. 사용 가능 여부 확인, 연결, 키 생성, Windows Terminal 프로필, 그리고 흔한 문제 해결을 설명해요.

업데이트 2026년 8월 23일

Windows에서는 별도의 SSH 프로그램이 필요하지 않아요. OpenSSH 클라이언트가 시스템에 내장되어 있고, Windows Terminal은 제대로 된 탭과 글꼴을 제공해요.

클라이언트가 설치되어 있는지 확인하기

PowerShell 또는 Windows Terminal을 여세요.

ssh -V

버전이 출력되면 준비가 끝난 거예요. 명령을 찾을 수 없다면 구성 요소를 설치하세요.

Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0

이 명령에는 관리자 권한이 필요해요.

ssh root@203.0.113.10

주소와 바로 사용할 수 있는 명령은 머신 제어판의 “개요” 탭에서 복사할 수 있어요. 지문을 묻는 메시지가 나오면 yes라고 답한 뒤 “접근” 탭에 있는 root 비밀번호를 입력하세요. 입력하는 동안에는 문자가 표시되지 않아요.

첫 연결 시 발생하는 오류 해결 방법은 머신에 처음 로그인하기 문서에서 다뤄요.

Linux와 똑같이 동작해요.

ssh-keygen -t ed25519 -C "artem@windows"
type $env:USERPROFILE\.ssh\id_ed25519.pub

두 번째 명령은 공개 키를 출력해요. 그 줄을 제어판의 “접근” 탭에 붙여 넣으세요. 그곳의 키 목록은 전부 교체되니 SSH 키를 참고하세요.

연결할 때마다 키 암호를 입력하지 않으려면 에이전트를 활성화하세요.

Set-Service ssh-agent -StartupType Automatic
Start-Service ssh-agent
ssh-add $env:USERPROFILE\.ssh\id_ed25519

C:\Users\<you>\.ssh\config 파일을 만드세요.

Host vds
    HostName 203.0.113.10
    User root
    IdentityFile ~/.ssh/id_ed25519

그러면 ssh vds만으로 충분해요. 자세한 내용은 ~/.ssh/config 파일을 참고하세요.

설정 → 프로필 추가 → 빈 프로필:

이제 드롭다운 목록에서 머신이 자체 탭으로 열려요.

증상	해결 방법
`ssh: command not found`	OpenSSH 클라이언트 구성 요소가 설치되지 않음 (위 명령 참고)
`Bad owner or permissions on config`	`.ssh` 권한이 너무 넓음: 상속을 제거하고 자신의 계정에만 접근을 남기세요
`UNPROTECTED PRIVATE KEY FILE`	키 파일에도 같은 내용이 적용돼요
출력의 키릴 문자가 깨짐	오래된 `cmd` 콘솔 대신 Windows Terminal을 사용하세요
`REMOTE HOST IDENTIFICATION HAS CHANGED`	머신이 재설치됨: `ssh-keygen -R 203.0.113.10`
유휴 상태에서 연결이 끊김	`~/.ssh/config`에 `ServerAliveInterval 30`을 추가하세요

Linux와 같은 명령을 사용해요.

scp C:\work\dump.sql root@203.0.113.10:/root/

더 자세한 내용은 scp와 rsync 및 SFTP로 파일 전송하기를 참고하세요.

그래픽 인터페이스와 세션 창을 선호한다면 PuTTY도 여전히 선택지예요. 더 나쁘지 않고, 그저 다를 뿐이에요.