Dokploy: свой Vercel на своём сервере и деплой через Claude Code

Что такое Dokploy простыми словами

Начну с боли, потому что до Dokploy я дошёл именно через неё.

У тебя есть приложение, и на ноуте оно работает. Чтобы его увидели люди, оно должно круглосуточно жить на сервере: с адресом, замочком https, базой и способом обновляться так, чтобы сайт при этом не падал на две минуты. Настроить это руками можно. Но там свой мир из конфигов, портов и прав доступа, и знакомство с ним занимает не один вечер.

Поэтому появились Vercel, Netlify и Heroku. Ты привязываешь репозиторий, пушишь код, и через минуту сайт обновился. Ни одного конфига ты не написал, красота.

Платишь ты за это деньгами и свободой. Код собирается на чужих машинах, база живёт у отдельного вендора, а счёт растёт вместе с трафиком.

Dokploy это та же кнопка «задеплоить», только она стоит на твоём сервере.

Арендуешь VPS за восемьсот рублей, ставишь одну программу, получаешь панель в браузере. Внутри всё то же самое: подключил GitHub, нажал Deploy, посмотрел логи сборки, привязал домен, поднял рядом Postgres. Разница в том, что сервер твой, данные твои, а счёт не зависит от того, сколько людей сегодня зашло.

Магии внутри нет никакой. Dokploy это надстройка над двумя штуками, которые в мире серверов работают уже сто лет:

• Docker запускает приложение в изолированной коробке, чтобы оно вело себя одинаково и на ноуте, и на сервере,
• Traefik принимает запросы из интернета, раздаёт их нужным приложениям по доменам и сам выпускает SSL-сертификаты.

Обе настраиваются руками через конфиги, и ровно на этом ломаются все, кто впервые вышел за пределы «залил файлы на хостинг». Dokploy закрывает их кнопками. Залезть внутрь ты по-прежнему можешь, но в обычный день это не нужно.

Dokploy или Vercel: считаем деньги

Обычно спор про свой сервер ведут лозунгами: свои данные, никакого вендор-лока, свобода. Скучно и никого не убеждает. Давай цифрами.

Vercel Pro стоит $20 в месяц за пользователя, и это только вход. Дальше платишь за потребление: 10 миллионов запросов и 1 ТБ трафика включены, сверху $2 за миллион запросов и $0.15 за гигабайт. Отдельно считаются вызовы функций ($0.60 за миллион), процессорное время ($0.128 в час), минуты сборки, трансформации картинок. Посчитать заранее невозможно, счёт зависит от того, как пойдёт трафик.

VPS стоит фиксированно. Минимум для Dokploy это 2 ГБ памяти и 30 ГБ диска. Беру для примера AdminVPS, там бэкапы уже входят в тариф, а не идут отдельной строкой в счёте:

Promo это ровно минимальные требования Dokploy, впритык. Брать я советую Micro на 4 ГБ. На двух гигабайтах Dokploy живёт, но собирать тяжёлое приложение и одновременно держать базу будет тесно, и первое, обо что ты споткнёшься, это упавшая по памяти сборка.

Разница выходит примерно вдвое, и это только по базовой строке. На Vercel сверху капает оплата за потребление, второй разработчик стоит ещё $20, а базу ты берёшь у отдельного вендора, и это ещё примерно столько же. На своём сервере всё это уже внутри тех же восьмисот рублей: и база, и воркеры, и сколько угодно проектов, и вся команда.

Последняя строка таблицы и есть настоящая цена вопроса. Ты экономишь деньги, но покупаешь ответственность: бэкапы, обновления, место на диске теперь твои. Для пет-проекта, пары клиентских сайтов или небольшого продукта размен отличный. Для проекта, где каждая минута простоя стоит денег, а чинить прод ночью некому, оставайся на Vercel и не выпендривайся.

Ставим Dokploy на VPS

Дальше практика. Понадобится три вещи: сервер, домен и репозиторий с приложением.

1. 01

   Создаём сервер

   В панели провайдера берём машину с чистым Ubuntu. Именно чистым: Dokploy сам поставит Docker и всё остальное, а предустановленные панели вроде ISPmanager будут мешать. Записываем IP и пароль root.

2. 02

   Подключаемся по ssh

   Открываем терминал и заходим на сервер, подставив свой IP:

   ssh root@203.0.113.10

   Если с ssh раньше не сталкивался, этот шаг подробно разобран в гайде про первый сайт на сервере.

3. 03

   Запускаем установку

   Одна команда. Скрипт сам поставит Docker, поднимет Traefik и запустит Dokploy:

   curl -sSL https://dokploy.com/install.sh | sh

   Займёт несколько минут. В конце скрипт напечатает адрес панели.

