ssh-agent

SSH 클라이언트의 서명에 사용할 인증 키를 에이전트로 관리.

실행 전 확인

macOS에 에이전트가 이미 있을 수 있으므로 ssh-add -l부터 확인하세요. eval 예제는 PowerShell이 아닌 zsh/bash용입니다. 필요한 경우에만 별도 에이전트를 시작하고 직접 시작한 에이전트만 종료하세요. 환경 변수는 현재 셸과 자식 프로세스에 적용됩니다. 에이전트 전달(-A)을 함부로 켜지 마세요. 침해된 원격 호스트가 전달 중인 에이전트를 인증에 악용할 수 있습니다.

사용 예제

별도 에이전트를 시작하고 현재 셸에 환경 변수를 설정합니다.

eval "$(ssh-agent -s)"

위에서 시작한 에이전트를 종료하고 해당 셸 변수를 해제합니다.

eval "$(ssh-agent -k)"

옵션 및 예제

-s자주 사용

Bourne 호환 셸 명령을 인쇄하여 에이전트 환경 변수를 설정합니다. 예는 sh 호환 쉘에 대한 것입니다.

예제
eval "$(ssh-agent -s)"
-c

Bourne-shell 명령 대신 C-shell 명령을 인쇄합니다.

예제
ssh-agent -c
-k자주 사용

현재 환경에서 식별된 에이전트를 중지하는 명령을 인쇄합니다. 시작한 에이전트만 중지하십시오.

예제
eval "$(ssh-agent -k)"
-t life

ssh-add가 이를 재정의하지 않는 한 이 에이전트에 추가된 ID의 기본 수명을 설정하십시오.

예제
ssh-agent -t 1h
-a bind_address

에이전트를 지정된 Unix 소켓 경로에 바인딩합니다. 해당 소켓에 대한 액세스를 보호합니다.

예제
ssh-agent -a /tmp/example-ssh-agent.sock
-D

포그라운드에서 에이전트를 실행합니다. 감독에 유용합니다.

예제
ssh-agent -D

공식 참고 자료

검토일: 2026년 10월 27일