---
title: "서버 네트워크 준비"
description: "서버와 클라이언트에서 Alpacon 워크스페이스에 안전하게 연결할 때 필요한 아웃바운드 목적지를 확인합니다. 방화벽 허용 목록, 프록시 변수, 다운로드 호스트와 리전 선택을 점검하세요. SSH 접근을 줄이기 전에 대체 접속 경로와 연결 문제 해결 방법도 함께 미리 확인하세요."
---

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

# 서버 네트워크 준비

<span id="인프라-구성-가이드" />
# 서버 네트워크 준비

Alpacon을 엔터프라이즈 환경에서 안전하게 구성하기 위한 가이드입니다.

## 방화벽 구성

### 서버 시스템

Alpacon 에이전트는 아웃바운드 HTTPS/WSS 연결을 사용합니다. 화이트리스트 기반 방화벽이나 프록시를 사용하는 경우, 다음 대상으로의 아웃바운드 연결을 허용해야 합니다.

| 도메인 | 용도 | 필수 여부 | 비고 |
|--------|------|----------|------|
| `https://<workspace>.<region>.alpacon.io` | 핵심 기능 | 필수 | 워크스페이스 이름과 리전은 설정에 따라 다름 |
| `https://api.github.com` | 최신 릴리스 조회 | 최신 릴리스를 조회하거나 설치할 때 | Linux 패키지 관리자는 조회가 실패해도 업그레이드를 진행할 수 있음 |
| `https://github.com` | 에이전트 설치 및 업데이트 다운로드 | Windows·macOS 필수 | Linux는 패키지 저장소로 설치·업데이트 |
| `https://release-assets.githubusercontent.com`, `https://objects.githubusercontent.com` | GitHub 릴리스 자산 다운로드 | 해당 Windows·macOS 다운로드에 필요 | GitHub에서 이 호스트로 다운로드를 리다이렉트할 수 있음 |
| `https://s3.*` | WebFTP 업로드/다운로드 | 선택 | WebFTP 기능을 사용하지 않으면 선택사항 |

위 도메인을 허용하지 않으면 Alpacon의 전체 기능을 사용할 수 없습니다. 워크스페이스와 설치 경로에 필요한 목적지만 허용하세요. 제3자 다운로드 도메인은 조직의 네트워크 정책에 맞춰 검토하세요.

#### 프록시 시스템 사용 (선택사항)