4. 04

   Заходим в панель

   Открываем http://ВАШ_IP:3000. Dokploy попросит создать первый аккаунт, и это владелец всего сервера. Пароль сохрани по-человечески, а не в заметках на рабочем столе.

Всё, платформа работает. Дальше в терминал можно не возвращаться, остальное делается кнопками.

Первый деплой из GitHub

В Dokploy всё живёт внутри проектов. Проект это папка, куда складываются связанные сервисы: приложение, база, кеш. Жмём Create Project, внутри Create Service и выбираем Application.

Дальше объясняем Dokploy, откуда брать код.

1. 01

   Подключаем GitHub

   В разделе Git настроек подключаем провайдера. Правильный путь это GitHub App: Dokploy проведёт по созданию приложения в твоём аккаунте и попросит выдать доступ к нужным репозиториям.

   Так лучше, чем просто ссылка на репозиторий: GitHub App умеет приватные репы и сам присылает уведомление о пуше. Именно на этом дальше заработает автодеплой.

2. 02

   Выбираем репозиторий и ветку

   На вкладке General выбираем провайдера, свою репу и ветку (обычно main). Если приложение лежит не в корне, а в подпапке, путь указывается в build path.

3. 03

   Выбираем, как собирать

   Тут же Build Type, и это единственное место, где легко накосячить:

   • Nixpacks вариант по умолчанию. Dokploy сам смотрит на проект, понимает, что это Node или Python, и собирает без твоего участия. Для старта берём его.
   • Railpack новый преемник Nixpacks: Node, Python, Go, PHP, статика. Умеет фиксировать версию языка, чтобы сборка не разъезжалась со временем.
   • Dockerfile если в репозитории лежит свой. Полный контроль, и для прода я советую в итоге прийти именно сюда.
   • Static для чистой статики, которую просто раздаёт nginx.
4. 04

   Добавляем переменные окружения

   Вкладка Environment, сюда копируем содержимое локального .env. С версии 0.29.12 Dokploy хранит их зашифрованными на диске (AES-256-GCM), так что это не просто текстовый файлик на сервере.

5. 05

   Жмём Deploy

   Кнопка Deploy, рядом в реальном времени бежит лог. Первая сборка самая долгая: Docker качает базовые образы. Дальше кеш, будет заметно быстрее.

Лог закончился успехом, приложение работает. Но по адресу пока не открывается, мы же не сказали, по какому.

Домен и HTTPS автоматом

Вот этот шаг руками отнимает вечер: настроить nginx, поставить certbot, разобраться с продлением сертификата, не забыть редирект с http. В Dokploy он занимает минуту, потому что этим занимается Traefik.

Сначала направляем домен на сервер. У регистратора (reg.ru, Cloudflare, где покупал) в DNS создаём A-запись: имя @ для корневого домена или, скажем, app для поддомена, значение это IP сервера.

Дальше в приложении открываем вкладку Domains:

• Host это сам адрес, например app.твойдомен.ru,
• Container Port это порт, который слушает приложение внутри контейнера (у большинства Node-приложений 3000),
• HTTPS включаем тумблером,
• Certificate Provider выбираем Let's Encrypt.

Остальные поля (Path, Internal Path, Strip Path, Custom Entrypoint, Middlewares) на старте не трогаем, значения по умолчанию делают ровно то, что нужно.

Сохраняем. Traefik сам сходит за сертификатом, повесит его на домен и настроит редирект с http. Продлевать вручную ничего не надо, он будет обновляться сам, пока жив сервер.

Открываем адрес в браузере. Замочек на месте, сайт живой. Кайф.

База данных в два клика

Второй платёж, который обычно идёт в комплекте с Vercel, это база. Отдельный вендор, отдельный аккаунт, отдельный растущий счёт. В Dokploy база это просто ещё один сервис в том же проекте.

Create Service и выбираем: PostgreSQL, MySQL, MariaDB, MongoDB, Redis или LibSQL. Задаём имя, пользователя, пароль, жмём Deploy. Через полминуты база работает.

А теперь самое важное место во всей статье.

Строку подключения кладём в переменные окружения приложения и передеплоиваем. Всё: приложение и база на одном сервере, за один фиксированный платёж, и ни одного конфига, написанного руками.

Подключаем Dokploy к Claude Code по MCP

До этого места мы собрали обычный self-hosted сетап, каких в интернете полно. А теперь то, ради чего я вообще сел писать эту статью.

В апреле 2026 в версии 0.29.0 у Dokploy появился свой MCP-сервер.

Если коротко, MCP это протокол, по которому агент получает не текстовое описание твоей инфраструктуры, а настоящие инструменты: посмотреть список приложений, запустить деплой, прочитать логи, перезапустить сервис. Агент перестаёт советовать и начинает делать.

Пакет официальный, @dokploy/mcp, генерируется автоматически из OpenAPI-спеки. Поэтому покрытие полное: 508 инструментов в 49 категориях.

