# 使用插件
- 本页主要说明 Qv2ray 插件系统的使用方法
- 要使用插件,Qv2ray 的版本至少应为
Qv2ray v2.5.0-pre1 BuildVersion: 5264
# 何为插件
从技术上讲,一个 Qv2ray 插件是一个实现了
QvPlugin
接口、从而能扩展 Qv2ray 功能的共享库文件。
Qv2ray 插件扩展了 Qv2ray 的功能,能让你使用更多特性。通过插件,Qv2ray 甚至可以脱离 V2Ray 核心而运行。
当前,Qv2ray 项目组共发布如下 6 个我们维护的插件:
- QvPlugin-SS (opens new window) - 让你能在 Qv2ray 中启用 Shadowsocks SIP003 完整支持
- QvPlugin-SSR (opens new window) - 让你能在 Qv2ray 中使用 ShadowsocksR
- QvPlugin-Trojan (opens new window) - 让你能在 Qv2ray 中使用 Trojan
- QvPlugin-NaiveProxy (opens new window) - 让你能在 Qv2ray 中使用 NaiveProxy
- QvPlugin-Command (opens new window) - 当特殊事件发生时,运行任意指定的命令
- QvPlugin-Trojan-Go (opens new window) - 让你能在 Qv2ray 中使用 Trojan-Go
内置 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. 获取插件
- 部分插件可能会通过包管理系统(如 Scoop)分发,若合意可直接使用。
- 若你已通过此方法安装了插件,接下来请转至 第三步。
- 根据实际的操作系统,从插件的 Release 页面下载。
# 2. 放置插件
- 点击 插件管理器 窗口中的 打开本地插件文件夹 按钮,此时应自动打开一个名为
plugins
的文件夹。 - 将您所下载的插件文件(
.dll
/.dylib
/.so
)放入此目录。 - 关闭 Qv2ray 并重新打开。这将让 Qv2ray 重新扫描插件目录。
# 3. 启用插件
- 打开插件管理器,你将看到所找到的插件。
- 在插件列表中勾选所希望使用的插件即可。
- 某些插件,尤其是核心插件(如 Trojan、ShadowsocksR 等),需要重新启动 Qv2ray 后才会生效。
# 4. 享受!
插件已经可以用了!
# 常见问题
# Qv2ray 没有检测到插件
- 请确认插件位于 Qv2ray 的插件目录(
config\plugins
)下。 - 请确认插件版本与 Qv2ray 版本匹配。目前,
2.0.0
及之后版本的插件需要使用 Qv2rayv2.6.0-rc2
版本。 - 如果问题仍然存在,建议直接向插件提供者进行反映。请包含下面的信息,以助开发者定位您的问题:
- Qv2ray 的详细版本,包括在哪里下载的、具体的版本号和构建号。
- 对应插件的详细版本,有条件的请带上插件文件的
sha256
和md5
。 - Qv2ray 的日志,可以使用
qv2ray(.exe) --debug > log.txt
命令进行收集。
# 插件没有适合我操作系统的文件
通常是插件作者懒得支持你的操作系统,或者:
- 这个插件不适用于你的操作系统:
- 例如:一个针对 Linux 系统的
iptables
设置插件可能就不适合 macOS 和 Windows。
- 例如:一个针对 Linux 系统的
# 插件导致 Qv2ray 崩溃
- 可以试试用
qv2ray(.exe) --noPlugin
禁用所有插件的加载. - 如果 Qv2ray 成功启动了(证明的确是插件的问题),请同上述方法报告问题。