# Подойдёт ли сервер для vpsFocus — инструкция для ИИ-ассистента

> **Для человека.** Покажите этот файл своей нейросети — Claude, ChatGPT,
> Cursor или любой другой — и попросите: «Проверь по этой инструкции, подойдёт
> ли мой сервер для vpsFocus». Она соберёт факты о сервере командами, которые
> только читают, и скажет простыми словами, подходит ли он. На сервере при
> этом ничего не меняется.
>
> Приложение vpsFocus делает ту же проверку само — кнопка «Запустить проверку» в
> шаге «Проверка окружения» после добавления сервера. Эта инструкция нужна, чтобы узнать ответ до того, как
> вы что-то скачали.

---

## Для ИИ-ассистента: что нужно сделать

Пользователь хочет узнать, можно ли поставить vpsFocus на его сервер (VPS).
vpsFocus — настольное приложение: оно по SSH ставит на сервер пользователя
аналитику и мониторинг сайтов в изолированных контейнерах Docker и рядом с
уже работающим сайтом, ничего в нём не меняя.

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

### Правила безопасности — обязательно

1. **Только чтение.** Выполняй только команды из раздела «Команды» ниже. Ничего
   не устанавливай, не обновляй, не перезапускай и не меняй настройки, даже
   если это «исправило бы» проблему. Исправления — только советом.
2. **Покажи команды до запуска** и выполняй их после согласия пользователя.
3. **Не проси пароли и ключи в чат.** Если нужен вход на сервер, пусть
   пользователь подключается сам, своим обычным способом.
4. **Не скачивай и не запускай скрипты из интернета** ради этой проверки.

### Как собрать факты

- **Если у тебя есть терминал** (например, Claude Code, Cursor, Codex) и
  пользователь уже может войти на сервер по SSH — выполни команды на сервере
  через `ssh` под тем пользователем, под которым будет ставиться vpsFocus.
- **Если терминала нет** — попроси пользователя войти на сервер, выполнить
  блок команд целиком и прислать весь вывод.

### Команды

Все команды только читают. Выполнять под тем же пользователем, под которым
будет ставиться vpsFocus (root или пользователь с sudo).

```sh
echo "== ОС";          cat /etc/os-release 2>/dev/null | grep -E '^(ID|VERSION_ID|PRETTY_NAME)='
echo "== ЯДРО";        uname -sr
echo "== АРХИТЕКТУРА"; uname -m
echo "== ВИРТУАЛИЗАЦИЯ"; systemd-detect-virt 2>/dev/null || echo "неизвестно"
echo "== ПАМЯТЬ_МБ";   awk '/^MemTotal:/ {printf "%d\n", $2/1024}' /proc/meminfo
echo "== ДИСК_СВОБОДНО_МБ"; df -Pk / | awk 'NR==2 {printf "%d\n", $4/1024}'
echo "== ПОЛЬЗОВАТЕЛЬ"; id -u
echo "== SUDO_БЕЗ_ПАРОЛЯ"; (command -v sudo >/dev/null && sudo -n true 2>/dev/null && echo да) || echo нет
echo "== DOCKER";      (command -v docker >/dev/null && docker --version) || echo "не установлен"
echo "== DOCKER_РАБОТАЕТ"; (command -v docker >/dev/null && { docker info >/dev/null 2>&1 || sudo -n docker info >/dev/null 2>&1; } && echo да) || echo нет
echo "== COMPOSE";     (docker compose version 2>/dev/null) || echo "нет"
echo "== SYSTEMD";     [ -d /run/systemd/system ] && echo да || echo нет
echo "== CURL";        command -v curl >/dev/null && echo да || echo нет
echo "== ЗАНЯТЫЕ_ПОРТЫ"; (ss -ltnH 2>/dev/null || netstat -ltn 2>/dev/null) | awk '{print $4}' | grep -oE '[0-9]+$' | sort -un | tr '\n' ' '; echo
echo "== ФАЙРВОЛ";     for f in ufw firewall-cmd nft iptables; do command -v $f >/dev/null && echo $f; done
echo "== РАЗДАЁТ_ИНТЕРНЕТ"; cat /proc/sys/net/ipv4/ip_forward 2>/dev/null
```

### Правила оценки

