---
title: "작업 세션 기능"
description: "Alpacon 작업 세션에서 사용할 수 있는 주요 기능인 웹 터미널, 파일 전송, 명령 실행, 포트 포워딩, 코드 에디터, sudo를 알아봅니다. 기능별로 브라우저에서 여는지 CLI에서 사용하는지 확인하세요. 승인 후 기능을 바꾸는 경우와 필요한 권한도 함께 살펴봅니다."
---

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

# 작업 세션 기능

<span id="세션-기능" />

# 작업 세션 기능

세션 기능에는 웹 터미널, 파일 전송, 명령 실행, 포트 포워딩, 코드 에디터, sudo가 있습니다.

## 세션 기능의 사용 방식

[세션을 요청할 때](/use/work-sessions/create/) 사용할 기능을 선택합니다. 각 기능은 세션에 포함된
서버에서 작업할 수 있는 방법을 제공합니다. 요청하고 승인된 기능만 사용할 수 있습니다.

기능은 다음 두 가지 방식으로 사용합니다.

- **웹 인터페이스**: 세션 상세 페이지에서 브라우저로 바로 실행함
- **CLI**: 세션에 연결한 뒤 [CLI 레퍼런스](/reference/cli/)에서 사용함

## 사용 가능한 기능

### 웹 터미널 (Websh)

브라우저 터미널에서 서버 명령을 실행합니다. 세션의 **세션** 탭에서 해당 서버의 **터미널**을 클릭하세요. CLI에서도 터미널을 열 수 있습니다.

```
$ alpacon websh SERVER
```

[터미널 접근 개요](/use/work-sessions/terminal/)와 [`alpacon websh`](/reference/cli/websh/) CLI 문서를 참고하세요.

### 파일 전송 (WebFTP)

서버와 파일을 주고받을 수 있으며, 브라우저에서는 드래그 앤 드롭도 지원합니다. 세션의 **세션** 탭에서 해당 서버의 **파일**을 클릭하세요. CLI에서도 파일을 전송할 수 있습니다.

```
$ alpacon cp SERVER:/path/to/remote ./local/
```

[파일 관리 개요](/use/work-sessions/files/)와 [`alpacon cp`](/reference/cli/cp/),
[`alpacon edit`](/reference/cli/edit/) CLI 문서를 참고하세요.

### 명령 실행 (Command)

CLI에서 하나 이상의 서버에 명령을 실행합니다.

```
$ alpacon exec SERVER -- COMMAND
```

사용법과 플래그는 [`alpacon exec`](/reference/cli/exec/) CLI 문서를 참고하세요.

### 포트 포워딩 (Tunnel)

서버 포트를 로컬 컴퓨터로 안전하게 전달합니다. CLI에서 사용합니다.

```
$ alpacon tunnel SERVER -l LOCAL -r REMOTE
```

사용법과 플래그는 [`alpacon tunnel`](/reference/cli/tunnel/) CLI 문서를 참고하세요.

