---
title: "사용자 제거하기"
description: "Alpacon 워크스페이스에서 사용자를 제거하기 전에 필요한 권한과 진행 중인 작업 세션을 확인하세요. 일반 삭제와 완전 삭제의 차이를 비교하고, 삭제 뒤 남는 기록과 데이터에 미치는 영향을 살펴본 뒤 알맞은 방법을 선택합니다. 사용자를 제거하기 전에 영향받는 권한을 점검하세요."
---

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

# 사용자 제거하기

워크스페이스에서 더 이상 필요하지 않은 사용자를 제거합니다.

## 필수 권한

사용자를 제거하려면 `staff` 또는 `superuser` 권한이 필요합니다.

## 삭제 유형

Alpacon은 두 가지 사용자 삭제 방식을 제공합니다. 아래의 서버 계정 삭제는 Alpacon이 사용자를 위해 만든 Linux 계정에 적용됩니다. 서버에서 발견한 계정은 디스크에 남고, 제거된 사용자와의 연결만 해제됩니다.

### 일반 삭제 (Normal deletion)

일반 삭제는 사용자 계정을 제거하되 **서버의 홈 디렉터리는 그대로 둡니다**.

**처리 내용:**

- 워크스페이스에서 사용자 계정 삭제
- 서버의 홈 디렉터리를 `/home/deleted_users/`로 이동
- 디렉터리 소유권을 `root` 사용자로 변경
- 디렉터리 권한을 `0700`으로 설정

**이럴 때 사용하세요:**

- 감사나 복구를 위해 사용자 데이터를 보존해야 할 때
- 나중에 파일을 복원할 수 있게 남겨두고 싶을 때
- 규정 준수상 데이터를 보관해야 할 때

### 완전 삭제 (Purge deletion)

완전 삭제는 사용자와 서버의 모든 관련 데이터를 완전히 제거합니다.
이 방식을 쓰려면 삭제 모달의 **홈 디렉터리 삭제** 체크박스를 선택하세요.

**처리 내용:**

- 워크스페이스에서 사용자 계정 삭제
- 서버의 홈 디렉터리 영구 삭제
- 모든 사용자 파일 제거

**⚠️ 경고:** 복구할 수 없습니다. 매우 신중하게 사용하세요.

**이럴 때 사용하세요:**

- 사용자 데이터가 더 이상 필요 없을 때
- 규정 준수상 데이터를 완전히 지워야 할 때
- 디스크 공간을 확보할 때

## 제거 방법

### 사용자 상세 페이지에서

1. **IAM** > Users로 이동합니다.
2. 제거할 사용자 클릭
3. 우측 상단의 **휴지통 아이콘** 클릭
4. 삭제 유형 선택: **홈 디렉터리 삭제** 체크박스
   - **체크 안 함**: 일반 삭제 (홈 디렉터리 보존)
   - **체크함**: 완전 삭제 (데이터까지 완전 삭제)
5. 확인 모달에서 **계속** 클릭
6. 토스트 메시지로 결과 확인

## 제거 전 확인사항

### 데이터 영향

사용자를 제거하면 다음이 영구 삭제됩니다.

- 사용자 프로필 정보
- 그룹 멤버십
- 권한 설정
- 활동 기록

**주의:** 삭제한 뒤에는 복구할 수 없습니다.

### 서버 접근

- 사용자가 접근하던 서버에서 자동으로 제거됩니다.
- Alpacon이 사용자를 위해 만든 Linux 계정은 삭제되며, 홈 디렉터리 처리는 선택한 삭제 방식에 따릅니다.
- 서버에서 발견한 계정은 유지되며, 제거된 사용자와의 연결만 해제됩니다.

### 소유한 리소스

사용자가 소유한 리소스를 확인하세요.

- 서버 소유자인 경우
- 그룹 관리자인 경우
- Webhook 소유자인 경우

필요하면 소유권을 다른 사용자에게 먼저 넘기세요.

## 작업 세션

사용자를 제거하면 접근 권한도 정리됩니다.

- 그 사용자에게 지정된 작업 세션이 승인됨 또는 활성 상태라면 철회됩니다. 웹 터미널, 파일 전송, 포트 포워딩, 에디터 연결이 닫힙니다. 아직 전달되지 않은 명령어와 대기 중인 연장 요청은 취소됩니다. 세션에 연결된 sudo 권한도 끝납니다.
- 사용자가 별도로 열어 둔 웹 터미널과 파일 전송 세션이 종료됩니다.
- 사용자의 개인 API 토큰이 삭제됩니다.
- 승인 대기 중인 세션 요청은 대기 상태로 남습니다. 관리자는 승인자에게 반려를 요청하거나 Superuser에게 취소를 요청하세요.

[세션 수명 주기](/use/work-sessions/detail/#세션-수명-주기)에서 상태별 의미와 세션을 종료할 수 있는 사람을 확인하세요.

## 워크스페이스 나가기

워크스페이스에서 나가려면 워크스페이스 관리자에게 [멤버 제거](/use/iam/users/remove/#제거-방법)를 요청해야 합니다. 사용자가 직접 워크스페이스를 나갈 수는 없습니다.

## Superuser 제거

Superuser를 제거할 때 유의할 점입니다.

**최소 1명의 Superuser 유지:**

- 워크스페이스에는 항상 Superuser가 1명 이상 있어야 합니다.
- 마지막 Superuser는 제거할 수 없습니다.
- 다른 사용자를 먼저 Superuser로 승격한 뒤 제거하세요.

## 제거 후

사용자를 제거하면:

- 사용자가 워크스페이스 목록에서 빠집니다.
- 이메일 알림은 발송되지 않습니다.
- 같은 이메일로 다시 초대할 수 있습니다.

## 사용자 비활성화 vs 제거

| 작업     | 효과                        | 복구          |
| -------- | --------------------------- | ------------- |
| 비활성화 | 로그인 차단, 데이터 유지    | 재활성화 가능 |
| 제거     | 완전 삭제, 데이터 영구 삭제 | 복구 불가     |

**권장:** 일시적으로 접근을 막을 때는 비활성화를 사용하세요.

## 문제 해결

**제거 버튼이 비활성화된 경우:**

- Staff 또는 Superuser 권한이 있는지 확인
- 마지막 Superuser인지 확인

**"Cannot delete last superuser" 오류:**

- 다른 사용자를 먼저 Superuser로 승격
- 그런 다음 제거 진행

## 감사 로그

사용자 제거는 감사 로그에 기록됩니다.

- 제거한 관리자
- 제거 시간
- 제거된 사용자 정보

## 관련 문서

- [사용자 추가하기](/use/iam/users/add/)
- [사용자 관리하기](/use/iam/users/manage/)
- [그룹 관리](/use/iam/groups/manage/)

Source: https://docs.alpacax.com/ko/use/iam/users/remove/