沒有圖形介面的 Linux、macOS 或 Windows，使用官方命令列程式 vilanet-cli。它是單個靜態檔案，用 VilaVPN 帳號登入，不匯入訂閱連結。整機連線用 TUN。
1. 下載對應的套件
從 發佈頁或 cli.vilavpn.com 下載。在中國大陸若 GitHub 打不開，用 cli.vilavpn.com 上的鏡像選擇。Linux 或 macOS 不確定架構時執行 uname -m：x86_64 是 AMD64，arm64 或 aarch64 是 ARM64。
| 系統 | 處理器 | 檔名結尾 |
|---|---|---|
| Linux | Intel/AMD 64 位元 | linux_amd64.tar.gz |
| Linux | ARM 64 位元 | linux_arm64.tar.gz |
| Linux | ARMv7 | linux_armv7.tar.gz |
| macOS | Apple 晶片 | darwin_arm64.tar.gz |
| macOS | Intel | darwin_amd64.tar.gz |
| Windows | Intel/AMD 64 位元 | windows_amd64.zip |
| Windows | ARM 64 位元 | windows_arm64.zip |
2. 安裝
Linux：解壓下載的壓縮檔，然後：
sudo install -m 0755 vilanet-cli /usr/local/bin/
sudo setcap 'cap_net_admin,cap_net_bind_service+eip' /usr/local/bin/vilanet-climacOS：解壓後同樣 sudo install -m 0755 vilanet-cli /usr/local/bin/。全裝置 TUN 需要 sudo。只做本機代理時不必 sudo。
Windows：解壓 ZIP。只從 Wintun 官網下載 Wintun，把相符的 wintun.dll 放在 vilanet-cli.exe旁邊。以系統管理員身分打開 PowerShell，進入該資料夾。第一次請在前景執行，不必先裝 Windows 服務。
確認安裝：Linux 或 macOS 執行 vilanet-cli version；Windows 執行 .\vilanet-cli.exe version。應輸出版本號而不是報錯。
3. 登入、選節點並連線
不要把密碼寫進指令、截圖或工單。login 會提示輸入，不會進 shell 歷史。
vilanet-cli login --email [email protected]
vilanet-cli list packages
vilanet-cli list servers
vilanet-cli connect --country HK登入成功後，憑證加密保存在這台裝置上。沒有系統鑰匙圈的無螢幕伺服器會改用加密檔案，SSH 登入也可以。日常不要加 --insecure-store。可按國家篩選，例如 vilanet-cli list servers --country HK。把 HK 換成您要的國家代碼。
macOS 上若 TUN 需要權限，在 connect 前加 sudo。Windows 在已提高權限的 PowerShell 裡執行。前景指令要保持執行，Ctrl+C 停止。未設定預設方案時，connect 使用第一個仍有剩餘流量的方案。單次換方案可加 --package，ID 來自 list packages。圖形版桌面 App 見 我應該使用哪一款應用程式。桌面版在 Ubuntu 上因 GLIBC 打不開時，用這個命令列程式，見 Linux 安裝。
連到了用完流量或不是要的方案
vilanet-cli list packages查看 ID 和名稱。若連線用了 sudo，這裡也用 sudo。vilanet-cli settings set selected_package <方案ID>- 再執行
vilanet-cli connect --country HK。也可以vilanet-cli connect --package <方案ID> --country HK。
login 和 connect 必須是同一個使用者：都加 sudo，或都不加。否則讀不到帳號或剛設定的方案。查看目前預設：vilanet-cli settings get selected_package。更多方案說明見 切換方案。
怎樣確認已經連上
- 前景：保持那個終端機不要關，確認程式還在。再開 IP 檢測頁，公用 IP 應與平時的電信業者 IP 不同。前景這次連線不要用
status來判斷。 - Linux 或 macOS 的背景：另一個終端機執行
vilanet-cli status。egress_ip就是出口公用 IP。健康檢查沒能確認、狀態為 running-unverified 時，這一列仍可能出現；在中國這很常見，不代表出口一定不可用。若egress_ip為空，過幾秒再查一次。 - Windows 前景：
disconnect、status和switch控制不了這個前景程式。用還開著的視窗和 IP 檢測頁確認，停止時按Ctrl+C。
斷開和登出
Linux 或 macOS 上，停止背景連線：vilanet-cli disconnect。只是斷開時不必 logout。vilanet-cli logout 會刪除已儲存的憑證和快取的帳號資料。
本機代理方式預設不修改系統代理。只有同時使用不開 TUN 的本機代理，並加上 --system-proxy，才會在連線期間設定系統代理，斷開時恢復原來的設定。整機 TUN 不需要這個參數。
常見報錯
command not found：程式不在 PATH 上，或改到解壓目錄裡執行。- 結束代碼
2：檢查電子郵件地址和密碼，再login。 - 結束代碼
4：先登入；若因為重複請求被限流，等一會兒再試。 - 結束代碼
5：用所需的管理員權限再跑；Linux 上把上面的setcap再做一次。 no daemon active：背景沒在跑。先vilanet-cli connect（會把它拉起來），再查 status。這是 Linux/macOS 背景，不是 Windows 前景。- 已經有一個 daemon：用正在跑的那個，或先
disconnect再啟動。 - 節點 ID 找不到：ID 過期或輸錯。重新
list servers，用目前列表裡的值。 - 鑰匙圈不可用（
the OS keyring is unavailable on this build或Specified keyring backend not available）：這是舊程式。從發佈頁換新的檔案後再login。不要把密碼寫進指令。 - Windows 報 Wintun：確認官方
wintun.dll就在vilanet-cli.exe旁邊。 - Windows 沒有
vilanet-cli update。從發佈頁下載新的壓縮檔，替換舊程式。
vilanet-cli update 要從 GitHub 下載，機器離線或存取不了 GitHub 時會失敗。連不上的時候不要把 update 當第一步。需要新程式時，從 cli.vilavpn.com 或發佈頁下載，覆蓋舊檔案並保持可執行，再執行 vilanet-cli version。
仍然不行？
執行 vilanet-cli logs --follow，先安全斷開，把刪掉敏感內容的片段發給客服。不要把整個設定目錄發出去，裡面可能有加密憑證和連線資訊。也可以 建立支援工單。連線失敗的下一步見 無法連線。文件：VilaNet CLI。