[English](README.md) | [简体中文](README-zh.md) | [繁體中文](README-zh-Hant.md) | [Русский](README-ru.md) | [Video en Español](https://www.youtube.com/watch?v=99qtaJU2E2k)
# WireGuard VPN 伺服器一鍵安裝腳本
[](https://github.com/hwdsl2/wireguard-install/actions/workflows/main.yml) [](https://github.com/hwdsl2/wireguard-install/stargazers) [](https://opensource.org/licenses/MIT)
使用 Linux 腳本一鍵快速架設自己的 WireGuard VPN 伺服器。支援 Ubuntu、Debian、AlmaLinux、Rocky Linux、CentOS、Fedora、openSUSE 和 Raspberry Pi OS。
此腳本可讓你在幾分鐘內建立自己的 VPN 伺服器，即使你以前沒有使用過 WireGuard。[WireGuard](https://www.wireguard.com) 是一種快速且現代的 VPN，其設計目標是易於使用和高效能。
**功能特性：**
- 全自動的 WireGuard VPN 伺服器設定，無需使用者輸入
- 支援使用自訂選項進行互動式安裝
- 生成 VPN 設定檔以自動設定 Windows、macOS、iOS 和 Android 裝置
- 為行動裝置設定生成 QR 碼
- 支援管理 WireGuard VPN 使用者
- 最佳化 `sysctl` 設定以提升 VPN 效能
- 為 VPN 客戶端提供雙協定棧 IPv4 和 IPv6 支援
**另提供：**
- Docker VPN：[WireGuard](https://github.com/hwdsl2/docker-wireguard/blob/main/README-zh-Hant.md)、[OpenVPN](https://github.com/hwdsl2/docker-openvpn/blob/main/README-zh-Hant.md)、[IPsec VPN](https://github.com/hwdsl2/docker-ipsec-vpn-server/blob/master/README-zh-Hant.md)、[Headscale](https://github.com/hwdsl2/docker-headscale/blob/main/README-zh-Hant.md)
- AI：[自架 AI 套件](https://github.com/hwdsl2/self-hosted-ai-stack/blob/main/README-zh-Hant.md)，用於本機 LLM、聊天、RAG、語音和 AI 工具
- 書籍：[Privacy Tools in the Age of AI](docs/vpn-book-zh-Hant.md#新privacy-tools-in-the-age-of-ai)、[架設自己的 VPN 伺服器](docs/vpn-book-zh-Hant.md#架設自己的-vpn-伺服器ipsec-vpnopenvpn-與-wireguard-實作指南)
## 安裝說明
首先在你的 Linux 伺服器\* 上下載腳本：
```bash
wget -O wireguard.sh https://get.vpnsetup.net/wg
```
\* 一個雲端伺服器、虛擬專用伺服器 (VPS) 或專用伺服器。
**選項 1：** 使用預設選項自動安裝 WireGuard。
```bash
sudo bash wireguard.sh --auto
```
查看腳本的範例輸出（終端記錄）。
**註：** 此終端記錄僅用於示範目的。
> [!TIP]
> 你可以選擇在同一台伺服器上安裝 [OpenVPN](https://github.com/hwdsl2/openvpn-install/blob/master/README-zh-Hant.md)、[IPsec VPN](https://github.com/hwdsl2/setup-ipsec-vpn/blob/master/README-zh-Hant.md) 和/或 [Headscale](https://github.com/hwdsl2/headscale-install/blob/main/README-zh-Hant.md)。
對於有外部防火牆的伺服器（例如 [EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-security-groups.html)/[GCE](https://cloud.google.com/firewall/docs/firewalls)），請為 VPN 開啟 UDP 連接埠 51820。
**選項 2：** 使用自訂選項進行互動式安裝。
```bash
sudo bash wireguard.sh
```
你可以自訂以下選項：VPN 伺服器的網域名稱、UDP 連接埠、VPN 客戶端的 DNS 伺服器以及第一個客戶端的名稱。
對於有外部防火牆的伺服器，請為 VPN 開啟所選的 UDP 連接埠。
如果無法下載，請點這裡。
你也可以使用 `curl` 下載：
```bash
curl -fL -o wireguard.sh https://get.vpnsetup.net/wg
```
然後依照上面的說明安裝。
或者，你也可以使用以下連結：
```bash
https://github.com/hwdsl2/wireguard-install/raw/master/wireguard-install.sh
https://gitlab.com/hwdsl2/wireguard-install/-/raw/master/wireguard-install.sh
```
如果無法下載，打開 [wireguard-install.sh](wireguard-install.sh)，然後點擊右側的 `Raw` 按鈕。按快捷鍵 `Ctrl/Cmd+A` 全選，`Ctrl/Cmd+C` 複製，然後貼上到你喜歡的編輯器。
進階：使用自訂選項自動安裝。
進階使用者可以使用自訂選項自動安裝 WireGuard，方法是在執行腳本時指定命令列參數。有關更多資訊，請參見下一節，查看 WireGuard 腳本的使用資訊。
或者，你也可以提供一個 Bash "here document" 作為安裝腳本的輸入。此方法也可用於在安裝後提供輸入以管理使用者。
首先，使用自訂選項以互動方式安裝 WireGuard，並記下你對腳本的所有輸入值。
```bash
sudo bash wireguard.sh
```
如需移除 WireGuard，請再次執行腳本並選擇適當的選項。
然後使用你的輸入值建立自訂安裝命令。例如：
```bash
sudo bash wireguard.sh <
查看 WireGuard 腳本的使用資訊。
```
Usage: bash wireguard.sh [options]
Options:
--addclient [client name] add a new client
--dns1 [DNS server IP] primary DNS server for new client (optional, default: Google Public DNS)
--dns2 [DNS server IP] secondary DNS server for new client (optional)
--listclients list the names of existing clients
--removeclient [client name] remove an existing client
--showclientqr [client name] show QR code for an existing client
--uninstall remove WireGuard and delete all configuration
-y, --yes assume "yes" as answer to prompts when removing a client or removing WireGuard
-h, --help show this help message and exit
Install options (optional):
--auto auto install WireGuard using default or custom options
--serveraddr [DNS name or IP] server address, must be a fully qualified domain name (FQDN) or an IPv4 address
--port [number] port for WireGuard (1-65535, default: 51820)
--clientname [client name] name for the first WireGuard client (default: client)
--dns1 [DNS server IP] primary DNS server for first client (default: Google Public DNS)
--dns2 [DNS server IP] secondary DNS server for first client
To customize options, you may also run this script without arguments.
```
## 社群
- 📬 [訂閱專案更新](https://selfhostedstack.beehiiv.com/subscribe?utm_campaign=vpn-zh-hant)（每月 1–2 封郵件）——獲取免費的 VPN 和 AI 部署指南（PDF，英文）
- 💬 加入 [r/selfhostedstack](https://www.reddit.com/r/selfhostedstack/) 社群，參與討論與專案展示
- ⭐ 如果你覺得本專案有用，請為儲存庫加星——這能幫助更多人發現它。
## 下一步
安裝完成後，你可以再次執行腳本來管理使用者或移除 WireGuard。
設定你的電腦或其他裝置使用 VPN。請參見：
**[設定 WireGuard VPN 客戶端](docs/clients-zh-Hant.md)**
**閱讀 [:book: VPN book](docs/vpn-book-zh-Hant.md) 以存取[額外內容](https://ko-fi.com/post/Support-this-project-and-get-access-to-supporter-o-X8X5FVFZC)。**
開始使用自己的專屬 VPN! :sparkles::tada::rocket::sparkles:
## 致謝
此腳本基於 [Nyr 和 contributors](https://github.com/Nyr/wireguard-install) 的出色工作，並進行了增強和修改以與 [Setup IPsec VPN](https://github.com/hwdsl2/setup-ipsec-vpn/blob/master/README-zh-Hant.md) 專案相容。
對 Nyr/wireguard-install 的改進列表。
- 改進了與 Setup IPsec VPN 的相容性
- 改進了腳本的可靠性、使用者輸入和輸出
- 支援使用預設或自訂選項自動安裝
- 支援使用網域名稱作為伺服器位址
- 增加了對 openSUSE Linux 的支援
- 支援列出現有的 VPN 客戶端
- 支援顯示客戶端設定的 QR 碼
- 支援為 VPN 客戶端自訂 DNS 伺服器
- 支援使用命令列參數管理 VPN 客戶端
- 最佳化 `sysctl` 設定以提升 VPN 效能
- 在使用 `sudo` 時改進客戶端設定檔的建立
...以及更多！
## 授權條款
MIT