도움말 센터

GenTerminal

GenTerminal란?

GenTerminal은 Genspark의 크로스 플랫폼 SSH 터미널 클라이언트로, iPhone, Android, Mac, Windows를 지원합니다. 서버에 접속하고, 호스트를 관리하며, 어떤 기기에서든 명령을 실행할 수 있습니다 — 호스트와 설정은 Genspark 계정을 통해 동기화됩니다.

핵심 기능:

  • SSH 터미널 — 어떤 서버든 SSH로 접속해 데스크톱이나 모바일에서 완전한 기능의 터미널로 작업
  • 호스트 관리 — 서버를 저장하고 그룹으로 정리하며, 최근 호스트에 한 번의 탭으로 재접속
  • 기기 간 동기화 — Genspark 계정으로 로그인하면 저장한 호스트와 설정이 모든 기기로 따라옵니다
  • 암호화 키 Vault — 저장된 비밀번호와 개인 키를 Vault 비밀번호로 보호
  • SFTP 파일 전송 — 서버의 파일을 탐색하고 업로드·다운로드
  • 포트 포워딩(Mac & Windows) — 로컬 및 원격 터널을 설정
  • Snippets — 자주 쓰는 명령을 저장해 한 번의 탭으로 실행
  • 빠른 창 토글 & 시스템 트레이(Mac & Windows) — 전역 단축키로 창을 즉시 띄우거나 숨기고, 트레이에 넣어 화면을 깔끔하게 유지

빠른 시작

  1. GenTerminal 다운로드 및 설치

    • iPhone — App Store에서 받기
    • Android — Google Play에서 받기
    • Mac / Windowsgenterminal.ai에서 데스크톱 앱 다운로드

    그런 다음 앱을 여세요.

  2. Genspark 계정으로 로그인

    기존 Genspark 계정으로 로그인하세요. GenTerminal은 Genspark와 연동되어 있어 별도 가입이 필요 없으며 — 로그인하면 호스트가 기기 간에 동기화됩니다.

  3. 호스트 추가

    호스트 추가(+ 버튼)를 탭하거나 클릭한 뒤 서버 정보를 입력하세요:

    • 호스트 / 주소 — 서버의 호스트명 또는 IP 주소
    • 포트 — SSH 포트(보통 22)
    • 사용자 이름 — 서버의 로그인 사용자
    • 인증비밀번호 또는 개인 키 중 하나

    호스트를 저장하세요.

  4. 접속

    방금 저장한 호스트를 열어 SSH 세션을 시작하세요. Mac과 Windows에서는 일반 터미널처럼 키보드로 명령을 입력하고, iPhone과 Android에서는 키보드 위의 기능 키 바를 사용해 Tab, Ctrl, Esc, 방향키 등을 입력합니다.


기능 가이드

호스트 관리 & 그룹

호스트 목록은 모든 작업의 시작점입니다. 여기에서 다음을 할 수 있습니다:

  • 호스트 추가·편집·삭제 — 모든 서버를 한곳에서 관리
  • 그룹으로 정리 — 관련 서버(예: 프로젝트별 또는 환경별)를 그룹으로 분류해 목록을 깔끔하게 유지
  • 최근 호스트에 재접속 — 가장 최근에 사용한 연결이 표시되어 한 번의 탭으로 재접속

기기 간 클라우드 동기화

Genspark 계정으로 로그인하면 GenTerminal은 호스트, 그룹, Snippets, 설정을 모든 기기에서 자동으로 동기화합니다. 휴대폰에서 서버를 추가하면 Mac에서도 그대로 나타납니다 — 수동 내보내기나 가져오기가 필요 없습니다.

동기화는 Genspark 계정에 연동되어 있어, 새 기기에서 로그인하면 저장한 모든 것이 복원됩니다.


키 Vault

Vault는 호스트의 민감한 부분 — 저장된 비밀번호와 개인 키 — 을 나만 아는 Vault 비밀번호로 암호화하여 보호합니다.

  • Vault 비밀번호 설정 — 자격 증명을 처음 저장할 때 Vault 비밀번호를 만들도록 안내됩니다. 이 비밀번호는 어떤 기기에서든 저장된 키를 잠금 해제합니다.
  • 새 기기에서 잠금 해제 — 다른 기기에서 동일한 Vault 비밀번호를 입력하면 동기화된 자격 증명이 해당 기기에서 복호화됩니다. Vault 비밀번호는 서버에 저장되지 않으므로 안전한 곳에 보관하세요 — 대신 복구해 드릴 수 없습니다.
  • 동기화 전 키 암호화 — 개인 키를 기기에서 떠나기 전에 Vault 비밀번호로 암호화하여, 암호문만 동기화되도록 하는 설정입니다. 동기화 과정에서 키를 종단 간으로 보호하고 싶다면 켜세요.

SFTP 파일 전송

