> For the complete documentation index, see [llms.txt](https://docs.clore.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.clore.ai/guides/guides_v2-ru/nachalo-raboty/clore-troubleshooting.md).

# Устранение неполадок

Распространённые проблемы и решения при аренде GPU-серверов на маркетплейсе CLORE.AI.

{% hint style="success" %}
Все примеры можно запускать на GPU-серверах, арендованных через [маркетплейс CLORE.AI](https://clore.ai/marketplace).
{% endhint %}

{% hint style="info" %}
Это руководство основано на технической документации платформы CLORE.AI.
{% endhint %}

## Содержание

* [Проблемы при создании заказа](#order-creation-issues)
* [Проблемы с подключением](#connection-issues)
* [Проблемы с контейнером](#container-issues)
* [Проблемы с GPU](#gpu-issues)
* [Проблемы с оплатой](#payment-issues)
* [Ограничения платформы](#platform-limits)

***

## Проблемы при создании заказа

### Создание заказа не удалось: «Недостаточно средств»

**Причина:** Недостаточно средств для покрытия платы за создание и минимального депозита.

**Решение:**

* Проверьте баланс в выбранной валюте (CLORE, BTC или USDT/USDC)
* Плата за создание взимается при создании заказа
* Пополните баланс на сумму, достаточную для нескольких часов аренды

### Создание заказа не удалось: «Сервер недоступен»

**Причина:** Сервер уже арендован или офлайн.

**Решение:**

* Обновите страницу маркетплейса
* Проверьте статус сервера (индикатор онлайн/офлайн)
* Для Spot-аренды — вас могли перебить

### Заказ завис в статусе «Создание»

**Причина:** Контейнер разворачивается или произошла ошибка.

**Решение:**

1. Подождите 2–5 минут (образ Docker загружается)
2. Проверьте логи в **Мои заказы**
3. Загрузка больших образов (10 ГБ+) занимает больше времени
4. Если зависло более чем на 10 минут — отмените и повторите

***

## Проблемы с подключением

### Не удаётся подключиться по SSH

**Причина:** Порт не настроен или контейнер не готов.

**Чек-лист:**

1. Порт 22 должен быть задан как **TCP** (не HTTP)
2. Статус контейнера должен быть **Активный** (не «Создание»)
3. Используйте правильный сопоставленный порт из **Мои заказы**

**Правильная команда SSH:**

```bash
ssh -p <MAPPED_PORT> root@<PROXY_ADDRESS>
```

Где `<MAPPED_PORT>` это публичный порт (например, 45678), а НЕ порт 22.

### SSH работает, но веб-интерфейс не открывается

**Причина:** Порт задан как TCP вместо HTTP, либо служба не запущена.

**Решение:**

1. Порты веб-интерфейса должны быть заданы как **HTTP** (не TCP)
2. Служба должна слушать на `0.0.0.0`, а не `localhost`
3. Проверьте логи — служба могла аварийно завершиться при запуске

**Правильная конфигурация портов:**

```
22/tcp      - доступ SSH
7860/http   - интерфейс Gradio/WebUI
8000/http   - API-сервер
```

### Ошибка «Connection refused»

**Причина:** Служба внутри контейнера не запущена или слушает не на том адресе.

**Решение:**

1. Зайдите в контейнер по SSH и проверьте статус службы:

   ```bash
   ps aux | grep python
   netstat -tlnp
   ```
2. Служба должна слушать на `0.0.0.0`, а не `127.0.0.1`:

   ```bash
   # Неправильно:
   python app.py --host 127.0.0.1

   # Правильно:
   python app.py --host 0.0.0.0
   ```

### Ошибка «Connection timed out»

**Причина:** Неверный адрес/порт или проблемы с сетью.

**Чек-лист:**

1. Используйте адрес Proxy из **Мои заказы** (не IP сервера!)
2. Используйте сопоставленный порт (публичный порт, а не порт контейнера)
3. Используйте правильный протокол (http\:// для HTTP-портов)

***

## Проблемы с контейнером

### Контейнер постоянно перезапускается

**Причина:** Ошибка в команде запуска или недостаточно ресурсов.

**Решение:**

1. Проверьте логи в **Мои заказы**
2. Упростите команду запуска:

   ```bash
   # Плохо — длинная команда может не сработать:
   apt update && \\

   # Лучше — начните с простой команды:
   sleep infinity
   ```
3. Затем зайдите по SSH и настройте вручную

### Невозможно сбросить контейнер

**Причина:** Период ожидания между сбросами.

**Факт:** Сброс контейнера имеет **120-секундный** период ожидания.

**Решение:** Подождите 2 минуты между попытками сброса.

### Данные теряются после перезапуска

**Причина:** Данные не находятся в постоянном хранилище.

**Важно:**

* Данные внутри контейнера **сохраняются** при «Сбросе контейнера»
* Данные **теряются** когда заказ отменён или истекает
* Всегда скачивайте результаты перед завершением аренды:

  ```bash
  scp -P <port> root@<proxy>:/workspace/results.tar.gz ./
  ```

### Команда запуска не выполняется

**Причина:** Синтаксическая ошибка или проблема с образом.

**Распространённые ошибки:**

```bash

# Ошибка: лишний пробел после \\
apt update && \\
apt install -y git   # <-- пробел перед следующей строкой

# Правильно:
apt update && \\
apt install -y git && \\
python app.py
```

**Решение:**

1. Используйте простой запуск: `bash` или `sleep infinity`
2. Настройте всё через SSH
3. Или создайте собственный Docker-образ с предустановленным ПО

***

## Проблемы с GPU

### GPU не виден в контейнере

**Проверьте:**

```bash
nvidia-smi
```

**Если команда не найдена:**

* Docker-образ должен поддерживать CUDA
* Используйте образы с поддержкой CUDA: `pytorch/pytorch:2.11.0-cuda12.8-cudnn9-runtime`

**Если GPU не отображается:**

* Убедитесь, что на сервере есть GPU (проверьте карточку на маркетплейсе)
* Свяжитесь с провайдером сервера

### Несоответствие версии CUDA

**Ошибка:** `Версия драйвера CUDA недостаточна для версии runtime CUDA`

**Причина:** Версия CUDA в образе несовместима с драйвером сервера.

**Решение:**

* Проверьте версию драйвера: `nvidia-smi` (в правом верхнем углу)
* Используйте образ с совместимой версией CUDA
* Безопасный выбор: CUDA 12.8 (работает на любой карте от Turing до Blackwell) — см. [Совместимость CUDA и PyTorch](/guides/guides_v2-ru/nachalo-raboty/cuda-pytorch-compatibility.md)

### Недостаточно памяти GPU

**Ошибка:** `CUDA out of memory`

**Решения:**

1. Используйте модель поменьше или квантизацию
2. Добавьте флаги оптимизации памяти:
   * Stable Diffusion: `--medvram` или `--lowvram`
   * LLM: `load_in_4bit=True` или `load_in_8bit=True`
3. Очистите память: `torch.cuda.empty_cache()`
4. Арендуйте сервер с большим объёмом VRAM

***

## Проблемы с оплатой

### Поддерживаемые валюты

CLORE.AI поддерживает три валюты:

* **CLORE** - нативный токен платформы
* **BTC** - Bitcoin
* **USD** - стейблкоины (если включены провайдером)

### Заказ отменён: «Перебили ставку»

**Причина:** Кто-то предложил более высокую цену на Spot-рынке.

**Решение:**

* Используйте **On-Demand** для гарантированной аренды
* Или увеличьте вашу ставку на Spot

### Баланс списан, но заказ не создан

**Причина:** Плата за создание взимается даже если создание заказа не удалось.

**Решение:**

* Плата за создание обычно минимальна
* Проверьте причину отмены в истории
* Обратитесь в поддержку при повторяющихся проблемах

***

## Ограничения платформы

Проверено по коду CLORE.AI:

| Параметр                            | Лимит                       |
| ----------------------------------- | --------------------------- |
| Портов на заказ                     | **5**                       |
| Всего переменных окружения          | **12 288 символов** (12 КБ) |
| Имя одной переменной окружения      | 128 символов                |
| Значение одной переменной окружения | 1 536 символов              |
| SSH-ключ                            | **3 072 символа**           |
| Пароль SSH                          | **32 символа**              |
| Токен Jupyter                       | **32 символа**              |
| Период ожидания сброса контейнера   | **120 секунд**              |
| Диапазон портов                     | 1-65535                     |
| Протоколы портов                    | Только TCP или HTTP         |

***

## Переменные окружения

Используйте переменные окружения для доступа по SSH и к Jupyter:

| Переменная      | Назначение             | Максимальная длина |
| --------------- | ---------------------- | ------------------ |
| `SSH_KEY`       | Ваш публичный SSH-ключ | 3 072 симв.        |
| `SSH_PASSWORD`  | Пароль SSH             | 32 симв.           |
| `JUPYTER_TOKEN` | Токен Jupyter Notebook | 32 симв.           |

**Пример конфигурации:**

```
SSH_PASSWORD=mypassword123
JUPYTER_TOKEN=mysecrettoken
```

***

## Диагностические команды

```bash

# Проверить GPU
nvidia-smi

# Проверить использование памяти
free -h

# Проверить место на диске
df -h

# Проверить запущенные процессы
ps aux | grep python

# Проверить открытые порты
netstat -tlnp

# Проверить последние журналы ошибок
dmesg | tail -50

# Очистить память GPU (Python)
import torch
torch.cuda.empty_cache()
```

***

## Получение помощи

Если проблема сохраняется:

1. Проверьте [Документация CLORE.AI](https://docs.clore.ai/)
2. Опишите проблему, приложив логи и скриншоты
3. Укажите ID заказа и ID сервера


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.clore.ai/guides/guides_v2-ru/nachalo-raboty/clore-troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
