Quantumult 配置教程

安装 Quantumult

安装前准备

• 选择部署环境：Quantumult 支持在 Kubernetes 和 Docker 上运行。
  • Kubernetes：适用于生产环境。
  • Docker：适用于开发和测试环境。
• 检查系统要求：确保环境满足 Quantumult 的最低要求，包括 CPU、内存和存储空间。

安装 Quantumult

• 下载镜像：

  • 运行以下命令下载镜像：

    docker pull quantumult/quantumult:latest

• 拉取镜像并启动容器：

  docker run -d --restart unless-stopped --name quantumult \
  -e QUANTUMULT_LICENSE_KEY=your_license_key \
  -p 9002:9002 quantumult/quantumult:latest

  • -e QUANTUMULT_LICENSE_KEY：添加您的许可证密钥。
  • -p 9002:9002：将 Quantumult 的管理界面暴露在本地 9002 端口。
  • --restart unless-stopped：确保容器在故障时自动重启。

• 登录容器：

  docker exec -it quantumult sh

  进入容器后,运行以下命令初始化配置：

  quantumult-control --init

---

配置 Quantumult

配置监听地址

• 默认配置文件路径：/etc/quantumult/quantumult.conf
• 编辑配置文件：

  nano /etc/quantumult/quantumult.conf

  # 监听地址
  listen_on = "...:9002"
  # 虚拟网络接口
  listen_on_vxnet = "vxnet:9001"

高级配置

• 日志级别：

  log_level = "debug"

• 启用 Gvisor：

  enable_gvisor = true

• 网络策略：

  # 允许来自互联网的流量
  default_rule = "allow"

• API 配置：

  # 生成 API 令牌
  quantumult_api_token = "your_api_token"

• 数据持久化：

  data_dir = "/var/lib/quantumult/data"

• 加载配置模板：

  cp /usr/local/quantumult/templates/default.conf /etc/quantumult/quantumult.conf

启用 API 和数据持久化

• 启用 API：

  quantumult-control --enable-api

• 数据持久化：

  quantumult-control --enable-data-persistence

---

使用 Quantumult

登录 Quantumult

• 浏览器访问：
  • 打开浏览器，访问 http://localhost:9002。
  • 使用管理员账号登录。

使用 API

• 生成 API 密钥：

  quantumult-control --generate-api-token

  复制 API 密钥并保存。

• 使用 Python 客户端：

  import quantumult_api
  quantumult_api.init("your_api_token")
  # 查看流量
  print(quantumult_api.get_flows())

使用命令行工具

• 停止服务：

  qctl stop

• 重启服务：

  qctl restart

• 查看状态：

  qctl status

---

故障排除

• 服务无法启动：
  • 检查配置文件语法。
  • 查看容器日志：

    docker logs quantumult

• 网络问题：
  • 确保 Quantumult 有权限访问所需网络接口。
  • 检查防火墙规则，确保 9002 端口开放。