安装 Cloudflare 版

Cloudflare 版是为 WebAssembly 构建的同一面板，由六个 Cloudflare Workers 和一个 D1 数据库运行，无需在自有 Linux 服务器上运行二进制文件。运行一条命令 mistgate edge deploy 即可在 Cloudflare 账户中创建所有内容。节点仍然是你自己的服务器，照常从管理后台添加。本页介绍如何从 Cloudflare 账户开始，在管理后台创建所有者账户。示例使用 panel.example.com。

要求#

创建 API 令牌#

命令会使用你创建的令牌访问 Cloudflare API。在 Cloudflare 控制面板中打开「我的个人资料 → API 令牌 → 创建令牌 → 创建自定义令牌」（My Profile → API Tokens → Create Token → Create Custom Token），并授予以下权限：

在账户资源（Account Resources）中选择你的账户，在区域资源（Zone Resources）中选择该主机所属的单个区域。

只能通过环境变量 CLOUDFLARE_API_TOKEN 向命令提供令牌。没有对应标志，因此令牌不会出现在进程列表中；命令也不会将它写入密钥文件或 Cloudflare。在错误信息中，令牌会替换为 [REDACTED]。在 bash 中，下面的命令也不会将它写入历史记录；在 PowerShell 中使用 $env:CLOUDFLARE_API_TOKEN = "..."：

read -rs CLOUDFLARE_API_TOKEN && export CLOUDFLARE_API_TOKEN

只有你计算机上的命令会使用令牌；已部署的面板不会收到它。完成后在控制面板中删除令牌，下次部署时重新创建。

部署#

先查看计划。--dry-run 只会读取 Cloudflare 中的信息（令牌、区域、现有脚本和数据库），检查发布包并输出实际运行时将执行的操作。不会创建文件，也不会更改 Cloudflare：

mistgate edge deploy --host panel.example.com --dry-run

然后正式运行：

mistgate edge deploy --host panel.example.com

面板由六个 Worker 组成。只有第一个绑定域名；其余的没有自己的地址，通过它访问：

• <name>，前端 Worker：不含 WebAssembly 的小型路由。它按路径把每个请求转给其他 Worker，并拥有节点 Agent 所连接的 Durable Objects。
• <name>-public：订阅、用户页面和伪装站点。
• <name>-link：面板一侧的 Agent 连接处理。
• <name>-admin：管理后台及其 API。只有它会在空数据库上创建面板。
• <name>-jobs：由 cron 触发器每分钟启动的任务。
• <name>-provision：通过 SSH 安装节点。

六个 Worker 共用同一个 D1 数据库。

命令会按以下顺序执行这些步骤，并在首次失败时停止：

1. 下载发布包并验证签名。
2. 检查令牌，并查找主机所属的账户和区域。
3. 如果已有同名 Worker 脚本或 D1 数据库，但缺少密钥文件，则拒绝继续：命令不会接管或替换无法使用自身密钥打开的内容。
4. 写入密钥文件（见下文），然后才创建任何内容。
5. 创建 D1 数据库。
6. 按以下顺序上传六个脚本：link、provision、public、admin、jobs，最后上传前端 Worker，这样被绑定的脚本总是先于绑定它的脚本存在。第一次部署时，前端 Worker 会先于所有脚本上传，并且不绑定其他脚本，因为 link Worker 要绑定它的 Durable Objects；最后它会带着这些绑定再上传一次。管理后台静态文件随 public 和 admin 一起上传。密钥随各个脚本一并上传：运行面板的五个脚本都使用 MASTER_KEY；管理后台私密路径、订阅私密路径和设置令牌的哈希值只给 admin。内容与上次运行相同的脚本不会再次上传。
7. 每个脚本上传后立即关闭它的 workers.dev 名称和预览 URL，在 jobs 脚本上设置每分钟运行一次的 cron 触发器，并将 panel.example.com 作为自定义域名绑定到前端 Worker。Cloudflare 会创建 DNS 记录和证书。
8. 最多等待五分钟，直到 https://panel.example.com/ 上的伪装页面响应，然后输出链接。

六个脚本的 Workers Logs 都会关闭。

密钥文件#

命令会在当前目录中写入 mistgate-edge-<name>.json（使用默认名称时为 mistgate-edge-mistgate-edge.json），并输出完整路径。该文件保存所有无法从 Cloudflare 读回的内容：面板的主密钥、管理后台和订阅的私密路径、设置令牌，以及账户、区域和数据库的 ID。更新之后，它还记录每个脚本更新前的版本，用于回滚。

在 Linux 和 macOS 上，文件权限为 0600。在 Windows 上不会强制设置权限：文件会继承所在文件夹的权限，因此将其保存在私密文件夹中（命令会对此发出警告）。使用 --resume 时，当前运行目录中必须有此文件；setup-link 需要传入该文件的路径。

如果运行中途停止（网络错误、Ctrl+C 或 Cloudflare 错误），已完成的更改不会回滚，密钥文件也会保留。解决问题后，使用 --resume 重新运行相同的命令：它会读取密钥文件和其中记录的发布包版本，并继续使用相同的密钥和设置令牌；已经上传的脚本不会再次上传。若不使用 --resume，发现密钥文件时会将此运行视为更新（见下文）。

部署完成后#

命令会输出密钥文件位置、管理后台地址（https://panel.example.com/ 加上 24 个随机字符组成的私密路径）和一次性设置链接：

