Одна песочница.
Не только для сайтов.

От Telegram до первой запущенной команды

Весь цикл проходит в браузере. VPS, SSH и ручная настройка Linux для старта не нужны.

1. 1
   Откройте @datanodehostbot

   Нажмите Start. Бот создаст привязанный аккаунт и выдаст имя и ключ доступа. Это не публичный API-токен.

2. 2
   Войдите в панель

   Откройте ссылку из бота, введите выданные данные и пройдите проверку Telegram или Authenticator, если она включена.

3. 3
   Выберите профиль и запустите Sandbox

   Clean подходит для своей структуры; Static, Node.js, Python и PHP создают стартовые файлы. После запуска откроются Files, Editor и Terminal.

4. 4
   Откройте VS Code в браузере

   Перейдите в Editor. Он работает с теми же файлами, что Files и Terminal, поэтому копировать проект не нужно.

5. 5
   Запустите Python

   В Terminal выполните python3 --version, затем создайте hello.py и запустите python3 hello.py.

6. 6
   Добавьте или импортируйте проект

   Загрузите файлы до 50 МБ, создайте их в Files или импортируйте публичный GitHub-репозиторий.

7. 7
   Опубликуйте сайт, если это нужно

   В Domain выберите Files для Static/PHP или Worker HTTP для Node.js/Python, затем выполните показанную DNS-настройку.

Выберите удобную отправную точку

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

Управление проектом без FTP

Файловое дерево показывает содержимое workspace и поддерживает основные операции прямо в браузере.

Полноценный редактор в браузере

Editor открывается на editor.datanode.host и работает с тем же workspace, что и Files и Terminal.

• подсветка синтаксиса и работа с несколькими файлами;
• поиск и навигация по проекту;
• единые изменения: сохранённый файл сразу виден в Files и Terminal;
• быстрое открытие конкретного файла из файлового дерева.

Запускайте инструменты в изоляции

Терминал выполняет установленные программы внутри Bubblewrap-контейнера. Рабочая директория доступна как /workspace; временные файлы и кэши — как /tmp.

python3 --version
node --version
php -v

python3 script.py

python3 -m pip install -r requirements.txt
npm install

$ python3 --version
Python 3.10.16
$ node --version
v24.13.0
$ php -r 'echo PHP_VERSION;'
8.4.23

Встроенные команды

pwd, cd, ls, tree, cat, head, tail, wc, du, mkdir, touch, rm, rmdir, mv, cp и clear.

Постоянные процессы в Sandbox

Воркеры запускают один долгоживущий процесс на workspace, перезапускают его по выбранной политике и сохраняют отдельный вывод. Sandbox должен оставаться запущенным.

python3 bot.py

# Node.js template
npm install
npm start

# Python template
python3 -m pip install -r requirements.txt
python3 app.py

Вывод воркера и события машины

Откройте Ещё → Логи. Вкладка объединяет stdout/stderr воркера и журнал действий Sandbox без смешивания с файлами проекта.

Точки восстановления workspace

Каждый аккаунт может хранить до пяти снимков, скачать ZIP-копию, восстановить workspace или удалить ненужную точку.

1. 1
   Создайте снимок

   Откройте Ещё → Снимки, укажите понятную метку и нажмите «Создать снимок».

2. 2
   Восстановите при необходимости

   Воркер будет остановлен, а workspace атомарно заменён проверенным содержимым архива.

3. 3
   Переустановите зависимости

   node_modules, vendor, виртуальные окружения, runtime-кэши и секретные .env-файлы намеренно не входят в снимок.

Снимки создаются пользователем вручную и не являются резервными копиями по расписанию или гарантией хранения.

Автоматизация через API и SSH

Публичный API

Создайте токен в Ещё → Доступ. Секрет показывается один раз; каждому токену назначаются отдельные scopes: account, storage, files, execute, logs, workers и snapshots.

API scope files даёт только чтение. execute и workers разрешают выполнение кода; workers также управляет командой запуска. snapshots может заменить код при восстановлении, но Worker остаётся остановленным. Изменение кода через панель, SSH или Editor может повлиять на последующий запуск Worker.

export DATANODE_API_TOKEN='dn_live_...'

curl https://datanode.host/api/v1/account \
  -H "Authorization: Bearer $DATANODE_API_TOKEN"

API v1 предоставляет account, storage, files, files/content, execute, logs, worker и snapshots. Отзывайте неиспользуемые токены в разделе Доступ.

SSH по публичному ключу

Добавьте Ed25519, ECDSA P-256 или security-key public key. SSH использует тот же Bubblewrap-контур и workspace, не выдаёт host-root и запрещает forwarding.

Публикация веб-проекта

Раздел Domain связывает собственный домен со статическими файлами, PHP-проектом или HTTP-приложением, запущенным через Воркеры.

Подтвердите владение доменом TXT-записью _datanode.ваш-домен со значением из панели Domain. Сохраняйте её: повторная проверка выполняется каждые пять минут. Удаление TXT отключает публикацию после истечения DNS-кэша; смена домена требует новой проверки.

1. 1
   Выберите источник

   Files публикует Static/PHP из выбранной папки. Worker HTTP направляет запросы в приложение Node.js или Python.

2. 2
   Подготовьте проект

   Для Files добавьте index.html или index.php. Для Worker HTTP сохраните команду приложения в Воркеры и запустите её.

3. 3
   Добавьте домен

   Укажите имя без протокола и создайте показанные в панели DNS-записи.

4. 4
   Проверьте публикацию

   После DNS-проверки откройте домен. Для приложения индикатор HTTP endpoint должен перейти в состояние Ready.

Worker HTTP поддерживает обычные HTTP-запросы. WebSocket upgrade пока не проксируется; размер запроса ограничен 16 МБ, ответа — 32 МБ.

Разработка Telegram-ботов

Sandbox можно использовать для полного цикла работы с ботом: создать проект, установить библиотеку, проверить обработчики и запустить long polling как постоянный worker.

telegram-bot/
├── bot.py
├── handlers/
├── requirements.txt
├── .env.example
└── README.md

Безопасное хранение токена

Создайте настоящий .env через Files или Editor, добавьте его в .gitignore и храните в репозитории только .env.example без секретов. Стартовые Node.js и Python-шаблоны загружают .env автоматически.

Секретные .env, .env.local и другие .env.* исключаются из новых snapshots. .env.example, .env.sample и .env.template сохраняются; при восстановлении текущие секретные env-файлы остаются в workspace, о чём панель предупреждает. В API можно передать preserve_secrets: false, чтобы восстановить snapshot без текущих секретов.

Что ещё можно делать в Sandbox

Как запрос доходит до Sandbox

Архитектура специально остаётся короткой: каждый слой отвечает за одну понятную задачу.

Подробности о сети, логах, удалении и бэкапах опубликованы на странице безопасности. Статус компонентов — на Status.

Границы окружения

• песочница не имеет прямого доступа к файловой системе хоста;
• системные директории подключены только для чтения;
• доступ на изменение ограничен workspace, временной директорией и runtime-кэшами;
• не публикуйте токены, пароли, приватные ключи и резервные коды.

Если что-то не работает