Перейти к содержимому

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

Как работает Crossroads: аккаунты, серверы, продление, оплата и API.

Как получить аккаунт

Аккаунты открываем мы, а не форма регистрации. Расскажите, что вам нужно, мы согласуем детали и откроем аккаунт. Аккаунты бывают двух видов:

  • С предоплатой: у вас есть баланс в манатах, и каждый сервер оплачивается с него период за периодом.
  • Бизнес: серверы работают без периодов, а вы получаете один счёт в месяц. Нам нужны юридическое название компании, VÖEN (ИНН) и адрес.

Управление через Claude

Crossroads работает как набор инструментов внутри Claude. Когда аккаунт готов, подключите его одним кликом и просите обычными словами: Claude проверит, что свободно, назовёт цену в манатах, создаст сервер, когда вы согласитесь, а потом будет запускать, останавливать, делать снапшоты и продлевать его.

  • Claude видит только ваш аккаунт и ваши серверы.
  • Сначала он показывает тариф и цену; пока вы не согласитесь, ничего не списывается.
  • Удаление сервера всегда требует вашего явного подтверждения.
  • Можно также спросить о балансе, выписке и счетах.

Создание сервера

Выберите тариф (от CR-1 до CR-8, GPU-4, GPU-8) или любой размер, который рассчитывает калькулятор, период (1 день, 7 дней, 1 месяц, 90 дней или 1 год), имя хоста, например web-1, и ваш открытый SSH-ключ. GPU-серверы с выделенной Quadro P1000 выдаются по запросу. На серверы можно войти только по ключу, никогда по паролю. Ключа ещё нет? Создайте его на своём компьютере и пришлите нам или Claude строку, которую выведет команда:

ssh-keygen -t ed25519
cat ~/.ssh/id_ed25519.pub

На аккаунте с предоплатой баланса должно хватать на первый период. Период начинается, когда сервер готов; если настроить его не удалось, ничего не списывается.

На каждом сервере работает Ubuntu 24.04 LTS с Docker, файрволом, fail2ban и автоматическими обновлениями безопасности, и у каждого есть собственный сетевой файрвол, который отделяет его от серверов других клиентов. На GPU-серверах также установлены драйвер NVIDIA и NVIDIA Container Toolkit.

Подключение к серверу

Вы входите по SSH как ubuntu с ключом, который нам дали. Когда сервер готов, мы настраиваем подключение вместе с вами и присылаем детали.

Периоды и продление

  • Продление: за день до конца периода сервер сам продлевается на тот же период с вашего баланса. Это можно отключить или поменять период для каждого сервера.
  • Напоминания: пишем за 7 дней и за 1 день и сообщаем, хватает ли баланса на следующий период.
  • Фиксированные цены: сервер сохраняет цену, по которой был создан, в том числе при продлении.
  • Без разрывов: каждый новый период начинается там, где закончился предыдущий.

Если период закончился

  1. Отсрочка: 72 часа сервер продолжает работать, а мы пишем вам.
  2. Остановка: затем он останавливается; диск и адрес хранятся 7 дней.
  3. Удаление: затем он удаляется навсегда, после последней резервной копии.

Пополнение баланса до удаления возвращает сервер: если автопродление включено, он продлится, как только придут деньги; иначе продлите его сами или попросите нас. Время отсрочки и остановки входит в новый период.

Баланс и оплата

Оплачивайте банковским переводом; если нужен документ для оплаты, попросите счёт на пополнение. Когда деньги приходят, мы зачисляем их на баланс и присылаем квитанцию на почту, а серверы, ждущие оплаты, сразу продлеваются. Каждый платёж и каждое списание есть в выписке, вместе с балансом после каждой операции. Остаток на балансе можно вернуть, а если мы вам должны, мы зачисляем сумму на баланс.

Бизнес-аккаунты и счета

В начале каждого месяца вы получаете счёт за каждый день, когда каждый сервер существовал в прошлом месяце, по его собственной ставке, плюс согласованные ежемесячные платежи. Он оплачивается банковским переводом в течение 14 дней, с номером счёта в назначении платежа. Счета — это PDF на азербайджанском и английском с номерами CR-; счета на пополнение имеют номера PF-. Выставленный счёт никогда не меняется: ошибка исправляется кредит-нотой и новым счётом.

Включение и снапшоты

Запускайте и останавливайте серверы когда угодно; остановленный сервер сохраняет ресурсы, поэтому стоит столько же. У каждого сервера можно хранить до трёх снапшотов. Попросите Claude или нас.

API

Всё, что делает Claude, проходит через REST API Crossroads, и им можно пользоваться напрямую. Каждый запрос передаёт ваш API-ключ в заголовке X-API-Key. Ключ показывается один раз, при создании, поэтому храните его в надёжном месте; если он утечёт, мы его отзовём и выдадим новый.

GET /api/v1/ratesСтавки
POST /api/v1/instancesСоздать сервер; GET — список ваших
POST …/instances/{vmid}/startА также /stop и /snapshot
GET /api/v1/billing/ledgerБаланс и выписка
GET /api/v1/invoicesВаши счета, каждый также в PDF

Доступ к API открывается вместе с управлением через Claude; адрес мы присылаем вместе с ключом.

Поддержка

Напишите на info@crossroads.az или воспользуйтесь формой связи; если вопрос о сервере, укажите его имя хоста.