SSD Nodes Learn Hosting plans →
Руководства Matt ConnorАвтор: Matt Connor

Как запустить Rakazo на своем VPS

Пошаговое руководство по развертыванию Rakazo через Docker Compose. Настройка Node 22, pnpm, Postgres и Graphile Worker. Узнайте требования к ресурсам и выбор песочницы.

Что на самом деле запускает Rakazo при self-hosting

Self-hosting Rakazo означает запуск пяти компонентов на одном Linux-сервере: PostgreSQL, процесса Graphile Worker, API, веб-приложения и контейнера-песочницы, который служит компьютером для ботов. Rakazo — это open-source альтернатива Grok Bot, опубликованная пользователем elie222 под лицензией Apache 2.0. Каждый бот получает собственные диалоги, память, процедуры и историю, использует один Team Computer совместно с другими ботами рабочего пространства (если ему не предоставлен Private Computer) и может создавать узлы-аналоги (peers) или кратковременных субагентов. Если такие слова, как «память», «субагент» и «вызов инструмента» в этом предложении вам незнакомы, сначала стоит потратить день на поэтапное изучение принципов работы агентов, так как большинство настроек ниже станут понятны только тогда, когда вы сможете представить, что делает бот при пробуждении.

Последнее — причина, по которой это решение следует размещать на VPS (виртуальном выделенном сервере), а не на настольном компьютере. Бот, который хранит память и выполняет запланированные задачи, должен быть доступен, пока вы спите. Ноутбук, переходящий в спящий режим, сбрасывает очередь задач.

По состоянию на октябрь 2026 года Rakazo всё ещё находится в стадии бета-тестирования, несмотря на выпуск релизов с номерами стабильных версий, поэтому рассматривайте это как рабочую конфигурацию, а не как готовое к эксплуатации устройство. Весь стек написан на TypeScript: React 19 и Vite для веб-приложения, Hono для API, Postgres с Prisma, Better Auth для управления учётными записями и Graphile Worker для фоновых задач. Graphile Worker хранит очередь внутри Postgres, поэтому Redis или другое хранилище данных не требуются. .env.example устанавливает WAKEUP_DRIVER=graphile, что означает, что пробуждение бота — это задача, поддерживаемая Postgres. Остановите Postgres, и все запланированные действия ботов остановятся вместе с ним. Если вы предпочитаете собрать агента из отдельных частей, а не использовать чужой продукт, существует другой путь: создание собственного агента из компонентов.

Почему тариф с 1 ГБ не подойдет для этой задачи

Посчитайте количество процессов. Postgres — один. API — процесс Node. Воркер — второй. Веб-приложение — третье. Супервизор песочницы — четвертый. Затем идет компьютер ботов: по умолчанию это один общий контейнер Team Computer с графическим рабочим столом Linux, внутри которого для каждого активного бота запускается отдельный X-дисплей и процесс Chrome.

Документация по self-host версии проекта больше не указывает размер хоста. Документация по адресу v0.3.5, проверенная 27 октября 2026 года, содержит только требования к программному обеспечению. Что она действительно указывает, так это ограничение на один компьютер: при использовании Docker-песочниц RAKAZO_COMPUTER_MEMORY по умолчанию составляет 2g, а RAKAZO_COMPUTER_CPUS — 2. Это ограничение применяется к каждому компьютеру, а не к каждому боту. Каждое рабочее пространство по умолчанию получает один Team Computer, и все активные боты Team запускают свои рабочие столы и браузеры внутри него, поэтому все они делят эти 2 ГБ и два ядра. Только бот, перенесенный на Private Computer, получает отдельный контейнер и собственное ограничение. Если установить SANDBOX_PROVIDER=docker, эти рабочие столы переместятся на ваш VPS поверх плоскости управления, поэтому 4 ГБ — это минимальный порог, а не целевое значение. Начинайте с 8 ГБ, если планируете держать активным более одного бота, увеличьте RAKAZO_COMPUTER_MEMORY, чтобы общий компьютер мог фактически использовать эту память, и измеряйте реальные показатели с помощью docker stats во время работы ботов. Именно браузер внутри песочницы определяет потребление памяти, поэтому спецификации вам этого не скажут. Чтобы небольшой сервер не запускал слишком много браузеров одновременно, установите положительное значение SANDBOX_TEAM_SCREEN_LIMIT, которое ограничивает количество активных рабочих столов на Docker Team Computer. В поставке 0 это значение не ограничено. Если памяти в целом не хватает, RAKAZO_COMPUTER_MEMORY также принимает меньшее значение, например 1536m. Общий метод подбора размера сервера для работы агентов описан в сколько оперативной памяти и процессора на самом деле нужно VPS для агента, где подробно рассматривается процесс измерений.

