---
title: "서버 관리"
description: "등록된 서버의 정보를 바꾸고 원격 관리 작업을 수행합니다. 서버 목록과 상세 화면에서 가능한 작업을 확인한 뒤 터널과 코드 에디터를 켜거나 끄고, Alpamon 에이전트를 재시작하거나 업그레이드하세요. 설정 변경 이력과 업그레이드가 끝난 뒤의 기록도 확인할 수 있습니다."
---

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

# 서버 관리

서버 정보를 수정하고 원격으로 서버를 제어합니다.

## 서버 정보 수정

### 기본 정보 변경

1. 서버 상세 페이지에서 **업데이트** 버튼 클릭
2. 수정할 수 있는 항목:
   - **이름**: 서버 식별자
   - **접근 허용 그룹**: 접근할 수 있는 사용자 그룹
   - **소유자**: 서버 소유자
3. **저장** 클릭

**참고:** 메트릭 알림은 Metrics 앱에서 관리합니다.
[메트릭 알림 규칙 설정](/use/metrics/rules/)을 참고하세요.

### 터널과 코드 에디터

**업데이트** 패널의 체크박스 두 개로 이 서버에서 포트 포워딩과 브라우저 코드 에디터를 쓸 수 있는지 정합니다.

- **터널**: `alpacon tunnel`로 하는 [포트 포워딩](/reference/work-session-features/)을 허용함
- **코드 에디터**: [코드 에디터](/use/work-sessions/editor/connect/)를 허용함

작업 세션에서 포트 포워딩과 코드 에디터는 체크박스가 선택된 서버에서만 동작합니다. 세션의 어느 서버에서도 켜져 있지 않으면 세션에서 그 기능에 사용할 수 있는 서버가 없다는 경고가 표시됩니다.

