문서

Shellvana 문서

버전 1.0.0 기준입니다. 최종 업데이트: 2026-10-05.

Shellvana는 휴대폰용 SSH 클라이언트입니다. 사용자의 서버에 표준 SSH로 연결하고 출력을 읽기 쉬운 글로 보여 줍니다. 이 페이지에서는 설정과 일상적인 사용법을 다룹니다.

필요한 것

휴대폰. iOS 15 이상의 iPhone 또는 Android 휴대폰.
표준 sshd가 실행 중인 호스트. 이미 ssh로 접속할 수 있는 Linux, BSD, macOS 머신이면 모두 됩니다. 서버에 설치할 것은 없습니다. 에이전트도, 데몬도, 플러그인도 필요 없습니다.
그 호스트까지 가는 네트워크 경로. Shellvana는 휴대폰에서 입력한 주소로 직접 연결합니다. 호스트가 집 네트워크에서만 접근 가능하다면 먼저 사용 중인 VPN(WireGuard, Tailscale 등)으로 연결하세요. Shellvana에는 중간에 거치는 릴레이나 클라우드 서비스가 없습니다.

설치

App Store 또는 Google Play에서 Shellvana를 받으세요. 앱은 무료입니다. 만들어야 할 계정도, 로그인할 곳도 없습니다.

호스트 추가

호스트 목록에서 +를 탭해 호스트 추가를 엽니다.
이름(원하는 이름), 호스트(주소 또는 호스트 이름), 포트(보통 22), 사용자를 입력합니다.
인증에서 비밀번호 또는 가지고 있는 SSH 키 중 하나를 고릅니다. 키가 아직 없으면 목록에는 비밀번호만 나타납니다. SSH 키를 참고하세요.
그리드에서 Shellvana가 서버에 요청할 터미널 크기를 고릅니다. 콘솔은 132열 40행으로, 일반적인 셸 작업에 알맞습니다. AI 에이전트는 60열 40행으로, 사이드바를 그리는 전체 화면 터미널 도우미에 알맞습니다. 사용자 지정에서는 열과 행을 직접 설정할 수 있습니다.
저장을 탭한 다음 호스트를 탭해 연결합니다.

첫 연결과 호스트 키

처음 연결하면 Shellvana가 서버의 호스트 키 알고리즘과 지문을 보여 주고 이 호스트를 신뢰할까요?라고 묻습니다. 서버에 있는 지문과 비교해 보세요. 예를 들어 ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub로 확인할 수 있습니다. 일치하면 신뢰를 탭하세요.

Shellvana는 그 키를 기억합니다. 서버가 나중에 다른 키를 제시하면 이전 지문과 새 지문이 함께 표시된 경고: 호스트 키가 변경되었습니다 경고가 나타나고, 새 키를 수락하려고 호스트 이름을 직접 입력하지 않으면 세션이 열리지 않습니다. 서버를 다시 설치하거나 키를 바꾼 적이 없다면 수락하지 마세요.

취약하거나 오래된 호스트 키 알고리즘은 거부됩니다. "허용되지 않는 호스트 키 알고리즘입니다"라는 메시지가 보이면 서버에서 Ed25519 같은 최신 호스트 키를 활성화하세요.

세션 읽기

읽기 보기. 모든 세션은 읽기 보기로 열립니다. 일반 글과 Markdown은 휴대폰에 맞는 가변폭 글꼴로 다시 배치됩니다. 표, diff, 트리 출력, 열이 정렬된 모든 출력은 정확한 간격 그대로 고정폭을 유지합니다.
터미널 보기. 상단 바의 터미널 아이콘을 탭하면 서버가 보낸 정확한 그리드가 보입니다. 읽기 아이콘을 탭하면 돌아갑니다. 두 보기는 같은 세션을 보여 주므로 전환해도 잃는 것이 없습니다.
읽기용 글꼴과 크기. 상단 바의 읽기용 글꼴 아이콘을 탭하면 글꼴과 읽기 크기를 바꿀 수 있습니다.
전체 화면 프로그램. vim, htop, tmux 같은 프로그램은 평소처럼 실행됩니다. 프로그램이 화면을 차지하면 Shellvana가 그 레이아웃에 그리드가 필요하다고 알려 주고 그리드 버튼을 보여 줍니다.
링크. 출력 속 링크는 이동할 곳을 확인한 뒤에만 열리며, 앱 밖의 사용자 브라우저에서 열립니다.

명령어 입력

아래쪽 입력창(명령어 입력)에 입력하고 보내기 버튼을 탭하세요.
입력창 위의 키 줄은 휴대폰 키보드에 없는 Ctrl-C, Tab, Esc, 방향키, Ctrl-D, Ctrl-Z 같은 키를 보냅니다.
출력이 비밀번호 프롬프트처럼 보이면 Shellvana가 보안 입력을 제안합니다. 이렇게 입력한 텍스트는 서버로 전송되지만 저장되지 않으며 기록에도 남지 않습니다.

SSH 키

호스트 목록에서 메뉴(점 세 개)를 열고 SSH 키를 선택하세요.

