---
title: "세션 관리하기"
description: "Websh 터미널은 탭을 닫아도 작업 세션이 활성 상태인 동안 다시 연결할 수 있습니다. 종료 사유를 확인하고, Essentials 이상 플랜에서는 이메일이나 일회용 링크로 세션을 공유하세요. 공유할 때 참여자의 입력 권한과 링크 만료를 정하고 이후 참여자를 관리할 수 있습니다."
---

> Full documentation index: https://docs.alpacax.com/llms.ko.txt

# 세션 관리하기

작업 세션에서 Websh 터미널에 다시 접속하고, 지원 플랜에서는 팀원과 공유합니다.

## 터미널 연결 유지

터미널은 [작업 세션](/use/work-sessions/)을 통해 열리며, 브라우저 탭을 닫아도 연결이 유지됩니다. 세션이 활성 상태인 동안 다시 접속할 수 있으며, 지원 플랜에서는 팀원과 세션을 공유해 함께 작업할 수 있습니다.

## 세션 재접속

터미널 세션은 백그라운드에서 유지됩니다. 돌아가려면 작업 세션의 **이어하기** 탭에서 돌아갈 터미널의 **다시 연결**을 누르세요. 자세한 내용은 [열린 터미널과 에디터](/use/work-sessions/detail/#열린-터미널과-에디터)를 참고하세요. 활성 세션은 접근 > Sessions에 표시되며, 슈퍼유저는 다른 사용자의 활성 세션도 볼 수 있습니다.

터미널을 끝내려면 `exit`를 입력하거나 세션에서 종료하세요.

## 연결 상태

터미널 헤더에는 현재 연결 상태가 표시됩니다.

| 상태             | 의미                                                                                                                            |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **연결 중**      | Alpacon이 연결을 여는 중입니다.                                                                                                 |
| **연결됨**       | 연결되어 바로 입력할 수 있는 상태입니다.                                                                                        |
| **재연결 중**    | 연결이 끊어져 자동으로 재시도하고 있습니다. 이 동안 입력한 내용은 순서대로 대기했다가 연결이 돌아오면 전달됩니다. 다만 한도가 있어서, 한도를 넘으면 그 이후 입력은 전송되지 않고 알림이 표시됩니다. |
| **오프라인**     | 브라우저의 네트워크 연결이 끊긴 상태입니다. 연결이 돌아오면 터미널이 자동으로 재접속합니다.                                     |
| **연결 끊김**    | 자동 재접속이 더 이상 시도되지 않는 상태입니다. **재시도**를 클릭하거나, 다른 브라우저 탭으로 이동했다가 돌아오면 재접속을 다시 시도합니다. |
| **연결 해제됨**  | 세션에서 제외되었거나, Alpacon이 원인을 알 수 없는 이유로 연결이 종료된 상태입니다. 자동으로 재접속하지 않으므로 **재시도**를 클릭해 다시 참여하세요. |
| **세션 종료됨** | 세션이 끝난 상태입니다. [세션 종료 사유](#세션-종료-사유)에서 원인과 해결 방법을 확인하세요. |

본인이 세션을 직접 종료했거나 셸이 종료되어 세션이 끝난 경우, **터미널 자동 닫기**가 켜져 있으면 브라우저 탭도 자동으로 닫힙니다([Websh 설정](/use/settings/websh/#세션-관리) 참고). 그 외의 종료(제한 시간 초과, 관리자 종료, 연결 끊김 등)는 이유를 확인할 수 있도록 탭이 열린 채로 남습니다.

## 세션 종료 사유

콘솔에 표시된 안내를 찾아 종료 사유와 해결 방법을 확인하세요. 사용자가 터미널을 닫았거나, 에이전트가 재시작되었거나, 승인된 계정이 바뀌었을 때는 **세션이 종료됐어요.** 안내가 표시됩니다. 구체적인 종료 사유를 알 수 없을 때도 같은 안내가 표시됩니다.

**이 세션과의 연결이 끊어졌어요.** 안내가 표시되면 **재시도**를 선택하세요. 공유 링크로 참여한 사람에게 **연결이 종료됐어요** 안내가 표시되면 소유자에게 다른 링크를 받아야 합니다. **세션이 이미 종료되었어요.**는 터미널이 끝났다는 뜻이고, **해당 URL은 더 이상 유효하지 않아요.**는 공유 링크가 유효하지 않다는 뜻입니다.

## 사용 제한

| 제한 항목 | 적용 내용 |
| --- | --- |
| 세션 유지 시간 | 기본값은 터미널을 연 시점부터 1일입니다. 개인 설정으로 줄일 수 있으며, 워크스페이스 한도를 넘길 수 없습니다. |
| 공유 링크 만료 시간 | 5~180분이며 기본값은 30분입니다. 링크는 한 번만 사용할 수 있습니다. |
| 이메일 초대 | 한 번에 이메일 주소를 20개까지 입력할 수 있습니다. 중복 입력한 주소도 개수에 포함됩니다. |
| 월간 Websh 사용량과 공유 | 워크스페이스 플랜에 따라 제공 여부와 한도가 달라집니다. |
| 터미널 녹화 재생 | Free에서는 녹화를 재생할 수 없습니다. 아래 안내가 표시되며, 유료 플랜에서는 플랜에 따라 녹화를 볼 수 있습니다. |

Free에서는 **터미널 녹화는 Essentials 요금제부터 볼 수 있어요.** 안내가 표시됩니다. 플랜별 제공 범위는 [플랜과 결제](/use/workspace/plans-billing/)를, 재생 방법은 [터미널 녹화](/use/audit/sessions/review/#터미널-녹화)를 참고하세요.

키 입력, 터미널 출력, 브라우저 재접속으로는 제한 시간이 초기화되지 않습니다. 작업 세션의 **이어하기** 탭에서 다시 연결해도 같습니다. 에이전트의 터미널 연결이 다시 맺어질 때만 이 시간이 초기화됩니다. 제한 시간 전이라도 작업 세션이 끝나면 터미널이 종료될 수 있습니다.

[Websh 설정](/use/settings/websh/#세션-관리)에서 **세션 유지 시간**을 조정하세요. 최소 10분이며 워크스페이스의 **Websh 세션 유지 시간**을 넘길 수 없습니다. 관리자는 워크스페이스 한도를 10분부터 1일까지 설정할 수 있습니다.

## 세션 공유

터미널은 세션 소유자만 공유할 수 있습니다. 워크스페이스 멤버나 외부 협업자를 초대해 화면을 함께 보거나 명령어를 입력할 수 있습니다.

세션 공유는 Essentials 플랜 이상에서 제공됩니다. Free 플랜에서는 공유 시 업그레이드 안내가 표시됩니다. [플랜과 결제](/use/workspace/plans-billing/)를 참고하세요.

세션에서 **공유**를 클릭하고 다음 중 하나를 선택합니다.

- **이메일로 초대**: 이메일 주소를 20개까지 입력해 직접 초대합니다.
- **1회용 액세스 링크**: 공유할 링크를 만듭니다.

### 1회용 액세스 링크

링크 생성 시 다음을 설정합니다.

- **사용자 권한**: **읽기 전용**(보기만) 또는 **읽기 & 쓰기**(명령 입력) 중에서 선택합니다. 링크는 기본적으로 읽기 전용입니다.
- **링크 만료**: 5분부터 180분까지 5분 단위로 설정하며, 기본값은 30분입니다. 링크는 1회용이라 한 번 접속하면 즉시 만료됩니다.

소유자가 접속해 있는 동안에는 링크와 비밀번호를 가진 사람 누구나 참여할 수 있습니다. 로그인하지 않은 사람은 닉네임을 입력해야 합니다. 사용했거나 만료된 링크는 다시 쓸 수 없으므로 소유자에게 다른 링크를 요청하세요.

### 참여자

터미널 헤더의 참여자 아이콘을 선택하면 **참여자** 패널이 열립니다. 아이콘에는 세션에 있는 인원 수가 표시되고, 패널이 열려 있는 동안 목록이 자동으로 갱신됩니다. 소유자는 참여자를 선택해 다음을 할 수 있습니다.

- 참여자 권한을 읽기 전용과 **입력 가능** 사이에서 변경합니다. 변경은 바로 적용됩니다.
- 세션에서 내보내기로 참여자를 내보냅니다.

공유 링크 없이 다른 사용자의 세션을 열 수 있는 사람은 관리자뿐이며, 읽기 전용으로만 참여할 수 있습니다. 슈퍼유저는 세션 목록에서 다른 사용자의 세션에 **강제 종료**를 사용할 수 있습니다.

## 공유 활용 사례

- **함께 디버깅**: 팀원이 동일한 화면을 보고 명령을 제안하거나 실행합니다.
- **안전한 교육**: 읽기 전용으로 공유해 입력 없이 관찰하게 합니다.
- **도움 받기**: 시니어 엔지니어를 초대해 실시간 출력을 함께 확인합니다.

## 관련 문서

- [터미널 접속하기](/use/work-sessions/terminal/connect/)
- [작업 세션](/use/work-sessions/)
- [명령어 실행하기](/use/work-sessions/terminal/commands/)

Source: https://docs.alpacax.com/ko/use/work-sessions/terminal/sessions/