环境变量和命令行参数

介绍

环境变量

本节所列变量有可能已过时,可通过 v2raya --help 查看支持的参数,环境变量与之对应。

V2RAYA_ADDRESS: 监听地址 (默认 “0.0.0.0:2017”)

V2RAYA_CONFIG: v2rayA 配置文件目录 (默认 “/etc/v2raya”)

V2RAYA_V2RAY_BIN: v2ray 可执行文件路径。留空将自动检测。可修改为 v2ray 分支如 xray 等文件路径。

V2RAYA_V2RAY_ASSETSDIR: v2ray 所使用的数据文件所在路径。

V2RAYA_V2RAY_CONFDIR: 附加的 v2ray 配置文件目录,该目录中的 v2ray 配置文件会与 v2rayA 生成的配置文件进行组合。

V2RAYA_WEBDIR: v2rayA 前端 GUI 文件目录,如不指定,将使用二进制内嵌 GUI 文件。

V2RAYA_PLUGINLISTENPORT: v2rayA 内部插件端口 (默认 32346)

V2RAYA_FORCE_IPV6_ON: 跳过检查,强制启用 IPv6 的支持。

V2RAYA_PASSCHECKROOT: 跳过 root 权限检测,确认你有 root 权限而 v2rayA 判断出错时使用,或者使用非 root 用户时使用。

V2RAYA_VERBOSE: 详细日志模式,混合打印 v2ray-core 和 v2rayA 的运行日志。将在之后的版本被遗弃。

V2RAYA_RESET_PASSWORD: 重设密码。

命令行参数

与环境变量对应,详情使用下列命令查看:

v2raya --help

如何设置

下面将以指定V2RAYA_V2RAY_BIN为xray为例,介绍各个环境下的设置方法。

systemd 管理的 v2rayA

使用 apt 等包管理器,或直接使用安装包进行安装的,一般都为这种方式。

  1. 新建文件夹 /etc/systemd/system/v2raya.service.d,然后新建一个 xray.conf 的文件,添加以下内容:

    [Service]
    Environment="V2RAYA_V2RAY_BIN=/usr/local/bin/xray"
    

    注意检查 Xray 的路径是否正确。

  2. 重载服务:

    sudo systemctl daemon-reload && sudo systemctl restart v2raya
    

OpenWrt

  • 针对已适配选项:

    详细可配置列表参见 /etc/config/v2raya

    uci set v2raya.config.v2ray_bin='/usr/bin/xray'
    uci commit v2raya
    
  • 针对未适配选项(nightly / advanced 用户):

    更改 /etc/init.d/v2raya

    start_service() {
       config_load "$CONF"
    
       is_enabled "config" "enabled" || exit 1
    
       procd_open_instance "$CONF"
       procd_set_param command "$PROG"
       procd_set_param env XDG_DATA_HOME="/usr/share"
    
       # 追加命令行参数
       procd_append_param command --v2ray-bin="/usr/bin/xray"
       # 追加环境变量
       procd_append_param env V2RAYA_V2RAY_BIN="/usr/bin/xray"
    
       --- cut here ---
    
  • 重载服务:

    /etc/init.d/v2raya restart
    

Alpine

修改 /etc/init.d/v2raya中的command_args,例如:

#!/sbin/openrc-run

name="v2rayA"
description="A Linux web GUI client of Project V which supports V2Ray, Xray, SS, SSR, Trojan and Pingtunnel"
command="/usr/local/bin/v2raya"
command_args="--config=/usr/local/etc/v2raya --v2ray-bin=/usr/local/bin/xray"
pidfile="/run/${RC_SVCNAME}.pid"
command_background="yes"

depend() {
    need net
}

再重启服务即可。

Docker

使用-e指定环境变量,下例修改监听端口为2021:

# run v2raya
docker run -d \
  --restart=always \
  --privileged \
  --network=host \
  --name v2raya \
  -e V2RAYA_ADDRESS=0.0.0.0:2021 \
  -v /lib/modules:/lib/modules \
  -v /etc/resolv.conf:/etc/resolv.conf \
  -v /etc/v2raya:/etc/v2raya \
  mzz2017/v2raya

在 Github 上编辑此页

最后更新于: 2022年12月23日 14:08:35 +0800

贡献者: mzz2017 cubercsl 1715173329