**변경할 수 있는 사람:** 서버에 할당된 그룹의 소유자와 관리자, [서버의 maintainer](/use/workspace/settings/roles/#권한-상속-및-누적), Staff 또는 Superuser 역할을 가진 사용자입니다. 그 밖의 사용자에게는 **업데이트** 버튼이 보이지 않습니다.

**요구 사항:**

| 체크박스 | 필요 조건 |
| --- | --- |
| **터널** | Alpamon 2.0.0 이상 |
| **코드 에디터** | Alpamon 2.0.0 이상, 메모리 2GB 이상 |

조건을 갖추지 못한 서버에서는 이 기능을 켤 수 없습니다. 저장하면 어떤 조건이 부족한지 알려 주는 오류가 납니다. [에이전트를 업그레이드](#에이전트-카드)하면 버전 조건은 해결되지만 메모리는 늘어나지 않으므로, 메모리가 2GB보다 적은 서버에서는 코드 에디터를 쓸 수 없습니다. 켜 둔 뒤에 에이전트가 조건에 맞지 않는 버전을 보고하면 Alpacon이 그 기능을 끄고, 다시 켤 때까지 꺼진 상태로 남습니다.

Windows 서버에서 포트 포워딩은 Alpamon 2.5.1 이상이면 쓸 수 있지만, 코드 에디터는 실행되지 않습니다. 체크박스는 선택할 수 있어도 에디터를 열면 시작 시간 초과로 끝납니다. [Windows 서버](/reference/platforms/windows/)를 참고하세요.

**기능을 끄면** 그 서버로 새 포트 포워딩이나 에디터 연결을 열 수 없습니다. 열어 둔 에디터도 기능이 꺼져 있는 동안에는 다시 연결할 수 없습니다.

**새 서버의 기본값:** 새로 등록하는 서버에서 각 기능을 켠 상태로 시작할지는 Superuser가 [서버 기본 설정](/use/policies/server-access/)에서 정합니다. 기본값은 서버를 등록할 때 한 번만 적용되고, 서버가 요구 사항을 갖춘 경우에만 켜집니다. 기본값을 바꿔도 이미 등록된 서버는 바뀌지 않습니다.

### 서버 상세 정보

서버 상세 페이지에서 다음 정보를 확인할 수 있습니다.

**개요 탭:**

- 에이전트 정보(버전, 상태)
- OS 정보(배포판, 버전)
- 시스템 정보(CPU, 메모리, 디스크)
- 운영 정보(가동 시간, 부팅 시간)
- 네트워크 인터페이스
- 오프라인 알림 이력

마지막 동기화 시간 옆의 **지금 새로고침**을 클릭하면 다음 예약 동기화를 기다리지 않고 현재 시스템
정보를 바로 가져옵니다.

네트워크 인터페이스 아래의 **오프라인 알림 이력**에는 이 서버에서 해제된 오프라인 알림이 최신순으로
페이지당 5개씩 표시됩니다. 각 알림의 발생 시각(**발생**), 해제 시각(**해제**), 지속 시간(**지속 시간**), 종료 사유(**해제 사유**), 해제 알림을 전달한 채널(**전달 채널**,
[알림 이력](/use/metrics/rules/#알림-이력)과 같은 칩)을 확인할 수 있습니다. **해제 사유**에는 짧은
이름이 표시되고, 전체 설명은 툴팁에서 볼 수 있습니다. 해제 사유는 **다시 연결됨**, **연결 안정**(연결 상태가
반복해서 바뀌던 단계가 끝남), **등록 해제**, **비활성화**, **알림 끔**, **서버 삭제**, **인스턴스 꺼짐**, **더 이상 해당 없음**, 또는 종료 사유를 기록하기 전에 해제된 알림의 경우 **기록 없음**입니다. 이 표는 차트나 메트릭 알림과 달리 Metrics 확장 기능이 없어도 모든 요금제에서 사용할 수
있습니다.

**활동 탭:**

- 명령 실행 기록
- 서버 댓글과 멘션
- 사용자 활동 로그
- Alpacon을 거치지 않고 서버에 도달한 직접 로그인. 작업 세션과 같은 타임라인에 표시됩니다. [서버 페이지](/use/audit/governance/external-access/review/#server-page)를 참고하세요.

**접근 탭:**

- **직접 로그인 탐지 범위**: 서버의 직접 로그인 탐지 여부와 탐지 불가 원인, 변경할 내용, 점검 방법. [서버 상태 점검](/use/audit/governance/external-access/coverage/#check-a-server)을 참고하세요.
- 시스템 사용자. 계정별 마지막 직접 로그인과 검토 대기 중인 발견 사항을 보여주며, 제거된 멤버에 연결된 계정에는 표시가 붙습니다.
- 시스템 그룹

차트와 메트릭 알림은 서버 상세 페이지가 아닌 Metrics 앱에서 확인할 수 있습니다.
[서버 상태 모니터링](/use/servers/monitor/)을 참고하세요.

**로그 탭:**

- Alpamon 에이전트의 최근 로그
- Backhaul 기록(데이터 전송 로그)
- 전송 상태와 데이터 크기

## 서버 제어

**요구 사항:**

- 서버 상태: **연결됨**
- 권한: 할당된 그룹의 소유자 또는 관리자, [서버의 maintainer](/use/workspace/settings/roles/#권한-상속-및-누적), Staff 또는 Superuser 역할을 가진 사용자

### 에이전트 카드

서버 상세 페이지의 에이전트 카드에서는 Alpamon 에이전트 자체를 관리할 수 있습니다. 에이전트 버전 옆의 **업데이트 정책**에는 워크스페이스의 [에이전트 업데이트 정책](/use/workspace/settings/agent-updates/)이 **최신 버전**, **한 릴리스 이전 버전**, **수동** 중 하나로 표시됩니다.

- **에이전트 재시작**: 에이전트 프로세스를 다시 시작함. 연결 문제를 해결할 때 유용하며, 서버가 잠시
  오프라인으로 표시된 뒤 자동으로 다시 연결됨
- **에이전트 업그레이드**: 에이전트를 최신 릴리스로 업데이트하고 다시 시작함. 업데이트 정책이 **수동**일
  때만 버튼이 표시됨. 자동 정책에서는 워크스페이스의 유지보수 시간대 안에서 에이전트가
  업그레이드되며 버튼이 표시되지 않음. Windows에서는 Alpamon 2.4.0 이상이
  필요하며, 그보다 오래된 에이전트의 업그레이드 절차는 [에이전트 업그레이드](/use/servers/register/install/#에이전트-업그레이드)에 있음
- **alpamon-pam 설치 또는 업그레이드**: 호스트의 패키지 매니저로 `alpamon-pam` 패키지를 root 권한으로 설치하고, 이전 버전이 있으면
  업그레이드함. alpamon만 설치해 등록한 서버나 [sudo with MFA](/use/work-sessions/terminal/sudo-with-mfa/)를 켤 때 오프라인이던 서버에 사용함.
  `apt`, `yum`, `zypper`를 쓰는 호스트에서 에이전트가 연결돼 있을 때 표시됨. 서버의 sudo 정책 행에 `alpamon-pam`이
  설정되지 않았다고 나오면 같은 작업이 그 행의 설치 링크로 표시됨. [접근 규칙](/use/policies/access-rules/)에서
  **Alpacon을 통한 sudo**가 꺼져 있으면 버튼이 비활성화되고 "**서버 접근 정책에서 sudo with MFA가 꺼져 있어요**" 안내가 표시됨. 이미 현재 버전이 설치된 호스트는
  그대로 두고, 설치가 아직 완료되지 않은 서버에 다시 요청하면 거부됨. CLI에서는
  [`alpacon agent install-pam`](/reference/cli/agent/install-pam/)으로 같은 작업을 실행할 수 있음

버튼을 클릭하고 대화상자에서 확인한 뒤 토스트 메시지로 결과를 확인하세요.

업그레이드는 에이전트를 이전 버전으로 되돌리지 않습니다. **수동** 정책에서 에이전트가 이미 최신 릴리스를 실행 중이면 **에이전트 업그레이드** 버튼은 그대로 보이지만 비활성화되고, **에이전트가 최신이에요**라는 안내가 표시됩니다. 서버에서 업그레이드가 이미 진행 중일 때 다시 요청하면 "이 서버에서 에이전트 업그레이드가 이미 진행 중이에요. 끝난 뒤 다시 시도해 주세요."라는 메시지와 함께 거부됩니다.

### 업그레이드 이력

서버의 **개요** 탭에서 네트워크 인터페이스와 오프라인 알림 다음에 **업그레이드 이력**이 표시됩니다. 이 서버의 자동·수동 에이전트 업그레이드를 최신순으로 한 페이지에 5개씩 보여 주며, 5개를 넘으면 목록 아래에 페이지 이동 버튼이 나타납니다. **업그레이드 상태**와 **시작 방식**(**자동** 또는 **수동**)으로 목록을 좁힐 수 있습니다. 같은 종류의 실패가 반복되면 "연속 3회 실패"처럼 한 행으로 묶이고, 필터를 적용하면 각 시도가 별도 행으로 표시됩니다. 실패·시간 초과·롤백된 행에 로그가 있으면 해당 행을 선택해 에이전트 로그를 열 수 있습니다. **전체 업그레이드 이력**을 선택하면 볼 수 있는 모든 서버의 업그레이드 이력이 열립니다. 이 서버를 볼 수 있는 사람은 누구나 이력을 볼 수 있습니다.

각 행에는 다음 내용이 표시됩니다.

- **결과**: **진행 중**, **성공**, **롤백됨**(새 버전이 정상적으로 올라오지 않아 에이전트가 이전 버전으로 돌아감), **실패**, **시간 초과**(에이전트가 제시간에 업그레이드를 확인하지 않음), **거부됨**(에이전트에 도달하기 전에 업그레이드가 철회됨) 중 하나
- **버전**: 업그레이드 전 버전과 업그레이드 후 버전. 예: `1.4.2 → 1.5.0`. 에이전트가 결과를 보고하기 전까지는 업그레이드할 버전에 (목표)가 붙음
- **시각과 요청자**: 업그레이드를 요청한 시각과 시작한 주체. 멤버의 사용자 이름, API 토큰 이름, 자동 업그레이드라면 **Alpacon 자동 정책** (latest)로 표시됨
- **사유**: 실패하거나 롤백된 업그레이드는 적용되지 않은 이유가, 거부되거나 실패한 업그레이드는 Alpacon의 짧은 설명이 표시됨

사유 문구는 다음과 같습니다.

| 문구 | 의미 |
|---|---|
| **서명 불일치** | 릴리스 서명이 검증되지 않아 에이전트가 설치하지 않음 |
| **다이제스트 불일치** | 다운로드한 패키지가 게시된 체크섬과 일치하지 않음 |
| **다운로드 실패** | 에이전트가 릴리스를 다운로드하지 못함 |
| **교체 실패** | 에이전트가 자신의 실행 파일을 새 파일로 교체하지 못함 |
| **상태 확인 실패** | 새 버전이 시작된 뒤 상태 확인을 통과하지 못함 |
| **패키지 관리자 오류** | 시스템 패키지 관리자(`apt`, `yum`, `zypper`)가 오류를 보고함 |
| **유지보수 시간대 밖** | 업그레이드가 시작되기 전에 유지보수 시간대가 닫힘 |
| **Alpacon 설정 문제로 조치할 필요 없어요** | Alpacon 쪽 문제. 서버에서 바꿀 것은 없음 |
| **알 수 없음** | 에이전트가 원인을 알 수 없는 실패를 보고함 |

**거부됨** 행은 대개 업그레이드가 에이전트에 도달하기 전에 유지보수 시간대가 닫혔거나, 정책이 **수동**으로 바뀌었거나, 대기 중이던 자동 업그레이드를 수동 업그레이드가 대신했거나, Alpacon이 플랫폼 전체의 자동 업그레이드를 일시 중지한 경우입니다. 설치된 것은 없으며 에이전트는 기존 버전으로 계속 실행됩니다.

이력은 업그레이드 이력 기능이 도입된 시점부터 남습니다. 그 전의 업그레이드는 표시되지 않으며, 그 뒤로 업그레이드가 없는 서버에는 "이 기록은 업그레이드 이력이 도입된 시점부터 남아요. 그 전의 업그레이드는 보이지 않아요."가 표시됩니다. 각 업그레이드는 전송될 때와 끝날 때 모두 [활동 로그](/use/audit/governance/activity-log/)에도 기록되므로, 워크스페이스 활동을 검색하거나 내보낼 때 함께 포함됩니다.

볼 수 있는 모든 서버의 업그레이드를 한꺼번에 보려면 Servers에서 **더보기** → **에이전트 업그레이드**를 여세요. 이 서버들의 최근 에이전트 업그레이드가 최신순으로 표시되며, 서버를 볼 수 있는 역할이라면 누구나 열 수 있습니다. **결과**나 **시작 방식**(**자동** 또는 **수동**)으로 목록을 거를 수 있고, 서버 이름을 선택하면 해당 서버로 이동합니다. 각 행을 읽는 방법은 위의 목록과 같습니다. 같은 이력을 [에이전트 업그레이드 API](/reference/api/servers/agent-upgrades/)로도 확인할 수 있습니다.

### 업그레이드 실패 알림

에이전트 업그레이드가 실패하거나 롤백되면 Alpacon은 해당 서버에 **경고** 알림을 발생시킵니다. 알림 제목은 `에이전트 1.5.0 업그레이드에 실패했습니다`와 같은 형식입니다. 이 알림은 알림 종 아이콘과 알림 목록에만 표시되며, 이메일이나 Slack 메시지는 보내지 않고 매시간 발송되는 미해결 알림 요약에도 들어가지 않습니다. 업그레이드가 연달아 실패해도 서버마다 열려 있는 알림은 하나뿐이며, 다음 업그레이드가 성공하면 해결됩니다. 업그레이드가 성공했을 때는 알림을 보내지 않으며, 사유가 **Alpacon 설정 문제로 조치할 필요 없어요**인 실패에도 알림을 발생시키지 않습니다.

### 호스트 작업

서버를 재부팅하거나 종료하거나 운영체제 패키지를 업그레이드할 때는 서버 페이지의 버튼 대신
[작업 세션](/use/work-sessions/)에서 명령을 실행하세요. 세션에서 Websh를 열거나 `--work-session`으로
`alpacon exec`를 세션에 연결한 뒤, 다른 관리자 권한 명령과 마찬가지로 sudo를 사용하세요. 예를 들어
`sudo reboot`, `sudo shutdown -h now`, `sudo apt upgrade -y` 또는 사용 중인 플랫폼의 패키지 관리자
명령을 실행할 수 있습니다. `alpacon exec --work-session SESSION_ID my-server -- sudo reboot`를
실행하면 `SESSION_ID` 세션에서 `my-server`가 재부팅됩니다. 이 작업에는 워크스페이스의 sudo 정책,
MFA, 승인 규칙이 적용되며 Alpacon은 다른 세션과 마찬가지로 기록을 남깁니다. 작업을 계획하고 있다면
먼저 [서버 알림을 음소거](/use/servers/monitor/#서버-알림-일시-중지)하세요. 이 방식으로 명령을 실행하면
Alpacon이 오프라인 알림을 자동으로 보류하지 않습니다.

## 서버 목록에서 할 수 있는 작업

서버 목록에서 서버를 하나 이상 선택하면 다음 작업을 할 수 있습니다.

- 선택한 서버가 포함된 작업 세션 요청(**연결**)
- 선택한 서버의 **알림 끄기**. [서버 음소거](/use/servers/monitor/#서버-알림-일시-중지) 참고
- 선택한 서버 **연결 해제**. [일괄 삭제](/use/servers/remove/#일괄-삭제) 참고

에이전트 재시작과 업그레이드는 목록에서 할 수 없습니다. 각 서버의 상세 페이지에 있는
[에이전트 카드](#에이전트-카드)를 사용하세요. 시스템 정보 새로고침도 목록에서 할 수 없습니다. 상세
페이지에서 마지막 동기화 시간 옆의 **지금 새로고침**을 사용하세요.

**필터링:**

- 그룹 필터: 특정 그룹의 서버만 표시
- 상태 필터: 연결된 서버와 연결이 끊긴 서버 구분
- 검색: 서버 이름으로 빠르게 검색

## 서버 댓글

서버 관련 정보를 팀원과 공유합니다.

**댓글 추가:**

1. 서버 상세 페이지 > 활동 탭
2. 댓글 입력란에 내용 작성
3. @username으로 특정 사용자 멘션
4. **추가** 클릭

**댓글 고정:**

- 중요한 댓글을 맨 위에 고정, 최대 3개
- 핀 아이콘을 클릭해 고정하거나 고정 해제

## 자체 업데이트가 안 되는 Windows 에이전트 업그레이드

자동·수동 업그레이드는 [업그레이드 이력](#업그레이드-이력)에 남습니다. Linux에서는 시스템 패키지 관리자로 업데이트하고, macOS와 Windows에서는 릴리스를 다운로드합니다. 버전을 확인하려면 서버에서 `api.github.com`으로 HTTPS 연결이 가능해야 합니다. 업데이트 중 에이전트가 재시작하므로 서버가 잠시 오프라인으로 표시될 수 있습니다. 실패하면 이전 버전이 계속 실행됩니다.

Windows에서도 Alpamon 2.4.0 이상이면 macOS와 같은 방식으로 에이전트가 자체 업데이트합니다. 2.4.0보다 오래된 에이전트는 스스로 업데이트하지 못합니다. 업그레이드 이력에 **지원하지 않는 플랫폼**으로 실패가 남고, 에이전트가 다른 버전을 보고하기 전까지 Alpacon은 새 업그레이드를 예약하지 않습니다. 이미 등록된 호스트에서는 설치 프로그램을 다시 실행해도 `alpamon.exe register`가 `config file already exists`로 멈추므로 업그레이드되지 않습니다. 대신 바이너리를 한 번 직접 교체하세요. 그 뒤로는 업그레이드가 알아서 진행됩니다. 자체 업데이트 경로가 막혀 있을 때도 같은 방법을 쓰세요.

다음 단계는 Websh가 아닌 서버에서 직접(로컬 콘솔, RDP, 클라우드 시리얼 콘솔) 관리자 권한 PowerShell로 실행하세요. 서비스를 멈추면 내 세션뿐 아니라 그 서버에 열린 모든 Websh와 WebFTP 세션, 터널이 끊기므로, 서버를 쓰는 사람이 없을 때 진행하세요.

1. [GitHub Releases](https://github.com/alpacax/alpamon/releases)에서 최신 `alpamon-X.Y.Z-windows-amd64.zip`과 `alpamon-X.Y.Z-checksums.sha256`을 같은 폴더에 내려받습니다. 압축 파일의 해시가 체크섬 파일에 적힌 값과 같은지 확인하고, 다르면 압축 파일을 쓰지 마세요.

   ```powershell
   (Get-FileHash .\alpamon-X.Y.Z-windows-amd64.zip -Algorithm SHA256).Hash.ToLower()
   Select-String 'alpamon-X.Y.Z-windows-amd64.zip' .\alpamon-X.Y.Z-checksums.sha256
   ```

2. [방법 1](/use/servers/register/install/#방법-1-수동-설치)처럼 차단을 해제하고 압축을 풉니다.
3. 압축을 푼 폴더에서 서비스를 멈추고 바이너리를 바꿉니다. 오래된 에이전트는 서비스가 멈춘 뒤에도 `alpamon.exe` 프로세스가 남아 파일을 잠글 수 있습니다. 그래서 남은 프로세스를 끝내고, 기존 파일은 덮어쓰지 않고 다른 이름으로 옮겨 둡니다.

   ```powershell
   Stop-Service alpamon -Force
   Get-Process alpamon -ErrorAction SilentlyContinue | Stop-Process -Force
   Move-Item -Force "$env:ProgramFiles\alpamon\alpamon.exe" "$env:ProgramFiles\alpamon\alpamon.exe.old"
   Copy-Item .\alpamon.exe "$env:ProgramFiles\alpamon\alpamon.exe"
   Start-Service alpamon
   ```

   `alpamon.exe.old`는 새 에이전트가 시작할 때 지웁니다.

4. 서버의 [에이전트 카드](/use/servers/manage/#에이전트-카드)에 새 버전이 표시되는지 확인합니다.

업그레이드가 적용되지 않으면 [에이전트 업그레이드 문제](/use/servers/troubleshooting/#에이전트-업그레이드-문제)를 참고하세요.

## 관련 문서

- [서버 모니터링](/use/servers/monitor/)
- [서버 접근 제어](/use/servers/groups/)
- [서버 제거](/use/servers/remove/)

Source: https://docs.alpacax.com/ko/use/servers/manage/