Quantumult X 是一个强大的代理管理工具,用于管理和配置各种代理服务器(如 Socks代理、HTTP代理、DNS-over-HTTPS 等),以下是一些使用 Quantumult X 的基本指南和常见操作的步骤:
安装 Quantumult X
Quantumult X 可以通过以下方式安装:
- Linux(支持 Ubuntu、CentOS 等)
- Windows
- macOS
在 Ubuntu 上安装:
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/quantumult.gpg] https://deb.quantumult.com/ bionic main" > /etc/apt/sources.list.d/quantumult.list sudo apt update sudo apt install -y quantumult
在 Windows 上安装:
下载并安装 Quantumult X 的最新版本,从 官方网站 获取。
在 macOS 上安装:
使用 Homebrew:
brew install --cask quantumult
配置 Quantumult X
Quantumult X 的配置文件通常位于 /etc/quantumult/quantumult.conf 或 ~/.config/quantumult/quantumult.conf。
示例配置文件:
# 代理配置 socks-proxy-server 127...1:108 # HTTP 代理配置 http-proxy-server 127...1:3128 # DNS-over-HTTPS 配置 dns-over-https-server 127...1:853 # 自定义插件配置 # 加载自定义插件(放在插件目录中,如 /usr/lib/quantumult/plugins) plugin /usr/lib/quantumult/plugins/my_plugin.so # 其他设置 log-file /var/log/quantumult.log
保存并退出编辑器。
启动和停止 Quantumult X
- 启动:
sudo systemctl start quantumult # 或 quantumult start
- 停止:
sudo systemctl stop quantumult # 或 quantumult stop
管理代理
Quantumult X 提供了命令行工具来管理代理。
列出当前配置的代理:
quantumult list
查看代理详情:
quantumult show [代理名称]
删除代理:
quantumult delete [代理名称]
启用/禁用代理:
quantumult toggle [代理名称]
监控和日志
Quantumult X 提供实时监控和日志功能。
查看实时日志:
quantumult logs
查看系统状态:
quantumult status
插件开发与使用
Quantumult X 支持插件机制,用户可以编写自定义插件来扩展功能。
示例插件代码(C++ 实现):
// 插件配置文件(quantumult_plugin.conf)
{
"name": "My Plugin",
"description": "A simple Quantumult plugin",
"version": "1..",
"author": "Your Name",
"license": "MIT",
"main": "main",
"priority": 10
}
编译插件:
# 编译 C++ 源码 g++ -o quantumult_plugin.so -shared -fPIC -I include/quantumult -D Quantumult_API_VERSION=1.. quantumult_plugin.cpp
加载插件:
# 在配置文件中添加插件路径 plugin /path/to/quantumult_plugin.so
集成与自动化
Quantumult X 可以与其他工具集成,
- CI/CD Pipeline:在构建过程中自动切换代理。
- 监控系统:集成到现有的监控工具(如 Prometheus、Grafana)中,实时监控代理状态。
故障排除
- Quantumult X 不响应,可以尝试重启服务。
sudo systemctl restart quantumult
- 如果代理无法连接,检查配置文件是否正确,尤其是代理地址和端口是否正确。
- 如果插件加载失败,检查插件文件路径是否正确,并确保插件与 Quantumult X 版本兼容。
资源与文档




