v2rayN Linux 版安裝教學：Deb／RPM 套件安裝與開機自動啟動設定

一、先確認發行版、架構與桌面工作階段

前往用戶端下載頁選擇 Linux 安裝套件。Debian、Ubuntu 及其衍生發行版通常使用 deb，Fedora 則使用 rpm。套件格式與處理器架構都必須相符：x86_64 對應 x64，aarch64 對應 ARM64。請勿只根據電腦品牌判斷架構。

cat /etc/os-release
uname -m
printf '桌面工作階段：%s\n' "$XDG_SESSION_TYPE"

以下步驟適用於已登入 GNOME、KDE 等圖形桌面的情況。純命令列伺服器沒有桌面工作階段，不能直接套用桌面自動啟動方式。v2rayN 是圖形用戶端，代理核心才負責連線與轉送；安裝用戶端不代表代理已啟用。

二、Debian／Ubuntu：安裝 deb 並修復依賴

先在檔案管理員中開啟下載資料夾，再選擇「在終端機中開啟」。將這次要安裝的 deb 單獨放在一個資料夾，避免指令選到舊版本或其他套件。以下指令請在 Bash 中執行：先確認目前資料夾內只有一個 deb，再讀取套件資訊並安裝；變數只會保留在目前的終端機工作階段。

mapfile -d '' packages < <(find . -maxdepth 1 -type f -name '*.deb' -print0)
if [ "${#packages[@]}" -eq 1 ]; then
  deb_file="${packages[0]}"
  dpkg-deb -f "$deb_file" Package Version Architecture
  sudo apt update
  sudo apt install "$deb_file"
else
  printf '請在目前資料夾只保留這次要安裝的一個 deb 套件。\n'
fi

確認輸出中的套件名稱、版本與架構後，再確認安裝提示。路徑以 ./ 開頭代表本機檔案；省略路徑時，apt 可能會將參數視為套件庫中的套件名稱。若出現架構不符的提示，請重新選擇安裝套件，不要使用強制參數略過檢查。

1. 確認套件資訊

   查看 dpkg-deb -f 的輸出，確認下載的是 v2rayN 對應套件，且架構與系統相符。

2. 安裝並補齊依賴

   使用 sudo apt install "$deb_file"。若先前使用 dpkg 安裝後留下未完成的套件設定，再執行 sudo apt --fix-broken install，確認修復計畫後繼續。

3. 檢查桌面捷徑

   安裝完成後開啟應用程式選單並搜尋 v2rayN；請勿先對程式資料夾遞迴新增寫入權限。

4. 以一般使用者啟動

   以目前登入的使用者身分開啟 v2rayN，確認主視窗與記錄都正常後，再設定訂閱與登入自動啟動。

三、Fedora：使用 dnf 安裝 rpm

同樣在只存放這次安裝套件的資料夾中開啟 Bash。先用 rpm -qp 查詢中繼資料，再交由 dnf 安裝。查詢本機套件不會執行安裝，也不需要管理員權限。

mapfile -d '' packages < <(find . -maxdepth 1 -type f -name '*.rpm' -print0)
if [ "${#packages[@]}" -eq 1 ]; then
  rpm_file="${packages[0]}"
  rpm -qp --queryformat '%{NAME} %{VERSION}-%{RELEASE} %{ARCH}\n' "$rpm_file"
  sudo dnf install "$rpm_file"
else
  printf '請在目前資料夾只保留這次要安裝的一個 rpm 套件。\n'
fi

不要使用 rpm --nodeps 略過依賴。這可能導致套件顯示已安裝，啟動時卻找不到共享函式庫。若發生依賴錯誤，請先確認 dnf 顯示的套件名稱與版本限制；若套件庫沒有所需版本，請檢查系統版本與套件是否相容。

• 提示套件已安裝：先查詢目前版本，不必重複安裝。更新時重新下載符合架構的套件，再交由 dnf 處理。
• 提示無法讀取檔案：確認終端機目前所在資料夾與檔名；不要對整個下載資料夾執行 chmod -R 777。
• 疑似遭安全政策攔截：檢查實際錯誤訊息與稽核記錄，不要為了開啟視窗就直接停用 SELinux。

安裝本機 deb 或 rpm 不代表已新增可持續更新的套件來源。後續是否能透過系統更新升級，取決於安裝套件是否設定了軟體庫；若沒有，就需要下載新版套件並重新安裝。

四、首次執行：先確認監聽，再測試代理

從應用程式選單啟動 v2rayN，匯入自己持有的訂閱或節點設定，並選取可用節點。接著前往「設定」→「參數設定」，查看本機監聽相關設定。不同版本的選項位置可能有所調整，請以目前介面顯示的連接埠與通訊協定類型為準。

以下假設本機 SOCKS 或混合監聽連接埠為 10808；這只是驗證範例，不保證所有版本都使用這個預設值。若實際連接埠不同，請在執行前修改指令中的數字。socks5h 會將目標網域交由代理端解析，可減少本機 DNS 對這次測試的干擾。

