Getting Started zh Hant

🌐 English | 繁體中文

快速上手

從原始碼建置並執行 Player Club Private VPN。本頁對應 README 的快速開始章節——本頁補充先決條件、疑難排解，以及首次執行的完整流程。應用程式實際上線後如何使用，請見使用者手冊。

先決條件

• Rust（穩定版）— 透過 rustup 安裝
• Node.js 20+ 與 pnpm 10+
• Windows — MSVC 工具鏈、Visual Studio C++ Build Tools 2022、WebView2 Runtime（Windows 11 已預先安裝）
• Linux — libwebkit2gtk-4.1-dev、libgtk-3-dev、libayatana-appindicator3-dev、librsvg2-dev、patchelf、build-essential（可參考 CI 工作流程安裝的 apt 套件，見 .github/workflows/release.yml）
• macOS — Xcode Command Line Tools

本應用程式可在 Windows、Linux、macOS 上建置並執行。不過，真實的虛擬介面卡目前僅支援 Windows——TUN/TAP 程式碼僅在 #[cfg(windows)] 下編譯，因此 Linux／macOS 版本僅為介面預覽版，尚無可運作的通道。詳情請見 PLATFORM-SUPPORT.zh-Hant.md。

安裝並執行

pnpm install
pnpm tauri dev

此指令會啟動 Vite 開發伺服器，並以熱重載模式開啟 Tauri 視窗。

建置正式版

pnpm tauri build

會於 src-tauri/target/release/ 下產生安裝器（.msi、NSIS .exe）。 官方建置版本亦會在每次推送 v* 標籤時由 CI 自動產生——見 .github/workflows/release.yml——並發布為草稿GitHub Release 供審閱後再正式公開。

使用本應用程式

應用程式啟動後，完整的操作流程請見**使用者手冊**——首次啟動、Basic／Expert 模式、啟用真實介面卡、連接對等節點、代管虛擬網路，以及每個設定頁面的說明。

疑難排解

• Expert 模式顯示「需要管理員權限」 — 點選重新啟動提示；在 Windows 上建立介面卡需要提升權限。
• Windows 上建置連結失敗 — 確認已安裝 MSVC Build Tools（而非僅有 MinGW）；Windows 上的 Rust 需要 -msvc 工具鏈。
• cargo update 導致建置失敗 — Cargo.lock 固定了 alloc-stdlib（0.2.2）與 brotli-decompressor（5.0.1）的版本，讓相依套件圖維持在 alloc-no-stdlib 2.0.x。請避免對這些套件執行未限定範圍的 cargo update： alloc-no-stdlib 3.0.0 與 brotli 8.0.3 不相容（Rust 錯誤 E0277）。若遇到此問題，請還原鎖定檔（lockfile）中該部分的變更，而非嘗試向前解決。
• 屬於應用程式使用問題，而非建置問題 — 請先查閱使用者手冊或常見問題。

仍然卡關？歡迎在 Discussions 提問，或查閱現有議題。