常见问题

请求头配置
添加配置
隐私
自动更新

什么是 x-duckray- 自定义请求头？

DuckRay 客户端可以读取服务器随订阅文件一起发送的以 x-duckray- 开头的特殊 HTTP 请求头。

如何添加自定义参数？

您可以向客户端传递任何参数（例如规则链接、Telegram 支持联系方式或任何其他文本）。唯一的要求是请求头必须以前缀 x-duckray- 开头。

Remnawave 面板操作指南

  1. 打开订阅部分。
  2. 进入设置。
  3. 找到额外请求头部分。
  4. 输入键 (Key)：以 x-duckray- 开头（例如 x-duckray-faq 或 x-duckray-support）。
  5. 输入值 (Value)：您的文本或 URL。

支持的订阅请求头

DuckRay 客户端读取面板随订阅文件返回的标准 HTTP 请求头。

  • profile-title — 订阅名称，显示在应用中
  • announce — 管理员消息，连接时显示
  • support-url — 支持链接（在应用中显示为按钮）
  • profile-update-interval — 自动更新间隔（小时）
  • subscription-userinfo — 流量信息（upload=...; download=...; total=...; expire=...）
  • x-duckray-* — 管理员自定义参数（见上方卡片）

如何添加配置或订阅？

外部订阅是指向服务器上配置文件的 URL 链接。客户端下载并在需要时自动更新。

如何连接

  1. 复制您的订阅 URL，例如：https://your-server.com/sub/token
  2. 将其粘贴到 DuckRay 客户端的密钥输入字段中。
  3. 客户端将自动下载配置并连接。

直接密钥

如果您没有订阅 URL，可以粘贴单个直接密钥：vless://...、vmess://...、trojan://...、ss://...。这是一次性连接，不支持自动更新。

配置自动更新

如果服务器返回 profile-update-interval 请求头，客户端将按指定间隔（小时）自动更新订阅。

兼容性：外部订阅适用于任何面板（Marzban、3x-ui、Remnawave 等）。配置无需重新连接即可更新。

客户端向服务器发送什么？

每次订阅更新时，客户端会在请求中附加几个请求头。这使管理员可以查看设备统计信息并管理访问权限。

传输的请求头

  • x-hwid — 设备唯一 ID（最多 36 个字符）
  • x-device-model — 设备型号
  • x-device-os — 操作系统（Windows、macOS、Android 等）
  • x-ver-os — 操作系统版本
  • X-App-Version — 应用版本
  • X-App-Platform — 平台（windows、macos、android 等）

如何禁用

可以在客户端设置中禁用 HWID 和设备数据传输：设置 → 禁用「发送 HWID」。

数据不会与第三方共享。只有您面板的管理员才能访问这些信息。

自动更新如何工作？

DuckRay 客户端在每次启动时自动更新配置，如果服务器设置了间隔，也会定期更新。

如何设置自动更新间隔

服务器必须在订阅响应中返回此请求头：

  • profile-update-interval: 12 — 每 12 小时更新一次
  • profile-update-interval: 24 — 每天更新一次

手动更新

点击应用主界面的订阅刷新按钮。配置将无需重新连接即可更新。

如果服务器未返回 profile-update-interval 请求头，则不会执行自动更新。请手动更新。