ss -lntp 'sport = :10808'
curl --proxy socks5h://127.0.0.1:10808 \
  --connect-timeout 5 --max-time 15 \
  --head https://example.com/

• 沒有監聽記錄：先確認核心是否已啟動、連接埠是否正確，以及記錄中是否有設定解析錯誤。
• 出現連線遭拒：通常表示該位址與連接埠上沒有可用的監聽服務，請先檢查本機入口。
• 已收到 HTTP 回應：代表這次明確指定代理的請求已收到目標或中間服務的回應；仍須依狀態碼判斷存取結果。

瀏覽器可以連線，不代表終端機會自動使用系統代理；上方的 curl 指令明確指定了代理，不依賴桌面代理設定。首次部署時，請先完成這種單次測試，再視需要啟用系統代理或 TUN。一般本機代理不需要長期以 root 身分執行整個圖形用戶端。

五、登入時自動啟動：沿用套件提供的桌面捷徑

這裡所說的「開機自動啟動」是指使用者登入圖形桌面後啟動 v2rayN，並非電腦開機後、登入之前就執行。日常桌面使用建議優先採用 XDG 自動啟動捷徑；它可以沿用套件維護的執行路徑，減少升級後捷徑失效的機會。

找出安裝後的 desktop 檔案

在一般使用者的終端機中執行下方搜尋指令。只有找到一個檔案時，腳本才會複製；若找到多個，則會列出候選項目並停止。如此不必預設安裝目錄，也不會把安裝套件檔名誤當成程式啟動指令。

mapfile -d '' entries < <(
  find /usr/share/applications /usr/local/share/applications \
    -maxdepth 1 -type f -iname '*v2rayn*.desktop' \
    -print0 2>/dev/null
)
if [ "${#entries[@]}" -eq 1 ]; then
  desktop_file="${entries[0]}"
  grep -E '^(Name|Exec|TryExec|Path|Hidden|OnlyShowIn|NotShowIn)=' "$desktop_file"
  autostart_dir="${XDG_CONFIG_HOME:-$HOME/.config}/autostart"
  mkdir -p "$autostart_dir"
  cp -- "$desktop_file" "$autostart_dir/v2rayn.desktop"
  printf '已複製至：%s\n' "$autostart_dir/v2rayn.desktop"
else
  printf '找到 %s 個捷徑，請先手動確認：\n' "${#entries[@]}"
  printf '%s\n' "${entries[@]}"
fi

若找不到捷徑，可回到先前執行安裝的終端機，使用 dpkg-deb -f "$deb_file" Package 或 rpm -qp --queryformat '%{NAME}\n' "$rpm_file" 取得套件名稱，再透過 dpkg -L 或 rpm -ql 查看套件檔案清單。確認實際捷徑後再繼續，不要猜測 /opt 下的程式路徑。

檢查是否已停用

使用文字編輯器開啟複製後的檔案，並在 [Desktop Entry] 區段檢查：若已有 Hidden=true，請改為 Hidden=false；若已有 X-GNOME-Autostart-enabled=false，請改為 true。若沒有這些停用設定，通常不需要另外新增。若有 OnlyShowIn 或 NotShowIn，也請確認目前使用的桌面環境未被排除。

• 保留原有 Exec、TryExec 和 Path 的有效值，不要任意將啟動指令改成 sudo。
• Exec 不是互動式 shell，不會像終端機一樣自動展開 ~、管線或重新導向。
• 寫入使用者的自動啟動資料夾不需要 sudo；使用 sudo 反而可能產生屬於 root 的設定檔。
• 若先前已啟用用戶端內建的自動啟動，請先停用其中一種方式，避免同時建立兩個啟動來源。

六、登出後驗證，並保留復原方式

儲存目前工作，正常結束 v2rayN，然後登出桌面並重新登入。只關閉終端機無法測試登入自動啟動。登入後先確認視窗或程序是否執行，再檢查監聽連接埠；部分桌面環境不支援系統匣圖示，不能只靠系統匣中是否出現圖示來判斷結果。

pgrep -af '[vV]2ray[Nn]'
ss -lntp 'sport = :10808'
journalctl --user -b --no-pager -n 100

使用者記錄是否包含啟動資訊，取決於桌面環境；不應直接將「記錄中沒有內容」視為啟動失敗。若用戶端已執行但節點連線逾時，請先等待網路連線完成，再檢查訂閱、節點與核心記錄；不要為了解決網路問題而重複新增自動啟動項目。

rm -f -- "${XDG_CONFIG_HOME:-$HOME/.config}/autostart/v2rayn.desktop"

七、安裝與權限錯誤的常見處理方式

最後分三項驗收：系統套件管理工具能查詢到套件；一般使用者手動啟動後，代理請求可以正常使用；重新登入桌面後，監聽入口會自動恢復。三項都通過，才代表安裝、連線與自動啟動均已完成。之後若修改連接埠或升級安裝路徑，也請依此順序重新檢查。