USER MANUAL

HyperMaru
사용자 매뉴얼

SSH · 터미널 · SFTP 통합 데스크탑 앱. 등록 · 접속 · 파일 전송 · 서비스 관리 · 백업까지 모든 일상 작업을 한 화면에서 처리할 수 있도록 설계했습니다.

버전 v1.0.7 최종 수정 2026.04.19 한국어
01 · OVERVIEW

개요

여러 SSH 서버를 등록하고 터미널 접속, 파일 전송(SFTP), 서비스 정보를 한 화면에서 관리할 수 있습니다.

핵심 기능

01
다중 탭
여러 서버에 동시 접속
02
다중 패널
화면을 좌우 / 상하로 분할
03
다중 사용자
서버 1개에 여러 계정
04
SFTP
GUI 파일 브라우저
05
서비스 관리
WEB · DB · WAS · ETC
06
백업 / 복구
JSON 내보내기 · 가져오기
02 · LAYOUT

화면 구성

사이드바 · 탭 바 · 콘텐츠 · 상태바의 4-영역 구조입니다.

사이드바 헤더 버튼

사이드바 ◀ / ▶
사이드바 접기 / 펼치기
+ 서버 추가
새 서버 등록 다이얼로그를 엽니다.
··· 더보기
서버 전체 목록 · 서비스 전체 목록 · 설정 · 정보 메뉴로 진입합니다.

더보기 메뉴

☰ 서버 전체 목록
등록된 모든 서버를 한 화면에서 검색·필터링·일괄 액션.
서비스 전체 목록
WEB·DB·WAS·ETC 서비스 일괄 관리 + 연관관계 그래프.
설정
그룹 · 터미널 · 백업/복구 탭으로 구성된 설정 창.
정보
앱 버전 · 빌드 정보 · 라이선스.
03 · SERVERS

서버 관리

등록 · 편집 · 그룹 드래그로 수십 대의 서버를 정리하세요.

서버 추가

  1. 사이드바 헤더의 + 버튼을 클릭합니다.

  2. 이름 · 호스트 · 사용자명을 입력합니다. (포트는 기본값 22)

  3. 인증 방식을 선택합니다 — 비밀번호 또는 SSH 키.

  4. 기존 그룹을 선택하거나 + 로 새 그룹을 생성합니다.

  5. 저장을 누르면 사이드바와 트리에 즉시 반영됩니다.

우클릭 컨텍스트 메뉴

터미널 연결
새 터미널 탭을 열어 SSH 접속합니다.
SFTP 연결
듀얼 패널 파일 브라우저를 엽니다.
편집
서버 정보를 수정합니다.
삭제
서버 항목과 추가 사용자 정보를 제거합니다.
!
그룹 드래그 이동 — 서버 항목을 마우스로 끌어서 다른 그룹 헤더 위에 놓으면 그룹이 변경됩니다. 드래그 중에는 반투명 미리보기가 따라다닙니다.
04 · TERMINAL

터미널 접속

다섯 가지 연결 방법과 탭 조작 방식을 지원합니다.

5가지 연결 방법

METHOD 01
클릭
서버 클릭 → 다이얼로그에서 터미널 버튼
METHOD 02
더블클릭
서버 항목을 더블클릭하면 바로 탭이 열립니다.
METHOD 03
우클릭
우클릭 메뉴에서 터미널 연결.
METHOD 04
전체 목록
··· → 서버 전체 목록 → 터미널 버튼.
METHOD 05
최근 접속
대시보드 하단의 최근 접속 목록 클릭.

탭 조작

클릭
탭 활성화
우클릭
패널 이동 / 새 패널로 분리 메뉴
드래그
다른 패널로 이동 · 하단 드롭으로 새 패널 생성
연결 종료 후 탭 닫기
i
같은 서버 다중 접속 — 동일 서버에 여러 번 연결하면 탭에 #2, #3 번호가 표시됩니다. 우클릭 → 오른쪽/아래 새 패널로 이동으로 나란히 배치할 수 있습니다.
05 · PANELS & USERS

다중 패널 · 다중 사용자

화면을 자유롭게 분할하고, 하나의 서버에 여러 계정을 등록해 동시에 접속하세요.

다중 패널

⊞ 버튼
우측에 새 컬럼 패널을 추가합니다.
탭 우클릭
오른쪽 / 아래 새 패널로 이동.
탭 하단 드래그
패널 아래 영역으로 끌면 상하 분할이 생성됩니다.
구분선 드래그
패널 사이 구분선으로 크기를 조절합니다.

다중 사용자 등록