키 가져오기. 가져오기를 탭하고 OpenSSH 개인 키를 붙여 넣은 뒤, 암호가 있으면 입력합니다. 키는 기기에 암호화되어 저장됩니다.
하드웨어 키 생성 (Pro). 보안 키 생성은 휴대폰의 보안 하드웨어 안에 키를 만듭니다. iPhone에서는 Secure Enclave, Android에서는 StrongBox 또는 하드웨어 기반 키 저장소입니다. 개인 키 절반은 기기 밖으로 나갈 수 없습니다. 이 키는 ECDSA P-256이며 서버에서는 ecdsa-sha2-nistp256으로 표시됩니다.
서버에 공개 키 설치. 키의 메뉴를 열고 공개 키 복사를 선택한 뒤, 그 줄을 서버의 해당 사용자 ~/.ssh/authorized_keys에 추가하세요. 처음에는 비밀번호로 연결해서 이 작업을 해야 합니다.
키 사용. 호스트를 편집하고 인증에서 비밀번호 대신 그 키를 고르세요.

연결이 끊겨도 작업을 유지하려면

휴대폰은 연결을 자주 놓칩니다. 화면이 잠기거나, 네트워크가 바뀌거나, 앱이 백그라운드로 넘어가면 그렇습니다. Shellvana가 다시 연결하면 서버가 새 셸을 줍니다. 터미널 멀티플렉서 안에서 실행하지 않았다면 이전 셸에서 실행 중이던 것은 모두 사라집니다.

오래 걸리는 작업은 서버의 tmux나 screen 안에서 시작하세요. 예를 들어 연결한 뒤 tmux new -A -s main을 실행합니다. 연결이 끊기면 다시 연결해서 같은 명령을 실행하면 하던 곳에서 이어서 작업할 수 있습니다.

호스트별 보안 설정

연결 전 잠금 해제 요구. 기본값은 꺼짐입니다. 호스트에 켜면 Shellvana가 그 호스트에서 세션을 열기 전에 지문, 얼굴 또는 화면 잠금을 확인합니다.
스크린샷 차단. 기본값은 켜짐입니다. 세션의 스크린샷과 앱 전환기 미리보기가 차단됩니다. 호스트별로 끌 수 있습니다.
시크릿으로 연결 (Pro). 호스트 메뉴에서 이 항목을 고르면 기록을 전혀 남기지 않는 세션이 열립니다.

기록과 데이터

세션 기록은 휴대폰에만 저장되며 SQLCipher로 암호화됩니다. 30일이 지난 기록은 저절로 삭제됩니다.
호스트 하나의 저장된 기록을 지우려면 그 호스트의 메뉴를 열고 이 호스트의 기록 삭제를 선택하세요. 전체를 지우려면 메인 메뉴를 열고 모든 기록 삭제를 선택하세요.
호스트를 삭제하면 목록에서는 사라지지만, 저장된 기록과 신뢰한 호스트 키는 그대로 남습니다. 이것들도 없애려면 먼저 기록을 삭제하세요.
Shellvana에는 계정, 분석, 비정상 종료 보고가 없습니다. 앱이 만드는 모든 네트워크 연결은 개인정보 처리방침에 나와 있습니다.

무료와 Pro

무료. 라이브 세션 1개, 비밀번호 및 키 인증, 호스트 프로필, 완전한 읽기용 렌더링. 읽기 편한 화면은 유료 기능이 아닙니다.
Pro. 구독이 아닌 1회 결제입니다. 동시 세션 최대 4개, 하드웨어 기반 키 인증, 모든 읽기용 글꼴, 시크릿 세션이 추가됩니다.
구매와 복원. 호스트 목록에서 메뉴를 열고 Shellvana Pro를 선택하세요. 새 휴대폰에서는 해당 시트에서 구매 복원을 탭하세요.

문제 해결

연결 시간이 초과됩니다. 휴대폰이 호스트에 접근할 수 있는지부터 확인하세요. 호스트가 사설 네트워크에 있다면 먼저 VPN을 켜고, 포트가 sshd가 수신 대기하는 포트와 같은지 확인하세요.
키가 거부됩니다. 공개 키 복사로 얻은 공개 키가 호스트 프로필에 지정된 것과 같은 사용자의 ~/.ssh/authorized_keys에 한 줄로 들어 있는지, 서버가 그 키 유형을 허용하는지 확인하세요.
읽기 보기에서 프로그램 레이아웃이 이상합니다. 터미널 보기로 전환하세요. 전체 화면 프로그램은 그리드에 맞춰 그려지며, 그리드는 항상 정확한 출력입니다.
전체 화면 도우미가 잘려 보입니다. 호스트를 편집해 그리드를 AI 에이전트로 바꾼 다음 다시 연결하세요.
"이전 구매를 찾지 못했습니다." 휴대폰이 Pro를 구매한 App Store 또는 Google Play 계정과 같은 계정으로 로그인되어 있는지 확인하고 구매 복원을 다시 시도하세요.

도움 받기

기기 모델과 iOS 또는 Android 버전을 적어 [email protected]으로 메일을 보내거나 지원 페이지를 확인하세요.