포트 포워딩은 **터널** 설정이 켜진 서버에서만 동작합니다. [터널과 코드 에디터](/use/servers/manage/#터널과-코드-에디터)를 참고하세요.

### 코드 에디터 (Editor)

브라우저의 코드 에디터에서 서버 파일을 직접 수정합니다. 세션의 **세션** 탭에서 해당 서버의 **에디터**를 클릭하세요.

코드 에디터는 **코드 에디터** 설정이 켜진 서버에서만 동작합니다. [터널과 코드 에디터](/use/servers/manage/#터널과-코드-에디터)를 참고하세요. 설정이 꺼져 있으면 해당 서버의 **에디터** 동작에서 열 수 없는 이유를 확인할 수 있습니다.

[코드 에디터 개요](/use/work-sessions/editor/)를 참고하세요.

### 권한 상승 (Sudo)

세션의 다른 기능에서 상승된 권한(sudo)으로 작업할 수 있습니다. 이 기능은 단독으로 실행하지 않습니다.
터미널, 파일 전송 등 사용하는 기능에 상승된 권한을 부여합니다. 세션에 포함하는 것만으로는 충분하지
않습니다. 다른 기능과 마찬가지로 요청하고 승인받아야 합니다.

이후 sudo를 사용할 때마다 해당 작업을 다시 확인합니다. 워크스페이스의 승인 정책에 따라 위험도가 낮은
작업은 자동으로 승인되거나 담당자의 승인을 기다리며, MFA를 요청할 수도 있습니다. 승인은 제한된 시간
동안만 유효하고 모든 sudo 작업은 감사 기록에 남습니다.

**사람이 승인한 명령에는 그 명령의 sudo 승인도 포함됩니다.** 승인 대기 중인 명령을 사람이 승인하면,
승인한 명령줄에 적힌 `sudo`도 함께 승인됩니다. 이때 권한 상승은 별도의 sudo 승인 없이 실행되며,
위험도가 심각 수준이어도 이를 이유로 거부되지 않습니다. 승인 범위는 승인자가 확인한 내용과 그 명령이
실행되는 동안으로 한정됩니다. 다만 공백이 포함된 스크립트를 실행하는 `sudo sh -c '…'`, `root`가 아닌
계정을 지정하는 `sudo -u`, 스크립트나 `xargs` 등을 통해 간접적으로 실행되는 `sudo`는 별도로
확인하며, 추가 승인을 요청하거나 거부할 수 있습니다. 워크스페이스에서 명령을 거부하거나 승인자를 둘
이상 요구하도록 정한 정책도 그대로 적용됩니다.

**사람이 승인하지 않은 명령**은 명령 전체의 위험도와 AI 검증에서 거부된 위험도 중 더 높은 수준으로
판단합니다. 명령 전체의 위험도가 낮게 표시되더라도 AI 검증에서 심각 수준으로 거부된 명령은 실행되지
않고, 높음 수준으로 거부된 명령은 승인을 기다립니다.

[실행 제어](/use/policies/server-access/)가 **Advisory**로 설정된
워크스페이스에서는 위험도가 높아도 sudo 작업이 보류되지 않습니다. 대신
[Privilege elevation](/use/audit/events/sudo/)에 **Advisory** (not gated)로 기록됩니다. 그 밖의 sudo 동작은
그대로입니다. 명령을 실행할 권한이 있어야 하며 MFA를 요청받을 수 있습니다.

여기서는 작업 세션에서 사용하는 sudo를 설명합니다. 서비스 토큰으로 실행하는 파이프라인에는 다른
기준이 적용됩니다. 이 경우 사람의 승인을 기다리느라 보류되지 않으며 MFA도 요청하지 않습니다. 자세한
내용은
[명령 패턴과 sudo](/use/iam/applications/service-tokens/command-patterns/#토큰이-sudo를-실행하면)를
참고하세요.

[sudo with MFA](/use/work-sessions/terminal/sudo-with-mfa/)를 참고하세요.

## 기능 요약

| 기능 | 사용 방법 | CLI 명령 |
| --- | --- | --- |
| 웹 터미널 | 브라우저 및 CLI | `alpacon websh SERVER` |
| 파일 전송 | 브라우저 및 CLI | `alpacon cp SERVER:/remote ./local/` |
| 명령 실행 | CLI | `alpacon exec SERVER -- COMMAND` |
| 포트 포워딩 | CLI | `alpacon tunnel SERVER -l LOCAL -r REMOTE` |
| 코드 에디터 | 브라우저 | — |
| 권한 상승 | 수식 기능(별도 실행 없음) | — |

## 승인 후 기능 변경

세션 소유자 또는 Superuser는 승인된 세션이나 활성 세션의 기능을 변경할 수 있습니다. 변경 사항을
적용하려면 다시 승인이 필요할 수 있습니다. 자세한 내용은
[세션 사용하기](/use/work-sessions/detail/)를 참고하세요.

## 관련 문서

- [세션 요청하기](/use/work-sessions/create/)
- [세션 사용하기](/use/work-sessions/detail/)
- [CLI 레퍼런스](/reference/cli/)

Source: https://docs.alpacax.com/ko/reference/work-session-features/