Один параметр предотвращает ухудшение ситуации. .env.example поставляется со значением SANDBOX_IDLE_MS=600000, и в комментарии к нему сказано, что компьютеры приостанавливаются или останавливаются после указанного количества миллисекунд бездействия. Десять минут бездействия — и компьютер переходит в спящий режим. Минимальное допустимое значение — 30000, а 0 отключает спящий режим по бездействию. Тот же комментарий предлагает использовать 0 для Docker self-host установок, где простаивающий компьютер ничего не стоит, поэтому долго работающие приложения и сессии остаются активными. Это верно для денег, но не для памяти. На небольшом VPS оставьте таймер включенным, потому что без него каждый запущенный вами компьютер и каждый браузер внутри него продолжат работать.

Диск также имеет значение. Образ песочницы, модули Node и том Postgres используют один диск, поэтому 40 ГБ — разумная отправная точка.

Фиксация версии перед клонированием

Rakazo развивается быстро, и main не является релизом. По состоянию на 9 ноября 2026 года, v0.8.0, опубликованный 4 ноября 2026 года, является релизом, помеченным как Latest. Данное руководство привязано к версии v0.3.5, опубликованной 25 октября 2026 года.

git clone https://github.com/elie222/rakazo.git
cd rakazo
git checkout f31e3c0699f086d663637c4107858c238a086fb3
git log -1 --format='%H %ci'

Этот коммит — тот самый, на который указывает v0.3.5. Фиксируйте именно коммит, а не ветку или тег. Ветка может измениться под вами при следующем git pull, а тег — это перемещаемая метка, которую сопровождающий может переназначить, поэтому ни то, ни другое не гарантирует возможность вернуться к конкретному состоянию дерева. Идентификатор коммита неизменен. Запишите его рядом с другими параметрами вашего сервера, потому что если обновление приведет к сбою, быстрым решением будет git checkout <old commit> и пересборка, а это сработает только в том случае, если вы знаете, какой коммит был рабочим. В закрепленном README Rakazo называется бета-версией, поэтому такая точная фиксация оправдывает небольшие усилия. Проект с долгой историей стабильных релизов можно фиксировать на опубликованном теге, что и делает небольшой self-hosted стек, такой как openGym.

Системные требования: Node 22, pnpm 9 и Docker

node -v
pnpm -v
docker --version

package.json объявляет "engines": { "node": "^22.22.2 || ^24.0.0 || >=26.0.0" } и "packageManager": "pnpm@9.15.0". Поэтому node -v должен выводить v22.22.2 или более позднюю версию 22.x, любую v24 или v26 и выше. Версия v22 старше 22.22.2 выходит за рамки этого диапазона, а в README прямо указано, что Node.js 23.x и 25.x не поддерживаются. Установите поддерживаемую версию Node через NodeSource или nvm. Corepack поставляется вместе с Node 22 и 24; для Node 26 и выше сначала установите его с помощью npm install -g corepack. Затем активируйте pnpm:

corepack enable
corepack prepare pnpm@9.15.0 --activate

Docker Engine вместе с плагином compose покрывает остальные требования. Документация по self-host требует Docker Engine 26 или новее, API 1.45 или новее для работы с подпутями томов бота, а также наличие curl и OpenSSL. Ваш пользователь также должен иметь доступ к демону. Если docker ps возвращает permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock, добавьте своего пользователя в группу docker и откройте новую сессию входа. Предварительно осознайте последствия: членство в docker эквивалентно правам root на машине, так как любой участник этой группы может запустить контейнер, который примонтирует файловую систему хоста.

