원격 페더레이션 (ssh)
ssh 너머 다른 머신의 pytmux 서버 탭을 지금 화면에 끌어와, 로컬 탭과 원격 탭을 한 창에서 섞이지 않게 함께 씁니다.
붙이기 · 분홍 탭
remote-attach <host> 로 ssh 너머 다른 머신의 pytmux 서버에 붙습니다. 원격 탭은
탭바·외곽선을 분홍색으로 구분하며, 로컬 탭과 섞이지 않습니다. 원격 서버가 없으면
분리 서버를 자동 기동합니다(PYTMUX_NO_REMOTE_AUTOSTART=1 로 opt-out). 전송은
ssh -T 이며, 접속 대상·인증은 사용자의 ssh 설정(~/.ssh/config·
known_hosts·키)을 그대로 따릅니다.
원격 탭 다루기
| 명령 | 동작 |
|---|---|
remote-attach <host> | 원격 서버의 탭들을 붙이기 |
remote-new-tab | 원격에 새 터미널을 만들어 새 탭으로 붙이기 |
merge-remote-tab | 같은 원격 서버의 다른 탭을 현재 탭에 패널로 합치기(피커) |
remote-detach [host] | 원격 호스트 떼어내기(비우면 전체). 원격 탭의 [x] 는 그 탭 하나만 분리합니다(같은 호스트의 다른 원격 탭은 그대로) |
원격 탭도 고정(핀)할 수 있습니다(다운스트림 로컬 뷰 기준). 이 핀은 호스트 기준으로
기억해, 같은 호스트에 다시 remote-attach 하거나 끊겨서 자동 재연결돼도
유지됩니다 — 그 사이 원격에 새로 생긴 탭만 비고정으로 붙고, 없어진 탭의 핀은 사라집니다.
remote-detach 로 직접 떼어내면 그 호스트의 핀은 잊습니다(다시 붙이면 전부 비고정).
원격에서 pytmux 를 다시
돌리는 중첩 상황은 그 패널의 실제 ssh 목적지로 자동 승격됩니다
(nest-auto-attach, 기본 on — nest-auto-attach off 로 끄면 거부).
여러 기기에서 볼 때 화면 크기 (호스트 SSH keepalive 권장)
한 원격 서버를 여러 기기가 동시에 보면, 화면은 tmux 처럼 기본적으로 가장 작은
화면에 맞춰집니다(smallest — 남는 영역은 빈 여백 띠로 채워집니다). 어떤 기기가 정상 종료 없이
끊기면(노트북 절전·네트워크 단절 등) 그 유령 접속이 남아 화면을 계속 작게
붙잡을 수 있습니다. 지금 화면에서 detach -a(다른 접속 내보내기)로, 또는 그
접속을 가진 기기에서 remote-detach 로 정리되지만, 유령을 근본적으로
막으려면 원격 서버를 여는 호스트의 SSH 데몬이 죽은 접속을 스스로 끊게 해 두는 것이 좋습니다.
여백 띠가 유령이 아니라 진짜 작은 기기 때문이라면, window-size(별칭
winsize)로 공유 격자 크기 기준을 바꿀 수 있습니다(tmux 동형). :settings →
동작 → window-size 에서도 고를 수 있고, 값은 서버에 영속됩니다.
| 값 | 공유 격자 크기 |
|---|---|
smallest (기본) | 가장 작은 접속에 맞춤 — 아무도 잘리지 않지만 큰 화면엔 여백 띠가 남습니다. |
latest | 마지막으로 조작한(입력·마우스·스크롤·리사이즈) 접속의 크기에 맞춤. 아직 아무 조작도 없으면 smallest 로 폴백합니다. |
largest | 가장 큰 접속에 맞춤. |
latest·largest 에서는 작은 접속이 공유 격자를 다
담지 못해 오른쪽·아래가 잘립니다(여백 띠가 아니라 잘림 — 하나의 공유 격자를 나눠 보는
구조의 한계로, tmux 도 같은 트레이드오프입니다). 그래서 기본은 아무도 안 잘리는 smallest 입니다.
macOS · Linux — 호스트에서 드롭인 한 파일(관리자 권한):
약 45초(15초 × 3회) 무응답이면 죽은 접속으로 보고 끊습니다. macOS 는 접속마다 sshd 를
새로 띄우므로 재시작 없이 다음 접속부터 적용됩니다. Linux 는
sudo systemctl reload ssh(배포판에 따라 sshd)로 반영합니다. 드롭인 디렉토리가
없으면 /etc/ssh/sshd_config 에 위 두 줄을 직접 추가해도 됩니다.
Windows(OpenSSH 서버 호스트) — C:\ProgramData\ssh\sshd_config 에 같은 두 줄을
추가하고, 관리자 PowerShell 에서 Restart-Service sshd 로 재시작합니다.