在受支持的 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。