서버 1개에 여러 SSH 계정을 등록하고 접속 시 선택할 수 있습니다.

  1. 서버 편집 화면의 추가 사용자 섹션을 엽니다.

  2. + 추가를 누르고 표시명과 사용자명을 입력합니다.

  3. 인증 방식을 선택한 뒤 저장합니다.

접속 시 사용자 선택

기본
ec2-user · 서버 주 계정
admin
admin_user · 추가 계정
deploy
deploy_bot · 추가 계정
06 · SFTP

SFTP 파일 브라우저

듀얼 패널 · 드래그 업로드 · 일괄 작업으로 빠르게 파일을 옮기세요.

파일 조작

폴더 열기
항목 클릭으로 진입.
상위 폴더
버튼 또는 브레드크럼 클릭.
다운로드
원격 파일 클릭 →
업로드
원격 패널 버튼 또는 로컬에서 드래그.
이름 변경
버튼.
삭제
버튼.
폴더 생성
원격 + 버튼.
새로고침
버튼.
다중 선택 — 파일/폴더 체크박스로 여러 항목을 선택하면 상단에 일괄 업로드 · 다운로드 · 삭제 바가 표시됩니다.
07 · SERVICES

서비스 관리

서버 위에서 도는 WEB · DB · WAS · ETC 서비스를 통합 관리합니다.

서비스 유형

WEB
웹 서비스
URL
DB
데이터베이스
호스트 · 포트 · 사용자명
WAS
애플리케이션 서버
호스트 · 포트 · 사용자명
ETC
기타
메모

서비스 등록 · 관리

방법 1 · 연결 다이얼로그
서버 클릭 → 서비스 → 서비스 추가
방법 2 · 전체 목록
··· → 서비스 전체 목록 → ✎ 편집
네트워크 그래프 — 서비스 전체 목록 우측 상단의 그래프 버튼으로 서버-서비스 연결 관계를 시각적으로 확인할 수 있습니다.
08 · SETTINGS

설정 & 단축키

터미널 스타일과 주요 마우스 조작을 설정 창에서 한 번에 다룰 수 있습니다.

터미널 설정

··· → 설정터미널 탭에서 다음 항목을 변경할 수 있습니다.

폰트
총 8종 지원
SF Mono Cascadia Code Fira Code JetBrains Mono Hack D2Coding Consolas Menlo
크기
8 ~ 32 pt
배경색
8가지 프리셋 + 직접 선택
Black VS Dark Dracula Nord Monokai Solarized Tokyo Night One Dark
커서
모양 — 블록 / 밑줄 / 막대  ·  깜빡임 켜기 / 끄기

변경 사항은 미리보기에서 즉시 확인되며, 저장하면 모든 터미널에 적용됩니다.

주요 마우스 조작

서버 클릭
연결 다이얼로그 표시
서버 더블클릭
바로 터미널 탭 열기
서버 우클릭
컨텍스트 메뉴
서버 드래그
그룹 변경
그룹 헤더 클릭
접기 / 펼치기
그룹 헤더 우클릭
그룹 컨텍스트 메뉴
탭 드래그
패널 간 이동
탭 하단 드래그
하단 분할 패널 생성
패널 구분선 드래그
패널 크기 조절
사이드바 구분선
사이드바 너비 조절
09 · BACKUP & RESTORE

백업 / 복구

그룹 · 서버 · 추가 사용자 데이터를 JSON 파일로 내보내고 가져옵니다.

··· → 설정백업/복구 탭으로 진입.

백업 — JSON 내보내기

  1. 백업 파일 저장 버튼을 클릭합니다.

  2. 저장 위치 및 파일명을 선택합니다.

  3. 그룹 · 서버 · 추가 사용자가 JSON 파일로 저장됩니다.

기본 파일명 형식 — hypermaru-backup-YYYY-MM-DD.json

복구 — JSON 가져오기

전체 교체

기존 데이터 모두 삭제 후 복구

초기화 후 백업 시점으로 복원합니다. 현재 데이터는 사라지므로 신중하게 사용하세요.

추가

기존 데이터 유지 + 병합

현재 데이터를 유지하면서 백업 파일의 항목을 추가로 병합합니다.

복구 절차

  1. 복구 모드를 선택합니다 — 전체 교체 또는 추가.

  2. 백업 파일 열기 버튼을 클릭합니다.

  3. JSON 백업 파일을 선택하면 자동으로 복구됩니다.

10 · STORAGE

데이터 저장 위치

OS별 설정 파일 경로와 추가 저장 정보입니다.

Windows
C:\Users\<사용자>\AppData\Local\HyperMaru
macOS
/Applications/HyperMaru.app
UI 설정
브라우저 localStorage (폰트 · 배경 · 커서)