사용 설명서

Pockterm에 오신 것을 환영합니다

Pockterm이 무엇이고 어떻게 구성되어 있는지

Pockterm은 iPhone용 본격 SSH 클라이언트입니다. 서버에 연결하고, 대화형 터미널을 사용하고, SFTP로 파일을 전송하고, 포트 포워딩 터널을 설정할 수 있습니다.

하단의 탭을 사용하여 호스트, 스니펫, 키체인, 포트 포워딩 사이를 이동하십시오.

모든 항목이 기기에 남습니다. 자세한 내용은 사용자 데이터 및 개인정보 보호를 참조하십시오.

호스트 추가하기

연결할 수 있는 서버를 생성합니다

호스트 생성하기

• 호스트 탭에서 +를 탭한 다음 새로운 호스트를 선택하십시오.
• 레이블, 주소(호스트 이름 또는 IP), 포트(기본값 22)를 입력하십시오.
• Pockterm이 로그인 방법을 알 수 있도록 인증 정보를 선택하십시오. 아직 없다면 새로운 인증 정보를 탭하십시오.
• 저장을 탭하십시오.

호스트 동작

• 호스트를 탭하면 연결됩니다.
• 왼쪽으로 쓸어넘기면 편집, 즐겨찾기 추가, 삭제를 할 수 있습니다.
• 오른쪽으로 쓸어넘긴 다음 파일을 탭하면 SFTP로 탐색합니다.

인증 정보 및 SSH 키

Pockterm이 로그인하는 방식

인증 정보는 사용자 이름과 인증 방법(암호 또는 SSH 키)으로 구성됩니다.

키 만들기

• 키체인 탭에서 +를 탭하고 Ed25519 키 만들기…를 선택한 다음 키에 레이블을 지정하십시오.
• Pockterm은 Ed25519 키 쌍을 만들고 개인 키를 iOS 키체인에 저장합니다.
• 표시된 공개 키 줄을 서버의 ~/.ssh/authorized_keys 파일에 추가하십시오.

이미 있는 키 가져오기

• 키체인 탭에서 +를 탭하고 기존 키 가져오기…를 선택하십시오.
• BEGIN과 END 줄을 포함해 개인 키 파일 전체를 붙여넣으세요. OpenSSH 형식의 Ed25519 및 RSA 키를 지원합니다.
• 또는 파일 선택…을 탭해 파일에서 키를 선택하십시오.
• 키에 암호가 설정되어 있으면 Pockterm이 한 번만 묻고 키와 함께 키체인에 저장합니다.

-----BEGIN RSA PRIVATE KEY-----로 시작하는 키는 예전 PEM 형식입니다. ssh-keygen -p -f <file>로 변환한 뒤 가져오세요. 키는 그대로 두고 파일만 다시 씁니다.

인증 정보 생성하기

• 호스트 편집기에서 새로운 인증 정보를 선택하십시오.
• 사용자 이름을 입력하고 암호 또는 키를 선택하십시오.
• 키를 선택한 경우, 보유한 키 중 하나를 선택하십시오.

터미널

연결하고 세션에서 작업하기

호스트를 탭하여 터미널 세션을 여십시오.

• 키보드 위의 막대에는 esc, ctrl, tab, 화살표 키 등이 있습니다.
• 여러 호스트를 동시에 열 수 있습니다. 각 세션은 상단의 탭으로 표시됩니다. 이름을 탭하여 전환하고, 빨간색 ✕를 탭하여 닫으십시오.
• 스니펫 버튼을 탭하면 저장한 명령어를 세션에서 실행합니다.

안경과 외부 디스플레이

터미널을 더 큰 화면에 띄우기

VITURE 같은 비디오 안경이나 모니터, TV를 연결하면 터미널이 그 화면에 꽉 차게 표시됩니다. iPhone에는 키보드와 키 바가 그대로 남고, 터미널이 있던 자리에 세션의 파일이 표시됩니다.

