适用范围：Linux 桌面与 systemd

以 Debian/Ubuntu、systemd 和本机浏览器为例。v2rayA 是管理界面，实际连接还需要兼容核心。按官方安装文档选择发行包与核心，不照抄过期的一键安装脚本。本文先验证本机代理，不指导把管理面板开放到公网。

已经按官方文档安装后：第一条启动本地服务；后两条读取状态与近期日志
sudo systemctl start v2raya.service
systemctl status v2raya.service --no-pager
journalctl -u v2raya.service -n 60 --no-pager

在本机打开 http://localhost:2017。打不开时先看服务和日志；2017 是官方文档的管理端口，改过设置时以实际监听为准。首次管理员账户属于本机 v2rayA，与订阅服务账户不同。服务运行状态不是出口连通性的证明。

导入节点，随后启动代理服务

先登录 Roxi 账户复制自己的第三方订阅链接。下文路径只替换原链接中的 /sub/ 部分一次，保留域名、个人标识及全部查询参数；不要把“个人标识”当真值，也不要把官网首页或登录页当订阅。已有对应格式的专用链接时直接使用。

本文用 /sub/nodes/个人标识 的 Base64 节点列表，避免客户端识别差异让节点入口收到完整 sing-box JSON。节点格式不会自动复制其他客户端的全部分流设置。

  1. 在导入入口添加个人订阅，更新后进入相应订阅标签页，确认当前节点列表非空。
  2. 先选一个节点，再启动界面中的代理服务；管理页面能打开与代理核心已启动是两个状态。
  3. 首次先关闭透明代理，只通过下面的显式本地端口测试。成功后再决定桌面系统代理或透明代理，避免同时修改多个层次。

区分管理端口与代理端口

官方默认端口用途检查方法
2017管理 Web 界面浏览器打开本机管理页
20170SOCKS5 代理支持 SOCKS5 的应用显式使用
20171HTTP 代理下面的 curl 显式请求
20172带分流规则的 HTTP 入口规则验证时再单独对照
Linux 终端：20171 需与界面设置一致；example.com 换成自己要验证的 HTTPS 网站
curl --noproxy "" --proxy http://127.0.0.1:20171 \
  --connect-timeout 10 --max-time 30 --output /dev/null \
  --write-out "HTTP %{http_code}\n" https://example.com/

连接被拒绝通常先查端口和核心；有 HTTP 返回仍需判读状态及内容，403 并不等于目标业务可用。想验证分流时要核对实际出站与日志，不能拿普通入口的一次请求代替透明代理测试。

透明代理与安全恢复

只有显式代理已可用时，再按官方手册检查透明代理实现、路由与规则库。修改前记下桌面代理设置，不与其他 VPN/TUN 同时接管。如果系统代理仍指向本机端口，先将它恢复成原值，再在界面停止代理；仅关闭网页不会停止后台服务。

仅在确实要停止整个本机管理服务时执行；先关闭接管并恢复系统代理
sudo systemctl stop v2raya.service

只分享脱敏后的失败阶段、字段名和日志摘要。订阅 URL、二维码、节点认证信息和导出的配置都可能包含凭据，不要发送到公开群或公共转换网站。本文依据官方资料与项目接口整理，未进行真机连接实测。