사용 방법
- 서버마다 별칭, 주소(HostName), 사용자, 포트, 개인키 경로를 입력합니다. 서버 추가 로 여러 서버를 만들 수 있습니다.
- 필요하면 점프 호스트(
ProxyJump)와 포트 포워딩(LocalForward)을 적습니다. - 아래 Host * 기본값으로 연결 유지, 키 자동 추가, 호스트 키 확인 방식 같은 공통 설정을 고릅니다.
- 생성된 내용을
~/.ssh/config에 붙여넣고chmod 600 ~/.ssh/config로 권한을 맞춥니다. 이제ssh 별칭만으로 접속합니다.
항목 설명
| 항목 | 지시어 | 설명 |
|---|---|---|
| 별칭 | Host |
ssh myserver 에서 쓸 이름. 공백으로 여러 개, *·? 패턴도 가능 |
| 주소 | HostName |
실제 IP 또는 도메인 |
| 사용자·포트 | User, Port |
포트 22 는 기본값이라 생략됩니다 |
| 개인키 | IdentityFile, IdentitiesOnly |
사용할 키 파일. IdentitiesOnly 는 에이전트의 다른 키를 시도하지 않게 해 인증 실패 횟수를 줄입니다 |
| 점프 호스트 | ProxyJump |
배스천 서버를 거쳐 접속. ops@bastion:2222,jump2 처럼 쉼표로 여러 단계 |
| 포트 포워딩 | LocalForward |
5433:localhost:5432 는 내 컴퓨터 5433 포트를 서버 쪽 localhost:5432 로 연결 |
| 연결 유지 | ServerAliveInterval, ServerAliveCountMax |
60초마다 확인 신호를 보내고 3번 응답이 없으면 끊습니다 |
| 호스트 키 확인 | StrictHostKeyChecking |
accept-new 는 처음 보는 호스트만 자동 등록하고 키가 바뀌면 거부합니다 |
| 연결 재사용 | ControlMaster, ControlPersist |
같은 서버에 여러 번 접속할 때 연결을 재사용해 빨라집니다 |
생성 예시
기본값으로 만들면 다음과 같이 나옵니다.
Host myserver
HostName 203.0.113.10
User deploy
IdentityFile ~/.ssh/id_ed25519
IdentitiesOnly yes
Host *
ServerAliveInterval 60
ServerAliveCountMax 3
AddKeysToAgent yes
StrictHostKeyChecking accept-new
Host * 블록은 항상 맨 뒤에 놓입니다. ssh 는 같은 옵션이 여러 블록에 있으면 먼저 찾은 값을 쓰므로, 구체적인 서버 설정이 앞에, 공통 기본값이 뒤에 와야 서버별 값이 이깁니다. 주소는 문서용 예시 IP(203.0.113.10)입니다.
보안 주의
- 개인키 내용을 붙여넣지 마세요. 이 도구는 키 파일의 경로만 받으며, 키 내용처럼 보이는 입력은 사용하지 않고 경고합니다. 공개키 파일(
.pub)을IdentityFile에 쓰는 실수도 알려 줍니다. ForwardAgent yes는 접속한 서버의 관리자나 침입자가 내 에이전트로 다른 서버에 접속할 수 있게 합니다. 신뢰하는 서버에만 쓰고, 배스천을 거치는 용도라면ProxyJump가 더 안전합니다.StrictHostKeyChecking no는 이 도구가 만들지 않습니다. 중간자 공격을 막는 확인을 끄는 설정이기 때문입니다.- 설정 파일은 본인만 쓸 수 있어야 합니다(
chmod 600). 권한이 느슨하면 ssh 가 파일을 거부합니다. 권한 숫자는 chmod 계산기에서 확인하세요. - 생성된 설정은 사용하기 전에 검토하세요.
ssh -G 별칭으로 ssh 가 실제로 적용할 값을 볼 수 있습니다. - 서버 쪽 방화벽 규칙은 방화벽 규칙 생성기, 서버에서 앱을 서비스로 돌리는 설정은 systemd 서비스 생성기에서 만들 수 있고, 접속용 비밀번호는 비밀번호 생성기로 만들 수 있습니다. 내부 네트워크 주소 계산은 IP 서브넷 계산기를 참고하세요.
자주 묻는 질문
SSH 키는 어떻게 만드나요?
터미널에서 ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519 를 실행하면 개인키와 공개키(.pub)가 만들어집니다. 공개키 내용을 서버의 ~/.ssh/authorized_keys 에 넣으면 되며, ssh-copy-id 명령으로 자동화할 수 있습니다. 개인키는 절대 공유하지 마세요.
Host 별칭과 HostName 은 무엇이 다른가요?
Host 는 명령줄에 입력하는 이름이고 HostName 은 실제로 접속할 주소입니다. Host prod 와 HostName 203.0.113.10 이면 ssh prod 가 그 주소로 접속합니다.
설정이 적용되지 않는 것 같을 때는 어떻게 하나요?
ssh -G 별칭 으로 최종 적용 값을 확인하세요. Host * 를 앞에 쓰면 그 값이 먼저 적용되어 아래 서버별 값이 무시될 수 있습니다. 파일 권한이 600 이 아니어도 무시됩니다.
접속이 자꾸 끊기면 어떻게 하나요?
ServerAliveInterval 60 과 ServerAliveCountMax 3 으로 주기적으로 신호를 보내면 NAT 나 방화벽이 유휴 연결을 끊는 문제를 줄일 수 있습니다.
입력한 내용이 서버로 전송되나요?
아니요. 설정은 브라우저 안에서만 만들어집니다.
입력한 내용은 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.