USER MANUAL
HyperMaru
사용자 매뉴얼
SSH · 터미널 · SFTP 통합 데스크탑 앱. 등록 · 접속 · 파일 전송 · 서비스 관리 · 백업까지 모든 일상 작업을 한 화면에서 처리할 수 있도록 설계했습니다.
버전 v1.3.6
최종 수정 2026.04.19
한국어
01 · OVERVIEW
개요
여러 SSH 서버를 등록하고 터미널 접속, 파일 전송(SFTP), 서비스 정보를 한 화면에서 관리할 수 있습니다.
핵심 기능
05
서비스 관리
WEB · DB · WAS · ETC
06
백업 / 복구
JSON 내보내기 · 가져오기
07
새 버전 알림
실행 시 업데이트 안내 모달
02 · LAYOUT
화면 구성
사이드바 · 탭 바 · 콘텐츠 · 상태바의 4-영역 구조입니다.
사이드바 헤더 버튼
+ 서버 추가
새 서버 등록 다이얼로그를 엽니다.
··· 더보기
서버 전체 목록 · 서비스 전체 목록 · 설정 · 정보 메뉴로 진입합니다.
더보기 메뉴
☰ 서버 전체 목록
등록된 모든 서버를 한 화면에서 검색·필터링·일괄 액션.
서비스 전체 목록
WEB·DB·WAS·ETC 서비스 일괄 관리 + 연관관계 그래프.
설정
그룹 · 터미널 · 백업/복구 탭으로 구성된 설정 창.
03 · SERVERS
서버 관리
등록 · 편집 · 그룹 드래그로 수십 대의 서버를 정리하세요.
서버 추가
사이드바 헤더의 + 버튼을 클릭합니다.
이름 · 호스트 · 사용자명을 입력합니다. (포트는 기본값 22)
인증 방식을 선택합니다 — 비밀번호 또는 SSH 키.
기존 그룹을 선택하거나 + 로 새 그룹을 생성합니다.
저장을 누르면 사이드바와 트리에 즉시 반영됩니다.
우클릭 컨텍스트 메뉴
터미널 연결
새 터미널 탭을 열어 SSH 접속합니다.
SFTP 연결
듀얼 패널 파일 브라우저를 엽니다.
상세정보 보기
서버 연결 정보 다이얼로그를 표시합니다.
삭제
서버 항목과 추가 사용자 정보를 제거합니다.
!
그룹 드래그 이동 — 서버 항목을 마우스로 끌어서 다른 그룹 헤더 위에 놓으면 그룹이 변경됩니다. 드래그 중에는 반투명 미리보기가 따라다닙니다.
04 · TERMINAL
터미널 접속
다섯 가지 연결 방법과 탭 조작 방식을 지원합니다.
5가지 연결 방법
METHOD 01
더블클릭
서버 항목을 더블클릭하면 바로 터미널 탭이 열립니다.
METHOD 02
우클릭
우클릭 메뉴에서 터미널 연결.
METHOD 03
전체 목록
··· → 서버 전체 목록 → 터미널 버튼.
METHOD 04
최근 접속
대시보드 하단의 최근 접속 목록 클릭.
METHOD 05
⌘K 팔레트
⌘K → 서버 검색 → Enter (SFTP는 ⇧Enter).
탭 조작
드래그 (좌우)
같은 탭 바 안에서 순서 변경 (삽입 위치 표시선)
드래그 (패널/가장자리)
다른 패널로 이동 · 가장자리/하단 드롭으로 새 패널 생성
i
단일 클릭은 동작하지 않습니다 — 서버 연결 정보를 보려면 우클릭 → 상세정보 보기를 사용하세요. 같은 서버에 여러 번 연결하면 탭에 #2, #3 번호가 표시되며, 우클릭 → 오른쪽/아래 새 패널로 이동으로 나란히 배치할 수 있습니다.
05 · PANELS & USERS
다중 패널 · 다중 사용자
화면을 자유롭게 분할하고, 하나의 서버에 여러 계정을 등록해 동시에 접속하세요.
다중 패널
탭 하단 드래그
패널 아래 영역으로 끌면 상하 분할이 생성됩니다.
구분선 드래그
패널 사이 구분선으로 크기를 조절합니다.
다중 사용자 등록
서버 1개에 여러 SSH 계정을 등록하고 접속 시 선택할 수 있습니다.
서버 편집 화면의 추가 사용자 섹션을 엽니다.
+ 추가를 누르고 표시명과 사용자명을 입력합니다.
인증 방식을 선택한 뒤 저장합니다.
접속 시 사용자 선택
06 · SFTP
SFTP 파일 브라우저
듀얼 패널 · 드래그 업로드 · 일괄 작업으로 빠르게 파일을 옮기세요.
파일 조작
상위 폴더
↑ 버튼 또는 브레드크럼 클릭. (Windows는 C:\ 위에서 드라이브 목록 표시)
업로드
원격 패널 ↑ 버튼 또는 로컬에서 드래그.
터미널로 드래그
로컬 파일을 SSH 터미널 탭 위로 드래그하면 터미널의 현재 디렉토리로 업로드 (우측 상단 진행률 표시).
★
다중 선택 — 파일/폴더 체크박스로 여러 항목을 선택하면 상단에 일괄 업로드 · 다운로드 · 삭제 바가 표시됩니다.
07 · SERVICES
서비스 관리
서버 위에서 도는 WEB · DB · WAS · ETC 서비스를 통합 관리합니다.
서비스 유형
DB
데이터베이스
호스트 · 포트 · 사용자명
WAS
애플리케이션 서버
호스트 · 포트 · 사용자명
서비스 등록 · 관리
방법 1 · 연결 다이얼로그
서버 클릭 → 서비스 → 서비스 추가
방법 2 · 전체 목록
··· → 서비스 전체 목록 → ✎ 편집
⊟
네트워크 그래프 — 서비스 전체 목록 우측 상단의 그래프 버튼으로 서버-서비스 연결 관계를 시각적으로 확인할 수 있습니다.
08 · SETTINGS
설정 & 단축키
터미널 스타일과 주요 마우스 조작을 설정 창에서 한 번에 다룰 수 있습니다.
터미널 설정
··· → 설정 → 터미널 탭에서 다음 항목을 변경할 수 있습니다.
폰트
총 9종 지원 (MesloLGS NF는 번들 — Nerd Font 아이콘 프롬프트 지원)
MesloLGS NF
SF Mono
Cascadia Code
Fira Code
JetBrains Mono
Hack
D2Coding
Consolas
Menlo
줄 간격
1.0 ~ 2.0 (0.1 단위 · 열린 터미널에 즉시 적용)
배경색
8가지 프리셋 + 직접 선택
Black
VS Dark
Dracula
Nord
Monokai
Solarized
Tokyo Night
One Dark
커서
모양 — 블록 / 밑줄 / 막대 · 깜빡임 켜기 / 끄기
변경 사항은 미리보기에서 즉시 확인되며, 저장하면 모든 터미널에 적용됩니다.
커맨드 팔레트 (⌘K)
⌘K / Ctrl+K
팔레트 열기 — 터미널 입력 중에도 동작
입력
서버(이름·호스트·계정)와 명령을 실시간 검색
Enter / ⇧Enter
터미널 접속 / SFTP 열기
주요 마우스 조작
서버 우클릭
컨텍스트 메뉴 (상세정보 보기 포함)
터미널 호버
우측 상단 퀵액션 칩 — ⇄ SFTP · ⧉ 새 세션
09 · BACKUP & RESTORE
백업 / 복구
그룹 · 서버 · 추가 사용자 데이터를 JSON 파일로 내보내고 가져옵니다.
··· → 설정 → 백업/복구 탭으로 진입.
백업 — JSON 내보내기
백업 파일 저장 버튼을 클릭합니다.
저장 위치 및 파일명을 선택합니다.
그룹 · 서버 · 추가 사용자가 JSON 파일로 저장됩니다.
기본 파일명 형식 — hypermaru-backup-YYYY-MM-DD.json
복구 — JSON 가져오기
전체 교체
기존 데이터 모두 삭제 후 복구
초기화 후 백업 시점으로 복원합니다. 현재 데이터는 사라지므로 신중하게 사용하세요.
추가
기존 데이터 유지 + 병합
현재 데이터를 유지하면서 백업 파일의 항목을 추가로 병합합니다.
복구 절차
복구 모드를 선택합니다 — 전체 교체 또는 추가.
백업 파일 열기 버튼을 클릭합니다.
JSON 백업 파일을 선택하면 자동으로 복구됩니다.
10 · STORAGE
데이터 저장 위치
OS별 설정 파일 경로와 추가 저장 정보입니다.
Windows
C:\Users\<사용자>\AppData\Local\HyperMaru
macOS
/Applications/HyperMaru.app
UI 설정
브라우저 localStorage (폰트 · 배경 · 커서)