자동 실행 검증 A · Ubuntu 26.04 · 2026-11-06게시 2026-11-06최종 확인 2026-11-06읽기 5분

ssh-agent 자동 시작·키 자동 등록: 셸마다 passphrase 묻는 문제

새 터미널을 열 때마다 SSH 키 passphrase를 다시 묻는다면 ssh-agent 소켓 경로를 고정하고 AddKeysToAgent를 켠다. ~/.bashrc 스니펫과 확인 결과를 정리했다.

30초 요약

  • 셸을 열 때마다 passphrase를 다시 묻는 것은 새 셸이 기존 ssh-agent를 찾지 못해서다. 소켓 경로를 고정해 agent 하나를 재사용하면 해결된다.
  • ~/.bashrc에는 SSH_AUTH_SOCK을 $HOME/.ssh/agent.sock으로 고정하고, ssh-add -l이 종료 코드 2로 실패할 때만 ssh-agent -a로 띄우는 몇 줄을 넣는다.
  • ~/.ssh/config에 AddKeysToAgent yes를 두면 키를 처음 쓸 때 agent에 올라간다.

증상/목표

터미널을 새로 열고 git push나 ssh를 하면 키 passphrase를 또 물어본다. 지난 터미널에서 이미 입력했는데도 그렇다. 이 글의 목표는 로그인 뒤 처음 한 번만 입력하고, 이후 새 셸에서는 묻지 않게 만드는 것이다.

Linux와 WSL처럼 bash를 쓰는 환경을 기준으로 쓴다. 설정할 파일은 ~/.bashrc와 ~/.ssh/config 둘이다.

원인

ssh-agent는 시작할 때 Unix 도메인 소켓을 만들고 그 경로를 SSH_AUTH_SOCK 환경변수에 저장한다. ssh와 ssh-add는 이 변수로 agent를 찾는다.

환경변수는 셸마다 따로 갖는다. 새 셸에 SSH_AUTH_SOCK이 없으면 agent가 떠 있어도 찾지 못한다. 반대로 .bashrc에 eval "$(ssh-agent -s)"만 넣으면 셸을 열 때마다 agent가 새로 뜬다. 어느 쪽이든 키는 매번 처음부터 등록해야 한다.

러너에서 SSH_AUTH_SOCK 없이 ssh-add -l을 실행하면 아래 오류가 난다. 아래 해결 방법의 수정 전 상태다.

Could not open a connection to your authentication agent.

해결 방법

1. ssh config에 AddKeysToAgent를 켠다

~/.ssh/config에 다음을 넣는다. 가장 간단한 방법이고, GitHub 문서도 같은 옵션을 안내한다.

Host github.com
AddKeysToAgent yes
IdentityFile ~/.ssh/id_ed25519

AddKeysToAgent의 허용 값은 no(기본값), yes, confirm, ask, 그리고 시간 간격이다. yes면 파일에서 불러온 키와 passphrase가 기본 수명으로 agent에 추가된다.

모든 호스트에 적용하려면 Host *를 쓴다. 이 옵션은 agent가 떠 있어야 효과가 있으므로 다음 단계가 필요하다.

2. ~/.bashrc에서 agent를 하나만 띄운다

~/.bashrc 끝에 다음을 추가한다.

Terminal window
export SSH_AUTH_SOCK="$HOME/.ssh/agent.sock"
ssh-add -l >/dev/null 2>&1
if [ $? -eq 2 ]; then
rm -f "$SSH_AUTH_SOCK"
eval "$(ssh-agent -a "$SSH_AUTH_SOCK" -s)" >/dev/null
fi

ssh-agent -a는 agent를 지정한 소켓 경로에 묶는다. 경로를 주지 않으면 임의 이름의 소켓이 만들어져 다른 셸이 찾을 수 없다. 최근 OpenSSH는 $HOME/.ssh/agent 아래에, 이전 버전은 /tmp 아래에 만든다(OpenSSH 10.1부터 /tmp에서 ~/.ssh/agent 아래로 옮겼다는 릴리스 노트가 있다). -s는 Bourne 셸용 환경변수 설정 명령을 출력하고, eval이 그것을 현재 셸에 적용한다.

ssh-add -l이 종료 코드 2를 돌려주면 agent에 연결하지 못했다는 뜻이다. 이때만 오래된 소켓 파일을 지우고 새로 띄운다. 키가 없는 agent는 종료 코드 1이므로 건드리지 않는다.

3. 키를 한 번 등록한다

새 셸을 열어 .bashrc를 읽게 한 다음, AddKeysToAgent yes를 켠 호스트에 한 번 접속하면 passphrase를 묻고 키가 올라간다. 접속하기 전에 미리 올리려면 ssh-add ~/.ssh/id_ed25519를 실행한다. 키 파일 이름이 다르면 그 이름으로 바꾼다.

