2026-07-07 新入庫:廳官女友提8個行李箱現金全款買房,舉報者卻被判刑 X RSS
翻牆工具 / 檔案 No.17246

自由檔案館|WireGuard 一鍵安裝腳本(中文版)

檔案編號No. 17246
來源作者自由檔案館
存檔日期2026-05-13

WireGuard 一鍵安裝教學:

專案位址:https://github.com/iwantruncom/WireGuard-install-cn

感謝原作者 Angristan張狗剩同志

🚀 一鍵安裝 📱 自動生成二維碼 🧰 中文嚮導 🔒 本地生成密鑰 💻 支援多平台

一、這篇教程適合誰?

很多新手想自己搭建 VPN,但一看到 Linux、端口、防火牆、密鑰、客戶端配置這些詞,就會覺得很複雜。

其實,如果只是自己使用,或者給手機、電腦配置一個私人 WireGuard 節點,並不需要很高的技術門檻。本文介紹的 WireGuard 中文一鍵安裝腳本,已經把複雜的安裝過程簡化成了中文嚮導,大部分選項直接按回車即可完成。

  • 適合想自己搭建私人 VPN 的使用者
  • 適合不熟悉 Linux 命令的新手
  • 適合希望手機掃碼快速連接的人
  • 適合想給手機、電腦、平板分別建立節點的人

二、什麼是 WireGuard?

WireGuard 是一種輕量、高效、現代化的 VPN 協議。相比傳統 VPN,它配置更簡單、速度更快、資源佔用更低,非常適合個人 VPS 搭建私人 VPN。

速度快 協議簡潔,性能表現好。
配置簡單 客戶端導入配置即可使用。
多平台支援 支援 Windows、macOS、iOS、Android、Linux。

三、安裝前需要準備什麼?

1. 海外 VPS 建議使用Vultr、Linode、Hetzner、DigitalOcean等VPS,系統選擇Ubuntu或CentOS。
2. SSH 工具 用於登錄伺服器執行安裝命令。
3. WireGuard 客戶端 手機或電腦安裝官方客戶端。

VPS 推薦配置

專案 建議
CPU 1 核即可
記憶體 512MB 以上
硬碟 5GB 以上
流量 越多越好
系統 Debian 12 或 Ubuntu 22.04 更適合新手
虛擬化 KVM 優先
注意:不建議使用 OpenVZ、LXC 容器、國內伺服器,或者無法開放 UDP 端口的 VPS。WireGuard 使用 UDP 協議,如果服務商不支援 UDP 放行,可能會出現“顯示已連接但無法上網”的問題。

四、支援哪些系統?

這個腳本支援常見 Linux 發行版,但需要使用 root 權限運行。

系統 最低版本要求
Debian 10 及以上
Ubuntu 18.04 及以上
Fedora 32 及以上
CentOS 8 及以上
新手建議:優先選擇 Debian 12 或 Ubuntu 22.04,這兩個系統相容性較好,網上資料也更多。

五、如何 SSH 登錄 VPS?

購買 VPS 後,你需要準備好下面這些資訊:

  • 伺服器 IP 位址
  • SSH 端口,通常是 22
  • 使用者名稱,通常是 root
  • root 密碼,或者 SSH 私鑰

假設你的伺服器 IP 是 1.2.3.4,使用者名稱是 root,可以使用下面的命令登錄:

SSH 登錄伺服器
ssh root@1.2.3.4

第一次登錄時,終端可能會提示:

首次連接確認
yes

六、WireGuard 一鍵安裝命令

SSH 登錄 VPS 後,請確認你是 root 使用者。如果不是 root 使用者,可以先執行:

切換 root 使用者
sudo su

然後執行下面三行命令:

WireGuard 中文一鍵安裝命令
wget https://raw.githubusercontent.com/iwantruncom/WireGuard-install-cn/main/wireguard-install-cn.sh
chmod +x wireguard-install-cn.sh
./wireguard-install-cn.sh
說明:這三行命令分別是:下載腳本、新增執行權限、運行安裝腳本。

七、安裝過程怎麼選擇?

運行腳本後,會出現中文安裝嚮導。一般情況下,新手不需要修改太多參數,大部分直接按回車即可。

