---
title: "Alpamon 구성"
description: "Alpamon의 구성 파일 경로와 등록용 환경 변수, 프록시 및 인증서 설정을 확인합니다. Linux, macOS, Windows 서버의 INI 필드를 참고해 필요한 값을 적용하세요. 일반 설치는 워크스페이스에서 생성한 명령을 사용하고, 별도 설정이 필요한 경우 이 자료를 참고합니다."
---

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

# Alpamon 구성

서버에 별도 인증서나 프록시 설정이 필요할 때 참고하세요. 일반적인 설치에는 워크스페이스에서 생성한 명령을 사용합니다. 절차는 [Alpamon 설치](/use/servers/register/install/)를 참고하세요.

## 구성

### 구성 파일

구성 파일 위치는 플랫폼에 따라 다릅니다:

- **Linux**: `/etc/alpamon/alpamon.conf`
- **macOS**: `/etc/alpamon/alpamon.conf`
- **Windows**: `%ProgramData%\alpamon\alpamon.conf`

형식 (INI):

```ini
[server]
id = your-server-id
key = your-server-key
url = https://your-workspace.ap1.alpacon.io

[ssl]
verify = true
# ca_cert = /path/to/ca.crt    # Custom CA certificate (optional)

[logging]
debug = false           # Enable verbose debug logging

[pool]
max_workers = 20        # Default: 20 concurrent workers
queue_size = 200        # Default: 200 queued jobs
default_timeout = 3600  # Default: 3600 seconds when unset (0 = no timeout)

[editor]
idle_timeout = 60       # Default: 60 minutes (0 = disabled)

[interface]
include_virtual =      # Default: empty; example: veth0, cali*
exclude_virtual_from_inventory = false # Default: false

[file]
# max_download_bytes = 0    # Max download size in bytes for URL fetches (0 = unlimited)
```

이 파일은 설치 또는 등록 시 자동으로 생성됩니다. 일반적으로 수동으로 편집할 필요가 없습니다.

### 네트워크 인터페이스 설정

`[interface]`의 `include_virtual`에는 인터페이스 이름이나 대소문자를 구분하는 glob 패턴을 쉼표로 나열합니다(예: `veth0, cali*`). 기본값은 빈 목록입니다. 트래픽 수집 대상에서 제외되는 가상 인터페이스의 트래픽도 수집하려면 이 목록에 추가하세요. 루프백 인터페이스나 하드웨어 주소가 없는 인터페이스는 이 설정으로 추가할 수 없습니다.

`exclude_virtual_from_inventory`의 기본값은 `false`입니다. 따라서 트래픽을 수집하지 않는 가상 인터페이스도 보고되는 인터페이스 목록에는 남습니다. 목록에서도 제외하려면 `true`로 설정합니다.

에이전트가 더 이상 보고하지 않는 인터페이스를 Alpacon 서버가 보존하는지 확인한 뒤에만 `exclude_virtual_from_inventory`를 켜세요. 서버가 보고되지 않는 인터페이스를 삭제하면 해당 인터페이스의 트래픽 이력도 함께 삭제됩니다.

### 환경 변수

다음 환경 변수는 패키지 설치 시 자동 등록에 사용됩니다:

```bash
# Required for auto-registration
export ALPACON_URL="https://your-workspace.ap1.alpacon.io"
export PLUGIN_ID="your-server-id"
export PLUGIN_KEY="your-server-key"

# Optional
export ALPACON_SSL_VERIFY="true"      # SSL certificate verification
export ALPACON_CA_CERT="/path/to/ca.crt"  # CA certificate path
export PLUGIN_DEBUG="false"           # Enable debug logging
```

### 프록시 구성

서버가 프록시 뒤에 있는 경우, 설치 명령 또는 `alpamon register` 실행 전에 HTTP 프록시 환경 변수를 설정합니다:

```bash
export http_proxy="http://proxy.example.com:8080"
export https_proxy="http://proxy.example.com:8080"
```

소문자 형식(`http_proxy` / `https_proxy`)을 사용하세요. 워크스페이스에서 생성된 명령과 시스템 패키지 매니저가 이 형식을 읽습니다. `sudo -EH`의 `-EH` 플래그는 설치 과정에서 이 변수를 보존합니다.

이 변수는 해당 셸에서 실행한 명령에만 적용됩니다. 설치된 에이전트 서비스는 이 변수를 물려받지 않으므로, 에이전트가 프록시를 거쳐 연결하게 하려면 [프록시 지원](/learn/security/network/#프록시-지원)을 참고하세요.

Source: https://docs.alpacax.com/ko/reference/agent-configuration/