ssh-copy-id

원격 계정의 authorized_keys에 공개 키 설치.

실행 전 확인

기존 인증 수단(보통 계정 암호), 쓰기 가능한 원격 홈 디렉터리, 호환 셸이 필요합니다. 모든 macOS나 Windows 설치에 포함되지는 않으므로 사용 가능 여부를 확인하세요. .pub 공개 키만 복사하세요. 키 설치는 암호 로그인을 비활성화하거나 OTP를 설정하지 않습니다.

사용 예제

기본 SSH 포트로 지정한 공개 키를 설치합니다.

ssh-copy-id -i ~/.ssh/id_ed25519.pub alice@server.example.com

포트 2222로 설치한 뒤 ssh -p 2222로 로그인을 확인합니다.

ssh-copy-id -p 2222 -i ~/.ssh/id_ed25519.pub alice@server.example.com

옵션 및 예제

-i identity_file자주 사용

서버에 설치할 공개 키를 선택하세요. 개인 키를 복사하지 마십시오.

예제
ssh-copy-id -i ~/.ssh/id_ed25519.pub alice@server.example.com
-p port자주 사용

지정된 SSH 포트에서 서버에 연결합니다.

예제
ssh-copy-id -p 2222 -i ~/.ssh/id_ed25519.pub alice@server.example.com
-n

키를 설치하지 않고 시험 실행을 수행합니다. 버전에 따라 가용성이 다릅니다.

예제
ssh-copy-id -n -i ~/.ssh/id_ed25519.pub alice@server.example.com
-f

키가 이미 있는지 확인하지 않고 강제 설치합니다. 중복이 발생할 수 있습니다.

예제
ssh-copy-id -f -i ~/.ssh/id_ed25519.pub alice@server.example.com
-o option

SSH 클라이언트 구성 옵션을 연결에 전달합니다.

예제
ssh-copy-id -o ConnectTimeout=10 -i ~/.ssh/id_ed25519.pub alice@server.example.com
-F configfile

대체 SSH 클라이언트 구성 파일을 사용하십시오.

예제
ssh-copy-id -F ~/.ssh/lab_config alice@server.example.com

공식 참고 자료

검토일: 2026년 10월 27일