시작하기
1. 호스트 추가
터미널 탭에서 ☰을 눌러 접속을 열고 원격 터미널 · 새 SSH 호스트 추가를 누른 뒤 채웁니다.
- 별칭 — 목록에 보일 이름. 예:
dev-server - 호스트 주소 — 도메인이나 IP. 예:
192.168.0.10 - 포트 — 보통
22 - 사용자 이름 — 서버의 계정. 예:
ubuntu
2. 로그인 방식 고르기
인증에서 하나를 고릅니다. 무엇을 고르든 Android Keystore 키로 암호화되어 키체인에 저장되고, 다른 호스트에서도 다시 쓸 수 있습니다.
- 새 키 생성(추천) — 이 기기에 봉인된 Ed25519 키를 만듭니다. 공개 키 복사를 누르고 서버에 넣습니다.
mkdir -p ~/.ssh && chmod 700 ~/.ssh echo '여기에-공개-키-붙여넣기' >> ~/.ssh/authorized_keys chmod 600 ~/.ssh/authorized_keys - 가져오기 — 가지고 있는 개인 키를 붙여 넣거나 파일로 고릅니다. 암호화된 키면 암호 문구를 넣습니다.
- 비밀번호 — 서버 비밀번호. 일회용 코드(OTP)를 묻는 서버는 접속할 때 입력합니다.
3. 처음 접속할 때 서버 키 확인
처음에는 서버 키의 지문이 보입니다. 신뢰를 누르기 전에 서버에서 확인한 지문과 같은지 대조하세요.
ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub
그 뒤로는 접속할 때마다 키를 확인합니다. 키가 바뀌면 접속하지 않고 알려 줍니다.
4. tmux나 Herdr로 세션 유지하기
휴대폰은 연결이 자주 끊깁니다. 서버에서 멀티플렉서를 쓰면 프로그램과 에이전트는 계속 돌고, Termexa는 같은 세션에 다시 붙습니다. 호스트를 추가할 때 실행할 명령에 넣거나, 접속한 뒤 직접 입력하세요.
tmux new -A -s main # "main"에 붙고, 없으면 만듭니다
herdr --session main # Herdr도 같습니다
단축키 패널에 둘러보기 키를 넣어 두세요(설정 → 단축키 패널에서 칸을 누르고 플러그인 탭에서 고릅니다). 누르면 세션·창·pane이 목록으로 보이고, 누른 곳으로 바로 갑니다.
~/.tmux.conf에 set -g set-clipboard on을 넣으면 tmux에서 복사한 글이 휴대폰 클립보드로 옵니다. 호스트마다 처음 한 번 묻고, 나중에는 호스트 편집의 서버의 클립보드 복사에서 바꿉니다.
5. 도구바를 내 손에 맞게
- 터미널 아래 두 줄 도구바에 Esc·Tab·Ctrl·Alt·Shift·Page Up/Down·방향키·Enter가 있습니다. 휴대폰 키보드를 내리면 그 아래에 더보기 패널이 보이고, 오른쪽 아래 키보드 버튼으로 다시 키보드를 엽니다.
- 설정 → 단축키 패널에서 키를 눌러 바꾸고, 줄을 끌어 순서를 바꾸고, 페이지를 늘립니다.
- 내 단축키로 Ctrl·Alt·Shift와 아무 키를 조합하고, 내 단축 메시지에 자주 치는 글을 저장하세요.
6. 파일
터미널 위쪽의 폴더 버튼을 누르면 같은 호스트의 SFTP 파일 창이 열립니다. 탐색, 올리기·받기, 이름 바꾸기, 권한 바꾸기, 글 파일 편집을 할 수 있고, 창을 닫아도 전송은 끝까지 이어지며, 아래 막대의 전송 목록 버튼에서 모든 호스트의 진행 상황과 기록을 봅니다. 항목을 길게 눌러 고른 뒤 선택 막대의 ⋮ 버튼으로 압축 파일을 서버에서 바로 풀거나 묶을 수 있고, 경로 줄의 별을 누르면 그 폴더가 즐겨찾기에 들어갑니다.
7. 명령이 끝나면 알림 받기
셸 통합을 켜면 10초 넘게 걸린 명령이 끝났을 때 다른 화면을 보고 있어도 알려 줍니다(설정의 터미널 알림을 켜 두세요). fish 4 이상은 이미 지원합니다. zsh는 ~/.zshrc 끝에 다음을 붙이세요.
# Termexa shell integration (OSC 133)
_termexa_osc() { if [ -n "$TMUX" ]; then printf '\ePtmux;\e\e]133;%s\a\e\\' "$1"; else printf '\e]133;%s\a' "$1"; fi; }
_termexa_precmd() { local s=$?; _termexa_osc "D;$s"; _termexa_osc A; return $s; }
_termexa_preexec() { _termexa_osc C; }
precmd_functions=(_termexa_precmd $precmd_functions)
preexec_functions+=(_termexa_preexec)
bash는 ~/.bashrc 끝에 붙이세요.
# Termexa shell integration (OSC 133)
_termexa_osc() { if [ -n "$TMUX" ]; then printf '\ePtmux;\e\e]133;%s\a\e\\' "$1"; else printf '\e]133;%s\a' "$1"; fi; }
_termexa_prompt() { local s=$?; _termexa_osc "D;$s"; _termexa_osc A; return $s; }
PROMPT_COMMAND="_termexa_prompt${PROMPT_COMMAND:+;$PROMPT_COMMAND}"
PS0='$(_termexa_osc C)'"$PS0"
tmux 안에서 쓰면 ~/.tmux.conf에 set -g allow-passthrough on도 넣으세요. 그러면 tmux 안에서도 알림이 옵니다.
접속이 안 될 때
- 호스트 카드의 ⋮ → 호스트 편집에서 연결 진단을 누르세요. 접속에 실패했을 때는 연결 상세 창에도 있습니다. 주소, 포트, 서버 키, 로그인을 차례로 확인해 어느 단계에서 막혔는지 알려 줍니다.
- 서버 방화벽과 클라우드 보안 규칙에서 22번(또는 쓰는 포트)이 열려 있는지 확인하세요.
- 키로 접속한다면 같은 사용자의
~/.ssh/authorized_keys에 공개 키가 있고 파일 권한이chmod 600인지 확인하세요.