ssh-copy-id

로컬 공개 키를 원격 호스트의 ~/.ssh/authorized_keys에 추가한다.

비밀번호 또는 기존 SSH 인증으로 접속한 뒤, 로컬 공개 키를 원격 계정에 설치할 때 사용한다.

ssh-copy-id [user@]hostname
ssh-copy-id -i ~/.ssh/id_ed25519.pub user@example.com
ssh-copy-id -p 2222 user@example.com

• ssh-copy-id [<switches>…] [user@]hostname

• -f: 이미 설치 여부를 검사하지 않고 공개 키 복사를 강제로 진행
• -n: dry run. 실제 복사 없이 수행 내용만 확인
• -h: 도움말 출력
• -?: 도움말 출력
• -i identity_file: 기본 키 대신 지정한 공개 키 파일 사용
• -p port: 원격 SSH 포트 지정
• -o option: 내부적으로 호출되는 ssh에 -o 옵션 전달

# 현재 사용자의 기본 공개 키를 원격 계정에 등록
ssh-copy-id user@example.com
 
# 특정 공개 키 파일을 사용
ssh-copy-id -i ~/.ssh/id_ed25519.pub user@example.com
 
# 비표준 SSH 포트로 접속
ssh-copy-id -p 2222 user@example.com
 
# 실제 복사 없이 동작만 확인
ssh-copy-id -n user@example.com

ssh-copy-id -h

Usage: /usr/bin/ssh-copy-id [-h|-?|-f|-n] [-i [identity_file]] [-p port] [[-o <ssh -o options>] ...] [user@]hostname
	-f: force mode -- copy keys without trying to check if they are already installed
	-n: dry run    -- no keys are actually copied
	-h|-?: print this help

• ssh
• ssh-keygen

• codex:: 2026-06-14 Migrated page structure for CLI readability and preserved existing option coverage.