Qv2ray

# 使用插件

  • 本页主要说明 Qv2ray 插件系统的使用方法
  • 要使用插件，Qv2ray 的版本至少应为 Qv2ray v2.5.0-pre1 BuildVersion: 5264

# 何为插件

从技术上讲，一个 Qv2ray 插件是一个实现了 QvPlugin 接口、从而能扩展 Qv2ray 功能的共享库文件。

Qv2ray 插件扩展了 Qv2ray 的功能，能让你使用更多特性。通过插件，Qv2ray 甚至可以脱离 V2Ray 核心而运行。

当前，Qv2ray 项目组共发布如下 6 个我们维护的插件：

内置 Shadowsocks 支持 vs QvPlugin-SS

一个常见的误解是 Qv2ray 不装 QvPlugin-SS 就用不了 Shadowsocks 节点，这是不对的。Qv2ray 已有来自 V2Ray 内核的 内置 Shadowsocks 支持 (opens new window)，已足以满足一般使用需要。因此，你不必非要安装 QvPlugin-SS。

然而，尽管强烈不推荐，若你仍然头铁坚持要用某些过时的/弃用的加密方式（如性能和安全性都被 aes-128-gcm 和 chacha20-ietf-poly1305 等吊打的臭名昭著的 rc4-md5 加密），你的确需要 QvPlugin-SS 才能使用这些节点。此外，带有 SIP003 插件的服务器（例如 simple-obfs (opens new window), kcptun (opens new window) 和 v2ray-plugin (opens new window)）也需要 QvPlugin-SS 才能运作。

# 插件的获取与使用

你可以下载并启用任意数量的插件。

要安装一个插件，你需要进行下面的操作：

# 1. 获取插件

  1. 部分插件可能会通过包管理系统（如 Scoop）分发，若合意可直接使用。
    • 若你已通过此方法安装了插件，接下来请转至 第三步。
  2. 根据实际的操作系统，从插件的 Release 页面下载。

# 2. 放置插件

  1. 点击 插件管理器 窗口中的 打开本地插件文件夹 按钮，此时应自动打开一个名为 plugins 的文件夹。
  2. 将您所下载的插件文件（.dll / .dylib / .so）放入此目录。
  3. 关闭 Qv2ray 并重新打开。这将让 Qv2ray 重新扫描插件目录。

# 3. 启用插件

  1. 打开插件管理器，你将看到所找到的插件。
  2. 在插件列表中勾选所希望使用的插件即可。
  3. 某些插件，尤其是核心插件（如 Trojan、ShadowsocksR 等），需要重新启动 Qv2ray 后才会生效。

# 4. 享受！

插件已经可以用了！

# 常见问题

# Qv2ray 没有检测到插件

  • 请确认插件位于 Qv2ray 的插件目录（config\plugins）下。
  • 请确认插件版本与 Qv2ray 版本匹配。目前，2.0.0 及之后版本的插件需要使用 Qv2ray v2.6.0-rc2 版本。
  • 如果问题仍然存在，建议直接向插件提供者进行反映。请包含下面的信息，以助开发者定位您的问题：
    • Qv2ray 的详细版本，包括在哪里下载的、具体的版本号和构建号。
    • 对应插件的详细版本，有条件的请带上插件文件的 sha256 和 md5。
    • Qv2ray 的日志，可以使用 qv2ray(.exe) --debug > log.txt 命令进行收集。

# 插件没有适合我操作系统的文件

通常是插件作者懒得支持你的操作系统，或者：

  • 这个插件不适用于你的操作系统：
    • 例如：一个针对 Linux 系统的 iptables 设置插件可能就不适合 macOS 和 Windows。

# 插件导致 Qv2ray 崩溃

  • 可以试试用 qv2ray(.exe) --noPlugin 禁用所有插件的加载.
  • 如果 Qv2ray 成功启动了（证明的确是插件的问题），请同上述方法报告问题。
编辑此页 (opens new window)
上次更新: 2021/1/21 上午8:06:03

⟵ V2Ray 集成 ⟶