# 세션 — Liu Terminal

> Liu Terminal 세션. 파일 브라우저, SFTP, 포트 포워딩, Mosh, known-hosts TOFU가 포함된 완전한 SSH 클라이언트.

URL: https://liu.software/ko/docs/sessions/  
Language: ko  
Updated: 2026-10-17

로컬 PTY는 AI 에이전트를 실행합니다. 동일한 Session 추상화가 SSH, SFTP, Mosh, Telnet 및 시리얼도 지원합니다. 제품이 더 이상 원격 셸을 헤드라인으로 내세우지 않지만, 여전히 많은 사람들이 필요로 하므로 연결된 상태를 유지합니다.

## 세션이란?

Liu의 모든 탭과 분할 리프는 하나의 세션입니다. 그중 대부분은 로그인 셸을 실행하는 로컬 PTY입니다. 이것이 바로 AI 에이전트(Claude, Codex, Copilot, …)가 실제로 실행되는 기반입니다. 세션은 원격일 수도 있습니다: SSH, SFTP, Mosh, Telnet, 시리얼. 이들은 하나의 추상화, 하나의 렌더링 파이프라인, 하나의 스크롤백을 공유합니다.

## 로컬 PTY

새 탭(⌘ T)은 부모 탭의 cwd에서 로컬 PTY를 생성합니다. Finder나 Dock에서 실행된 경우, Liu는 상속된 / cwd를 감지하고 자식에서 조용히 chdir($HOME)을 수행하여 프롬프트가 유용한 위치에서 열리도록 합니다.

셸의 작업 디렉터리는 OSC 7을 통해 추적됩니다. PROMPT\_COMMAND에 printf '\\\\e\]7;file://%s%s\\\\e\\\\\\\\' "$HOSTNAME" "$PWD"를 넣으면 Liu의 사이드바, 분할 상속 및 에이전트 기록 cwd 범위가 모두 활성화됩니다.

## SSH (기반 계층, 여전히 유지)

libssh2 기반. 비밀번호, 공개키, 에이전트, 키보드 대화형 인증. ~/.ssh/config의 Host, Match, Include, ProxyJump, IdentityFile 등 관련 지시를 따릅니다. Liu는 내부적으로 연결을 멀티플렉스하지만 ssh config의 ControlMaster / GSSAPI 줄은 아직 라이브 세션으로 파싱되지 않습니다.

- 볼트 패널에서 ED25519 / RSA-3072 키를 생성합니다. 개인 키는 저장 시 암호화된 상태로 유지됩니다.
- 발신 인증에 SSH\_AUTH\_SOCK이 사용됩니다. 에이전트 포워딩은 호스트별로 설정되며 기본적으로 비활성화되어 있습니다.
- 멀티홉 ProxyJump + SOCKS5 지원. GSSAPI/Kerberos ssh-config 줄은 아직 라이브 세션에 연결되지 않았습니다.

## 알려진 호스트

첫 연결 시 SHA-256 지문과 랜덤아트 미리보기가 함께 표시됩니다. 수락된 항목은 OpenSSH 호환 형식으로 ~/.config/Liu/known\_hosts에 저장됩니다. 호스트 키가 변경되면 재승인 전까지 입력이 차단됩니다.

## 기타 프로토콜

- SFTP — 저장된 모든 호스트에 대해 사이드바에서 열 수 있습니다. 드래그 앤 드롭, 연결 해제 시 재개.
- Mosh — SSH 호스트와 페어링하여 로밍 + 적응형 재전송을 지원합니다.
- Telnet 및 시리얼 — 레거시 장비용. 동일한 세션 UI, 암호화 없음.

## 포트 포워딩

각 호스트는 연결 시 적용되는 포워딩 규칙 목록을 가지고 있습니다 — 로컬, 원격, 동적(SOCKS). 바인딩되면 상태 표시줄에 녹색 점으로, 바인딩에 실패하면 빨간색 점으로 표시됩니다.

```
{ "type": "local",   "from": "8080",  "to": "localhost:80" }
{ "type": "remote",  "from": "9000",  "to": "127.0.0.1:9000" }
{ "type": "dynamic", "from": "1080" }
```

[다음 파일 탐색기 →](https://liu.software/ko/docs/file-browser.md)