GenTerminal

GenTerminal란?

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

핵심 기능:

• SSH 터미널 — 어떤 서버든 SSH로 접속해 데스크톱이나 모바일에서 완전한 기능의 터미널로 작업
• 호스트 관리 — 서버를 저장하고 그룹으로 정리하며, 최근 호스트에 한 번의 탭으로 재접속
• 기기 간 동기화 — Genspark 계정으로 로그인하면 저장한 호스트와 설정이 모든 기기로 따라옵니다
• 암호화 키 Vault — 저장된 비밀번호와 개인 키를 Vault 비밀번호로 보호
• SFTP 파일 전송 — 서버의 파일을 탐색하고 업로드·다운로드
• 포트 포워딩(데스크톱 앱) — 로컬 및 원격 터널을 설정
• Snippets — 자주 쓰는 명령을 저장해 한 번의 탭으로 실행
• 빠른 창 토글 & 시스템 트레이(데스크톱 앱) — 전역 단축키로 창을 즉시 띄우거나 숨기고, 트레이에 넣어 화면을 깔끔하게 유지
• Genspark Mesh — 내 기기들을 프라이빗 네트워크에 연결해 서로 직접 통신할 수 있도록 구성
• 터미널 공유 — 브라우저 링크를 통해 실시간 터미널을 다른 사람과 공유
• 내장 에이전트 탭 — 별도 탭에서 동작하는 내장 에이전트가 터미널 스크롤백을 읽고 세션 진행을 도와줍니다
• 지속 세션 — 연결을 끊어도 세션이 호스트에서 계속 실행됩니다

빠른 시작

GenTerminal 다운로드 및 설치

• iPhone — App Store에서 다운로드하세요.
• Android — Android 앱은 Google Play에서 제공되지 않으므로 genterminal.ai에서 APK 파일로 직접 다운로드하세요.
• Mac / Windows / Linux — genterminal.ai에서 데스크톱 앱을 다운로드하세요. Linux 데스크톱 앱은 AppImage 형식으로 제공되며 자동 업데이트되지 않으므로, 새 Linux 빌드는 같은 페이지에서 받으세요.

데스크톱 설치 프로그램 링크가 작동하지 않으면 genspark.ai/download에서도 데스크톱 앱을 받을 수 있습니다. 그런 다음 앱을 실행하세요.

Genspark 계정으로 로그인

기존 Genspark 계정으로 로그인하세요. GenTerminal은 Genspark와 통합되어 있어 별도의 회원가입이 필요 없으며, 로그인하면 호스트가 여러 기기 간에 동기화됩니다.

호스트 추가

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

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

호스트를 저장하세요.

연결

방금 저장한 호스트를 열어 SSH 세션을 시작하세요. 데스크톱 앱에서는 일반 터미널처럼 키보드로 명령어를 입력하면 됩니다. iPhone과 Android에서는 키보드 위의 기능 키 바를 사용해 Tab, Ctrl, Esc, 화살표 키 등을 입력할 수 있습니다.

기능 및 사용 가이드

호스트 관리 & 그룹

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

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

기기 간 클라우드 동기화

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

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

키 Vault

Vault는 호스트의 민감한 부분 — 저장된 비밀번호와 개인 키 — 을 나만 아는 Vault 비밀번호로 암호화하여 보호합니다. Vault 비밀번호는 각 기기에서 저장된 자격 증명을 보호하며, 아래의 동기화 전 키 암호화 설정은 개인 키가 동기화될 때 어떻게 보호되는지를 제어합니다. Vault 비밀번호를 잊어버리면 복구할 수 없습니다. 대신 Vault를 재설정해야 하며, 이 경우 저장된 자격 증명이 삭제됩니다. 최신 빌드에서는 재설정이 브라우저에서 승인됩니다.

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

SFTP 파일 전송

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

포트 포워딩