Настройка .env и запуск Postgres

cp .env.example .env
chmod 600 .env

Перед запуском необходимо изменить несколько значений. .env.example поставляется с BETTER_AUTH_SECRET=replace-with-32-plus-character-secret, ENCRYPTION_KEY=replace-with-64-random-hex-characters, SCREEN_PROXY_SECRET=replace-with-32-plus-character-screen-proxy-secret и SANDBOX_SUPERVISOR_TOKEN=replace-with-32-plus-character-supervisor-token, оставляя POSTGRES_PASSWORD и POSTGRES_APP_PASSWORD пустыми. Все эти заполнители опубликованы в репозитории, поэтому развертывание с ними означает использование публично известных секретов. Установите для каждого параметра уникальное случайное значение. ENCRYPTION_KEY должно состоять из 64 случайных шестнадцатеричных символов, которые генерирует openssl rand -hex 32. Для остальных секретов требуется 32 или более символов, поэтому выполните команду base64 для каждого из них. Для двух паролей Postgres в документации по self-host рекомендуется использовать URL-безопасные значения; последняя строка генерирует их, поэтому выполните её для каждого пароля. База данных имеет две учетные записи. DATABASE_MIGRATION_URL поставляется как postgres://rakazo:REPLACE_WITH_POSTGRES_PASSWORD@127.0.0.1:5433/rakazo — владелец, выполняющий миграции, а DATABASE_URL как postgres://rakazo_app:REPLACE_WITH_POSTGRES_APP_PASSWORD@127.0.0.1:5433/rakazo — учетная запись приложения, которая не имеет прав суперпользователя и ограничена политиками безопасности на уровне строк (row-level security). Вставьте каждый пароль в соответствующий URL. pnpm db:migrate создает логин rakazo_app с заданным вами паролем.

openssl rand -base64 48
openssl rand -hex 32
openssl rand -hex 24

Затем запустите базу данных отдельно и выполните миграции.

docker compose --env-file .env -f infra/compose/docker-compose.yml -f infra/compose/docker-compose.postgres-host.yml up postgres -d
pnpm install
pnpm db:generate
pnpm db:migrate
pnpm sandbox:build

pnpm sandbox:build собирает образ компьютера бота, определенный в package.json как docker build -t rakazo/computer:local infra/sandboxes/computer. Это графический образ, поэтому первая сборка загружает много данных и занимает время. Убедитесь, что образ создан, с помощью docker image ls rakazo/computer — команда должна вывести одну строку.

Базовый файл compose не публикует порт Postgres. Оверлей docker-compose.postgres-host.yml в этой команде публикует его как 127.0.0.1:5433, доступный только через loopback, чтобы локальные инструменты, такие как pnpm db:migrate и pnpm dev, могли подключиться к нему. Оставьте эту конфигурацию. Compose отказывается запускать Postgres без POSTGRES_PASSWORD в .env, но порт Postgres, доступный из Интернета, подвергает систему атакам на подбор пароля. Файл compose для production считывает ту же переменную и не публикует порт базы данных.

Первый запуск

pnpm dev

Это запускает четыре компонента: API на порту 3100, Graphile Worker, веб-приложение Vite на 5173 и sandbox supervisor на 7091 по умолчанию. Если эти порты заняты, pnpm dev выбирает другой свободный блок и выводит URL-адреса. На стандартных портах приложение доступно по адресу http://127.0.0.1:5173, где вы должны увидеть страницу входа.

На VPS вы не находитесь непосредственно за машиной, поэтому не следует публиковать порт 5173 для доступа к нему. Вместо этого перенаправьте порты через SSH (secure shell) со своей локальной машины.

ssh -L 5173:127.0.0.1:5173 -L 3100:127.0.0.1:3100 you@your-server

