pivpn.io

PiVPN是什么网站?

PiVPN 是一个帮助用户在 Raspberry Pi 或 Debian/Ubuntu 服务器上快速搭建和管理 VPN 的开源项目网站，核心卖点是“低门槛安装、开箱即用、默认安全配置”。

它解决什么问题

传统手动配置 OpenVPN 或 WireGuard 涉及证书、加密参数、端口和路由规则，容易出错。PiVPN 把这些步骤包装成一个安装脚本和一套管理命令，让不熟悉 VPN 底层细节的人也能在几分钟内跑起来。

典型使用场景

• 家里有一台树莓派，想把它变成个人 VPN 服务器，在外出时安全访问家庭网络。
• 有一台便宜的 Debian/Ubuntu 云服务器，想自建 VPN 而不依赖商业 VPN 服务。
• 想给家人或小团队分发 VPN 客户端配置，并能随时撤销某个客户端。

主要功能

• 一键安装：页面给出的命令是 curl -L https://install.pivpn.io | bash，安装后可能需要在家用路由器上开放对应端口。
• 可定制：安装过程允许自定义 VPN 端口、密钥加密强度、客户端 DNS 等。
• 命令行管理：安装完成后提供 pivpn 命令，可添加客户端、撤销客户端、列出已有配置，还能用 pivpn uninstall 完整卸载。
• 默认安全加固：支持自动安全更新，使用较新的 TLS 协议，数据和控制通道采用 AES 与 SHA256，并预配置服务器证书验证以降低中间人攻击风险。

适用条件

PiVPN 官方定位是给 Raspberry Pi 用的，但页面明确说明安装器同样能在 Ubuntu 或 Debian 服务器上运行。如果你用的是其他 Linux 发行版，或想要图形化管理界面，它就不是最直接的选择。

在树莓派上安装PiVPN需要提前准备什么系统环境?

在树莓派上安装 PiVPN，官方建议先装好 Raspberry Pi OS Lite，并尽量使用最新镜像；普通版 Raspberry Pi OS 也能用。

需要提前准备的环境

• 系统：Raspberry Pi OS Lite（首选），或普通 Raspberry Pi OS；Ubuntu、Debian 服务器同样可运行安装器。
• 访问方式：最好提前启用 SSH，方便无显示器操作。
• 网络：安装后可能需要在路由器上开放对应端口。
• 安装命令：curl -L https://install.pivpn.io | bash

安装时能配置什么

PiVPN 安装器不是一键黑盒，它会让你自定义 VPN 端口、密钥加密强度、客户端 DNS 服务器等。装完后服务器上会多出一个 pivpn 命令，用来添加客户端配置、吊销客户端、列出已有客户端，也可以用 pivpn uninstall 完整卸载。

适合谁

适合想在树莓派上低成本搭 VPN、又不想手动折腾 OpenVPN 配置的人；也适合已有 Ubuntu/Debian 服务器、想快速得到一套加固过的基础配置的用户。官方强调默认安全设置已高于普通默认值，包括自动安全更新、仅用最新 TLS、AES 与 SHA256、证书校验等。

下一步

先在树莓派上刷好 Raspberry Pi OS Lite，启用 SSH，再执行上面的安装命令；安装过程中按提示选端口、加密强度和 DNS，最后检查路由器是否需要放行端口。

PiVPN安装完成后如何用pivpn命令添加或撤销客户端?

安装完成后，直接在服务器终端运行 pivpn，会进入一个文字菜单，添加和撤销客户端都在里面完成。

添加客户端

在菜单里选择添加客户端的选项（通常标为 Add 或类似字样），按提示设置客户端名称即可。完成后会生成对应的客户端配置文件（.ovpn 或 WireGuard 配置），需要把它传到手机或电脑上导入 VPN 客户端使用。

撤销客户端

在同一个菜单里选择撤销/删除客户端的选项（通常标为 Revoke 或 Remove），然后从已有客户端列表中选择要撤销的那一个。撤销后该客户端的证书或密钥即失效，无法再连接。

其他相关操作

• 运行 pivpn 后还能列出已创建的客户端（List 类选项），方便确认谁还在使用。
• 如果想彻底重来，可以运行 pivpn uninstall，把安装器做过的改动全部清除。资料里特别说明这一点，意味着你可以放心试验，不必担心留下无法回退的配置。

使用情境

适合在树莓派（或 Ubuntu / Debian 服务器）上自建 VPN 的个人或小团队：装好后给每位家人、每台设备各建一个客户端配置，某人设备丢失或不再使用时，用 pivpn 撤销对应客户端即可，不影响其他人。

PiVPN支持自定义哪些VPN配置选项,比如端口和加密强度?

PiVPN 在安装时会让你自定义几类关键配置，主要包括端口、加密强度、客户端 DNS 等。

可自定义的配置项