명령 실행 외에도 GenTerminal은 SFTP로 서버의 파일을 탐색할 수 있습니다. 접속된 호스트의 파일 브라우저를 열어 폴더를 탐색하고, 기기에서 파일을 업로드하거나 서버에서 파일을 다운로드할 수 있습니다.


포트 포워딩

Mac과 Windows에서 GenTerminal은 SSH 터널을 설정해 서버를 통해 서비스에 접근할 수 있습니다:

  • 로컬 포워딩 — 원격 네트워크의 포트를 내 컴퓨터에서 접근할 수 있게 만듭니다(예: 서버만 볼 수 있는 데이터베이스나 내부 웹 앱을 열기)
  • 원격 포워딩 — 내 컴퓨터의 포트를 원격 측에 노출

호스트 연결과 함께 터널을 설정하면 접속 중에는 터널이 계속 활성화됩니다.


Snippets

Snippets는 한 번 저장해 두고 재사용하는 명령입니다. 같은 명령을 자주 입력한다면 Snippet으로 저장해 두고, 다시 입력하는 대신 한 번의 탭이나 클릭으로 터미널에 삽입하세요.


빠른 창 토글 & 시스템 트레이

Mac과 Windows에서 GenTerminal은 화면을 어지럽히지 않으면서도 손쉽게 쓸 수 있습니다:

  • 전역 단축키 — 어디서든 키보드 단축키를 눌러 GenTerminal 창을 즉시 표시하거나 숨길 수 있습니다. 설정에서 단축키를 변경할 수 있습니다.
  • 시스템 트레이 — 창을 닫아도 GenTerminal은 트레이(Mac에서는 메뉴 막대)에서 계속 실행되어 세션과 빠른 토글을 유지합니다. 작업을 마치면 트레이 메뉴에서 완전히 종료하세요.

기능 키 바

iPhone과 Android에서는 휴대폰 키보드에 터미널에 필요한 키가 없으므로, GenTerminal은 키보드 위에 Tab, Ctrl, Esc, 방향키 및 기타 특수 키가 있는 기능 키 바를 추가합니다 — 덕분에 데스크톱 터미널처럼 대화형 도구와 단축키를 사용할 수 있습니다.


FAQ

Q: GenTerminal은 어떤 플랫폼을 지원하나요?

GenTerminal은 iPhone, Android, Mac, Windows에서 실행됩니다. 모바일 앱은 App Store와 Google Play에서, Mac과 Windows 데스크톱 앱은 genterminal.ai에서 받으세요. 동일한 Genspark 계정으로 로그인하면 호스트와 설정이 모든 기기에서 동기화됩니다. 포트 포워딩과 전역 단축키 / 시스템 트레이는 데스크톱 앱에서 사용할 수 있고, 기능 키 바는 모바일에서 사용할 수 있습니다.

Q: iPhone에서 앱을 벗어나면 잠시 후 SSH 세션이 끊기는데 왜 그런가요?

이는 iPhone의 정상 동작이며 버그가 아닙니다. iOS는 앱이 백그라운드에서 할 수 있는 작업을 제한하므로, GenTerminal이 백그라운드에 약 30초간 머물면 운영체제가 앱을 일시 중단하고 SSH 연결이 끊깁니다. 앱으로 돌아오면 호스트에 다시 접속하면 됩니다. 오래 걸리는 명령이 중단되지 않도록 하려면 GenTerminal을 전면에 유지하세요. (Mac과 Windows 앱은 이 제한의 영향을 받지 않습니다.)

Q: 문제를 보고할 때 진단 정보는 어떻게 보내나요?

문제가 발생해 지원팀이 로그를 요청하면, 앱 안에서 진단 정보를 업로드할 수 있습니다:

  1. 설정을 여세요
  2. 진단 정보 보내기를 탭하거나 클릭하세요

이렇게 하면 최근 앱 로그가 업로드되어 조사에 활용됩니다. 지원팀에 연락할 때 문제가 발생한 대략적인 시각을 알려 주시면 알맞은 로그를 찾는 데 도움이 됩니다.

Q: 지원은 어떻게 받나요?

[email protected]로 이메일을 보내 주세요. 무슨 일이 있었는지, 사용 중인 기기와 OS 버전, 그리고 — 이미 진단 정보를 업로드했다면 — 문제가 발생한 대략적인 시각을 함께 알려 주세요.

Q: 계정은 어떻게 삭제하나요?

앱 안에서 계정을 삭제할 수 있습니다. 설정을 열고 계정 섹션을 찾아 계정 삭제를 선택하세요. 계정을 삭제하면 동기화된 데이터가 제거되며, 이 작업은 취소할 수 없습니다.

Q: 저장한 호스트가 기기 간에 동기화되나요?

네. 동일한 Genspark 계정으로 로그인되어 있는 한, 호스트, 그룹, Snippets, 설정이 iPhone, Android, Mac, Windows 전반에서 자동으로 동기화됩니다. 새 기기에서 동기화된 비밀번호와 키를 복호화하려면 그곳에서 Vault 비밀번호를 입력하세요.