Будьте внимательны к различиям в способах запуска. pnpm dev запускает Vite на хосте с привязкой к локальному интерфейсу. Сервис web в файле compose для разработки публикует 127.0.0.1:5173:5173, а сервис api — 127.0.0.1:3100:3100, оба только на loopback, поэтому для них работает один и тот же туннель. В production-файле веб-приложение не публикует порты на хосте и открывает 5173 только для контейнеров в своих сетях, а Caddy единолично публикует порты 80 и 443. Используйте production-файл и его reverse proxy для всего, что оставляете работать постоянно.

Какой sandbox provider безопасен на сервере?

Это единственная настройка, которую нужно выбрать правильно. SANDBOX_PROVIDER в .env по умолчанию имеет значение docker, а закреплённый checkout также поддерживает Railway наряду с providers, перечисленными в self-host doc.

  • docker используется по умолчанию. Компьютеры ботов запускаются как containers на вашей машине, создаются из image, который производит команда pnpm sandbox:build, и запускаются под управлением supervisor. По умолчанию боты одного workspace используют один Team Computer, а собственный container бот получает только на Private Computer. Аккаунт E2B не требуется.
  • e2b запускает компьютеры ботов в E2B и требует E2B_API_KEY. В v0.3.5 factory принимает его в production, если ключ передан, без ограничения NODE_ENV. В self-host doc он назван подходящим для public или multi-user production, поскольку компьютеры ботов не находятся на host, где запущены ваш API и база данных.
  • daytona, createos и boat — это дополнительные remote providers, для каждого нужен собственный ключ: DAYTONA_API_KEY, CREATEOS_SANDBOX_API_KEY или BOAT_API_KEY.
  • railway запускает компьютеры в Railway и требует RAILWAY_API_TOKEN и явно выбранного RAILWAY_ENVIRONMENT_ID на API и worker. Для sandboxes используйте отдельный Railway project или environment.
  • desktop запускает команды бота непосредственно на host API и worker, как сказано в doc. В v0.3.5 API и worker отказываются использовать его, если NODE_ENV не имеет значения development или test, но .env.example поставляется с NODE_ENV=development, поэтому сервер с запущенным pnpm dev всё равно его принимает. Не включайте его в public или shared service.
  • fake — это emulator только для verification. Это не runtime.
  • none запускает product вообще без computer host.

Воспринимайте это буквально. В desktop mode вообще нет границы изоляции, поэтому бот выполняет shell commands от имени пользователя, под которым запущен API process, с home directory этого пользователя, его SSH keys, его cloud credentials и его .env. Текст на web page, которую читает бот, становится командой на вашем сервере. Desktop mode на сервере — это способ, которым бот получает ваши credentials. Используйте его на машине, за которой вы работаете, или не используйте вообще. Переключение providers помещает container вокруг этого пути к web page, но не закрывает его, а выдача боту собственного backend поиска SearXNG охватывает ту же поверхность инъекции со стороны поиска.

docker образует реальную границу между ботами и вашим host, но слабую границу между самими ботами. По умолчанию они используют один Team Computer, а computer runtime doc сообщает, что Team bots используют одного и того же OS user, workspace, browser profiles, а также shell и X11 access, и что отдельные папки ботов организуют работу, но не являются границами безопасности. Поэтому любой Team bot может читать файлы другого Team bot. Бот, которому нужны собственные границы, должен работать на Private Computer, который docker provider запускает как отдельный соседний container в собственной сети. Однако supervisor, создающий эти containers, монтирует /var/run/docker.sock, и self-host doc прямо говорит: доступ к этому socket равнозначен контролю над Docker host. Поэтому supervisor должен оставаться закрытым. .env.example рассматривает SANDBOX_SUPERVISOR_TOKEN как отдельный credential, отличающийся от BETTER_AUTH_SECRET, который требуется Docker sandboxes за пределами local development, и поставляется с placeholder, доступным для чтения всем на GitHub. Задайте для него собственное случайное значение. Для максимально сильного доступного здесь разделения используйте e2b или выделите Rakazo машину, на которой больше ничего нет. По той же причине следует запускать coding agents в disposable VM: самый дешёвый способ пережить ошибку агента — использовать машину, которая ничего не стоит.

