mistgate 文档
中文

状态和路线图

了解 Mistgate 已发布版本的功能、当前测试内容、后续计划、1.0 发布条件，以及当前版本的已知限制。

本页内容

Mistgate 目前处于测试版（Beta）；当前发布版本为 v0.1.43。它已用于生产环境，但在 1.0 之前，API、存储设置和节点协议仍可能发生变化。本文档的其他部分仅描述当前代码的实际行为；计划集中在本页。计划没有日期：「下一步」和「以后」表示顺序，不代表时间安排。

  1. 已发布#

    v0.1.0 – v0.1.43

    以下功能已包含在发布版本和文档中。先介绍当前版本带来的内容，再按管理后台的分区介绍其他内容。

    • 当前版本的新内容#

      v0.1.43
      • 「可达性」成为独立部分，位于运行状况之后：按结论汇总、每个节点在各来源下最近一周的情况、最近 7 天的告警，以及原先位于集成中的三个来源卡片。参见可达性。
      • 用户页面上的订阅类应用 DNS：用户可以为 Happ、Mihomo 类应用、Xray JSON 和 sing-box 自行选择一个 DNS，选项来自你在「订阅 → 用户页面」中提供的预设。服务器上的 DNS 行现在只作用于 AmneziaVPN 密钥。页面上的预设名称跟随页面语言。参见订阅类应用的 DNS。

    • 协议配置#

      • Hysteria2 使用官方核心和 Salamander 混淆。
      • AmneziaWG 2.0 和 3.1，可运行于用户态或内核模块；每个节点可配置多个协议配置。
      • VLESS 使用 xray-core：REALITY 可通过 XHTTP 或 TCP（RAW + Vision）运行，目标可以是节点自己的站点或其他站点；TLS 可通过 XHTTP 或 WebSocket 运行，支持直连或通过 CDN。
      • 同一节点上运行 VLESS 和 Hysteria2，包括 TCP 443。

    • 节点#

    • 用户#

      • 用户和分组：支持按周期统计流量配额、有效期、按设备 ID 区分的设备（设备上限有三种模式），以及每用户和每设备限速。
      • 用户标签页可按任意列排序并显示设备数，支持一次对多个用户执行批量操作。

    • 订阅#

      • 每人一个订阅链接：为 Happ 等应用提供链接列表，为使用 mihomo 内核的应用提供 Mihomo YAML，为使用 Xray 和 sing-box 内核的应用提供 Xray JSON 与 sing-box JSON。
      • 订阅类应用的设备上限有三种模式：仅计数、限制和严格。
      • 用户页面：按平台提供说明、二维码、供 AmneziaVPN 使用的 vpn:// 密钥，以及用户自己的设备；用户可以重命名和删除这些设备，页面上还有复制链接的按钮。
      • 提供 DNS 预设；用户可以在用户页面中为订阅类应用选择 DNS，并为密钥按服务器选择 DNS。

    • 运行状况#

    • 更新#

      • 更新内容：显示你当前版本与可用版本之间的发布说明，语言与界面一致。
      • 签名的节点 Agent 更新：一次更新一个节点，可立即更新或定时更新；更新后检查失败时会自动回滚。
      • 面板可从已签名的 GitHub 发布版本自我更新；新面板无法持续运行时会自动回滚。
      • 单行命令安装面板，并验证发布签名。
      • 可复现发布版本，使用标签离线签名。

    • 集成#

      • API 令牌支持只读、操作员和管理员权限级别。
      • MCP 服务器支持计划 / 执行和所有者审批；AI 智能体指南提供可直接使用的提示词。
      • Telegram 告警会发送给关联聊天的管理员：包括运行状况、发布版本、备份失败、等待审批的计划和登录安全事件。

    • 设置#

      • 管理后台、用户页面、节点安装页面、Telegram 消息和本文档提供英语、俄语和简体中文；支持使用通行密钥或密码加身份验证器验证码登录，可选 Cloudflare Turnstile，并提供审计日志。参见安全。
      • 伪装站点会显示在面板地址上，向陌生人隐藏管理后台。
      • 支持定时将加密备份保存到 Cloudflare R2、设置保留期限，并离线恢复。

  2. 进行中#

    v0.1.34 – v0.1.43

    最新发布版本添加的功能正在生产环境中测试；测试结果用于改进功能和修正文档。

    • 在生产环境中测试 VLESS#

      v0.1.34 起支持 REALITY，v0.1.35 起支持以节点自己的站点为目标，v0.1.36 起支持 TLS 和 CDN。尚未通过真实 CDN 测试 VLESS：端到端测试中由节点自身模拟 CDN。参见 VLESS 通过 CDN 接入。

    • 在生产环境中测试按设备 ID 区分的设备#

      现有面板运行在仅计数模式，因此你可以在切换到限制之前先看到谁超出了上限。参见如何从「仅计数」切换到「限制」。

    • 在生产环境中测试 Xray JSON 与 sing-box JSON#

      默认没有规则下发 Xray JSON：请为需要的应用添加规则，或先在其链接末尾加上 ?format=xray-json 试用。参见下发规则。

    • 在每个节点上使用伪装站点#

      每个节点都可以使用内置站点、面板站点或自己的站点压缩包。v0.1.36 之前创建的节点会继续使用内置页面，直到你选择其他选项。参见自己的伪装站点。

    • 在生产环境中测试国家视角检测#

      所有来源默认关闭。请先开启其中一个，观察「从俄罗斯访问」列，再决定是否依赖它的告警：Globalping 探测点不属于面板，而 listed（在名录中）只是名录中的标记，不是实测结果。参见可达性。

  3. 下一步#

    队列中的下一批计划。

    • 在真实账户上运行 Cloudflare 版#

      预览版

      首次在真实 Cloudflare 账户上运行 mistgate edge deploy：六个 Worker、带域名的路由器和 --rollback。目前只在模拟的 Cloudflare 环境中测试过命令和面板。参见安装 Cloudflare 版。

    • 让 Cloudflare 版具备与 VPS 版相同的功能#

      为六个 Worker 的版本补齐目前尚未提供的功能：

      • 加密备份和恢复；
      • Telegram 告警；
      • MCP 和新 API 令牌；
      • 客户端视角隧道检测；
      • 从管理后台更新节点和面板；
      • 实时节点日志、节点自有站点伪装以及 WARP 注册。

  4. 以后#

    已计划，但尚未进入下一批队列。

    • 提供更多功能的 Telegram 机器人#

      目前机器人只发送告警并关联管理员聊天。未来计划：通过 Telegram 管理集群，并为用户提供机器人。参见 Telegram 告警。

    • 订阅镜像#

      在其他地址保存订阅副本，以便面板地址无法连接时，应用仍能获取订阅。

    • 在 VPS 版和 Cloudflare 版之间迁移#

      在两个版本之间迁移用户、节点和订阅链接，同时保持链接可用。目前要使用另一个版本，需要重新配置集群。参见迁移。

  5. 迈向 1.0#

    1.0 的发布条件。达到这些条件前仍可能有不兼容变更。

    • 固定节点协议和存储设置#

      不同 1.x 版本的面板和 Agent 可以互相理解；面板数据可以在不同版本间迁移，无需手动操作。

    • 测试旧版本升级#

      每个发布版本都通过自动升级测试：从旧版本升级包含数据且连接了节点的面板。

    • 稳定的 API#

      1.x 版本内的 API、API 令牌和 MCP 工具不会发生不兼容变更。参见 API 和 MCP。

