## 为什么选择OpenVPN？

在本脚本创建时，OpenVPN 是开源 VPN 的事实标准。WireGuard 后来出现，在大多数用例中更简单、更快。请查看 [wireguard-install](https://github.com/angristan/wireguard-install)。

话虽如此，当您需要以下功能时，OpenVPN 仍然值得考虑：

- **TCP 支持**：在 UDP 被封锁的限制性环境（企业网络、机场、酒店等）中也能工作
- **密码保护的私钥**：WireGuard 配置以明文存储私钥
- **传统兼容性**：几乎每个平台（包括较老系统）都有客户端

## 功能特点

- 安装并配置一个可立即使用的 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 认证
- 还有许多其他小功能！

## 兼容性

该脚本支持以下 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`。

### 推荐的 VPS 提供商

- [Vultr](https://umami.stanislas.cloud/q/1HH9Thp8i)：全球多地机房，支持 IPv6，每月 2.5 美元起
- [Hetzner](https://umami.stanislas.cloud/q/HdzaOJWq7)：全球多地机房，支持 IPv6，20 TB 流量，每月 3.59 欧元起
- [Digital Ocean](https://umami.stanislas.cloud/q/sEVh1l79B)：全球多地机房，支持 IPv6，每月 4 美元起

## 使用方式

首先，在您的服务器上下载脚本并使其可执行：```bash
curl -O https://raw.githubusercontent.com/angristan/openvpn-install/master/openvpn-install.sh
chmod +x openvpn-install.sh

本指南将带你完成安装和客户端管理。

在你的主目录下，你将看到 `.ovpn` 文件。这些是客户端配置文件。从服务器下载它们（例如使用 `scp`），然后使用你喜欢的 OpenVPN 客户端连接。

如有任何疑问，请先查阅[常见问题](#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

运行 `./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

Benefits:

- 简化设置：无需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的安全研究人员公布了一种针对64位块密码（如3DES和Blowfish）的攻击。他们表明，当相同数据被频繁发送时，能够恢复明文，并展示了如何利用跨站点脚本漏洞来足够频繁地发送感兴趣的数据。这适用于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/HEAD/%3Chttps:/en.wikipedia.org/wiki/Camellia_(cipher)>)目前不易受攻击，但比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%，并且使用256位密钥而不是128位密钥并无实际理由（来源：[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是另一种AEAD密码，提供与AES-GCM类似的安全性。它在没有硬件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 none`（ECDH）设为默认值，因为有限域DH正在被弃用。由于ECDH现已普遍支持且更受青睐，此脚本不再提供传统DH。

脚本配置`tls-groups`时使用以下偏好列表：```
X25519:prime256v1:secp384r1:secp521r1