macOS 安裝與首次運行

Apple 芯片選擇 arm64，Intel Mac 選擇 64。打開 DMG，將應用拖入 Applications 後再啓動。便攜 ZIP 需完整解壓，在可執行文件所在目錄運行 chmod +x v2rayN，再以普通用戶執行 ./v2rayN。

官方說明中 DMG 未簽名，首次運行可能顯示“已損壞”。確認文件來自項目發佈資產並完成校驗後，可在終端對這一應用運行下方命令，再重新打開。該命令會清除指定應用的擴展屬性，不是修復損壞下載的工具。若文件未完整下載，應重新下載。

macOS · Terminal複製
xattr -cr /Applications/v2rayN.app
macOS 下載簽名校驗

安裝後完成第一次連接

複製自己的分享鏈接，在客戶端非輸入框區域按 Ctrl+V，或用菜單執行剪貼板導入。若是訂閱地址，進入分組設置保存地址並更新訂閱。選擇列表中的一個配置設爲活動項，再啓用自動配置系統代理。

打開瀏覽器訪問目標；沒有連接時先看核心是否啓動、信息欄是否報錯。僅導入配置或完成測速，不代表瀏覽器已經使用代理。

訂閱操作排查連接

升級、備份與恢復

升級前在客戶端執行“備份和還原 → 備份”，保存 guiConfigs 的 ZIP 副本；非 Windows 系統應明確填寫 .zip 擴展名。記錄當前使用的客戶端、核心和架構。

便攜版可將新包解壓到新的文件夾，運行新版本後還原備份；保留舊文件夾，確認連接和訂閱正常後再自行整理。安裝版用同平臺和架構的包升級，不要假設卸載應用會同時清除用戶數據。還原成功後客戶端會重啓，未自動重啓時手動打開。

7.25.6 對核心版本與配置格式有調整，升級後檢查活動節點、路由、DNS、訂閱更新和 TUN。

當前版本更新內容備份說明