在 Ubuntu / Debian 上安裝 v2rayN 的完整步驟

從下載到開機自啟的全過程,包含桌面環境代理設定和無圖形介面伺服器的替代方案。

Linux2026 年 2 月 18 日約 3 分钟

Debian 系是 Linux 桌面使用者最多的一支。這篇按實際操作順序走一遍,包括很多教學會跳過的「裝完之后系統怎麼用上它」。

一、安裝

用 apt 安裝本地 deb 包
cd ~/Downloads

# 注意前面的 ./ 不能省,否则 apt 会去仓库里找同名包
sudo apt install ./v2rayN-linux-64.deb

# 如果提示缺依赖,先更新索引再重试
sudo apt update
sudo apt install -f

二、啟動

安裝后應該能在應用選單里找到圖標。也可以從終端啟動,好處是能直接看到報錯:

從終端啟動以觀察輸出
v2rayN

# 如果提示命令不存在,找一下实际路径
which v2rayN || dpkg -L v2rayn | grep bin

三、讓系統真正用上代理

這是 Linux 上最容易卡住的一步。和 Windows 不同,Linux 沒有統一的「系統代理」概念,不同層級要分別配置。

桌面環境代理GNOME/KDE 設定,影响遵循它的圖形程式環境變數http_proxy 等,影响終端和從終端啟動的程式APT 單獨配置包管理器不讀環境變數,需要單獨配
Linux 上代理需要分層配置

桌面環境:GNOME 下在「設定 → 網路 → 網路代理」里選「手動」,HTTP 和 HTTPS 都填 127.0.0.1,連接埠填 10809。KDE 在「系統設定 → 網路 → 設定 → 代理」。

環境變數:加到 ~/.bashrc 或 ~/.zshrc
export http_proxy="http://127.0.0.1:10809"
export https_proxy="http://127.0.0.1:10809"
export all_proxy="socks5://127.0.0.1:10808"
export no_proxy="localhost,127.0.0.1,::1,*.local"

# 大写形式有些程序也读
export HTTP_PROXY=$http_proxy
export HTTPS_PROXY=$https_proxy
APT 單獨配置
sudo tee /etc/apt/apt.conf.d/95proxy > /dev/null <<'EOF'
Acquire::http::Proxy "http://127.0.0.1:10809";
Acquire::https::Proxy "http://127.0.0.1:10809";
EOF

# 不用时删掉这个文件即可
# sudo rm /etc/apt/apt.conf.d/95proxy

四、開機自啟

用桌面自啟目錄(推薦給圖形環境)
mkdir -p ~/.config/autostart
cat > ~/.config/autostart/v2rayn.desktop <<'EOF'
[Desktop Entry]
Type=Application
Name=v2rayN
Exec=v2rayN
X-GNOME-Autostart-enabled=true
X-GNOME-Autostart-Delay=15
EOF

X-GNOME-Autostart-Delay=15 讓它延遲 15 秒啟動,等網路就緒,避免開機瞬間因為沒有網路而全部測速失敗。

五、沒有圖形介面的伺服器怎麼辦

v2rayN 是圖形用戶端,在純命令行的 VPS 上跑不起來。如果你要在無頭伺服器上用代理,正確的做法是直接運行內核

思路:只用內核 + 一份設定檔 + systemd
# 1. 在有图形界面的机器上用 v2rayN 配好,导出生成的 config.json
# 2. 把内核二进制和 config.json 传到服务器
# 3. 写一个 systemd service 让它常驻

sudo tee /etc/systemd/system/xray.service > /dev/null <<'EOF'
[Unit]
Description=Xray Service
After=network-online.target

[Service]
ExecStart=/usr/local/bin/xray run -c /usr/local/etc/xray/config.json
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl enable --now xray
sudo systemctl status xray

這樣伺服器上就有了一個常駐的本地代理連接埠,其他程式照常通過環境變數使用它。