시작하기

5분 정도 걸립니다. 접속할 수 있는 SSH 서버가 하나 있어야 합니다.

1. 호스트 추가

터미널 탭에서 ☰을 눌러 접속을 열고 원격 터미널 · 새 SSH 호스트 추가를 누른 뒤 채웁니다.

2. 로그인 방식 고르기

인증에서 하나를 고릅니다. 무엇을 고르든 Android Keystore 키로 암호화되어 키체인에 저장되고, 다른 호스트에서도 다시 쓸 수 있습니다.

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. 도구바를 내 손에 맞게

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 안에서도 알림이 옵니다.

접속이 안 될 때