已知限制#

  • 如果节点 Agent 没有报告所需能力，客户端视角检测会跳过 VLESS。v0.1.34 之前的 Agent 没有 VLESS 引擎；TLS 协议配置还需要 vless-tls/1（v0.1.36 或更高版本）。
  • 检测端口只从一个位置检测：集群中的另一节点或面板主机。对于 VLESS 端口，它会使用预期名称执行 TLS 握手，不会执行 REALITY 握手。
  • SSH 安装只支持密码登录（包括 keyboard-interactive），不支持密钥登录。此类服务器请使用手动安装。
  • API 令牌和 MCP 无法创建协议配置或分组，也无法将协议配置部署到节点；这些操作由所有者在管理后台执行。
  • 备份只能保存到 Cloudflare R2；恢复时必须离线运行 mistgate backup restore 命令，并指定新的数据目录。
  • 面板不会创建 Cloudflare 账户、存储桶或令牌；你需要提供一个仅限存储桶且具有读取、写入和删除权限的令牌。
  • Cloudflare 版仍处于预览阶段，尚未在真实 Cloudflare 账户上试过，也尚未提供部分功能（参见列表），也无法在 Cloudflare 版和 VPS 面板之间迁移集群。
  • 设备 ID 由应用自己报告。拉黑会拒绝该 ID；报告其他 ID 的应用算作新设备，并占用一个空闲名额。要让被转给他人的链接失效，还需要重新签发一个新链接。
  • 每用户限速按节点计算，因此同时连接两个节点的用户最多可获得上限的 2 倍。v0.1.39 之前的节点 Agent 会把每台设备限制在两个限速中较小的一个。
  • 在 Cloudflare 版中，面板记录的已发送到节点的内容摘要必须放进 D1 的一行（2 MB），约合每个节点 38,000 个凭据。参见此版本的限制。
  • sing-box JSON 没有 XHTTP，也无法按指纹校验自签名的 Hysteria2 证书；Gecko 和 AmneziaWG 只通过 Mihomo YAML 下发。格式无法承载的服务器不会出现在该格式中。参见各格式支持哪些协议配置。
  • 国家视角检测只从少数探测点观察，而不是从每个网络观察，封锁名单也只覆盖俄罗斯。listed（在名录中）表示地址在名录里，不表示它的流量被丢弃。
  • 部分默认值偏向俄罗斯用户（俄罗斯节点使用 Yandex DNS、诊断所用的检测域名、DNS 分流预设）；这些都可以在设置中修改。

在 GitHub 上编辑此页