첫 SSH 연결 설정하기
이 가이드는 TermAI에 첫 SSH 서버를 추가하는 절차를 약 3분에 안내합니다. 필요한 것: 서버의 IP 또는 호스트명, 사용자명, 비밀번호 또는 개인 키.
⏱ 연결 설정 가이드 · 2026년 10월 9일 업데이트
시작 전 준비
- TermAI 계정 (동기화 안 하려면 건너뛰기 가능)
- 서버 자격증명: 호스트명/IP, 포트 (보통 22), 사용자명, 비밀번호 또는 키
단계 1 — 연결 편집기 열기
SSH 탭을 열고 + 또는 연결 추가를 누릅니다. 이름, 호스트, 포트, 사용자 이름, 인증, 그룹, 태그를 설정합니다.
단계 2 — 기본 정보 입력
- 라벨 — "prod-web-01"과 같은 친근한 이름
- 호스트 — IP 주소 또는 호스트명 (192.168.1.100, myserver.example.com)
- 포트 — 기본값 22
- 사용자명 — SSH 사용자명 (root, ubuntu, 또는 본인 이름)
단계 3 — 인증 방식 선택
서버 계정의 비밀번호를 입력합니다. 사용자 이름은 SSH 로그인 이름이며 TermAI 이메일이 아닙니다. 서버에서 비밀번호 인증을 막았다면 개인 키를 사용하세요.
키를 선택하고 머리말, 꼬리말, 줄바꿈을 보존한 완전한 OpenSSH 개인 키를 붙여넣습니다. 암호화된 키는 암호도 입력합니다. 앱에서 키를 생성할 수도 있습니다. 대응하는 공개 키만 서버 대상 사용자의 ~/.ssh/authorized_keys에 추가하세요.
키를 추가하는 동안 기존 서버 연결을 유지하세요. 완전한 공개 키를 한 줄로 추가하고 개인 키를 authorized_keys에 넣거나 다른 키를 덮어쓰지 마세요.
개인 키 생성 →단계 4 — 첫 연결
저장한 연결로 터미널을 엽니다. TermAI는 최초 호스트 키를 기록(TOFU)하고 변경 시 경고합니다. 최초 신뢰만으로 서버 신원이 독립적으로 확인되지는 않습니다. 민감한 정보를 보내기 전에 관리자나 제공자 콘솔에서 지문을 확인하고 변경 이유를 알기 전에는 새 키를 승인하지 마세요.
ℹ️ 호스트 키 지문이란? 서버의 고유 식별자입니다. 첫 검증은 중간자 공격을 방지합니다. TermAI는 지문을 기억하고 변경 시 경고합니다.
문제 해결
| 오류 | 가능한 원인 | 해결 |
|---|---|---|
| Connection refused | SSH 미실행, 포트 오류 | 서버 가동 확인, 포트 재확인 |
| Permission denied (publickey) | 잘못된 키, 서버에 공개 키 없음 | authorized_keys에 공개 키 재복사 |
| Host key verification failed | 서버 호스트 키 변경됨 | 조사 (정당 또는 MITM), Known Hosts 업데이트 |
다음 단계
문서 문제 제보 → 2026년 10월 9일 업데이트