1. 01

   Получаем API-ключ

   Место неочевидное, в общих настройках его нет. Жмём на аккаунт в левом нижнем углу интерфейса, оттуда идём в Profile и листаем вниз: ключ там, в самом низу страницы.

   Создаём токен и сразу копируем. Это ключ от всей твоей инфраструктуры: не в репозиторий, не в чат, не в скриншот.

2. 02

   Добавляем MCP-сервер в Claude Code

   Одна команда:

   claude mcp add dokploy-mcp -- npx -y @dokploy/mcp

3. 03

   Передаём адрес и ключ

   Серверу нужны две переменные: адрес твоего Dokploy и токен.

   DOKPLOY_URL=https://твой-dokploy.ru DOKPLOY_API_KEY=твой-токен claude

   Чтобы не вбивать каждый раз, прописываем их в конфиг Claude Code.

Всё, агент видит твой сервер. Теперь можно прямо в разговоре сказать «задеплой main в проекте лендинг» или «покажи, что там с базой», и Claude Code сходит в Dokploy сам.

DOKPLOY_ENABLED_TAGS=project,application,deployment,postgres

Агент сам читает логи и находит то, чего ты не искал

По-настоящему эта связка выстреливает не в момент деплоя, а когда надо понять, что вообще происходит на проде.

Обычный цикл: увидел, что сайт лежит, полез в панель, открыл логи, проскроллил стену текста, нашёл ошибку, вспомнил, в каком файле это лежит, починил, запушил, подождал сборку, проверил. Пять переключений между браузером и редактором, и на каждом ты теряешь мысль.

С подключённым MCP всё иначе. Агент уже сидит в твоём репозитории, а теперь видит ещё и прод. Покажу на живом примере, не придуманном.

Я спросил ровно одну вещь:

Проверь, всё ли живо в ituzovlab, и покажи последние деплои, были ли падения?

Дальше он ушёл работать сам: восемь вызовов в Dokploy, состояние всех контейнеров, история выкаток по каждому сервису.

Само по себе это уже приятно: 51 деплой, ни одного упавшего, последняя выкатка прокатилась по пяти сервисам за 49 секунд. Такой отчёт руками я бы собирал полчаса и на середине бросил.

Но интереснее не отчёт, а то, чем он закончился.

Агент не поленился сверить коды выхода старых контейнеров. Веб вышел с 143, то есть получил SIGTERM и завершился штатно. А воркер стабильно уходит со 137, и это значит, что он сигнал проигнорировал, Docker подождал и добил его силой.

На человеческом это выглядит так: каждая моя выкатка обрывает воркеру задачу на середине. Платёж, отправка письма, синхронизация, что там в этот момент было в работе. Два месяца, 51 деплой, и я об этом не знал.

Вот в чём соль. Я не искал баг. Я спросил «всё ли живо», а получил проблему, которая тихо жила в проде с самого запуска. Руками её видно только если специально пойти сверять коды выхода убитых контейнеров, а туда никто не ходит, пока не рванёт.

Такую проверку стоит гонять регулярно, поэтому вот готовый промпт. Подставь название своего проекта и забирай:

Проверь состояние моего проекта в Dokploy.

1. Все ли контейнеры живы, какой у них аптайм.
2. Пройди историю деплоев: были ли упавшие, что деплоилось последним.
3. Посмотри коды выхода старых контейнеров. Если кто-то уходит по SIGKILL (137), а не по SIGTERM (143 или 0), скажи об этом отдельно: значит процесс не обрабатывает сигнал и его задачи обрываются при каждой выкатке.
4. Проверь свободное место на диске.

Ничего не перезапускай и не деплой, только собери картину.

Работает это и в обратную сторону, когда поломка уже случилась:

Приложение лендинг в Dokploy отвечает 502. Посмотри логи контейнера и последний деплой, найди причину. Если дело в коде, покажи, что править. Ничего не деплой без моего подтверждения.

Агент заберёт логи через MCP, сопоставит их с кодом, который у него перед глазами, и вернётся с диагнозом: не хватило переменной окружения, упала миграция, порт в домене не совпадает с портом приложения.

Отдельно с 0.29 в самом дашборде есть AI-анализ логов и ошибок сборки. Та самая кнопка AI, которую видно на скриншоте лога выше: превращает стену текста в короткое объяснение, что пошло не так, и никакой MCP для этого не нужен.

Только учти, из коробки она не заработает. В настройках Dokploy есть раздел AI, куда надо добавить провайдера и свой API-ключ. То есть за токены ты платишь сам, своим ключом, а Dokploy просто ходит с ним в модель. Своей встроенной нейросети у него нет и денег за неё он не берёт.

Автодеплой: пуш в main и новая версия в проде

Ради этого всё и затевалось. Если GitHub подключён через GitHub App, автодеплой включается одним переключателем Auto Deploy.

