## OpenVPN을 사용하는 이유?

이 스크립트가 생성될 당시 OpenVPN은 오픈소스 VPN의 사실상 표준이었습니다. WireGuard는 나중에 나왔으며 대부분의 사용 사례에서 더 간단하고 빠릅니다. [wireguard-install](https://github.com/angristan/wireguard-install)을 확인하세요.

그러나 OpenVPN은 다음과 같은 경우에 여전히 유효합니다:

- **TCP 지원**: UDP가 차단된 제한적인 환경(회사 네트워크, 공항, 호텔 등)에서 작동
- **비밀번호로 보호된 개인 키**: WireGuard 구성은 개인 키를 평문으로 저장
- **레거시 호환성**: 구형 시스템을 포함한 거의 모든 플랫폼에 클라이언트 존재

## Features

- 사용 가능한 OpenVPN 서버를 설치하고 구성합니다
- 자동화 및 스크립팅을 위한 CLI 인터페이스 (JSON 출력을 지원하는 비대화형 모드)
- 클라이언트 및 서버 인증서 갱신
- 연결된 클라이언트 목록 및 모니터링
- 인증서 폐기 시 즉시 클라이언트 연결 해제 (관리 인터페이스를 통해)
- 가능하면 최신 안정 릴리스를 위해 [공식 OpenVPN 저장소](https://community.openvpn.net/openvpn/wiki/OpenvpnSoftwareRepos) 사용
- 방화벽 규칙 및 포워딩을 원활하게 관리 (네이티브 firewalld 및 nftables 지원, iptables 폴백)
- VPN 서브넷 구성 가능 (IPv4: 기본 `10.8.0.0/24`, IPv6: 기본 `fd42:42:42:42::/112`)
- 터널 MTU 구성 가능 (기본값: `1500`)
- 필요한 경우 스크립트가 구성 및 방화벽 규칙을 포함한 OpenVPN을 깔끔하게 제거
- 암호화 설정 사용자 정의 가능, 향상된 기본 설정 (아래 [보안 및 암호화](#security-and-encryption) 참조)
- 가능한 경우 최신 OpenVPN 기능 사용 (아래 [보안 및 암호화](#security-and-encryption) 참조)
- 클라이언트에 푸시할 다양한 DNS 리졸버
- Unbound를 사용한 자체 호스팅 리졸버 선택 가능 (기존 Unbound 설치 지원)
- TCP와 UDP 중 선택
- 유연한 IPv4/IPv6 지원:
  - IPv4 또는 IPv6 서버 엔드포인트 (클라이언트 연결 방식)
  - IPv4 전용, IPv6 전용 또는 듀얼 스택 클라이언트 (VPN 주소 지정 및 인터넷 액세스)
  - 모든 조합 지원: 4→4, 4→4/6, 4→6, 6→4, 6→6, 6→4/6
  - 자동 누출 방지: 단일 스택 모드에서 원하지 않는 프로토콜 차단
- 권한 없는 모드: `nobody`/`nogroup`으로 실행
- Windows 10에서 DNS 누출 차단
- 무작위 서버 인증서 이름
- 비밀번호로 클라이언트 보호 선택 가능 (개인 키 암호화)
- 여러 장치가 동시에 동일한 클라이언트 프로필을 사용할 수 있는 옵션 (고정 IP 주소 비활성화)
- **피어 지문 인증** (OpenVPN 2.6+): CA 없이 간소화된 WireGuard 스타일 인증
- 기타 여러 작은 기능들!

## Compatibility

이 스크립트는 다음 Linux 배포판을 지원합니다:

|                     | 지원 |
| ------------------- | ------- |
| AlmaLinux >= 8      | ✅ 🤖   |
| Amazon Linux 2023   | ✅ 🤖   |
| Arch Linux          | ✅ 🤖   |
| CentOS Stream >= 8  | ✅ 🤖   |
| Debian >= 11        | ✅ 🤖   |
| Fedora >= 40        | ✅ 🤖   |
| openSUSE Leap >= 16 | ✅ 🤖   |
| openSUSE Tumbleweed | ✅ 🤖   |
| Oracle Linux >= 8   | ✅ 🤖   |
| Rocky Linux >= 8    | ✅ 🤖   |
| Ubuntu >= 18.04     | ✅ 🤖   |

참고 사항:

- 스크립트는 🤖로 표시된 배포판에서만 정기적으로 테스트됩니다.
  - `amd64` 아키텍처에서만 테스트되었습니다.
- 스크립트는 `systemd`를 필요로 합니다.

### Recommended providers

- [Vultr](https://umami.stanislas.cloud/q/1HH9Thp8i): 전 세계 위치, IPv6 지원, 월 \$2.5부터
- [Hetzner](https://umami.stanislas.cloud/q/HdzaOJWq7): 전 세계 위치, IPv6, 20TB 트래픽, 월 €3.59부터
- [Digital Ocean](https://umami.stanislas.cloud/q/sEVh1l79B): 전 세계 위치, IPv6 지원, 월 \$4부터

## Usage

먼저 서버에서 스크립트를 다운로드하고 실행 가능하게 만드세요:```bash
curl -O https://raw.githubusercontent.com/angristan/openvpn-install/master/openvpn-install.sh
chmod +x openvpn-install.sh

이 가이드는 설치 및 클라이언트 관리를 안내합니다.

홈 디렉토리에는 `.ovpn` 파일이 있습니다. 이 파일들은 클라이언트 구성 파일입니다. 서버에서 (예: `scp`를 사용하여) 다운로드한 후 선호하는 OpenVPN 클라이언트를 사용하여 연결하세요.

질문이 있으시면 먼저 [FAQ](#faq)를 확인하세요. 도움이 필요하면 [토론](https://github.com/angristan/openvpn-install/discussions)을 열 수 있습니다. 기존 이슈 및 토론을 먼저 검색해 주세요.

### CLI 모드

> [!WARNING]
> API 호환성은 보장되지 않습니다. 버전 간에 호환되지 않는 변경이 발생할 수 있습니다. 이 스크립트를 프로그래밍 방식(예: 자동화 또는 CI/CD)으로 사용하는 경우 master 브랜치 대신 특정 커밋에 고정하세요.

자동화 및 스크립팅을 위해 CLI 인터페이스를 사용하세요:```bash
# Install with defaults
./openvpn-install.sh install

# Add a client
./openvpn-install.sh client add alice

# List clients
./openvpn-install.sh client list

# Revoke a client (immediately disconnects if connected)
./openvpn-install.sh client revoke alice

Run `./openvpn-install.sh <command> --help`를 실행하여 명령별 옵션을 확인하세요.

#### 클라이언트 관리```bash
# Add a new client
./openvpn-install.sh client add alice

# Add a password-protected client
./openvpn-install.sh client add bob --password

# Revoke a client
./openvpn-install.sh client revoke alice

# Renew a client certificate
./openvpn-install.sh client renew bob --cert-days 365

스크립팅을 위한 JSON 출력:```text
$ ./openvpn-install.sh client list --format json | jq
{
  "clients": [
    {
      "name": "alice",
      "status": "valid",
      "expiry": "2035-01-15",
      "days_remaining": 3650
    },
    {
      "name": "bob",
      "status": "valid",
      "expiry": "2035-01-15",
      "days_remaining": 3650
    },
    {
      "name": "charlie",
      "status": "revoked",
      "expiry": "2035-01-15",
      "days_remaining": null
    }
  ]
}

연결된 클라이언트 표시 (데이터는 60초마다 새로고침됩니다):```text
$ ./openvpn-install.sh server status
══ Connected Clients ══
[INFO] Found 2 connected client(s)

   Name    Real Address          VPN IP      Connected Since   Transfer
   ----    ------------          ------      ---------------   --------
   alice   203.0.113.45:52341    10.8.0.2    2025-01-15 14:32  ↓1.2M ↑500K
   bob     198.51.100.22:41892   10.8.0.3    2025-01-15 09:15  ↓800K ↑200K

[INFO] Note: Data refreshes every 60 seconds.

**네트워크 옵션:**

- `--endpoint <host>` - 클라이언트용 공개 IP 또는 호스트명 (기본값: 자동 감지)
- `--endpoint-type <4|6>` - 엔드포인트 IP 버전 (기본값: `4`)
- `--ip <addr>` - 서버 수신 IP (기본값: 자동 감지)
- `--client-ipv4` - VPN 클라이언트에 IPv4 활성화 (기본값: 활성화)
- `--no-client-ipv4` - VPN 클라이언트에 IPv4 비활성화
- `--client-ipv6` - VPN 클라이언트에 IPv6 활성화 (기본값: 비활성화)
- `--no-client-ipv6` - VPN 클라이언트에 IPv6 비활성화
- `--subnet-ipv4 <x.x.x.0>` - IPv4 VPN 서브넷 (기본값: `10.8.0.0`)
- `--subnet-ipv6 <prefix>` - IPv6 VPN 서브넷 (기본값: `fd42:42:42:42::`)
- `--port <num>` - OpenVPN 포트 (기본값: `1194`)
- `--port-random` - 무작위 포트 사용 (49152-65535)
- `--protocol <udp|tcp>` - 프로토콜 (기본값: `udp`)
- `--mtu <size>` - 터널 MTU (기본값: `1500`)

**DNS 옵션:**

- `--dns <provider>` - DNS 제공자 (기본값: `cloudflare`). 옵션: `system`, `unbound`, `cloudflare`, `quad9`, `quad9-uncensored`, `fdn`, `dnswatch`, `opendns`, `google`, `yandex`, `adguard`, `nextdns`, `custom`
- `--dns-primary <ip>` - 사용자 지정 기본 DNS (`--dns custom` 필요)
- `--dns-secondary <ip>` - 사용자 지정 보조 DNS (`--dns custom` 필요)

**보안 옵션:**

- `--cipher <cipher>` - 데이터 암호 (기본값: `AES-128-GCM`). 옵션: `AES-128-GCM`, `AES-192-GCM`, `AES-256-GCM`, `AES-128-CBC`, `AES-192-CBC`, `AES-256-CBC`, `CHACHA20-POLY1305`
- `--cert-type <ecdsa|rsa>` - 인증서 유형 (기본값: `ecdsa`)
- `--cert-curve <curve>` - ECDSA 곡선 (기본값: `prime256v1`). 옵션: `prime256v1`, `secp384r1`, `secp521r1`
- `--rsa-bits <2048|3072|4096>` - RSA 키 크기 (기본값: `2048`)
- `--hmac <alg>` - HMAC 알고리즘 (기본값: `SHA256`). 옵션: `SHA256`, `SHA384`, `SHA512`
- `--tls-sig <mode>` - TLS 모드 (기본값: `crypt-v2`). 옵션: `crypt-v2`, `crypt`, `auth`
- `--auth-mode <mode>` - 인증 모드 (기본값: `pki`). 옵션: `pki` (CA 기반), `fingerprint` (피어 지문, OpenVPN 2.6+ 필요)
- `--tls-version-min <1.2|1.3>` - 최소 TLS 버전 (기본값: `1.2`)
- `--tls-ciphersuites <list>` - TLS 1.3 암호 제품군, 콜론으로 구분 (기본값: `TLS_AES_256_GCM_SHA384:TLS_AES_128_GCM_SHA256:TLS_CHACHA20_POLY1305_SHA256`)
- `--tls-groups <list>` - 키 교환 그룹, 콜론으로 구분 (기본값: `X25519:prime256v1:secp384r1:secp521r1`)
- `--server-cert-days <n>` - 서버 인증서 유효 기간 (일) (기본값: `3650`)

**클라이언트 옵션:**

- `--client <name>` - 초기 클라이언트 이름 (기본값: `client`)
- `--client-password [pass]` - 클라이언트 키를 암호로 보호 (기본값: 암호 없음)
- `--client-cert-days <n>` - 클라이언트 인증서 유효 기간 (일) (기본값: `3650`)
- `--no-client` - 초기 클라이언트 생성 건너뛰기

**기타 옵션:**

- `--multi-client` - 동일 인증서를 여러 장치에서 허용 (기본값: 비활성화)

#### 자동화 예시

**일괄 클라이언트 생성:**```bash
#!/bin/bash
for user in alice bob charlie; do
  ./openvpn-install.sh client add "$user"
done

**스크립팅을 위한 JSON 출력:**```bash
# Get client list as JSON
./openvpn-install.sh client list --format json | jq '.clients[] | select(.status == "valid")'

# Get connected clients as JSON
./openvpn-install.sh server status --format json

장점:

- 간편한 설정: CA 인프라가 필요 없음
- 이해하기 쉬움: SSH의 `known_hosts` 모델과 유사
- 소규모 설정에 이상적: 홈 네트워크, 연구실, 소규모 팀

작동 방식:

1. 서버가 자체 서명 인증서를 생성하고 지문을 저장
2. 각 클라이언트가 자체 서명 인증서 생성
3. 클라이언트 지문이 서버의 `<peer-fingerprint>` 블록에 추가됨
4. 클라이언트가 서버 지문을 사용하여 서버 확인
5. 해지 시 서버 구성에서 지문 제거 (CRL 불필요)

트레이드오프: 클라이언트 해지 시 OpenVPN을 다시 로드해야 함 (지문이 server.conf에 있음). PKI 모드에서는 새 연결 시 CRL 파일이 자동으로 다시 읽힘.

### 데이터 채널

> [!NOTE]
> 기본 데이터 채널 암호는 OpenVPN 2.5에서 변경되었습니다. 이전 버전은 `BF-CBC`가 기본값이었으나, OpenVPN 2.5 이상에서는 `AES-256-GCM:AES-128-GCM`이 기본값입니다. OpenVPN 2.6 이상에서는 가능한 경우 `CHACHA20-POLY1305`도 기본 암호 목록에 포함됩니다.

기본적으로 OpenVPN 2.4 이하에서는 데이터 채널 암호로 `BF-CBC`를 사용했습니다. Blowfish는 오래된(1993) 취약한 알고리즘입니다. 공식 OpenVPN 문서도 이를 인정합니다.

> 기본값은 BF-CBC로, Cipher Block Chaining 모드의 Blowfish를 의미합니다.
>
> BF-CBC는 64비트 블록 크기 때문에 더 이상 권장되지 않습니다. 이 작은 블록 크기는 SWEET32에서 입증된 것처럼 충돌 기반 공격을 가능하게 합니다. 자세한 내용은 <https://community.openvpn.net/openvpn/wiki/SWEET32>를 참조하세요.
> INRIA의 보안 연구자들은 3DES 및 Blowfish와 같은 64비트 블록 암호에 대한 공격을 발표했습니다. 동일한 데이터가 충분히 자주 전송될 때 평문을 복구할 수 있으며, 크로스 사이트 스크립팅 취약점을 활용하여 관심 있는 데이터를 충분히 자주 전송할 수 있음을 보여주었습니다. 이는 HTTPS뿐만 아니라 HTTP-over-OpenVPN에서도 작동합니다. 더 자세한 설명은 <https://sweet32.info/>를 참조하세요.
>
> OpenVPN의 기본 암호인 BF-CBC는 이 공격의 영향을 받습니다.

실제로 AES는 오늘날의 표준입니다. 현재 사용 가능한 가장 빠르고 안전한 암호입니다. [SEED](https://en.wikipedia.org/wiki/SEED)와 [Camellia](https://github.com/angristan/openvpn-install/blob/master/%3Chttps%3A/en.wikipedia.org/wiki/Camellia_%28cipher)>)는 현재까지 취약점이 발견되지 않았지만 AES보다 느리고 상대적으로 신뢰도가 낮습니다.

> 현재 지원되는 암호 중 OpenVPN은 AES-256-CBC 또는 AES-128-CBC 사용을 권장합니다. OpenVPN 2.4 이상에서는 GCM도 지원합니다. 2.4 이상에서는 AES-256-GCM 또는 AES-128-GCM 사용을 권장합니다.

AES-256은 AES-128보다 40% 느리며, AES에서 128비트 키 대신 256비트 키를 사용해야 할 실질적인 이유는 없습니다. (출처: [1](http://security.stackexchange.com/questions/14068/why-most-people-use-256-bit-encryption-instead-of-128-bit), [2](http://security.stackexchange.com/questions/6141/amount-of-simple-operations-that-is-safely-out-of-reach-for-all-humanity/6149#6149)). 또한 AES-256은 [타이밍 공격](https://en.wikipedia.org/wiki/Timing_attack)에 더 취약합니다.

AES-GCM은 [AEAD 암호](https://en.wikipedia.org/wiki/Authenticated_encryption)로, 데이터에 대해 기밀성, 무결성, 인증을 동시에 제공합니다.

ChaCha20-Poly1305는 AES-GCM과 유사한 보안을 제공하는 또 다른 AEAD 암호입니다. 하드웨어 AES 가속(AES-NI)이 없는 장치(예: 구형 CPU 및 많은 ARM 기반 장치)에서 특히 유용하며, AES보다 훨씬 빠를 수 있습니다.

스크립트는 다음 암호를 지원합니다:

- `AES-128-GCM`
- `AES-192-GCM`
- `AES-256-GCM`
- `AES-128-CBC`
- `AES-192-CBC`
- `AES-256-CBC`
- `CHACHA20-POLY1305` (OpenVPN 2.5+ 필요)

그리고 기본값은 `AES-128-GCM`입니다.

OpenVPN 2.4는 "NCP"(_Negotiable Crypto Parameters_)라는 기능을 추가했습니다. 즉, HTTPS처럼 암호 스위트를 제공할 수 있습니다. 기본적으로 `AES-256-GCM:AES-128-GCM`으로 설정되며, OpenVPN 2.4 클라이언트와 함께 사용하면 `--cipher` 매개변수를 재정의합니다. 단순화를 위해 스크립트는 위에서 선택한 암호로 `--cipher`(NCP가 아닌 클라이언트용 대체), `--data-ciphers`(최신 OpenVPN 2.5+ 명명법), `--ncp-ciphers`(OpenVPN 2.4 호환성을 위한 레거시 별칭)를 설정합니다.

### 제어 채널

OpenVPN 2.4는 기본적으로 최상의 암호를 협상합니다(예: ECDHE+AES-256-GCM).

#### TLS 1.2 암호 (`--tls-cipher`)

스크립트는 인증서에 따라 다음 옵션을 제안합니다:

- ECDSA:
  - `TLS-ECDHE-ECDSA-WITH-AES-128-GCM-SHA256`
  - `TLS-ECDHE-ECDSA-WITH-AES-256-GCM-SHA384`
  - `TLS-ECDHE-ECDSA-WITH-CHACHA20-POLY1305-SHA256` (OpenVPN 2.5+ 필요)
- RSA:
  - `TLS-ECDHE-RSA-WITH-AES-128-GCM-SHA256`
  - `TLS-ECDHE-RSA-WITH-AES-256-GCM-SHA384`
  - `TLS-ECDHE-RSA-WITH-CHACHA20-POLY1305-SHA256` (OpenVPN 2.5+ 필요)

기본값은 `TLS-ECDHE-*-WITH-AES-128-GCM-SHA256`입니다.

#### TLS 1.3 암호 (`--tls-ciphersuites`)

TLS 1.3이 협상되면 별도의 암호 스위트 세트가 사용됩니다. 이는 `--tls-ciphersuites`를 통해 구성되며 OpenSSL 명명 규칙을 사용합니다:

- `TLS_AES_256_GCM_SHA384`
- `TLS_AES_128_GCM_SHA256`
- `TLS_CHACHA20_POLY1305_SHA256`

기본적으로 세 암호 스위트 모두 활성화됩니다. TLS 1.3 암호 스위트는 키 교환 알고리즘(키 공유를 통해 별도로 협상됨)을 포함하지 않기 때문에 더 간단합니다.

### 키 교환

OpenVPN은 역사적으로 키 교환을 위해 2048비트 DH 매개변수를 기본으로 사용했습니다. 이 스크립트는 예전에 DH(구성 가능한 키 크기 포함)와 ECDH를 대안으로 제공했습니다.

OpenVPN 2.4는 ECDH 지원을 추가했으며, OpenVPN 2.7은 유한체 DH가 더 이상 사용되지 않음에 따라 `dh none`(ECDH)을 기본값으로 만들었습니다. ECDH가 이제 보편적으로 지원되고 선호되므로, 이 스크립트는 더 이상 기존 DH를 제공하지 않습니다.

스크립트는 `tls-groups`를 다음 선호 목록으로 구성합니다:```
X25519:prime256v1:secp384r1:secp521r1