데스크톱 앱에서 GenTerminal은 SSH 터널을 설정해 서버를 통해 서비스에 접근할 수 있습니다:

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

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

Snippets

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

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

데스크톱 앱에서 GenTerminal은 화면을 어지럽히지 않으면서도 손쉽게 쓸 수 있습니다:

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

기능 키 바

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

Genspark Mesh

Genspark Mesh는 사용자의 기기들을 프라이빗 네트워크에 연결하여 WireGuard를 통해 서로 직접 통신할 수 있도록 합니다. 공인 IP나 외부에 노출된 포트가 필요 없으며, 별도의 VPN 설정도 필요하지 않습니다. 기기가 메시에 연결되면 사이드바에 연결 가능한 상태로 표시되며, 같은 메시에 있는 다른 기기에서 해당 기기로 SSH 연결을 열 수 있습니다.

각 기기에서 설정하세요. 설정 → Genspark Mesh에서 Genspark Mesh를 켜세요. 다른 메시 기기로부터의 SSH 연결을 허용하려면 수신 SSH 연결 허용도 함께 켜세요.

브라우저에서 각 기기를 승인하세요. 기기를 추가하면 Genspark가 페어링 코드와 승인 링크를 표시합니다. 브라우저에서 승인하면 기기가 메시에 참여합니다. 이미 등록된 기기는 자동으로 다시 연결되므로 재승인이 필요하지 않습니다. 기기를 다시 등록하면 이전 등록 정보가 대체됩니다.

제한 및 비용. Genspark 계정당 최대 50대의 기기를 메시에 연결할 수 있습니다. Genspark Mesh는 무료입니다.

터미널 공유

브라우저 링크를 통해 실시간 터미널을 다른 사람과 공유하세요. 문제를 함께 해결하거나 동료에게 세션을 보여줄 때 유용합니다.

공유 시작하기. 연결된 탭을 마우스 오른쪽 버튼으로 클릭하고 터미널 공유를 선택하세요. GenTerminal이 보낼 수 있는 브라우저 링크를 생성합니다.

참여할 수 있는 사람. 시청자는 Genspark 계정으로 로그인한 뒤 전달받은 공유 비밀번호를 입력합니다. 특정 이메일 주소나 도메인으로 접근을 제한할 수도 있습니다. 공유는 기본적으로 읽기 전용이며, 시청자가 입력할 수 있도록 하려면 선택 사항인 입력 허용 스위치를 켜세요.

공유가 진행 중일 때. 링크는 SSH 재연결 후에도 유지되므로 세션이 끊겨도 공유가 중단되지 않습니다. 연결을 끊어도 공유가 즉시 취소되지는 않습니다. 공유는 공유를 중지한 후 약 24시간이 지나면 만료되며, 최대 5개의 공유를 동시에 활성화할 수 있습니다. 터미널 공유는 무료입니다.

번들 에이전트 탭

GenTerminal에는 자체 탭에서 실행되는 내장 에이전트가 포함되어 있습니다. 이 에이전트는 연결된 터미널 범위 내에서 작동합니다. 해당 탭의 스크롤백을 읽고 세션과 함께 작업할 수 있으므로, 이미 화면에 표시된 출력에 대해 질문하거나 다음 작업을 진행하는 데 도움을 받을 수 있습니다. 터미널 자체는 무료이지만, 에이전트는 Genspark의 LLM 프록시에서 실행되므로 에이전트의 응답에는 로그인한 Genspark 계정의 크레딧이 사용됩니다.

지속 세션

GenTerminal은 세션을 호스트에서 실행하므로, 클라이언트가 연결되어 있지 않아도 세션이 계속 실행됩니다. 탭을 닫거나 네트워크 연결이 끊겨도 세션은 중단되지 않으며, 다시 돌아오면 세션이 그대로 유지되어 있습니다.

문제 해결

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

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

FAQ

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

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

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

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

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

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

지원은 어떻게 받나요?

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

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

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

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

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