在支援的 Ubuntu 上，下載與電腦架構相符的官方 AppImage，設為可執行並登入，然後在設定裡做一次「安裝 TUN 模式支援」。AMD64 需要 Ubuntu 22.04 LTS 或更新版本，ARM64 需要 Ubuntu 24.04 LTS 或更新版本。若一啟動就提示找不到 GLIBC_2.38 或 GLIBCXX_3.4.32，請從下載頁下載最新的安裝包，不要去換系統程式庫。
1. 確認架構並下載
打開終端機，執行：
uname -mx86_64：下載 AMD64 版，系統為 Ubuntu 22.04 LTS 或更新版本。aarch64或arm64：下載 ARM64 版，系統為 Ubuntu 24.04 LTS 或更新版本。
AppImage 不需要傳統的套件安裝。請從 VilaVPN 下載頁或 發佈頁取得與架構相符的檔案。不要執行來路不明的副本。您還需要有效的 VilaVPN 帳號，以及一次性 TUN 設定所需的管理員權限。
2. 啟動 AppImage
- 打開終端機，進入下載目錄，例如
cd ~/Downloads。 - 對下載到的 AppImage 執行
chmod +x，檔名裡應能看出 AMD64 或 ARM64。 - 在同一目錄執行這個 AppImage。
這時可以先用代理模式。若要讓整台電腦的流量走系統層級 VPN 介面，請完成下面的一次性 TUN 安裝。
3. 登入
登入頁與 Windows、macOS、Android、iOS 相同，步驟見 如何登入 VilaNet。打開後停在「登入」，填寫「電子郵箱」和「密碼」，勾選「我已閱讀並同意：」，在「允許傳送最少資料以提供 VPN 服務嗎？」中選擇「允許」，再點「登入」。這個對話框不是登入失敗。方案過期或未啟用時，必須先續訂才能連線。
4. 安裝 TUN 支援
- 打開「設定」，在「連線」裡找到 Linux 區段。
- 閱讀「正在從 AppImage 執行」，然後選擇「安裝 TUN 模式支援」。若本機執行環境還沒準備好，在同一區段選擇「TUN模式」也會開始同一次安裝。
- Ubuntu 要求管理員認證時，確認要求屬於 VilaNet 的 TUN 安裝，再輸入密碼。這是 Linux 使用者帳戶的密碼，不是 VilaVPN 的密碼。
- 等待它裝好本機執行環境並重新啟動。不要關閉密碼提示，也不要再打開第二個副本。
- 重新啟動後確認已選取「TUN模式」。之後從桌面應用程式選單啟動 VilaNet，不要再執行原來的 AppImage。
不要用 sudo 反覆執行整個應用程式。若提示沒有出現，在 Ubuntu 上安裝圖形化密碼輔助工具後再試一次「安裝 TUN 模式支援」：
sudo apt update
sudo apt install zenity提升權限被取消或失敗時，TUN 設定沒有完成，可以暫時繼續用代理模式，或保留錯誤原文再聯絡客服。兩種模式的差別見 TUN 模式與代理模式。
5. 連線並確認
- 在主頁點選伺服器卡片，打開「伺服器節點」。
- 在「自動選擇」中選擇「最快」，除非您需要指定地點。頁面會自己回到主頁。
- 選擇「連接」，等到「連接中」變成「已連接」。如果這時又要求管理員權限，請先做完上面的 TUN 安裝並允許應用程式重新啟動。
- 讓應用程式再保持幾秒，狀態仍是「已連接」。用瀏覽器打開兩個您熟悉的 HTTPS 網站，回到應用程式後狀態應仍是「已連接」。
選中節點不等於已經連線。藍色伺服器卡片只表示目前選取。完整判斷見 VilaNet 要怎麼連線。
提示 GLIBC_2.38 或 GLIBCXX_3.4.32 not found
部分較早的 AMD64 版本在 Ubuntu 22.04 上會出現 GLIBC_2.38 / GLIBCXX_3.4.32 not found 錯誤。請從下載頁下載最新的安裝包。不是這台系統壞了。
請不要做這些事：不要手動升級或替換 glibc、libstdc++；不要為此重裝或升級作業系統；不要從第三方來源強裝較新的 libstdc++。
如果仍然出現錯誤，改用命令列用戶端 vilanet-cli。它是靜態單一檔案，不依賴系統的 glibc 版本，可以在 Ubuntu 22.04 上登入和連線。安裝見 如何安裝並使用 VilaNet 命令列用戶端，指南在 cli.vilavpn.com。
仍然不行？
- AppImage 打不開：核對
uname -m與所下架構、執行權限，以及是否滿足上面的 Ubuntu 版本。從終端機執行，以便留下完整錯誤。檔案不完整就從官方連結重新下載。 - 重新啟動後 TUN 不可用：到「設定 > 連線」的 Linux 區段確認選的是「TUN模式」，並從應用程式選單啟動。留下提到
CAP_NET_ADMIN、提升權限或 TUN 裝置的原文。 - 登入或連線失敗：檢查電子郵箱空格、訂閱是否有效，以及斷開後普通網頁能否打開。再試一次「自動選擇」。聯絡客服時用側邊欄「聯絡客服」，並保持「包含應用程式診斷資訊」開啟，或 建立支援工單。不要傳送密碼。
文件：Linux 上的 VilaNet。