qsh

SSH 터널 관리

• 로컬 포트 포워딩(-L) 및 SOCKS5 동적 포워딩(-D) 지원
• 터널 상태 표시 및 연결/해제, 재연결 기능
• 별칭(alias) 생성, 편집, 삭제
• 터널 상태 변경 시에만 화면 갱신 (유휴 CPU 0%)

QuickSSH와 설정 공유

• Electron 앱과 동일한 config.json 파일 사용
• 원자적 쓰기 및 파일 잠금으로 동시 사용 안전
• GUI에서 만든 별칭이 터미널에서도 표시

대화형 SSH 세션

• 별칭에서 ‘h’ 키를 누르면 네이티브 SSH 세션 시작
• 색상, 마우스, 크기 조절, 스크롤백 등 완전한 터미널 지원

설치 방법

• Windows: PowerShell에서 irm https://github.com/allenbijo/QuickSSH-terminal/releases/latest/download/install.ps1 | iex 또는 winget install allenbijo.qsh
• macOS/Linux: curl -fsSL https://github.com/allenbijo/QuickSSH-terminal/releases/latest/download/install.sh | sh 또는 Homebrew brew install allenbijo/tap/qsh
• Debian/Ubuntu: .deb 패키지 다운로드 후 sudo apt install ./qsh.deb
• Fedora/RHEL: .rpm 패키지 다운로드 후 sudo rpm -i qsh.rpm
• 소스 빌드: Go 1.22+ 필요, go install github.com/allenbijo/QuickSSH-terminal/cmd/qsh@latest

기본 사용

1. 터미널에서 qsh 실행
2. 첫 실행 시 ‘n’으로 새 별칭 생성 또는 ‘s’로 SSH config 지정
3. 목록에서 Enter/Space로 터널 켜기/끄기
4. ‘h’로 SSH 세션 열기, ‘e’로 편집, ‘d’로 삭제, ‘r’로 재연결

활용 예시

• 로컬 포트를 원격 DB에 연결: prod-db 별칭으로 9000 포트를 db:5432로 포워딩
• SOCKS5 프록시로 브라우저 트래픽을 SSH 호스트로 라우팅
• tmux나 SSH 세션 내에서 qsh를 실행하여 원격 서버의 터널 관리

지원 환경 및 요구사항

• 운영체제: Windows 10+, macOS, Linux
• SSH 클라이언트가 PATH에 있어야 함 (Windows 10+의 OpenSSH, 또는 Git Bash)
• 256색 및 UTF-8 지원 터미널 (Windows Terminal, iTerm2, kitty 등)
• 소스 빌드 시 Go 1.22 이상

버전 및 업데이트

현재 버전은 0.2.0 (2026-07-08)이며, GitHub Releases에서 최신 릴리스를 확인할 수 있습니다.

라이선스 및 확인 사항

qsh는 MIT 라이선스로 배포됩니다. 초기 개발 단계이므로 사용 전에 GitHub 저장소의 문서와 이슈를 확인하는 것이 좋습니다.