На главнуюRubox
[ ДОКУМЕНТАЦИЯ ]Документация

Документация Rubox

Постоянные Linux-песочницы для разработчиков и AI-агентов. Используйте Rubox как личную удалённую машину или как инфраструктурный слой через API: машины, файлы, процессы и сервисы за аутентифицированным прокси.

Открыть API-справкуВойти в кабинет
[ БЫСТРЫЙ СТАРТ ]

Запуск за 3 шага

1. Войдите в кабинет

Откройте кабинет Rubox, выберите тариф и создайте первую песочницу из раздела “Машины”.

2. Создайте API-ключ

В разделе “API-ключи” создайте ключ вида rubox_sk_... Он показывается один раз, поэтому сохраните его сразу.

3. Управляйте машиной

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

[ ЛИЧНОЕ ИСПОЛЬЗОВАНИЕ ]

Личное использование

Используйте Rubox как постоянную удалённую рабочую машину: подключайтесь по SSH, работайте из Cursor или VS Code, поднимайте web-сервисы и оставляйте агентов работать 24/7.

Подключение по SSH

Каждая песочница получает выделенный IP и SSH-доступ по ключу. Работать можно из любого терминала без специального клиента.

Cursor / VS Code

Используйте Remote-SSH для ощущения локальной IDE. Песочница выглядит как обычный Linux-хост.

ИИ-агенты 24/7

Claude Code, Codex, OpenCode и другие агенты могут работать непрерывно, даже когда ваш ноутбук выключен.

Доступ с мобильного

Открывайте рабочие URL и превью прямо с телефона через аутентифицированный прокси.

SSH-команда
ssh -i ~/.ssh/rubox_mybox root@<public-ip>
Доступ к сервисам

Если вы поднимаете HTTP-сервис внутри машины, открывайте его через аутентифицированный прокси, а не как голый публичный порт. Это даёт нормальный браузерный доступ без ручной настройки туннелей.

[ ИНФРАСТРУКТУРНОЕ ИСПОЛЬЗОВАНИЕ ]

Инфраструктурное использование

Внешний Rubox API покрывает жизненный цикл машин, файловую систему и выполнение процессов. Этого достаточно, чтобы строить CI-интеграции, автоматические среды для агентов и собственные панели управления.

REST API

Базовый слой для автоматизации: машины, lifecycle, exec, файлы и toolbox. Полная схема доступна в OpenAPI.

SDK-обёртки

TypeScript и Python SDK дают ресурсный интерфейс поверх того же REST API, без ручной сборки URL и заголовков.

Аутентификация API

Все запросы к внешнему Rubox API выполняются с API-ключом в заголовке Authorization.

Authorization: Bearer rubox_sk_YOUR_KEY

Основные endpoints машин
  • GET /v1/machines — список машин
  • POST /v1/machines — создать новую машину
  • GET /v1/machines/{id} — получить состояние машины
  • DELETE /v1/machines/{id} — удалить машину
  • POST /v1/machines/{id}/resize — изменить тариф машины
  • POST /v1/machines/{id}/exec — выполнить команду
Пример: создать машину
curl -X POST https://rubox.io/v1/machines   -H "Authorization: Bearer rubox_sk_YOUR_KEY"   -H "Content-Type: application/json"   -d '{
    "name": "production-agent",
    "tier": "pro"
  }'
[ SDK ]

TypeScript и Python SDK

SDK повторяют публичный Rubox API и используют тот же API-ключ rubox_sk_.... TypeScript-пакет публикуется как @rubox/sdk, Python-пакет как rubox-sdk с импортом from rubox import Rubox.

TypeScript
npm install @rubox/sdk

import { Rubox } from '@rubox/sdk';

const rubox = new Rubox({ apiKey: process.env.RUBOX_API_KEY! });

const machine = await rubox.machines.create({
  name: 'agent-worker',
  tier: 'basic',
});