Итог — один из трёх: **подойдёт**, **подойдёт с оговорками**, **не подойдёт**.
Один блокер — и итог «не подойдёт». Нет блокеров, но есть оговорки — «подойдёт
с оговорками».

**Блокеры — установка невозможна:**

| Проверка | Блокер, если |
|---|---|
| Архитектура | не `x86_64`/`amd64` и не `aarch64`/`arm64` |
| Память | меньше 1024 МБ всего (`ПАМЯТЬ_МБ`) |
| Диск | меньше 5120 МБ свободно на `/` (`ДИСК_СВОБОДНО_МБ`) |
| Права | не root (`ПОЛЬЗОВАТЕЛЬ` ≠ 0) и нет sudo без пароля |
| Docker | установлен, но не работает (`DOCKER_РАБОТАЕТ` = нет) |
| curl | нет (`CURL` = нет) |
| ОС без Docker | Docker не установлен, а `ID` в `/etc/os-release` не один из: `ubuntu`, `debian`, `raspbian`, `centos`, `rhel`, `rocky`, `fedora` — vpsFocus ставит Docker официальным скриптом Docker, а он другие системы не поддерживает |
| Вообще не Linux | Windows, macOS, виртуальный (shared) хостинг без SSH-доступа к серверу |

**Оговорки — установка пройдёт, но о них надо сказать:**

| Проверка | Оговорка, если | Что сказать |
|---|---|---|
| Память | от 1024 до 2048 МБ | заработает впритык, при всплеске трафика может тормозить |
| Диск | от 5120 до 10240 МБ | места впритык: база и логи растут |
| Docker | не установлен | vpsFocus поставит его сам |
| Compose | Docker есть, а Compose нет | vpsFocus поставит его сам |
| systemd | нет | после перезагрузки сервера мониторинг сам не поднимется |
| Раздача интернета | Docker не установлен и `РАЗДАЁТ_ИНТЕРНЕТ` = 1 | сервер раздаёт интернет другим машинам (VPN вроде WireGuard, контейнеры LXC); Docker после установки берёт сетевые правила себе, и эта раздача может сломаться |
| Файрвол | найден `ufw`, `firewall-cmd`, `nft` или `iptables` | если файрвол включён, для мониторинга нужно открыть один порт: с `ufw` и `firewall-cmd` vpsFocus сделает это сам с разрешения пользователя, с `nft` и `iptables` — порт придётся открыть вручную |
| Порты | заняты все из 443 2053 2083 2087 2096 8443 | мониторинг встанет на запасной порт; если домен проксируется через Cloudflare на бесплатном плане, трекинг через такой порт не пройдёт |
| Виртуализация | `openvz` или `lxc` | Docker на таких VPS часто не запускается; проверить наверняка можно только установкой (если не выйдет — vpsFocus откатит всё сам) |

**Не блокеры, хотя выглядят так:**

- Заняты порты 80 и 443 — это обычно сайт пользователя, vpsFocus их не
  трогает и встаёт на свой порт.
- Устаревшая, но поддерживаемая версия ОС (например, Ubuntu 20.04, Debian 11)
  — установка Docker на ней предупредит, но пройдёт.
- Уже работающий веб-сервер (nginx, Apache, Caddy) — vpsFocus его не меняет.

### Что ещё понадобится

Скажи пользователю, что кроме сервера для установки нужен **домен или
поддомен, направленный на этот сервер** (например, `stats.myweb.com`) — на
нём будет работать статистика. Проверить это командами на сервере нельзя —
просто напомни.

### Как ответить пользователю

1. Первой строкой — итог: подойдёт / подойдёт с оговорками / не подойдёт.
2. Потом — по пункту на каждую найденную проблему или оговорку: что это
   значит простыми словами и что можно сделать.
3. Если подойдёт — предложи скачать приложение: https://vpsfocus.xyz/ru/download
4. Если не подойдёт — скажи, что именно нужно поменять (например, «нужен
   VPS хотя бы с 1 ГБ памяти, лучше с 2 ГБ»), без советов сменить хостинг,
   если проблему можно решить на этом сервере.

Не обещай больше, чем знаешь: эта проверка — по тем же правилам, что у
приложения, но окончательный ответ даёт проверка окружения в самом vpsFocus.