Alpamon 2.8.5 이상은 에이전트 서비스의 `HTTPS_PROXY` 또는 `HTTP_PROXY` 변수에 설정한 프록시를 거쳐 연결하고, `NO_PROXY`에 적은 호스트에는 직접 연결합니다. 셸에서 `export`로 설정한 변수는 에이전트에 적용되지 않습니다. 에이전트 서비스에 변수를 설정하는 방법은 [프록시 지원](/learn/security/network/#프록시-지원)을 참고하세요.

### 클라이언트 시스템

Alpacon 클라이언트(웹/CLI)는 아웃바운드 HTTPS/WSS 연결을 사용합니다. 화이트리스트 기반 방화벽이나 프록시를 사용하는 경우, 다음 대상으로의 아웃바운드 연결을 허용해야 합니다.

| 도메인 | 용도 | 필수 여부 | 비고 |
|--------|------|----------|------|
| `https://alpacon.io` | 핵심 기능 | 필수 | |
| `https://<workspace>.<region>.alpacon.io` | 핵심 기능 | 필수 | 워크스페이스 이름과 리전은 설정에 따라 다름 |
| `https://auth.alpacon.io` | 인증 | 필수 | |
| `https://portal.alpacax.com` | 프로필 | 필수 | |
| `https://pay.alpacax.com` | 결제 | 선택 | 결제 관리자만 필요 |
| `https://s3.*` | WebFTP 업로드/다운로드 | 선택 | WebFTP 기능을 사용하지 않으면 선택사항 |

## 보안 고려사항

### SSH에서 Alpacon으로 전환

Alpacon으로 서버에 접속할 때는 사용자의 신원과 작업 범위에 따라 접근을 결정합니다.

#### 권장 조치

1. **SSH 포트 차단**
   - 사용자의 22번 포트 접근 차단
   - 오직 비상용 접근만 유지
   - 방화벽 설정 간소화

2. **직접 SSH 접근 제한**
   ```bash
   # /etc/ssh/sshd_config 설정 예시
   PermitRootLogin no
   PasswordAuthentication no
   PubkeyAuthentication no  # Alpacon 전용 시스템의 경우
   AllowUsers emergency-admin  # 비상용 계정만 허용
   ```

3. **VPN 의존도 제거**
   - VPN을 통한 내부망 접근 후 무제한 서버 접근은 보안 위협
   - 복잡한 VPN이나 jump host는 가시성 저하
   - Alpacon 단일 플랫폼으로 접근 간소화

### 보안 모범 사례

#### 1. 최소 권한 원칙

- 사용자별 필요한 서버만 접근 허용
- 그룹 기반 권한 관리 활용
- 정기적인 권한 검토

#### 2. 감사 로깅

모든 워크스페이스는 감사 이벤트를 자동으로 기록합니다.

1. **Audit** → **Events**에서 활동 검토 (Websh, sudo, 명령, 파일)
2. 권한이 필요한 작업에 대한 알림을 워크스페이스 **설정**에서 설정

#### 3. MFA 필수화

[Policies > Authentication](/use/workspace/settings/#인증)에서 MFA 정책을 구성합니다(Superuser 전용).

1. **Policies** → **Authentication**으로 이동
2. 모든 사용자에 대해 **추가 인증 필수** 활성화
3. 허용된 MFA 수단 선택 (하드웨어 보안 키, 생체 인증, 일회용 비밀번호). 생체 인증이나 하드웨어 보안 키를 허용하면 패스키 로그인도 MFA로 인정됨([자세히 보기](/use/workspace/settings/#패스키와-허용된-mfa-수단))
4. 인증이 유효한 시간을 정하는 **추가 인증 유지 시간** 설정

<span id="고가용성-구성" />

## 리전과 서비스 장애

<span id="리전별-구성" />

### 리전 선택

워크스페이스를 만들 때 호스팅 리전을 선택합니다. 나중에 변경할 수 없으므로 팀과 서버가 있는 곳을 고려하세요.

| 리전 | 엔드포인트 | 주요 대상 지역 |
| --- | --- | --- |
| US1 | `*.us1.alpacon.io` | 미주와 유럽 |
| AP1 | `*.ap1.alpacon.io` | 아시아 태평양 |

<span id="가용성-구성" />
<span id="재해-복구" />

### 서비스 장애가 발생하면

Alpacon을 사용할 수 없어도 서버 자체는 계속 실행됩니다. 서비스가 복구되면 에이전트가 다시 연결합니다. 기존 세션은 접근 시간이 남아 있는 동안 다시 연결될 수 있으며, Alpacon의 판단이 필요한 새 작업은 복구를 기다립니다. 현재 상태와 과거 장애는 [서비스 상태](https://status.alpacax.com)에서 확인하세요. 운영에 필요한 비상 접속 경로는 별도로 유지하세요.

## 컴플라이언스

### 규정 준수 준비 상황

Alpacon은 업계 표준 프레임워크 및 모범 사례를 따릅니다:

- **SOC 2 프레임워크**: 감사 준비가 진행 중이며 현재 내부 감사 단계입니다
- **ISO 27001 정렬**: ISO 27001 표준에 부합하는 보안 제어
- **GDPR 준수**: GDPR 요구사항을 지원하도록 설계된 데이터 처리 관행 (EU 고객)
- **HIPAA 준비**: 의료 산업 요구사항을 고려하여 설계된 인프라

### 데이터 소재지

- 워크스페이스 데이터와 핵심 서비스 기록은 주로 선택한 리전에 저장
- Alpacon AI 처리는 대한민국에서 이루어질 수 있음
- Alpacon Enterprise에서 고객 관리 클라우드 및 데이터센터 내 배포 지원
- 처리 위치와 배포 옵션에 대한 자세한 내용은 [데이터 보안](/learn/security/data-security/) 참고

## 문제 해결

### 연결 문제

| 증상 | 원인 | 해결 방법 |
|------|------|----------|
| 에이전트 오프라인 | 방화벽 차단 | 아웃바운드 HTTPS/WSS 허용 |
| 간헐적 연결 끊김 | 프록시 타임아웃 | 프록시 keepalive 설정 조정 |
| 느린 응답 | 리전 거리 | 리전은 생성 시 정해져 바꿀 수 없음. [support@alpacax.com](mailto:support@alpacax.com) 으로 문의 |

### 로그 확인

```bash
# 에이전트 로그
sudo systemctl status alpamon
sudo journalctl -u alpamon -n 50
```

## 마이그레이션 체크리스트

SSH에서 Alpacon으로 전환 시 체크리스트:

- [ ] 모든 서버에 Alpacon 에이전트 설치
- [ ] 사용자를 Alpacon 워크스페이스에 초대
- [ ] 그룹 및 권한 설정
- [ ] MFA 정책 구성
- [ ] 방화벽 규칙 업데이트
- [ ] SSH 포트 22 차단 (비상용 제외)
- [ ] 감사 로깅 설정
- [ ] 백업 및 복구 절차 수립
- [ ] 팀 교육 실시

## 관련 문서

- [Alpacon 작동 방식](/learn/how-it-works/)
- [제로 트러스트](/learn/key-concepts/zero-trust/)
- [보안 설정](/learn/best-practices/security/)
- [모니터링 전략](/learn/best-practices/monitoring/)

Source: https://docs.alpacax.com/ko/use/servers/configure-network/