await rubox.machines.exec(machine.id, {
  command: 'python --version',
});
Python
pip install rubox-sdk

from rubox import Rubox

client = Rubox(api_key="rubox_sk_...")

machine = client.machines.create(
    name="agent-worker",
    tier="basic",
)
ready = client.machines.wait_for_ready(machine["id"])

result = client.toolbox.process.execute(
    ready["id"],
    "python --version",
)
print(result["stdout"])
Покрытие SDK
  • Машины — создание, список, просмотр, запуск, остановка, перезапуск, смена тарифа, удаление
  • Файловая система — список, чтение, запись, загрузка, скачивание, удаление, mkdir, перемещение, chmod
  • Процессы — синхронный запуск, потоковый запуск, список, остановка
  • Помощники аутентификации и типизированные ресурсы для публичного API Rubox

Образы, scoped sharing tokens и специальные proxy helpers относятся к отдельным поверхностям платформы. Они не документируются как готовые публичные API-эндпоинты Rubox, пока не будут добавлены в OpenAPI-контракт.

[ БЕЗОПАСНОСТЬ ]

Безопасность и доступ

Доступ к машине строится вокруг SSH по ключам и аутентифицированного HTTP-прокси. Сервисы внутри машины не должны публиковаться наружу напрямую без слоя аутентификации.

Только SSH-ключ

Парольный логин отключён. Доступ к терминалу и IDE должен идти по SSH-ключам.

Аутентифицированный прокси

HTTP-доступ к сервисам и превью идёт через общий прокси-слой с проверкой пользователя или ключа.

  • SSH по ключам, без парольного логина
  • Аутентифицированный прокси для HTTP-сервисов и портов
  • API-ключи в формате rubox_sk_* для инфраструктурного доступа
  • Внутренние сервисы не должны публиковаться наружу напрямую
Публичный паттерн доступа к сервисам: пользователь или API-клиент проходит проверку на Rubox-прокси, а прокси уже доставляет запрос во внутренний сервис машины. Это защищает dev-серверы, базы данных и preview-порты от прямого доступа из интернета.
[ БИЛЛИНГ ]

Тарифы и биллинг

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

Старт
2 vCPU · 4 ГБ RAM · 80 ГБ SSD
800 ₽/мес
Базовый
4 vCPU · 8 ГБ RAM · 160 ГБ SSD
1 600 ₽/мес
Про
8 vCPU · 16 ГБ RAM · 320 ГБ SSD
2 900 ₽/мес
Мощный
12 vCPU · 24 ГБ RAM · 480 ГБ SSD
5 100 ₽/мес
Ультра
16 vCPU · 32 ГБ RAM · 640 ГБ SSD
7 000 ₽/мес
[ ПОДДЕРЖКА ]

Поддержка и справка

API файлов и процессов
  • POST /v1/machines/{id}/toolbox/files/upload — загрузить файл
  • GET /v1/machines/{id}/toolbox/files/download — скачать файл
  • POST /v1/machines/{id}/toolbox/files/find — найти текст
  • POST /v1/machines/{id}/toolbox/files/replace — найти и заменить
  • POST /v1/machines/{id}/toolbox/process/execute — выполнить процесс синхронно
  • POST /v1/machines/{id}/toolbox/process/execute/stream — выполнить процесс через SSE
  • GET /v1/machines/{id}/toolbox/process/list — список процессов
  • POST /v1/machines/{id}/toolbox/process/kill — остановить процесс
Куда идти дальше

Полная интерактивная Swagger/OpenAPI-справка доступна отдельно. Там видны схемы запросов, ответы и все текущие эндпоинты.

Открыть API-справкуOpenAPI JSON
Пример: выполнить команду
curl -X POST https://rubox.io/v1/machines/<machine_id>/exec   -H "Authorization: Bearer rubox_sk_YOUR_KEY"   -H "Content-Type: application/json"   -d '{
    "command": "docker ps",
    "timeout_ms": 30000
  }'