Где хранить API-ключи моделей?

Опциональная биллинговая система Rakazo для оплаты кредитов моделей остается отключенной, пока не заданы оба секретных ключа Stripe. Вы используете собственный ключ. .env.example задает PI_DEFAULT_PROVIDER=openrouter, поэтому OPENROUTER_API_KEY является стандартным местом для этого, а ключи провайдеров работают через ту же настройку.

Храните ключ в .env и не добавляйте его ни в один файл, который вы отправляете в репозиторий. Обе команды compose в репозитории передают --env-file .env, поэтому значения попадают в контейнеры, не записываясь в YAML-файлы, отслеживаемые git. Вы также можете оставить OPENROUTER_API_KEY пустым и подключить модель в приложении после регистрации; это еще одна причина, по которой ENCRYPTION_KEY должен содержать реальное случайное значение, а не стандартный заполнитель.

Установите лимит расходов для ключа на стороне провайдера, прежде чем его начнет использовать бот. Бот, попавший в цикл, — это бот, который тратит деньги. Rakazo также предоставляет MAX_TOOL_CALLS_PER_TURN: установите положительное целое число, чтобы принудительно завершить ход, который превышает бюджет вызовов инструментов, сохранив при этом возможность формирования итогового сообщения помощника. Если значение не задано, пусто или равно 0, лимит не применяется. Этот параметр учитывает количество вызовов инструментов, а не денежные средства, поэтому он не заменяет лимит расходов у провайдера. Присвойте этому ключу уникальное имя, чтобы иметь возможность отозвать только его. Если вы настраиваете систему для команды, а не для себя, единый шлюз OneCLI перед агентом каждого пользователя — это другое решение той же проблемы, так как оно позволяет хранить ключи провайдеров в одном месте, а не по одному на каждого человека.

Переход от режима разработки к постоянной работе

В репозитории поставляется production-файл compose, который запускает Postgres, API, worker, веб-приложение и Caddy для автоматического получения сертификатов TLS (transport layer security). Caddy — единственный сервис в этой конфигурации, открывающий порты. По умолчанию для компьютеров ботов используется E2B. Дополнительный оверлей infra/compose/docker-compose.prod.docker.yml позволяет запускать локальные Docker-контейнеры в том же стеке, однако документация предупреждает, что используемый им супервизор обладает правами root на хосте.

sudo --preserve-env=SSH_CONNECTION DEPLOY_USER=deploy bash infra/compose/harden-host.sh
docker compose --env-file .env -f infra/compose/docker-compose.prod.yml \
  build --build-arg GIT_SHA=$(git rev-parse HEAD)
docker compose --env-file .env -f infra/compose/docker-compose.prod.yml \
  up -d --wait --pull never
curl --fail https://app.example.com/health

Создайте учетную запись deploy только с ключом и убедитесь, что можете войти в систему, прежде чем запускать скрипт. harden-host.sh отключает вход по паролю SSH и вход для root, ограничивает частоту попыток подключения SSH, добавляет правила для SSH, HTTP и HTTPS в UFW (uncomplicated firewall) с сохранением существующих правил для частных сетей, а также включает fail2ban, автоматическую установку обновлений безопасности, AppArmor и правила аудита. Скрипт не запустится без SSH_CONNECTION, поэтому команда передает его через sudo. Изменения в файрволе будут отменены, если вы не подтвердите их в новой SSH-сессии в течение трех минут. Прочитайте скрипт перед запуском, так как он меняет настройки входа и перезагружает SSH. Держите консоль провайдера открытой, пока не убедитесь, что вход по SSH работает.

Для production-версии .env требуется больше настроек, чем для версии разработки. В документации по self-host указан этот минимум, а также секретные данные.