• VPN 端口：可以自行指定服务器监听的端口，不局限于默认值。
• 密钥加密强度：可以选择密钥的加密强度。
• 客户端 DNS 服务器：可以为客户端指定使用的 DNS。
• 其他选项：资料用“and more”概括，说明安装向导还提供更多可调项，但未逐一列出。

这些选项在什么场景下有用

• 想避开默认端口、减少被扫描或封锁的概率时，改端口。
• 对安全性要求更高，或受客户端设备性能限制时，调整加密强度。
• 想让 VPN 客户端走自建 DNS（如做广告过滤、内网解析）时，设置客户端 DNS。

顺带一提

PiVPN 安装后会在服务器上提供 pivpn 命令，用来添加、吊销、列出客户端配置，还支持 pivpn uninstall 完整卸载，方便反复试验配置。它虽然面向 Raspberry Pi 设计，但同样能运行在 Ubuntu 或 Debian 服务器上。

PiVPN如何配置才能让客户端通过VPN访问外网?

PiVPN 默认的目标是让客户端安全连回你的内网，而不是把所有流量都转发到外网。要让客户端通过 VPN 访问外网，需要在安装和客户端配置两处做调整。

安装时选对模式

在运行安装脚本（curl -L https://install.pivpn.io | bash）时，会问到是否将 VPN 流量转发出去。页面资料提到安装器可自定义端口、密钥强度、客户端 DNS 等，但未逐项列出该提问。按 OpenVPN/WireGuard 的通用做法，遇到类似 “Do you want to use this server as your default gateway / route all traffic through the VPN” 的选项时选是，即开启全局路由转发。

客户端需要走全局路由

• 安装脚本为每台客户端生成配置（pivpn add）。生成的 .ovpn 或 WireGuard 配置默认可能只推送内网网段路由。
• 要让客户端把外网流量也交给 VPN，配置里应包含 redirect-gateway def1（OpenVPN）或 AllowedIPs = 0.0.0.0/0（WireGuard）。PiVPN 的 pivpn 命令可添加、撤销、列出客户端，方便逐台确认。

服务器侧要做的两件事

1. 开启 IP 转发：在 /etc/sysctl.conf 里设 net.ipv4.ip_forward=1 并生效，让服务器能在 VPN 网卡和公网网卡之间转发包。
2. 配置 NAT（masquerade）：用 iptables 或 nftables 把来自 VPN 网段的流量伪装成服务器公网 IP，否则外网无法把回包送回客户端。

别忘了出口和 DNS

• 路由器上需把 VPN 端口映射到 Pi（页面明确提到安装后可能需要开一个端口）。
• 客户端 DNS 可在安装时自定义，全局模式下应指向一个能正常解析外网的 DNS，避免解析走错路径。

验证顺序

先确认服务器本机能上网 → 检查 IP 转发和 NAT 规则 → 在客户端连上后 curl ifconfig.me，看返回的是否为服务器公网 IP。返回服务器 IP 说明外网流量已成功经 VPN 出口。

怎样彻底卸载PiVPN并恢复服务器原有设置?

PiVPN 自带卸载命令，能撤销安装时做的改动；但安装前就存在的系统或网络配置，需要你手动确认恢复。

用官方命令卸载

在服务器上直接运行：

pivpn uninstall

PiVPN 页面说明，这个命令会移除安装器所做的全部内容，因此可以放心用它清理，不必担心留下不可逆的改动。

卸载后需要手动检查的部分

pivpn uninstall 处理的是 PiVPN 自己写入的配置。以下项目通常要你自己核对：

• 路由器端口转发：安装时可能为 VPN 开放了端口，卸载后应删除对应规则。
• 系统防火墙规则：如果安装过程中放行了 VPN 端口，检查并关闭。
• 自动更新设置：安装时可选启用 unattended-upgrades，若不再需要可自行调整。
• IP 转发等系统参数：确认 /etc/sysctl.conf 等位置没有残留的转发设置。

想恢复到“安装前状态”的做法

PiVPN 的定位是低成本的 Raspberry Pi VPN 方案，安装脚本会改动网络和加密相关配置。若要求完全还原，最稳妥的方式是：

1. 先运行 pivpn uninstall。
2. 逐项检查上面列出的网络与系统设置。
3. 如果服务器是专用或实验用途，直接重装 Raspberry Pi OS Lite 或 Debian/Ubuntu 系统，比逐条回滚更干净。

什么时候适合用它

• 在树莓派或 Debian/Ubuntu 服务器上快速搭 OpenVPN，之后想干净移除。
• 想先试用再决定是否长期保留，卸载命令降低了试错成本。
• 需要保留服务器其他服务，只想撤掉 VPN 部分。

如果只是换用其他 VPN 方案，也可以参考 OpenVPN 或 WireGuard 的官方部署方式，先卸载 PiVPN 再安装，避免端口和配置冲突。