伺服器公網 IP 位址 如果腳本自動識別的 IP 和 VPS 後台顯示的一樣,直接回車即可。
公網網卡名稱 常見名稱是 eth0、ens3 等,一般預設即可。
WireGuard 介面名稱 預設通常是 wg0,直接回車即可。
伺服器端內網 IP 預設通常是 10.66.66.1,直接回車即可。
WireGuard 監聽端口 腳本會隨機生成端口,例如 51413。這個端口後面需要在 VPS 防火牆裡放行 UDP。
DNS 設定 預設一般是 1.1.1.1 和 8.8.8.8,新手可以直接回車。
重要:請記住安裝時顯示的 WireGuard 端口。後面必須在 VPS 安全組或防火牆中放行這個 UDP 端口。

八、安裝完成後會自動做什麼?

腳本會自動完成大部分配置,不需要你手動編輯 WireGuard 配置文件。

自動安裝依賴 安裝 WireGuard、iptables、qrencode 等元件。
自動生成密鑰 伺服器端和客戶端密鑰在本地生成。
自動生成二維碼 手機 WireGuard App 掃碼即可導入配置。
自動啟動服務 啟動 wg-quick,並設定開機自啟。
自動建立配置 生成客戶端 .conf 配置文件。
支援管理菜單 可以新增、檢視、刪除客戶端,也可以解除安裝。

九、手機如何連接 WireGuard?

iPhone 使用者

  1. 打開 App Store
  2. 搜尋 WireGuard
  3. 下載 WireGuard 官方 App
  4. 打開 App,點擊右上角 +
  5. 選擇“掃描二維碼”
  6. 掃描伺服器終端裡顯示的二維碼
  7. 儲存配置並打開開關連接
如果你使用中國區 Apple ID,可能搜不到 WireGuard。可以切換到美區、港區、台區等非中國大陸區 App Store 下載。

Android 使用者

安卓使用者可以在 Google Play 搜尋 WireGuard,也可以前往 WireGuard 官網下載 APK。

WireGuard 官方客戶端下載 https://www.wireguard.com/install/

十、電腦如何連接 WireGuard?

Windows、macOS、Linux 使用者都可以安裝 WireGuard 官方用戶端,然後匯入指令碼產生的 .conf 配置文件。

WireGuard Windows / macOS / Linux 官方用戶端 https://www.wireguard.com/install/

指令碼產生的用戶端配置文件通常在:

用戶端配置文件路徑範例
/root/wg0-client-你的用戶端名稱.conf

十一、Mac 如何下載配置文件?

如果你使用 Mac,可以在本機 Mac 終端執行 scp 命令,把伺服器上的配置文件下載到本機下載目錄。

Mac 下載配置文件
scp root@你的伺服器IP:/root/wg0-client-你的用戶端名稱.conf ~/Downloads/

例如:

範例命令
scp root@1.2.3.4:/root/wg0-client-phone.conf ~/Downloads/

下載完成後,打開 WireGuard 用戶端,匯入這個 .conf 檔案即可。

十二、Windows 如何下載配置文件?

Windows 新手推薦使用 WinSCP 下載配置文件,介面比較直觀。

WinSCP 官方網站 https://winscp.net/
打開 WinSCP 協議選擇 SFTP。
填寫伺服器資訊 主機名稱填寫你的 VPS IP,使用者名稱通常是 root,連接埠通常是 22。
登入伺服器 輸入伺服器密碼後登入。
進入 /root/ 目錄 找到 wg0-client-xxx.conf 檔案。
下載並匯入 下載到電腦後,用 WireGuard 用戶端匯入。
WinSCP 登入資訊範例
協議:SFTP
主機名稱:你的伺服器 IP
使用者名稱:root
密碼:你的伺服器密碼
連接埠:22

十三、如何給多個設備新增節點?

如果你已經安裝完成,以後想給第二台手機、電腦、平板新增節點,不需要重新安裝系統,只需要重新執行指令碼。

打開 WireGuard 管理選單
./wireguard-install-cn.sh

你會看到類似選單:

管理選單
請選擇操作:
  1) 新增新用戶端
  2) 查看用戶端列表
  3) 刪除用戶端
  4) 卸載 WireGuard
  5) 退出
建議每個設備單獨建立一個用戶端配置,不要多個設備共用同一個配置。比如 iPhone 用 iphone,MacBook 用 macbook。

十四、最常見問題:顯示已連接,但無法上網

