Добавьте Studio в аккаунт Cloudflare вашей компании
Если домен вашей компании уже управляется через Cloudflare, Studio можно разместить в том же аккаунте, рядом с вашим сайтом. Он получает собственный бесплатный адрес workers.dev и, если хотите, новый поддомен вашего домена. Ваш сайт и его DNS-записи остаются в точности такими, как были.
- Лучше всего подходит для
- Компаний, домен которых уже управляется через Cloudflare.
- Что понадобится
- Maxisnap для Windows или Mac с выполненным входом в аккаунт, у которого есть Studio; данные для входа в аккаунт Cloudflare вашей компании, с которыми можно добавлять Workers, или человек, который отвечает за этот аккаунт; а также ИИ-ассистент для программирования на вашем компьютере или терминал с Node.js 20 или новее.
- Время
- Около 20 минут в первый раз.
- Что вы получите
- Studio на собственном адресе workers.dev, а также на новом поддомене, например snaps.yourcompany.com, если он вам нужен. Ваш сайт остаётся в точности таким, как был.
- Стоимость
- Studio рассчитан на работу в бесплатном тарифе Cloudflare. Cloudflare публикует актуальный бесплатный объём и цены R2.
Что Studio добавляет и что оставляет нетронутым
Studio добавляет
- Само приложение Studio (в Cloudflare его называют «Worker»)
- Хранилище для ваших снимков («R2 bucket»)
- Небольшая база данных для вашей библиотеки и команды («D1»)
- Его адрес на workers.dev, а также один новый поддомен, если вы его выберете
- Имя workers.dev для вашего аккаунта, если его ещё нет (одно имя на весь аккаунт)
Studio не затрагивает
- Ваш сайт и его файлы
- Существующие DNS-записи ваших доменов
- Любые другие Workers, хранилища или базы данных
- Ваши платёжные данные и остальные настройки аккаунта
Если имя уже занято, Studio выбирает другое или просит вас это сделать; он не заменяет то, что уже существует.
Если за ваш Cloudflare или сайт отвечает кто-то другой, сначала согласуйте это с ним. В некоторых компаниях действуют правила о том, кто может добавлять сервисы в аккаунт компании, или перед каждым поддоменом ставят страницу входа, которая блокировала бы загрузки из Maxisnap.
Передайте техническое описание тому, кто отвечает за ваш Cloudflare.
Проверьте, что хранилище включено
Studio хранит ваши снимки в Cloudflare R2. Войдите в аккаунт Cloudflare вашей компании и один раз проверьте это:
- В панели управления Cloudflare откройте Storage & databases → R2 → Overview.
- Если Cloudflare предложит добавить R2, завершите оформление заказа. Если вы не отвечаете за оплату в этом аккаунте, попросите ответственного выполнить этот шаг.
Панель управления Studio показывает, сколько хранилища вы используете. В документации Cloudflare по R2, прочитанной в октябре 2026 года, сказано, что начать работу с R2 можно бесплатно, с включённым бесплатным ежемесячным объёмом использования, а счета за использование выставляются ежемесячно.
Скачайте Studio на свой компьютер
- В Windows: в Maxisnap откройте Настройки → Аккаунт → Мастер настройки Studio, нажмите «Начать работу», затем «Скачать панель управления». Maxisnap сохраняет ZIP-архив Studio в папку «Загрузки» и открывает эту папку.
- На Mac: в Maxisnap откройте Settings → Welcome & Help → Studio Setup Guide, нажмите «Get Started», затем «Download Dashboard». Maxisnap сохраняет ZIP-архив Studio в папку «Загрузки».
Распакуйте ZIP-архив. В Windows щёлкните его правой кнопкой мыши и выберите «Извлечь все». На Mac дважды щёлкните его.
Хотите, чтобы ваш логотип и цвета были с самого начала? Дважды щёлкните «Maxisnap Studio - Start Here.html», настройте оформление и нажмите «Lock in my branding». Ассистент использует его. Или пропустите этот шаг и измените оформление позже в панели управления в разделе Branding.
Определитесь с адресом
Studio всегда получает адрес workers.dev, который работает с самого начала. Можно добавить и новый поддомен вашего домена, например snaps.yourcompany.com, если этот домен активен в данном аккаунте Cloudflare.
Ваш адрес будет выглядеть так: snaps.yourcompany.workers.dev
Свой домен можно добавить позже, ничего не потеряв.
Передайте это ИИ-ассистенту
- Откройте ИИ-ассистент для программирования: Claude Code, Codex, Cursor или другой, который может выполнять команды на вашем компьютере.
- Скопируйте готовые инструкции из руководства по настройке с ИИ-ассистентом, замените строку в угловых скобках на вашу папку Studio и вставьте их в своего ассистента.
- Скажите ассистенту, что ваша компания уже использует Cloudflare и нужен ли вам поддомен. Он читает файл с инструкциями в папке Studio и объясняет каждый шаг, прежде чем его выполнить.
Создайте ключ Cloudflare, когда его запросит ассистент
Для развёртывания нужно разрешение работать в вашем аккаунте. Вы даёте его с помощью токена API Cloudflare, который работает как пароль для этой единственной задачи.
- В 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 показывает токен только один раз, поэтому сразу скопируйте его.
- Когда ассистент запросит токен, вставьте его в терминал сами, а не в чат.
Откройте страницу API Tokens в Cloudflare.
В техническом описании объясняется, для чего используется каждое разрешение. Когда ваш Studio заработает, токен можно удалить; для последующего обновления или удаления Studio понадобится новый токен.
Проверьте план, затем создайте Studio
Пока вы не скажете «да», ничего не создаётся. Сначала ассистент запускает план и показывает его вам. В списке «Will create» — один Worker, одно хранилище R2 и одна база данных D1, а также ваше имя workers.dev, если оно новое, и ваш поддомен, если вы его выбрали. В списке «Will not touch» — ваши домены и DNS, другие ваши Workers, хранилища и базы данных.
- Если в плане показана проблема, например имя, которое уже используется, выберите другое имя и снова запустите план.
- Когда план вас устраивает, скажите ассистенту приступать. Если развёртывание остановится на полпути, повторный запуск той же команды продолжит его, и ничего не будет создано дважды.
Сохраните ключ администратора
- Когда всё готово, развёртывание один раз показывает адрес вашего Studio и его ключ администратора. Храните ключ в надёжном месте, например в менеджере паролей. С его помощью вы входите в панель управления, и любой, у кого он есть, может пользоваться вашим Studio.
- Оно также записывает файл deployment.json в папку cloudflare. Сохраните этот файл: он понадобится, когда вы будете обновлять или удалять Studio.
Подключите Maxisnap и попробуйте
- Maxisnap для Windows: откройте Настройки → Аккаунт → Мастер настройки Studio, нажмите «Начать работу», затем нажимайте «Далее», пока не дойдёте до шага 4 — «Подключите Maxisnap». Вставьте адрес вашего Studio и ключ, нажмите «Проверить подключение», затем «Далее», а на последней странице — «Завершить и сохранить». Подойдёт ключ администратора, полученный при настройке, а также код загрузки из раздела People & access в вашей панели управления.
- Maxisnap для Mac: откройте Settings → Welcome & Help → Studio Setup Guide и выберите «I already have a dashboard». Вставьте адрес вашего Studio и ключ, нажмите «Test Connection», затем «Next», затем «Finish & Save».
Сделайте снимок и нажмите «Загрузить» в редакторе. В Windows сочетание Ctrl+Alt+7 выполняет захват области и сразу загружает снимок. Ссылка для общего доступа оказывается в буфере обмена.
Maxisnap для Windows и Maxisnap для Mac отправляют каждую загрузку в Studio на Cloudflare одним запросом, а Studio принимает такие запросы для файлов размером до 25 МБ.
Что дальше: добавьте свою команду в панели управления в разделе 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 работает
Maxisnap блокируется настройкой безопасности Cloudflare на этом поддомене: 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.
Включите R2 в панели управления Cloudflare, как на шаге 1, затем попросите ассистента снова запустить план.
Имя 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 ещё включает адрес. Подождите несколько минут, затем снова откройте адрес.
Вы потеряли ключ администратора
Ассистент может задать новый ключ. Он запускает эту команду из папки cloudflare в пакете Studio, указав токен Cloudflare в терминале. Команда показывает новый ключ один раз; затем снова подключите Maxisnap с этим ключом.
node deploy/cli.mjs update --record deployment.json --yes --new-admin-key Большие видео не загружаются
Maxisnap для Windows и Maxisnap для Mac отправляют каждую загрузку в Studio на Cloudflare одним запросом, а Studio принимает такие запросы для файлов размером до 25 МБ.
Следите, чтобы записи были меньше этого размера, или обрежьте их перед загрузкой.
Maxisnap сообщает, что ключ неверный
Скопируйте ключ ещё раз из того места, где вы его сохранили, без пробелов до и после него. Проверьте и адрес: это адрес, который вам показала настройка, он начинается с https://.
Нужна дополнительная помощь?
Напишите нам, и вам ответит человек, обычно в течение одного рабочего дня. Эти сведения помогут нам ответить с первого раза:
- Выбранный вами вариант настройки и шаг, на котором вы находитесь.
- Скриншот экрана, на котором целиком видно любое сообщение об ошибке.
- Где будет работать ваш Studio: новый или существующий аккаунт Cloudflare либо название вашего хостинг-провайдера.
- Ваша версия Maxisnap: в Windows — Настройки, затем О программе; на Mac — Maxisnap, затем About Maxisnap.
Пожалуйста, не присылайте ключ администратора, ключ Cloudflare или пароль. Они не нужны нам, чтобы вам помочь.
Другие руководства по настройке
- У меня нет сайта
Разместите Studio в бесплатном аккаунте Cloudflare
- У меня есть веб-хостинг
Установите Studio на свой веб-хостинг
- Всё настроит мой ИИ-ассистент
Поручите настройку Studio вашему ИИ-ассистенту
- Я веб-разработчик
Настройка Studio для веб-разработчиков
- У меня уже есть Studio
Подключите Maxisnap к вашему Studio