跳至主要內容
Studio 設定指南 我的公司已經在使用 Cloudflare

將 Studio 加入你公司的 Cloudflare 帳戶

如果你公司的網域已經在 Cloudflare 上管理,Studio 可以放進同一個帳戶,與你的網站並存。它會有自己的免費 workers.dev 網址,如果你想要,也可以另外使用你網域底下的新子網域。你的網站和它的 DNS 記錄都會維持原樣。

最適合
網域已經在 Cloudflare 上管理的企業。
需要準備
Windows 或 Mac 版 Maxisnap,並使用擁有 Studio 的帳戶登入;能新增 Worker 的公司 Cloudflare 帳戶登入權限,或是負責管理該帳戶的人;以及你電腦上的 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 的上傳。

把技術簡介分享給負責管理你 Cloudflare 的人。

確認儲存空間已開啟

Studio 會把你的擷取內容存放在 Cloudflare R2。請登入你公司的 Cloudflare 帳戶,檢查一次:

  1. 在 Cloudflare 儀表板中,開啟「Storage & databases → R2 → Overview」。
  2. 如果 Cloudflare 提供新增 R2 的選項,請完成它的結帳流程。如果你不是這個帳戶的帳務擁有者,就請對方完成這一步。

你的 Studio 儀表板會顯示你使用了多少儲存空間。Cloudflare 的 R2 文件(2026 年 10 月查閱)指出:R2 可免費開始使用,並含有每月免費用量;你的用量則會按月計費。

你會看到的畫面 Cloudflare 的 R2 總覽頁面,其中有將 R2 加入你帳戶的按鈕,如果 Cloudflare 要求,還會有填寫信用卡或 PayPal 的表單。

在你的電腦上取得 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 上,按兩下即可。

想從一開始就使用自己的標誌和色彩嗎?請按兩下「Maxisnap Studio - Start Here.html」,設計你的品牌,再按一下「Lock in my branding」,助理就會採用。你也可以略過這一步,之後再到儀表板的「Branding」中變更品牌設定。

你會看到的畫面 解壓縮後的 Studio 資料夾:三個資料夾(cloudflare、docs 和 snaps)、Start Here 頁面,以及給 AI 助理的指示。

決定網址

Studio 一定會有一個 workers.dev 網址,一開始就能使用。如果你的網域已在這個 Cloudflare 帳戶中啟用,也可以另外加入網域底下的新子網域,例如 snaps.yourcompany.com。

你的網址會像這樣:snaps.yourcompany.workers.dev

之後你可以加上自己的網域,也不會失去任何東西。

交給你的 AI 助理處理

  1. 開啟你的 AI 程式設計助理:Claude Code、Codex、Cursor,或其他能在你電腦上執行指令的助理。
  2. 從說明中心的 AI 助理指南複製現成的指示,把角括號中的那一行換成你的 Studio 資料夾,然後貼上。
  3. 告訴它你的公司已經在使用 Cloudflare,以及你是否想要使用子網域。它會讀取 Studio 資料夾中的指示檔案,並在執行每個步驟之前先說明。

取得現成的指示。

當助理要求時,建立 Cloudflare 金鑰

部署需要取得在你的帳戶中作業的權限。你要透過 Cloudflare API 權杖來授權,它就像是專供這項工作使用的密碼。

  1. 在 Cloudflare 中開啟「My Profile → API Tokens」,按一下「Create Token」,並選擇建立自訂權杖。
  2. 加入這四項權限:Account Settings Read、Workers Scripts Edit、Workers R2 Storage Edit 和 D1 Edit。
  3. 如果要使用子網域,再加入三項:Zone Read、DNS Read 和 Workers Routes Read。
  4. 在「Account Resources」下,選擇你公司的帳戶。如果要使用子網域,則在「Zone Resources」下加入你的網域。
  5. 按一下「Continue to summary」,再按「Create Token」。Cloudflare 只會顯示一次權杖,所以請立刻複製。
  6. 當助理要求提供權杖時,請自己把權杖貼到終端機中,而不是貼到聊天視窗裡。

開啟 Cloudflare 的 API Tokens 頁面。

技術簡介說明了每項權限的用途。Studio 開始運作後,你可以刪除權杖;之後若要更新或移除 Studio,就需要一個新的權杖。

你會看到的畫面 Cloudflare 的權杖頁面:每項權限各有一列,底部有「Continue to summary」按鈕。

檢查計畫,然後建立你的 Studio

在你同意之前,不會建立任何東西。助理會先產生計畫並顯示給你看。「Will create」會列出一個 Worker、一個 R2 儲存貯體和一個 D1 資料庫;另外,如果 workers.dev 名稱是新的,會一併列出該名稱,如果你選擇了子網域,也會列出子網域。「Will not touch」會列出你的網域與 DNS、你的其他 Worker、儲存貯體和資料庫。

  1. 如果計畫顯示有問題,例如名稱已被使用,請改選另一個名稱,並重新產生計畫。
  2. 當計畫看起來正確時,就告訴助理可以繼續。如果部署中途停止,再執行一次相同的指令,就會接著進行,不會重複建立任何東西。
你會看到的畫面 助理會顯示計畫:先是 Studio 網址,接著是「Will create」、「Will not touch」以及任何警告。

保存你的管理員金鑰

  1. 完成後,部署作業會顯示你的 Studio 網址和管理員金鑰,而且只會顯示一次。請把金鑰存放在安全的地方,例如你的密碼管理員。你要用它登入儀表板,而任何拿到它的人都可以使用你的 Studio。
  2. 部署作業還會在 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 版和 Mac 版 Maxisnap 會以單一請求把每次上傳送到 Cloudflare 版 Studio,而它每個檔案最大可接受 25 MB。

接下來:在儀表板的「People & access」中加入你的團隊(每個人都會有自己的代碼和角色),並隨時可以在「Branding」中更改標誌或色彩。

如果發生問題

子網域已被使用

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 版和 Mac 版 Maxisnap 會以單一請求把每次上傳送到 Cloudflare 版 Studio,而它每個檔案最大可接受 25 MB。

請讓錄影檔維持在該大小以下,或在上傳前先修剪錄影長度。

Maxisnap 說金鑰不正確

請從你存放金鑰的地方重新複製一次,前後不要有空格。也請檢查網址:它應該是設定時顯示給你的那一個,開頭是 https://.

還需要協助嗎?

請寄電子郵件給我們,會有真人回覆你,通常在一個工作天內。提供下列資料,能讓我們一次就完整回覆你:

  • 你選擇的設定方式,以及你目前進行到哪一步。
  • 目前畫面的螢幕截圖,並完整呈現任何錯誤訊息。
  • 你打算把 Studio 放在哪裡:新的或現有的 Cloudflare 帳戶,或是你的虛擬主機公司名稱。
  • 你的 Maxisnap 版本:在 Windows 上位於「設定 → 關於」;在 Mac 上則位於「Maxisnap → About Maxisnap」。

請不要把你的管理員金鑰、Cloudflare 金鑰或密碼寄給我們。我們不需要它們就能協助你。

其他設定指南