這是新手最常見的問題。很多人安裝完成後,手機 WireGuard 顯示已經連接,但是打不開網頁,或者 WireGuard App 裡面的 Rx 接收資料一直都是 0 B。

重點:這種情況大概率不是指令碼問題,而是 VPS 服務商的安全組或防火牆沒有放行 WireGuard 的 UDP 連接埠。

正確的入站規則

項目 設置
類型 自定義
協議 UDP
連接埠 安裝時顯示的 WireGuard 連接埠,例如 51413
來源 0.0.0.0/0
防火牆規則範例
UDP 51413 0.0.0.0/0
千萬不要選成 TCP。WireGuard 使用的是 UDP。如果你只放行 TCP,手機可能顯示連接,但實際無法正常上網。

十五、如何判斷是不是防火牆問題?

打開 WireGuard App,看流量資料。

典型現象
Tx 有資料
Rx 一直是 0 B

這通常說明手機發出了請求,但是伺服器沒有返回資料。常見原因包括:

  • VPS 安全組沒有放行 UDP 連接埠
  • VPS 系統防火牆攔截了 UDP
  • WireGuard 連接埠填錯
  • 伺服器 IP 填錯
  • VPS 服務商屏蔽 UDP

優先檢查 VPS 後台的安全組或防火牆。

十六、伺服器端常用檢查命令

如果連不上,可以 SSH 登入伺服器,執行下面的命令檢查 WireGuard 狀態。

查看 WireGuard 服務狀態
systemctl status wg-quick@wg0
查看 WireGuard 目前連接狀態
wg
重啟 WireGuard 服務
systemctl restart wg-quick@wg0

十七、配置文件保存在哪裡?

文件 路徑
伺服器端配置 /etc/wireguard/wg0.conf
用戶端配置 /root/wg0-client-用戶端名稱.conf
參數文件 /etc/wireguard/params
不建議隨意刪除 /etc/wireguard 目錄,否則 WireGuard 配置會遺失。

十八、如何卸載 WireGuard?

如果你不想繼續使用,可以重新執行指令碼,進入管理選單後選擇卸載。

打開管理選單
./wireguard-install-cn.sh

然後選擇:

卸載選項
4) 卸載 WireGuard
卸載會刪除 WireGuard 配置文件和所有用戶端資訊。如果你想保留配置,請先備份 /etc/wireguard 目錄。

十九、安全說明

  • 指令碼元件從系統官方軟體源安裝
  • 指令碼不收集、不傳輸使用者資料
  • WireGuard 密鑰在伺服器本機產生
  • 用戶端配置文件保存在伺服器本機
  • 配置文件權限設置為 root 可讀
不要把伺服器密碼、用戶端配置文件、WireGuard 私鑰發給陌生人。一旦用戶端配置洩露,別人就可能使用你的 VPN 節點。

二十、完整流程總結

購買 VPS 建議選擇支援 UDP 的海外 KVM VPS。
選擇系統 新手推薦 Debian 12 或 Ubuntu 22.04。
SSH 登入伺服器 使用 root 使用者登入 VPS。
執行安裝命令 運行 WireGuard 中文一鍵指令碼。
放行 UDP 連接埠 在 VPS 後台安全組中放行安裝時顯示的 UDP 連接埠。
掃碼或匯入配置 手機掃碼,電腦匯入 .conf 檔案。

二十一、一鍵安裝命令彙總

SSH 登入伺服器後,執行:

完整安裝命令
wget https://raw.githubusercontent.com/iwantruncom/WireGuard-install-cn/main/wireguard-install-cn.sh
chmod +x wireguard-install-cn.sh
./wireguard-install-cn.sh

安裝完成後,如果需要管理客戶端,執行:

管理客戶端
./wireguard-install-cn.sh

探索更多來自 自由档案馆 的內容

訂閱即可透過電子郵件收到最新文章。

本文為檔案存檔,版權歸原作者所有。轉載請註明檔案編號與本館地址。

別讓下一篇文章消失在你眼前

域名可能被封,訂閱是找到我們的最穩方式。新檔案入庫即時送達。

適用電子郵件訂閱網站

輸入你的電子郵件地址訂閱網站的新文章,使用電子郵件接收新通知。

主域名無法訪問時請通過 X 或 RSS 獲取最新地址。