# 常见问题

TIP

有些错误内容可能需要将 核心设置 中的 日志等级 调整成 info 或者 debug 后才会出现。

# 启动问题

# 报错 <code>Only one usage of each socket address (protocol/network address/port) is normally permitted.

  • 根本原因: 出现了端口冲突
  • 原因 1: 上一个 V2Ray 进程没有正常退出,占用了相关的端口。
  • 解决办法: 终止当前占用该端口的进程。
  • 原因2: 在 Qv2ray 中设置的相关端口已被其他软件占用。
  • 解决方案: 更改 Qv2ray 或其他软件的端口设置。

# An attempt was made to access a socket in a way forbidden by its access permissions.

  • 原因: 如果您正在使用 Windows, 一个补丁可能会在 1000-2000 之间设置端口作为特权/保留端口。

  • 解决方案: 使用超过 2000 的端口。

# 启用 TProxy 后启动 V2Ray 核心失败

  • 详情: 开启 TProxy 后出现了 Segmentation Fault

  • 原因: 它是由某些 Linux 上的 SUID 限制所引起的。 详细的错误分析请查看:#59 (opens new window)

# 网络连接问题

# 连接配置是正确的,但运行时可以看到警告。

  • 可能的原因: 系统时间不匹配。 如果VMess是您的代理协议,它需要客户端和服务器的系统时间差小于90秒,否则它将拒绝连接。
  • 解决方案 (Windows):
    • 方法 1: 打开设置, 选择 “时间 & 语言”, 启用 “自动设定日期和时间”。 如果该选项已经启用,请点击"立即同步"按钮
    • 方案 2:打开控制面板,切换到“类别”视图,选择“时间和区域”,然后点击“日期和时间”, 在打开的对话框中选择"Internet time",然后点击“更改设置”按钮并检查“与Internet time server同步”。
  • 解决方案 (Linux):
    • 方法 1: 使用 system-timeyncd, 运行 sudo systemctl enable systemd-timesyncd --now
    • 方法2: 使用 Chrony (opens new window) 来同步时间。
  • 解决方案 (macOS): 打开系统首选项,单击“日期 & 时间”,并开启“自动设置日期和时间”。

# 我想要使用代理访问中国大陆网站。

# 当在 Linux 下运行时,透明代理 (tProxy) 不工作

  • 在这种情况下,日志可能显示错误 failed to set IP_TRANSPARENT > operation not permitted

  • 原因: V2Ray 没有设置套接字选项的权限。

  • 解决方案:

    • 对于所有 Linux 发行版,在终端中使用下面的命令 (使用 root/sudo):

      # /usr/bin/setcap "cap_net_bind_service=+ep cap_net_admin=+ep" /usr/bin/v2ray
      

      /usr/bin/v2ray 是大部分Linux 发行版安装V2Ray 的地方,如果不是,(例如) 您已经使用安装脚本安装了V2Ray,请替换 /usr/bin/v2ray 并使用您的 V2Ray 核心二进制路径。

    • 对于ArchLinux用户:
      尝试 AUR 包 Aur/v2ray-cap-git (opens new window) (由 @DuckSoft 创建)的自动化步骤

    • 适用于 Fedora 32+ / RHEL 8+ 用户:
      如果您通过 dnf / yum 安装 V2Ray,那么 V2Ray 二进制路径应该是 /usr/bin/v2ray , 您也可以安装RPM包 v2ray-cap (opens new window) (由 @sixg0000d 打包)。

# 配置 Windows 上拨号连接 / VPN 连接的代理

已经在 2.7.0-pre2 版本上支持

# 无法在 macOS 上自动配置系统代理 (错误: 命令需要管理员权限)

  • 原因: macOS 上的权限问题。

  • 解决办法:

    > # security authorizationdb write system.services.systemconfiguration.network allow
    YES (0)
    

# 行为和外观问题

# 没有托盘图标 / 托盘图标偶尔在GNOME中消失。

  • 原因: 这是个上游 Bug

  • 解决办法: Gnome 不支持托盘图标。 所有托盘图标都是第三方开发者或部分 Linux 发行版的拓展组件。 您可以使用以下命令作为临时解决方案:

    $ nohup gnome-shell --replace &
    

或者您也可以重启 Qv2ray 然后重试。

给 Gnome 用户的提示

原生的 Gnome 桌面无法显示托盘图标。所以 Qv2ray 托盘图标也无法显示。 如果您想要显示托盘图标, 您可以安装一个叫做 gnome-shell-extension-appindicator (opens new window) (也叫 ubuntu-appindicator) 安装扩展后,您应该注销,再次登录 然后在 Tweaks 中启用拓展 (ie gnome-modins), 然后你会看到托盘图标。

# macOS 频繁要求将 Qv2ray / Qv2ray 插件“移到废纸篓”

  • 原因: 为开发组隐私着想,我们并无兴趣使用个人苹果开发者帐户为 Qv2ray 签名。 我们的应用程序也没有通过苹果公司的所谓“审核”。 而我们实际上根本没有任何 macOS 设备。因而在这种情况下,请原谅我们不搞什么超级浪费时间的所谓“ 公证 (opens new window)”之类的东西。
  • 解决方案: 执行 sudo xattr -rd com.apple.quarantine /Applications/qv2ray.app 以跳过那个阴间的验证。

# 其他问题

# 为什么 Qv2ray 不自带插件和 V2Ray 核心,或者提供内置下载功能?

我们希望我们的用户能够知道 Qv2ray / V2Ray 如何工作,并愿意自己解决潜在的问题和需求。

如果 Qv2ray 不适合您,您可以自由选择其他软件。

  • 试试包管理?

# Qv2ray 是否会支持移动平台 (Android,iOS)?

目前尚无计划。 取决于开发者的个人需求,在将来可能会有对于移动平台的支持(在项目迁移到 QML 之后)