Дальше живёшь как на Vercel: пушишь в main, GitHub уведомляет Dokploy, тот забирает свежий код, собирает и подменяет контейнер. Старая версия работает, пока новая собирается, так что сайт не ложится на время сборки.

Если код собирается в GitHub Actions и в Dokploy приезжает уже готовый образ, то вместо этого дёргается webhook: готовый URL лежит на вкладке Deployments.

Грабли, которых нет в документации

Собрал то, на чём спотыкаются чаще всего.

Кончилось место на диске. Самая частая беда. Docker копит образы, слои и старые сборки, и через пару месяцев активной работы 40 гигабайт заканчиваются. Симптом обманчивый: деплой падает с невнятной ошибкой сборки, хотя с кодом всё в порядке. В настройках есть автоочистка Docker, включи её в первый же день. Руками это docker system prune -a по ssh.

Сборка падает по памяти на 2 ГБ. Node при сборке легко съедает больше гигабайта. На минимальной машине процесс убивает система, и в логе ты видишь просто оборванную сборку без объяснений. Лечится тремя способами: взять 4 ГБ, добавить swap или собирать образ в GitHub Actions, а в Dokploy отдавать готовый.

Порт в домене не тот. Приложение слушает 8080, а в настройках домена указано 3000. Traefik стучится не туда и отдаёт 502. Всегда сверяй порт с тем, что реально слушает контейнер.

Порт 80 занят. На сервере уже стоял nginx или Apache, Traefik не поднимается. Либо чистый сервер, либо убираешь конфликтующий веб-сервер до установки.

Приложение не видит базу по localhost. Внутри контейнера localhost это сам контейнер, а не сервер. К базе ходят по имени сервиса, разбирали выше.

Сертификат не выпускается. Почти всегда A-запись ещё не разошлась или показывает не туда. Проверяется командой dig твойдомен.ru +short, она должна вернуть IP сервера. Вторая по популярности причина это Cloudflare в режиме прокси (оранжевое облако), который перехватывает проверку.

Частые вопросы

Dokploy бесплатный? Да, это open-source, и self-hosted версия бесплатна. Платишь только за сервер. Есть отдельная платная enterprise-версия с SSO и корпоративными штуками, но для личных и небольших коммерческих проектов она не нужна.

Сколько проектов влезет на один сервер? Отвечу на своём примере. Машина на 4 ядра, 8 ГБ RAM и 80 ГБ NVMe, на ней крутится:

• семь сервисов лаборатории: фронт, API, воркер фоновых задач, Postgres, сборщик логов, MCP-сервер и телеграм-прокси,
• self-hosted Supabase,
• ещё четыре небольших проекта.

И сервер при этом чувствует себя прекрасно, без всякого героизма. Так что «сколько влезет» зависит не от Dokploy, а от прожорливости твоих приложений. Упрёшься ты в память, за ней и следи.

Чем Dokploy отличается от Coolify? Это ближайший конкурент, задачи почти те же. Dokploy работает поверх Docker Swarm, поэтому проще растянуть на несколько серверов, и у него есть официальные MCP-сервер и CLI. Coolify старше, и готовых шаблонов у него больше. Обе решают одну задачу, дальше дело вкуса.

Нужно ли знать Docker? Для первого деплоя нет, Nixpacks соберёт сам. Но как только что-то пойдёт не так, понимание, что такое образ, контейнер и слой, экономит часы. Это тот минимум, который стоит выучить, а не гуглить каждый раз заново.

Можно ли перенести проект с Vercel без переписывания? Обычно да, если приложение не завязано на фирменные вещи: edge-функции, их KV-хранилище, ISR в верселевском исполнении. Обычное Next-приложение переезжает почти без правок.

Что будет, если сервер упадёт? Ничего хорошего, поднимать его будешь ты. Поэтому сразу настрой в Dokploy регулярные бэкапы базы во внешнее хранилище, S3-совместимое подойдёт любое. Бэкап, который лежит на том же сервере, что и база, это не бэкап.

Что дальше

Теперь у тебя своя платформа: приложение, база, домен с сертификатом, автодеплой и агент, который умеет туда ходить. За фиксированные восемьсот рублей в месяц вместо счёта, растущего вместе с трафиком.

Но Dokploy это одна остановка на большом пути. Рядом всегда стоят вопросы, которые рано или поздно догоняют каждого: почему бесплатные площадки в какой-то момент перестают подходить, как вообще устроен Docker изнутри, куда девать секреты, что делать с базой в проде и как не потерять данные.

Это мы и разбираем в треке «Вайб-деплой»: от первой публикации на GitHub Pages до своего сервера, по шагам и на живых примерах. Тем самым путём, которым задеплоен сайт, который ты сейчас читаешь.

Посмотреть трек «Вайб-деплой»