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

    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 [email protected]

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

    首次連接確認
    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 [email protected]:/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

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

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