把 Studio 添加到你公司的 Cloudflare 账户
如果你公司的域名已经在 Cloudflare 中管理,Studio 可以放进同一个账户,与你的网站并存。它会获得自己的免费 workers.dev 地址,如果你愿意,还可以再获得你域名下的一个新子域名。你的网站及其 DNS 记录将保持原样。
- 最好用于
- 域名已经在 Cloudflare 中管理的企业。
- 你需要
- Windows 版或 Mac 版 Maxisnap,并已登录拥有 Studio 的账户;你公司 Cloudflare 账户的登录信息(需有添加 Worker 的权限),或者负责管理该账户的人;以及你电脑上的 AI 编程助手,或装有 Node.js 20 或更高版本的终端。
- 所需时间
- 第一次大约需要 20 分钟。
- 你会得到
- Studio 使用它自己的 workers.dev 地址;如果你想要,还可以再加一个新的子域名,例如 snaps.yourcompany.com。你的网站保持原样。
- 费用
- Studio 设计为可在 Cloudflare 的免费套餐上运行。Cloudflare 公布了 R2 当前的免费额度和价格。
Studio 会添加什么,又不会动什么
Studio 会添加
- Studio 应用本身(Cloudflare 称之为「Worker」)
- 存放你的截取内容的存储空间(一个「R2 存储桶」)
- 供资源库和团队使用的小型数据库(「D1」)
- 它在 workers.dev 上的地址,另外还有一个新子域名(如果你选择了的话)
- 你账户的 workers.dev 名称(如果账户还没有的话;整个账户共用一个名称)
Studio 不会改动
- 你的网站及其文件
- 你的域名现有的 DNS 记录
- 任何其他 Worker、存储或数据库
- 你的账单和账户的其他设置
如果某个名称已被占用,Studio 会改选另一个,或请你另选;它不会替换已有的任何东西。
如果你的 Cloudflare 或网站由别人负责管理,请先与对方确认。有些公司对谁可以向公司账户添加服务有规定,或者在每个子域名前面都设置了登录页面,而这会拦截 Maxisnap 的上传。
确认存储已开通
Studio 把你的截取内容存放在 Cloudflare R2 中。请登录你公司的 Cloudflare 账户,检查一次:
- 在 Cloudflare 控制台中,打开「Storage & databases → R2 → Overview」。
- 如果 Cloudflare 提示添加 R2,请完成它的结账流程。如果你不是该账户的账单所有者,请让对方来完成这一步。
你的 Studio 仪表盘会显示你用了多少存储空间。Cloudflare 的 R2 文档(2026 年 10 月查阅)称,R2 可以免费开始使用,并包含每月的免费用量,而你的用量会按月计费。
在你的电脑上获取 Studio
- 在 Windows 上:在 Maxisnap 中打开「设置 → 账户 → Maxisnap Studio 设置向导」,点击「开始使用」,然后点击「下载仪表盘」。Maxisnap 会把 Studio 的 ZIP 文件保存到「下载」文件夹,并打开该文件夹。
- 在 Mac 上:在 Maxisnap 中打开「Settings → Welcome & Help → Studio Setup Guide」,点击「Get Started」,然后点击「Download Dashboard」。Maxisnap 会把 Studio 的 ZIP 文件保存到「下载」文件夹。
解压这个 ZIP 文件。在 Windows 上,右键点击它并选择「全部解压缩」。在 Mac 上,双击它。
想从一开始就用上你的 Logo 和颜色?双击「Maxisnap Studio - Start Here.html」,设计你的品牌并点击「Lock in my branding」。你的助手会使用它。你也可以跳过这一步,以后再到仪表盘的「Branding」中更改品牌设置。
确定地址
Studio 总会获得一个 workers.dev 地址,一开始就能使用。如果你的域名在这个 Cloudflare 账户中处于有效状态,你还可以再添加该域名下的一个新子域名,例如 snaps.yourcompany.com。
你的地址会是这样的:snaps.yourcompany.workers.dev
以后你可以添加自己的域名,不会丢失任何东西。
交给你的 AI 助手
- 打开你的 AI 编程助手:Claude Code、Codex、Cursor,或其他能在你电脑上运行命令的助手。
- 从 AI 助手设置指南中复制现成的指令,把尖括号中的那一行替换成你的 Studio 文件夹,然后粘贴进去。
- 告诉它你的公司已经在使用 Cloudflare,以及你是否想要一个子域名。它会阅读你的 Studio 文件夹中的指令文件,并在执行每一步之前先作出说明。
等助手要求时,创建一个 Cloudflare 密钥
部署需要获得在你的账户中操作的权限。你通过 Cloudflare API 令牌来授予这个权限,这个令牌就像是只用于这一项任务的密码。
- 在 Cloudflare 中打开「My Profile → API Tokens」,点击「Create Token」,然后选择创建自定义令牌。
- 添加这四项权限:Account Settings Read、Workers Scripts Edit、Workers R2 Storage Edit 和 D1 Edit。
- 如果要使用子域名,请再添加三项:Zone Read、DNS Read 和 Workers Routes Read。
- 在「Account Resources」下,选择你公司的账户。如果要使用子域名,请在「Zone Resources」下选择包含你的域名。
- 点击「Continue to summary」,然后点击「Create Token」。Cloudflare 只会显示一次令牌,所以请立刻复制。
- 当助手要求提供令牌时,请你自己把令牌粘贴到终端中,而不是粘贴到聊天里。
打开 Cloudflare 的 API Tokens 页面。
技术说明里写明了每项权限的用途。Studio 运行起来之后,你可以删除这个令牌;以后更新或移除 Studio 时需要一个新的令牌。
查看计划,然后创建你的 Studio
在你同意之前,不会创建任何东西。你的助手会先生成计划并展示给你。「Will create」会列出一个 Worker、一个 R2 存储桶和一个 D1 数据库,另外还有你的 workers.dev 名称(如果它是新的)和你的子域名(如果你选择了子域名)。「Will not touch」会列出你的域名和 DNS、你的其他 Worker、存储桶和数据库。
- 如果计划中显示出问题,例如某个名称已被占用,请换一个名称,然后重新生成计划。
- 当计划看起来没有问题时,告诉助手可以继续。如果部署中途停止,再次运行同一条命令就会接着往下做,不会重复创建任何东西。
保存你的管理员密钥
- 完成后,部署会显示你的 Studio 地址和它的管理员密钥,而且只显示一次。请把密钥保存在安全的地方,例如你的密码管理器。你要用它登录仪表盘,任何拿到它的人也都可以使用你的 Studio。
- 部署还会在 cloudflare 文件夹中写入一个名为 deployment.json 的文件。请保留该文件,因为以后更新或移除 Studio 时会用到它。
连接 Maxisnap 并试一试
- Windows 版 Maxisnap:打开「设置 → 账户 → Maxisnap Studio 设置向导」,点击「开始使用」,然后一直点击「下一步」,直到第 4 步「连接 Maxisnap」。粘贴你的 Studio 地址和密钥,点击「测试连接」,再点击「下一步」,并在最后一页点击「完成并保存」。设置时得到的管理员密钥可以使用,仪表盘「People & access」中的上传码也可以。
- Mac 版 Maxisnap:打开「Settings → Welcome & Help → Studio Setup Guide」,选择「I already have a dashboard」。粘贴你的 Studio 地址和密钥,点击「Test Connection」,然后点击「Next」,再点击「Finish & Save」。
随便截取一些内容,然后点击编辑器中的「上传」。在 Windows 上,按 Ctrl+Alt+7 可以截取一个区域并立即上传。分享链接会出现在你的剪贴板中。
Windows 版 Maxisnap 和 Mac 版 Maxisnap 会通过一次请求把每次上传发送到 Cloudflare 版 Studio,而 Studio 对每个文件最多接受 25 MB。
接下来:在仪表盘的「People & access」下添加你的团队(每个人都有自己的访问码和角色),并可随时在「Branding」下更改你的 Logo 或颜色。
如果出了问题
该子域名已被占用
snaps.yourcompany.com is already in use (it has DNS records). Pick a name that isn’t used yet; Studio never changes existing DNS.
这个名称已经指向了别处,所以 Studio 不会去动它。请选一个尚未被使用的子域名,例如 studio 或 share。
已有 Worker 路由覆盖了该子域名
The Worker route “*.yourcompany.com/*” on yourcompany.com already covers snaps.yourcompany.com, so Studio would not receive its traffic. Pick another name.
你账户中的另一个 Worker 会响应所有与该路由匹配的子域名,所以 Studio 永远看不到自己的访客。请选一个不在该路由范围内的名称,或者询问设置该路由的人。
Studio 找不到你的域名
That domain is not in this Cloudflare account.
这个域名在另一个 Cloudflare 账户中,或者令牌看不到它。请在持有该域名的账户中创建令牌,并为该域名授予 Zone Read、DNS Read 和 Workers Routes Read 权限。
你的域名被标记为「not active yet」
yourcompany.com is not active on Cloudflare yet, so snaps.yourcompany.com will not work until it is.
Cloudflare 目前还不能为这个域名提供服务,通常是因为它的名称服务器仍然指向你原来的服务商。现在请先使用 workers.dev 地址;以后再添加子域名,不会丢失任何东西。
新子域名还打不开
Cloudflare 开通新子域名可能需要一段时间。workers.dev 地址从一开始就能使用,所以在此之前请先用它。
子域名上的上传失败,但 workers.dev 地址可以正常使用
该子域名上的 Cloudflare 安全设置拦截了 Maxisnap:Cloudflare Access(设在该地址前面的登录页面)、WAF 规则或 Bot Fight Mode。请让负责管理你的 Cloudflare 的人放行 Studio 子域名。技术说明里列出了需要检查的内容。
计划提示无法检查 Worker 路由
Studio could not check the Worker routes on yourcompany.com (the connection has no Workers Routes Read permission).
请给令牌添加 Workers Routes Read 权限。没有它,Studio 就无法判断是否已有其他 Worker 接管了这个新子域名。
存储尚未开通
R2 storage is not turned on for this Cloudflare account yet.
像第 1 步那样,在 Cloudflare 控制台中开通 R2,然后让助手重新生成计划。
Studio 名称已被占用
A Worker named “snaps” already exists in this account. Pick another name; Studio never replaces someone else’s Worker.
告诉助手换一个名称,例如 snaps-yourcompany。如果存储或数据库的名称已被占用,部署工具会自己选用下一个可用的名称。
Cloudflare 拒绝了某一步
Cloudflare refused this step: the connection does not have permission for it. Reconnect Cloudflare and approve every permission Studio asks for.
令牌缺少某项权限。请按照第 5 步中的权限创建一个新令牌,并在助手要求时再次把它粘贴到终端中。
设置中途停止了
请让助手再次运行同一条部署命令。它会从中断的地方接着做,不会重复创建任何东西。
你的新地址还打不开
Studio did not come online in time (HTTP 404). Cloudflare can take a few minutes to publish a new address; try again shortly.
所有内容都已创建;Cloudflare 还在开通这个地址。请等几分钟,然后再次打开该地址。
你丢失了管理员密钥
你的助手可以为你设置一个新密钥。它会在你的 Studio 程序包的 cloudflare 文件夹中运行这条命令,并在终端中使用 Cloudflare 令牌。命令只会显示一次新密钥;之后请用它重新连接 Maxisnap。
node deploy/cli.mjs update --record deployment.json --yes --new-admin-key 大视频无法上传
Windows 版 Maxisnap 和 Mac 版 Maxisnap 会通过一次请求把每次上传发送到 Cloudflare 版 Studio,而 Studio 对每个文件最多接受 25 MB。
请将录制内容控制在该大小以内,或在上传前先将其修剪得短一些。
Maxisnap 提示密钥不正确
请从你保存密钥的地方重新复制一遍,前后不要带空格。也请检查地址:它应该是设置时显示给你的那个,开头是 https://.
仍需帮助?
请给我们发邮件,会有真人回复你,通常在一个工作日内。提供以下信息,可以帮助我们一次性解答你的问题:
- 你选择的设置方式,以及你当前所在的步骤。
- 当前界面的截图,其中如有错误信息,请完整显示。
- 你打算把 Studio 放在哪里:新的或已有的 Cloudflare 账户,或者你的网站托管服务商的名称。
- 你的 Maxisnap 版本:在 Windows 上位于「设置 → 关于」;在 Mac 上位于「Maxisnap → About Maxisnap」。
请不要发送你的管理员密钥、Cloudflare 密钥或任何密码。我们不需要这些就能帮到你。