대형 기능 · SSH · SFTP native russh

SSH · SFTP

한 번 인증한 SSH 연결 하나 위에 터미널·원격 파일 탐색(SFTP)·추가 셸·포트 포워딩을 함께 올리는 MobaXterm식 클라이언트입니다. 호스트 등록 → 인-탭 접속 → 원격 편집·전송까지 앱을 떠나지 않고 끝냅니다.

접속하기

접속의 진입점은 우측 레일의 SSH 아이콘입니다. 누르면 접속 관리자가 우측 패널로 열려 저장한 호스트(그룹·검색)와 현재 세션을 한곳에서 봅니다. 바깥을 클릭하거나 Escape를 눌러도 닫히지 않습니다(항상 열림).

1. 레일에서 접속 관리자 열기

   호스트를 클릭하면 현재 Space에 탭이 열리며 접속을 시작합니다(저장한 프로필은 값이 채워진 채로, 더블클릭하면 바로 재접속). 헤더의 새 호스트, 볼트, 포트 포워딩도 여기서 엽니다.

   SSH 접속 관리자 — 우측 도킹 패널2 connected

   SSH 호스트

   ▾회사3

   🖥web-prod-01×2deploy · 22

   🖥web-prod-02×1deploy · 22

   🗄db-02postgres · 22

   ▾개인2

   🖥home-naszendy · 22

   🍓raspberrypipi · 2222

   ▸클라우드1

   ① 초록 dot = 접속 중, ×N = 세션 수(클릭하면 점프). ② 비밀은 저장하지 않고 호스트 정보만 보관합니다.

2. 인-탭 접속 폼

   새 탭 안에 접속 폼이 뜹니다. 호스트·사용자·포트를 채우고 인증을 고릅니다 — 비밀번호 / 공개키(키 경로 + 선택 passphrase) / SSH Agent. 접속에 성공하면 그 탭이 그대로 SSH 터미널이 됩니다.

   새 SSH 접속 — 인증: 공개키

   bash

   새 SSH 접속

   SSH 접속

   호스트

   예: deploy@web-prod-01.example.com

   사용자 이름

   인증

   비밀번호 공개키 SSH Agent

   개인키 경로

   passphrase · 선택

   취소접속

   ① 인증 3종(비밀번호·공개키·SSH Agent)을 세그먼트로 전환. ② 실패해도 host·user는 유지된 채 폼이 다시 떠 바로 재시도할 수 있습니다.

호스트키 신뢰 (TOFU)

처음 보는 서버이거나 호스트키가 바뀌면 접속을 멈추고 지문(fingerprint) 확인창을 띄웁니다. 수락하면 known_hosts에 기억해 다음부터 자동으로 접속합니다(TOFU = 최초 신뢰).

프로필 내보내기 · 가져오기

접속 관리자에서 호스트를 추가·편집하고 그룹·검색·더블클릭 재접속을 씁니다. 비밀은 절대 저장하지 않고 호스트·사용자·포트·인증방식·키 경로 같은 정보만 보관합니다(키 경로는 위치 참조일 뿐 키 내용이 아닙니다).

• 자체 JSON — 프로필 묶음을 파일로 주고받습니다. 비밀이 없어 유출 위험이 없습니다.
• ~/.ssh/config 가져오기 — 기존 OpenSSH 설정의 호스트를 그대로 읽어옵니다.
• 가져온 프로필은 목록에 그룹별로 나타나고 클릭·더블클릭으로 바로 접속합니다.

SFTP 원격 탐색기

SSH에 접속하면 좌측 파일 탐색기가 그 서버의 원격 트리로 자동 전환됩니다(MobaXterm식). 같은 연결 위에서 추가 로그인 없이 원격 홈을 펼칩니다.

• 더블클릭 편집 — 원격 파일을 열어 편집하고 저장하면 서버에 바로 씁니다. 서버에서 파일이 바뀌면 약 3초 안에 자동으로 다시 읽어옵니다(편집 중이면 확인창).
• 트리 자동 갱신 — 펼친 폴더의 생성·삭제를 3초마다 반영합니다.
• 원격 폴더에서 터미널 열기 — 컨텍스트 메뉴로 재인증 없이 같은 세션에 새 SSH 셸을 열고 그 폴더로 이동합니다.
• 프로젝트 스위처에 원격 포함 — 헤더 드롭다운이 로컬 프로젝트와 연결된 SSH(user@host)를 함께 보여주고, 원격을 고르면 로컬 터미널 탭으로 옮겨도 원격 트리가 유지됩니다.

5MB가 넘거나 바이너리인 파일은 로컬과 똑같이 편집기에서 열리지 않습니다. 원격 경로는 항상 / 형식(POSIX)입니다.

원격 파일 만들기 · 이름변경 · 삭제