Admin URL: https://panel.example.com/<secret path>/
Setup link (one-time; the token is valid for 30 minutes from the panel's first start): https://panel.example.com/<secret path>/setup#<token>

与 VPS 面板的私密路径模式一样，管理后台地址本来就是私密的：其他人打开主机时只会看到伪装站点。妥善保管该地址；密钥文件中也保存了它。

在浏览器中打开设置链接并创建所有者账户，操作方式与安装面板（第 8 步「首次登录」）相同。首次请求或首次 cron 触发时，面板会启动；实际通常在上传后一分钟内启动。此时令牌开始计时，30 分钟后过期。# 后面的部分不会发送到服务器。

如果链接过期，或在账户创建前关闭了页面：

• mistgate edge setup-link --file mistgate-edge-mistgate-edge.json 会再次输出已保存的链接。它使用同一个令牌，因此可找回丢失的链接，但无法续期已过期的链接。
• 要获取新令牌，不使用 --resume，再次运行 mistgate edge deploy --host panel.example.com：它会重新上传相同的发布包并生成新设置令牌。只有尚未创建管理员时此方法才有效；面板已有所有者后，设置链接不会执行任何操作。

如果输出的最后一行说主机尚未响应 HTTP 200，Cloudflare 可能仍在为自定义域名签发证书。部署本身已完成；几分钟后再打开链接。

添加节点#

像使用 VPS 面板一样，在节点 → 添加节点中添加节点；见添加节点。此版本也支持通过 SSH 安装，差异如下（详情见通过 SSH 安装节点）：

• 面板从 Cloudflare 网络连接新服务器，因此安装期间，服务器上的 SSH 必须接受来自互联网的连接，而不只是你自己的地址。
• 面板会拒绝属于 Cloudflare 或由其代理的地址、私有网络地址，以及只能通过 VPN 访问的服务器。向导会显示「面板网络拒绝了此地址，或无法从该网络访问服务器」。使用服务器自己的公网地址，或仅使用 DNS 解析的名称。
• 如果 SSH 无法以这种方式访问，或服务器只接受 SSH 密钥，使用手动安装命令。向导会在错误旁提供该选项。Agent 主动连接面板，因此只要网络可以访问 panel.example.com，就能使用。

此版本中尚不可用的功能#

在下列位置，管理后台会显示「Cloudflare 版暂不可用」；尝试启动此类操作时也会返回相同提示。其余功能与 VPS 面板相同：节点、协议配置、用户、订阅、用户页面、节点诊断和 SSH 安装。

此版本中与设备相关的限制：

• 每台设备在每个节点上都有自己的密钥，而面板把发给节点的内容记在 D1 的一行里，D1 限制这一行不超过 2 MB。这大约相当于每个节点 38,000 个凭据，即每人使用两个订阅链接协议、平均 2.5 台设备时约 7,500 人（设备还没有各自密钥时约为 19,000 人）。该行超过 1.5 MB 时，面板会在日志中对每个节点警告一次。
• 每小时的清理多调用一次 D1（清除已删除的旧设备）。

此版本也不支持从面板注册 WARP 账户；操作会失败并显示「此版本无法注册 WARP」，但管理后台暂时不会标明这一点。

更新#

下载较新的 mistgate（或传入 --version vX.Y.Z），然后在密钥文件所在目录中，使用相同的 --host 和 --name 再次运行命令；不要添加 --resume：

mistgate edge deploy --host panel.example.com

命令会读取密钥文件，因此密钥、数据库和私密路径都会保留。它会上传内容有变化的脚本（不涉及前端 Worker 的发布不会重启 Agent 的连接）、应用新的 Durable Object 迁移并生成新设置令牌；可以忽略该令牌（因此 admin 每次都会上传）。如果发布包比当前部署的版本旧，命令会在上传前拒绝操作。前端 Worker 替换期间，已连接的 Agent 会自行重新连接，正在进行的 SSH 安装会重试（第三次中断后失败）。密钥文件会更新为新发布包的版本；主密钥不变，因此先前备份的文件仍可用于解密所有内容。先阅读发布说明：数据库没有可供回退的备份，回滚也不会改动数据库。

回滚#

如果更新后工作不正常，在密钥文件所在目录中运行：

mistgate edge deploy --host panel.example.com --rollback

更新上传任何内容之前，命令会把六个脚本各自的当前版本和 cron 计划记入密钥文件。--rollback 通过 Cloudflare 的部署功能恢复它们：先恢复前端 Worker，再按上传的相反顺序恢复其他脚本，并恢复 cron 计划。它使用同一个令牌，不需要发布包，也不上传任何内容；与 --dry-run 一起使用时只列出将要恢复的内容。上次更新新建的脚本没有旧版本，保持原样。

• D1 数据库不会回滚。发布版本只应通过添加内容来更改数据库结构，因此更新前的版本仍可在其上运行。
• 只能回到上一次更新：密钥文件只保留上一个新发布包之前的版本。首次部署之后无处可回。
• 下一次 mistgate edge deploy 会重新上传全部六个脚本。

在 VPS 面板和 Cloudflare 版之间迁移#

目前尚不支持。无法将用户、节点和订阅链接从 VPS 面板迁移到 Cloudflare 版，或反向迁移：VPS 面板的备份归档不能在 Cloudflare 版恢复，节点也无法更改为连接新的面板地址。为新集群选择合适版本，或者计划重新创建用户并重新注册每个节点。支持双向迁移并保留有效订阅链接的功能仍在计划中，尚未实现。

命令停止时#

后续阅读#

添加节点，然后创建首批用户。除上文列出的功能外，使用指南中的其他页面都适用。各部分的配合方式见架构。