# 使用插件

  • 本页主要说明 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 成功启动了(证明的确是插件的问题),请同上述方法报告问题。