System Vault

Appearance

OpenVPN 3 Linux 安装与连接指南（Debian / Ubuntu） ​

适用系统：

  • Debian 12 / 13
  • Ubuntu 22.04 / 24.04
  • 其他兼容 apt 的 Debian 系发行版

https://community.openvpn.net/Pages/OpenVPN3Linux#stable-repository-debian-ubuntu

一、安装前说明 ​

本文说明如何在 Debian / Ubuntu 上安装 OpenVPN 3 Linux，并通过导入 .ovpn 配置文件建立 VPN 连接。

OpenVPN 3 Linux 与传统的 openvpn 不同，它使用独立的客户端和会话管理命令，适合日常连接、查看状态和管理会话。

如果你已经拿到了 VPN 提供方提供的 .ovpn 配置文件，可以直接按照本文操作。

二、安装依赖工具 ​

先安装 OpenVPN 官方软件源需要的依赖：

bash
sudo apt update
sudo apt install apt-transport-https curl

三、添加 OpenVPN 官方软件源 ​

1. 创建 keyrings 目录 ​

bash
sudo mkdir -p /etc/apt/keyrings

说明：

  • 某些系统默认没有 /etc/apt/keyrings
  • 先创建目录可以避免后续导入密钥失败

2. 导入 OpenVPN 软件源签名密钥 ​

bash
curl -sSfL https://packages.openvpn.net/packages-repo.gpg | sudo tee /etc/apt/keyrings/openvpn.asc >/dev/null

3. 添加 OpenVPN 3 软件源 ​

请将下面命令中的 <发行版代号> 替换为你系统对应的代号：

bash
echo "deb [signed-by=/etc/apt/keyrings/openvpn.asc] https://packages.openvpn.net/openvpn3/debian <发行版代号> main" | sudo tee /etc/apt/sources.list.d/openvpn3.list

常见发行版代号示例：

  • Debian 12：bookworm
  • Debian 13：trixie
  • Ubuntu 22.04：jammy
  • Ubuntu 24.04：noble

例如 Debian 12：

bash
echo "deb [signed-by=/etc/apt/keyrings/openvpn.asc] https://packages.openvpn.net/openvpn3/debian bookworm main" | sudo tee /etc/apt/sources.list.d/openvpn3.list

四、安装 OpenVPN 3 Linux 客户端 ​

更新软件源并安装客户端：

bash
sudo apt update
sudo apt install openvpn3-client

安装完成后，可以查看版本或帮助信息确认是否安装成功：

bash
openvpn3 version

如果你的系统不支持 version 子命令，也可以直接执行：

bash
openvpn3 --help

五、导入 .ovpn 配置文件 ​

假设你的配置文件路径为 <配置文件路径>，例如：

bash
/home/yourname/vpn/company.ovpn

导入命令：

bash
openvpn3 config-import --config <配置文件路径>

如果你想指定一个更容易记住的配置名，可以使用：

bash
openvpn3 config-import --config <配置文件路径> --name <配置名>

例如：

bash
openvpn3 config-import --config ~/vpn/company.ovpn --name workvpn

查看已导入的配置：

bash
openvpn3 configs-list

六、启动 VPN 连接 ​

如果你在导入时指定了配置名，可以直接启动：

bash
openvpn3 session-start --config <配置名>

例如：

bash
openvpn3 session-start --config workvpn

如果连接过程需要用户名、密码或双因素认证，终端中会提示输入。

连接成功后，系统会创建一个新的 OpenVPN 3 会话。

七、查看和管理 VPN 连接 ​

1. 查看当前活跃会话 ​

bash
openvpn3 sessions-list

输出中会包含：

  • 会话路径（Path）
  • 配置名称
  • 连接状态

其中会话路径通常类似：

bash
/net/openvpn/v3/sessions/xxxxxxxxxxxxxxxxxxxxxxxx

后续查看统计信息、日志和断开连接时都会用到这个路径。

2. 查看连接统计信息 ​

bash
openvpn3 session-stats --path <session-path>

例如：

bash
openvpn3 session-stats --path /net/openvpn/v3/sessions/xxxxxxxxxxxxxxxxxxxxxxxx

3. 查看会话详细信息 ​

bash
openvpn3 session-manage --path <session-path> --show-details

4. 查看实时日志 ​

bash
openvpn3 session-log --path <session-path>

八、验证 VPN 是否已经生效 ​

1. 查看当前公网 IP ​

bash
curl ifconfig.me

如果连接成功，公网 IP 通常会变化为 VPN 出口地址。

2. 查看本机网卡信息 ​

bash
ip addr show

通常会看到新的隧道网卡或地址信息。

3. 查看路由表 ​

bash
ip route show

如果默认路由或特定目标网段已经走 VPN，说明路由已生效。

九、断开 VPN 连接 ​

1. 按会话路径断开 ​

bash
openvpn3 session-manage --path <session-path> --disconnect

2. 按配置名断开 ​

bash
openvpn3 session-manage --config <配置名> --disconnect

例如：

bash
openvpn3 session-manage --config workvpn --disconnect

十、后续连接的常用方式 ​

配置导入后，后续通常不需要再次导入，只需要重新启动会话：

bash
openvpn3 session-start --config <配置名>

例如：

bash
openvpn3 session-start --config workvpn

十一、常用排查与状态检查命令 ​

查看所有配置 ​

bash
openvpn3 configs-list

查看所有会话（包括已断开的） ​

bash
openvpn3 sessions-list --all

查看 OpenVPN 3 服务状态 ​

bash
systemctl status openvpn3-service

查看帮助 ​

bash
openvpn3 --help

十二、常见问题 ​

1. apt update 时提示源不可用 ​

常见原因：

  • 发行版代号填写错误
  • 网络无法访问 OpenVPN 官方源
  • GPG 密钥未正确导入

建议检查：

bash
cat /etc/apt/sources.list.d/openvpn3.list
ls -l /etc/apt/keyrings/openvpn.asc

2. 已安装客户端，但命令找不到 ​

可以检查：

bash
which openvpn3

如果没有输出，说明客户端可能未正确安装。

3. 可以连接，但访问仍然没有走 VPN ​

优先检查：

bash
curl ifconfig.me
ip route show
openvpn3 session-stats --path <session-path>

如果 IP 没有变化，可能是：

  • VPN 服务端没有下发默认路由
  • 仅配置了部分网段走 VPN
  • 本地策略路由或防火墙影响了流量

十三、命令速查 ​

bash
# 导入配置
openvpn3 config-import --config <配置文件路径> --name <配置名>

# 查看配置
openvpn3 configs-list

# 启动连接
openvpn3 session-start --config <配置名>

# 查看会话
openvpn3 sessions-list

# 查看统计
openvpn3 session-stats --path <session-path>

# 查看详细信息
openvpn3 session-manage --path <session-path> --show-details

# 查看日志
openvpn3 session-log --path <session-path>

# 断开连接
openvpn3 session-manage --path <session-path> --disconnect
openvpn3 session-manage --config <配置名> --disconnect

个人脚本 ​

stop_proxy.sh

sudo openvpn3 session-manage --config xxx --disconnect

start_proxy.sh

#!/bin/bash

#sudo openvpn --config abcdef.ovpn

#sudo openvpn3 config-import --config abcdef.ovpn --name xxx --persistent

sudo openvpn3 config-manage --config xxx --allow-compression asym

sudo openvpn3 session-start --config xxx

文档生成时间：2026-03-14

Released under the MIT License.

Copyright © 2024-present DANTE FUNG