NODE_ENV=production
RAKAZO_HOST=app.example.com
BETTER_AUTH_URL=https://app.example.com
WEB_ORIGIN=https://app.example.com
API_URL=https://app.example.com
SIGNUPS_ENABLED=true
SIGNUP_ALLOWLIST=you@example.com
SANDBOX_PROVIDER=e2b
AGENT_RUNTIME=pi
WAKEUP_DRIVER=graphile
DATA_DIR=/data
RAKAZO_DEPLOY_DIR=/srv/rakazo
RAKAZO_IMAGE_TAG=local
POSTGRES_PASSWORD=<random, URL-safe>
POSTGRES_APP_PASSWORD=<random, URL-safe>
BETTER_AUTH_SECRET=<random>
ENCRYPTION_KEY=<64 random hex characters>
SCREEN_PROXY_SECRET=<random>
E2B_API_KEY=<your key>
OPENROUTER_API_KEY=<your key>

Направьте A-запись на сервер перед первым запуском up. Caddy запрашивает сертификат для имени, указанного в RAKAZO_HOST; это имя должно указывать на данный сервер, а порт 80 для HTTP-валидации или порт 443 для TLS-ALPN-валидации должны быть доступны извне. Оба метода проверки включены по умолчанию, поэтому закрытие только порта 80 не помешает выпуску сертификата через порт 443.

С самого начала установите SIGNUP_ALLOWLIST на свой адрес. .env.example поставляется с SIGNUPS_ENABLED=true, и обе настройки считываются из переменных окружения при каждом запуске API. Поэтому экземпляр с публичным именем, включенной регистрацией и пустым списком разрешенных адресов будет принимать регистрации от любого, кто его найдет. Непустой список разрешенных адресов применяется при каждом запуске и заменяет сохраненный список. Регистрация по списку разрешенных требует подтверждения по электронной почте для первой учетной записи, поэтому настройте отправку почты до регистрации. Если почта не настроена, документация предлагает запустить SIGNUPS_ENABLED=false и создать учетную запись с помощью серверной команды bootstrap; это создаст обычную подтвержденную учетную запись без привилегий администратора. Сначала настройте список разрешенных. Позже его можно расширить. Если на сервере уже запущено несколько сервисов и вы хотите использовать один список пользователей вместо отдельного списка для каждого приложения, размещение экземпляра Authentik перед ними перенесет управление доступом на прокси, хотя он будет работать поверх собственных учетных записей Better Auth от Rakazo, а не заменять их.

Используйте docs/self-host.md в репозитории как основной источник настроек для production, так как он меняется вместе с кодом, в отличие от этого руководства. Поскольку работу выполняет Compose, действуют обычные правила, а основы Docker Compose для VPS объясняют, почему --env-file и именованные тома становятся важнее, когда стек работает месяцами без вмешательства.

Резервное копирование

В данной конфигурации данные экземпляра хранятся в Postgres и каталоге data/. Для восстановления также требуются ENCRYPTION_KEY и все настроенные мастер-ключи контента, поэтому храните их копии вне сервера.

./scripts/backup.sh
./scripts/restore.sh backups/BACKUP_TIMESTAMP

backup.sh создает дамп Postgres и архивирует data/. restore.sh работает со стеком разработки Compose, используя пустую базу данных при остановленных сервисах приложения, и не считывает файлы резервных копий с продуктовой среды. Для критически важной машины установите infra/compose/backup-prod.sh как /usr/local/sbin/rakazo-backup с таймером, который поставляется в репозитории. Он записывает проверенный дамп и архив данных приложения в /var/backups/rakazo, сохраняет до трех проверенных снимков по умолчанию (значение задается в RAKAZO_BACKUP_KEEP) в пределах лимита 50 GiB, установленного в RAKAZO_BACKUP_MAX_GB, и очищает частичные снимки и устаревшую историю перед каждым запуском, поэтому ротация происходит автоматически. Инструмент также может шифровать каждую резервную копию с помощью age для публичных получателей, указанных в /etc/rakazo/backup.env, чтобы сервер записывал резервные копии, которые он не может прочитать. Сгенерируйте эту пару ключей на подконтрольной вам машине и храните закрытый ключ вне сервера. Без указания получателей резервная копия остается в открытом виде, а в журналы записывается предупреждение, но после создания первой зашифрованной резервной копии запуск без получателей завершится ошибкой, если вы явно не разрешите использование открытого текста с помощью RAKAZO_BACKUP_ALLOW_PLAINTEXT=1. Резервная копия, хранящаяся на том же диске, что и база данных, не является резервной копией, поэтому копируйте её за пределы сервера. Затем выполните восстановление один раз на запасном сервере, прежде чем это потребуется в экстренной ситуации.