• 따로 켤 것은 없습니다. 디스플레이를 연결하고 세션을 여세요.
• 열린 세션이 없거나 세션을 최소화하면, 안경에 iPhone에서 세션을 열라는 안내가 표시됩니다.
• 위쪽의 AA를 탭하면 안경의 글자를 작게 또는 크게 할 수 있습니다. 이 크기는 iPhone의 핀치 확대와 별도로 기억됩니다.
• 위쪽의 클립보드 버튼을 탭하면 터미널에 붙여넣을 수 있습니다. 키보드에서는 ⌘V도 됩니다.
• 키 바의 PgUp과 PgDn으로 안경 화면에서 밀려난 내용을 한 페이지씩 거슬러 볼 수 있습니다.
• 키보드를 가렸다면 위쪽의 키보드 버튼을 탭해 다시 표시하세요.
• 디스플레이 연결을 끊으면 터미널이 iPhone으로 돌아옵니다.

스니펫

재사용할 수 있는 명령어를 저장하고 실행합니다

스니펫은 자주 사용하는 명령어입니다.

• 스니펫 탭에서 +를 탭하여 레이블과 함께 명령어를 저장하십시오.
• 연결된 상태에서 터미널의 스니펫 버튼을 탭하면 실행할 수 있습니다.
• 호스트에 시작 스니펫을 지정하면 연결할 때 자동으로 실행됩니다.

그룹, 즐겨찾기 및 검색

많은 호스트 목록을 정돈합니다

• 호스트 메뉴에서 그룹 관리를 선택하십시오. 그룹은 중첩할 수 있으며, 그룹의 기본 인증 정보와 포트는 해당 호스트에 상속됩니다.
• 호스트 편집기에서 호스트를 그룹에 지정하십시오.
• 호스트를 즐겨찾기에 추가하면(왼쪽으로 쓸어넘기기) 즐겨찾기 섹션에 고정됩니다.
• 아래로 당기면 레이블이나 주소로 검색할 수 있습니다. 최근 사용한 호스트는 최근 항목에 표시됩니다.

ssh_config에서 가져오기

기존 호스트를 가져옵니다

• 호스트 메뉴에서 ssh_config에서 가져오기를 선택하십시오.
• 설정 텍스트를 붙여넣거나 파일 선택을 탭하십시오.
• 감지된 호스트를 검토하고 원하지 않는 항목을 끈 다음 가져오기를 탭하십시오.

Pockterm은 Host, HostName, User, Port 설정을 읽습니다. 사용자 이름마다 암호 인증 정보가 생성되므로 나중에 비밀 값을 입력할 수 있습니다.

파일 전송하기(SFTP)

파일을 탐색하고 다운로드하고 업로드합니다

모든 호스트에는 SFTP 파일 탐색기가 있습니다. SFTP는 동일한 SSH 연결에서 동작하므로 추가로 설정할 것이 없습니다.

탐색기 열기

• 호스트를 길게 누른 다음 파일 탐색을 선택하십시오.
• 또는 호스트의 프로토콜을 SFTP(파일)로 설정하면, 탭했을 때 터미널 대신 탐색기가 열립니다.
• 이미 세션에 있습니까? 터미널 상단 막대의 폴더 버튼을 탭하십시오.

파일 다운로드하기

• 파일을 탭한 다음 다운로드를 선택하십시오.
• 공유 시트에서 열리므로 어디로든 보낼 수 있습니다. 보관하려면 파일에 저장을 선택하십시오. iCloud Drive에도 저장할 수 있습니다.

파일 업로드하기