이후 새로 여는 셸은 같은 소켓을 읽으므로 passphrase를 묻지 않는다.

macOS는 설정이 다르다. GitHub 문서는 AddKeysToAgent yes와 함께 UseKeychain yes를 두어 passphrase를 키체인에 저장하라고 안내한다. Bad configuration option: usekeychain 오류가 나면 IgnoreUnknown UseKeychain을 추가한다.

확인

verify 스크립트는 러너의 홈을 건드리지 않도록 임시 HOME을 만들고 passphrase가 있는 ed25519 키를 새로 만든다. 새 셸은 bash -c로 프로세스를 새로 띄워 흉내 냈고, passphrase 입력은 SSH_ASKPASS_REQUIRE=force로 대신했다.

확인한 것은 다음이다.

  • SSH_AUTH_SOCK 없이 ssh-add -l을 실행하면 위 오류로 실패한다.
  • 스니펫을 읽은 첫 번째 셸에서 키를 등록하면 고정한 경로에 소켓이 생긴다.
  • 두 번째와 세 번째 셸에서 ssh-add -l이 같은 키 지문을 보여 주고, ssh-agent 프로세스는 하나뿐이다.
  • ssh -G가 addkeystoagent true를 보여 준다.

검증 범위: 스니펫의 agent 재사용과 키 등록은 실행으로 확인했다. AddKeysToAgent가 첫 접속 때 키를 올리는 동작은 접속할 서버가 없어 실행하지 않았고, 설정이 읽히는 것까지만 확인했다. 나머지는 OpenSSH 매뉴얼과 GitHub 문서로 대조했다. macOS의 UseKeychain도 GitHub 문서 대조다.

CI 실행 결과 · 수정 전 재현 1건 · 수정 후 9/9 단계 성공
검증 환경 3항목
OSUbuntu 26.04.1
bash5.3.9
실행 날짜2026-11-06
실행 기록
[PASS] OpenSSH 클라이언트가 설치돼 있다
[PASS] passphrase가 있는 ed25519 키를 만들었다
[PASS] 키 지문을 읽었다
수정 전 재현 · 예상된 실패 1건 재현됨수정 전: 새 셸에 agent가 없다
[XFAIL] SSH_AUTH_SOCK 없이 ssh-add -l — 예상된 실패 재현됨 (/Could not open a connection to your authentication agent/)
    > Could not open a connection to your authentication agent.
수정 후 확인 · 6/6 단계 성공수정 후: 스니펫이 소켓 경로를 고정해 agent를 하나만 재사용한다
[PASS] 첫 번째 셸에서 키를 agent에 등록했다
[PASS] 고정한 경로에 agent 소켓이 만들어졌다
[PASS] 두 번째 셸에서 passphrase 없이 같은 키가 보인다
[PASS] 세 번째 셸에서도 같은 키가 보인다
[PASS] 셸을 세 번 열었는데 ssh-agent는 하나뿐이다
Pseudo-terminal will not be allocated because stdin is not a terminal.
[PASS] ssh -G가 addkeystoagent true를 보여 준다
이 결과는 글의 명령어를 GitHub Actions의 깨끗한 환경에서 그대로 실행해 자동으로 붙인 것입니다.

주의

  • 소켓을 $HOME/.ssh/agent.sock처럼 고정하면 agent가 로그인 사이에도 남을 수 있다. 소켓은 현재 사용자만 접근하지만, 매뉴얼은 root나 같은 사용자의 다른 프로세스가 악용할 수 있다고 설명한다. 오래 두고 싶지 않으면 AddKeysToAgent에 시간 간격을 준다.
  • rm -f "$SSH_AUTH_SOCK"는 ssh-add -l이 종료 코드 2를 낼 때만 실행한다. 조건을 빼면 다른 셸이 쓰는 살아 있는 소켓까지 지워 agent가 둘로 갈라진다.

자주 묻는 질문

agent를 끄려면 어떻게 하나?

agent를 띄운 셸에서 ssh-agent -k를 실행한다. 이 명령은 SSH_AGENT_PID 환경변수가 가리키는 agent를 종료하는데, 그 변수는 eval로 agent를 띄운 셸에만 설정된다. 다른 셸에서는 소켓 파일을 쓰는 프로세스를 직접 찾아야 한다.

일정 시간 뒤에 키를 agent에서 빼려면?

AddKeysToAgent 4h처럼 시간 간격을 값으로 준다. 매뉴얼에 따르면 그 시간이 지나면 키가 agent에서 자동으로 제거된다. 형식은 sshd_config(5)의 TIME FORMATS 절을 따른다.

키를 쓸 때마다 확인을 받고 싶다면?

AddKeysToAgent confirm을 쓴다. ssh-add -c를 지정한 것과 같아서 키를 사용할 때마다 확인을 요청한다.

참고 자료