Почему возникают сбои и что вы увидите

pnpm db:migrate не может подключиться к базе данных. Миграция сообщает, что не удается связаться с сервером базы данных по адресу 127.0.0.1:5433. Либо контейнер Postgres не запущен, либо он запущен, но еще не готов к работе, либо он был запущен без оверлея docker-compose.postgres-host.yml, который отвечает за публикацию порта 5433 на хосте. Выполните docker compose --env-file .env -f infra/compose/docker-compose.yml ps и убедитесь, что сервис postgres сообщает о статусе healthy, так как файл compose содержит проверку работоспособности, выполняемую каждые три секунды. Если контейнер перезапускается в цикле, изучите его логи: зафиксированный стек Compose отказывается запускаться на старом томе Postgres 16, пока он не будет мигрирован до Postgres 18. Команда docker compose ... down -v очищает его, при этом удаляя все данные.

Порт уже занят. Запуск Postgres завершается ошибкой bind: address already in use, если порт 5433 уже занят другим процессом, чаще всего — забытым стеком Rakazo, который вы не остановили. Команда sudo ss -lntp | grep 5433 покажет имя процесса. Оверлей считывает порт хоста из POSTGRES_HOST_PORT, поэтому вы можете изменить его, если также обновите DATABASE_URL и DATABASE_MIGRATION_URL.

Бот не получает вычислительные ресурсы. При использовании SANDBOX_PROVIDER=docker и отсутствии образа rakazo/computer:local запускать нечего. Команда docker image ls rakazo/computer отвечает на это одной строкой, а pnpm sandbox:build исправляет ситуацию. Если супервизор не может получить доступ к сокету Docker, он также не сможет создавать контейнеры, а сообщение об ошибке укажет на путь: permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock.

Длительная команда прерывается на середине. Параметр .env.example задает SANDBOX_COMMAND_TIMEOUT_MS=300000, поэтому выполнение любой команды внутри вычислительной среды бота принудительно завершается через пять минут. Увеличьте это значение для медленных сборок, вместо того чтобы предполагать сбой песочницы.

pnpm install работает некорректно. В первую очередь проверьте node -v. Рабочая область объявляет ^22.22.2 || ^24.0.0 || >=26.0.0, поэтому версии 23.x, 25.x и любые версии 22.x до 22.22.2 не поддерживаются. Зафиксированный параметр .npmrc устанавливает engine-strict=true, поэтому pnpm install отклоняет неподдерживаемую версию Node с ошибкой engine/version еще до запуска кода зависимостей приложения.

Вход в систему работает локально, но не через домен. Параметры BETTER_AUTH_URL, WEB_ORIGIN и API_URL должны содержать тот же публичный origin, что и адресная строка браузера, включая схему. Устаревшее значение http://127.0.0.1:5173, оставшееся в одном из них, является обычной причиной того, что сессия не сохраняется.

Обновление зафиксированной версии (pinned checkout)

Путь обновления в документации по self-hosted установке для production-стека Compose, развернутого из вашего checkout, прост: получите исходный код новой версии, затем пересоберите и перезапустите API, worker и web app. Миграции выполняются при запуске API, так как команда запуска применяет их до начала обслуживания запросов.

sudo /usr/local/sbin/rakazo-backup
git fetch --all --tags
git checkout NEW_COMMIT_SHA
export GIT_SHA=$(git rev-parse HEAD)
docker compose --env-file .env -f infra/compose/docker-compose.prod.yml \
  up -d --wait --pull never --build api worker web