우클릭 또는 에서 원격 트리에 파일·폴더를 만들고 이름을 바꾸고 삭제합니다 — 로컬 탐색기와 같은 흐름입니다.

• 상위 폴더 자동 생성 — 새 항목 이름에 a/b 처럼 적으면 없는 상위 폴더까지 함께 만듭니다.
• 폴더 통째 삭제 — 폴더는 안의 내용까지 한 번에 지웁니다.
• 영구 삭제 — 원격에는 휴지통이 없어 되돌릴 수 없으므로 로컬보다 강한 확인창을 띄웁니다.

파일 전송 (업로드 · 다운로드)

파일·폴더를 로컬↔원격으로 전송합니다. 다운로드는 원격 트리 우클릭 → "다운로드", 업로드는 듀얼 페인 드래그(아래)로 합니다. 대용량 파일도 앱 메모리를 거치지 않고 곧장 전송됩니다.

• 폴더 통째 전송 — 폴더를 옮기면 하위 파일까지 함께 전송합니다.
• 충돌 4선택 — 같은 이름이 있으면 덮어쓰기 / 건너뛰기 / 모두 덮어쓰기 / 모두 건너뛰기를 묻습니다.
• 진행 바 + 취소 — 현재 파일·건수·% 진행 바를 탐색기 안에 표시하고 취소할 수 있습니다.

듀얼 페인 SFTP (드래그 전송)

SSH 터미널 탭의 "SFTP 열기" 버튼으로 같은 연결의 원격 트리를 별도 탭으로 띄우고, 좌측 탐색기 ↔ SFTP 탭 사이로 파일을 드래그해 전송합니다(MobaXterm 듀얼패널 방식). 접속이 여럿이면 어느 연결에 붙을지 고르는 선택창이 뜹니다.

운영체제 바탕화면이나 파일 탐색기에서 끌어다 놓는 방식은 지원하지 않습니다 — 전송은 앱 안의 두 패널 사이 드래그로 합니다.

셸 따라가기 (cd → 트리 동기)

SSH 셸에서 cd 하면 원격 페인과 좌측 원격 탐색기가 그 경로로 자동으로 따라옵니다(셸→트리 단방향). 기본은 꺼져 있고, 토글을 켜야 동작합니다.

• 켜는 순간 셸에 설정 한 줄이 1회 들어갑니다(스크롤백에 한 줄 보이는 건 켠 결과로 정상입니다).
• bash · zsh에서 동작하며 기존 셸 설정을 건드리지 않습니다(fish 등은 무동작).
• 원격 페인의 "CWD 따라가기" 토글과 좌측 탐색기 토글은 같은 상태를 공유합니다.

자격증명 볼트

SSH 비밀(비밀번호 · 키 passphrase)을 암호화해 저장하고, 저장한 프로필에 접속할 때 자동으로 쓰는 선택형 볼트입니다(매번 입력 불필요). 접속 관리자 헤더의 볼트 아이콘으로 엽니다.

• 암호화 — 모든 비밀은 하나의 마스터 비밀번호로 잠긴 볼트(AES-256-GCM)에 저장됩니다. 볼트 파일은 설정 DB와 분리됩니다.
• 앱 내부에만 보관 — 저장된 비밀의 평문은 화면(앱 UI)으로 다시 꺼내지지 않고, 접속할 때 앱 내부에서만 사용됩니다.
• 접속 통합 — 폼의 USE 토글로 저장된 자격증명을 쓰고(필요하면 마스터 비번 입력), SAVE 체크로 접속 성공 후 저장합니다.

포트 포워딩 터널

SSH 연결 위에 로컬(-L)·다이내믹 SOCKS5(-D) 포트 포워딩 터널을 만듭니다. 설정은 프로필에 저장되고(host:port만, 비밀 아님) 접속에 성공하면 자동으로 수립됩니다. 바인드는 127.0.0.1만이라 LAN에 노출되지 않습니다.

• 로컬(-L) — 내 PC의 포트를 원격 너머의 host:port로 연결합니다(예: 127.0.0.1:5432 → db-02:5432).
• 다이내믹(-D) — SOCKS5 프록시로 동작해 브라우저·도구의 트래픽을 서버 너머로 보냅니다.
• 관리 — 접속 관리자의 "포트 포워딩" 버튼에서 활성 터널을 보고 중지하거나 즉석에서 추가합니다.

크로스플랫폼 · 보안

• 비밀 미저장 — SFTP·추가 셸·터널은 이미 인증된 연결을 재사용하므로 새 비밀이 없습니다. 재시작하면 원격 연결 상태는 복원하지 않고 로컬로 돌아옵니다.
• 크로스플랫폼 — Windows · macOS · Linux를 지원합니다(macOS는 일부 환경에서 추가 검증 중).