# 常见问题

TIP

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

# 启动问题

# `报错`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)
- 解决方案：sudo sysctl fs.suid_dumpable=1 这种方法将会在重启后失效，请查看这篇文章 (opens new window)

# 网络连接问题

# 你已经确认连接配置是正确的，但运行时还是能看到警告，且代理未能工作：

可能的原因：系统时间不匹配。如果VMess是您的代理协议，它需要客户端和服务器的系统时间差小于90秒，否则它将拒绝连接。
解决方案（Windows）：
- 方法 1：打开设置，选择“时间和语言”，启用“自动设置时间”。如果该选项已经启用，请点击“立即同步”按钮。
- 方案 2：打开控制面板，切换到“类别”视图，选择“时钟和区域”，然后点击“日期和时间”，在打开的对话框中选择标签“Internet 时间”，然后点击“更改设置”按钮并勾选“与 Internet 时间服务器同步”。
解决方案（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）：
```
setcap "cap_net_bind_service=+ep cap_net_admin=+ep" /usr/bin/v2ray
```
  /usr/bin/v2ray 是大部分 Linux 发行版安装V2Ray 的地方，如果不是（例如您已经使用安装脚本安装了 V2Ray），请替换 /usr/bin/v2ray 并使用您的 V2Ray 核心二进制路径。
- 对于 Arch Linux 用户：尝试 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 版本上支持

然而，由于微软出现了一个问题 (opens new window) (可能也类似于这个原因 (opens new window))，如果连接名称包含非 ASCII 字符，代理设置将无法工作...
- 一个方法是重命名连接，并确保新名称只包含 ASCII 字符。

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

原因：macOS 上的权限问题。

解决办法

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

# 行为和外观问题

# Windows 启用 HiDPI 后字体渲染不好看

使用 qv2ray.exe -platform windows:fontengine=freetype 来启用 FreeType 渲染，可以将吃参数添加在 Qv2ray 的快捷方式中：

图片.png

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

原因：这是个上游 Bug
解决办法：GNOME 不支持托盘图标。所有托盘图标都是第三方开发者或部分 Linux 发行版的拓展组件。您可以使用以下命令作为临时解决方案
```
$ nohup gnome-shell --replace &
```

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

给 Gnome 用户的提示

原生的 GNOME 桌面无法显示托盘图标。所以 Qv2ray 托盘图标也无法显示。如果您想要显示托盘图标，您可以安装一个叫做 gnome-shell-extension-appindicator (opens new window)（也叫 ubuntu-appindicator）安装扩展后，您应该注销，再次登录然后在 Tweaks 中启用拓展（即 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 之后可能会有对于移动平台的支持。