Сначала создайте резервную копию. Миграции выполняются только в прямом направлении, и бета-версия не предоставляет надежного пути отката. Если ваш checkout старше 30 августа 2026 года, что включает коммит v0.1.0-beta, перед обновлением ознакомьтесь с примечанием в документации к миграции 20260830200000_space_scope_names_and_user_credentials. Это скоординированный переход, поэтому сначала остановите старый API и worker, а затем выполните проверку границ приватности пространства (Space privacy-boundary check), описанную в документации. При обновлении из checkout, созданного до появления раздельного входа в приложение, установите POSTGRES_APP_PASSWORD в .env перед пересборкой; production-файл compose не запустится без этого параметра. Исходный код и production-файлы Compose также используют Postgres 18: существующая установка Postgres 16 требует выполнения процедуры infra/compose/upgrade-postgres.sh из документации, прежде чем она сможет запуститься в новой конфигурации. Просмотрите коммиты между вашим зафиксированным SHA и новым перед их применением, так как в столь молодом проекте переменные окружения могут переименовываться без предварительного уведомления, а отсутствие переменной приводит к тому, что сервис запускается и сразу завершает работу. Если вы все еще решаете, подходит ли вам Rakazo, обзор self-hosted AI-агентов описывает другие решения в этой категории и стоимость их поддержки.

FAQ

Можно ли запустить Rakazo на VPS с 1 ГБ памяти?

Нет. Postgres, API, worker, sandbox supervisor и веб-приложение работают одновременно. При использовании SANDBOX_PROVIDER=docker компьютер бота добавляет контейнер с графическим рабочим столом, отдельным X-дисплеем и процессом Chrome для каждого активного бота. Все это ограничено стандартным лимитом в 2 ГБ памяти и два ядра CPU. Документация по self-host на v0.3.5 не указывает требования к размеру хоста. Считайте 4 ГБ минимальным порогом для control plane и увеличивайте ресурсы, если рабочие столы запускаются на вашей машине.

Безопасен ли desktop sandbox provider на сервере?

Нет. В документации по self-host указано, что desktop выполняет команды непосредственно на хосте API и worker, поэтому бот действует от имени пользователя, запустившего этот процесс, имея доступ к файлам и учетным данным этого пользователя. На v0.3.5 API и worker отклоняют этот режим вне среды разработки и тестирования, но сервер, работающий на pnpm dev, находится в режиме разработки и принимает его. Не используйте его на публичных или общих серверах. Используйте docker, предоставляя боту Private Computer, если он не должен делить файлы с другими ботами в рабочем пространстве, или e2b, если в систему входит более одного человека.

Какую версию Rakazo следует установить?

По состоянию на 9 ноября 2026 года новейший релиз — v0.8.0, опубликованный 4 ноября 2026 года и помеченный как Latest. Чтобы следовать этому руководству, используйте закрепленный v0.3.5 коммит f31e3c0699f086d663637c4107858c238a086fb3, а не отслеживайте main или августовский пререлиз v0.1.0-beta. Ветка может измениться, а тег — быть переназначен, поэтому ни то, ни другое не гарантирует возможность вернуться к конкретному состоянию кода. Записывайте хеш коммита, так как откат возможен только при знании того, какая версия работала.

Где указать API-ключ OpenRouter?

В .env как OPENROUTER_API_KEY, и никогда не добавляйте его в compose-файл, который вы отправляете в репозиторий. Обе команды compose в репозитории передают --env-file .env, поэтому значение попадает в контейнеры, не записываясь в отслеживаемый YAML. Вы также можете оставить это поле пустым и подключить модель в приложении после регистрации. Установите лимит расходов для ключа на стороне провайдера, так как бот в цикле будет продолжать вызывать модель, пока его что-то не остановит.

Нужны ли доменное имя и TLS?

Для всего, что выходит за рамки первого теста, — да. Production compose-файл запускает Caddy и автоматически получает сертификаты; установите RAKAZO_HOST в качестве публичного имени хоста, а BETTER_AUTH_URL, WEB_ORIGIN и API_URL — в качестве того же публичного HTTPS-источника. Для первого ознакомления можно обойтись без домена: запустите pnpm dev и пробросьте порт 5173 через SSH вместо его публикации.

Была ли эта статья полезной?