• 브라우저 하단의 업로드를 탭한 다음 파일… 또는 사진 및 비디오…를 선택하십시오.
• 파일…을 선택하면 iPhone의 파일 선택기가 열리므로 iCloud Drive, 나의 iPhone 등 파일의 어떤 위치에서든 바로 업로드할 수 있습니다. 사진 및 비디오…는 사진 보관함의 원본을 보냅니다.
• 원하는 만큼 선택하십시오. 보고 있는 폴더에 놓이며, 목록이 스크롤되어 보여 줍니다.
• 같은 이름의 파일이 이미 있으면 Pockterm이 대치할지 모두 유지할지 묻습니다. 모두 유지를 선택하면 IMG_0001 2.HEIC처럼 번호가 붙습니다.

파일 관리하기

• 파일이나 폴더 옆의 ⋯를 탭하면 이름을 변경하거나 권한을 바꾸거나 삭제할 수 있습니다.
• 상단의 폴더 버튼을 탭하여 폴더를 생성하십시오. 아래로 당기면 목록이 새로고침됩니다.
• 상단의 ..를 탭하면 상위 디렉토리로 이동합니다.
• 정렬 버튼을 탭하여 목록을 이름 또는 날짜 순으로 정렬합니다. 이미 선택된 항목을 다시 탭하면 최신순과 오래된순이 전환됩니다. Pockterm이 선택을 기억합니다.

전송은 청크 단위로 이루어지므로 큰 파일이라도 메모리를 소진하지 않습니다. 전송 중에는 경로 막대에 전송된 양과 전체 크기가 표시됩니다.

포트 포워딩

SSH를 통해 연결을 터널링합니다

포트 포워딩은 네트워크 연결을 SSH 서버를 통해 전달합니다.

• 로컬 — 기기의 포트가 서버에서 접근할 수 있는 호스트로 전달합니다.
• 원격 — 서버의 포트가 사용자의 기기로 다시 전달합니다.
• 동적 — 기기의 SOCKS5 프록시가 각 연결을 서버를 통해 보냅니다.

포워딩 실행하기

• 포트 포워딩 탭에서 +를 탭하여 추가하십시오.
• 행을 탭하면 편집할 수 있습니다.
• ▶를 탭하여 시작하십시오. 상태에 활성 여부가 표시됩니다. 중지하려면 ⏹를 탭하십시오.

호스트 키 확인하기

서버를 안전하게 신뢰하기

서버에 처음 연결할 때 Pockterm은 해당 키의 지문을 표시하고 수락할지 묻습니다. 이를 최초 사용 시 신뢰(trust on first use)라고 합니다.

• 지문이 서버 소유자로부터 확인한 값과 일치하는 경우에만 수락하십시오.
• 한 번 수락하면 키가 기억되어 다시 묻지 않습니다.
• 나중에 서버가 다른 키를 제시하면 Pockterm이 계속하기 전에 경고합니다. 서버를 다시 구축했거나 무언가 잘못되었다는 뜻일 수 있습니다.

사용자 데이터 및 개인정보 보호

모든 항목이 저장되는 위치

Pockterm에는 계정이 없으며, 연결 데이터는 기기에 남습니다.

• 호스트, 그룹, 스니펫, 포워딩은 기기에 저장됩니다.
• 암호와 개인 키는 iOS 키체인에 보관됩니다.
• 신뢰한 호스트 키는 호스트 키 확인하기에서 설명한 경고를 위해 기기에 기억됩니다.
• 어시스턴트 대화는 호스트마다 하나씩 기기에 저장되므로, 다시 연결해도 대화가 그대로 남아 있습니다. 삭제하려면 어시스턴트의 휴지통을 탭하십시오.

AI 어시스턴트만 예외입니다. 사용하면 관련 터미널 출력(및 첨부한 파일)이 사용자가 설정한 모델 제공업체(Anthropic, OpenAI, OpenRouter 또는 Hugging Face)로 사용자 본인의 API 키를 사용해 전송됩니다. 어시스턴트를 사용하기 전에는 아무것도 전송되지 않으며, 키는 iOS 키체인에 저장됩니다. 해당 데이터의 처리 방식은 제공업체의 개인정보 처리방침을 확인하십시오.