# Быстрый старт > От чистого сервера до отчёта первого сканирования: установка, вход, подключение ИИ, создание продукта, сканирование. Источник: https://scansuite.ru/documentation/quick-start Проверено: 2026-10-19 От чистого Linux-сервера до отчёта первого сканирования — за шесть шагов. В каждом шаге сказано, как проверить, что он удался, и дана ссылка на страницу со всеми параметрами. > **Хотите поручить это ИИ-агенту?:** ИИ-агент с доступом к командной строке сервера может выполнить установку (шаг 1) за вас и остановиться на шагах, которые можете сделать только вы. Дайте ему эту страницу: `https://scansuite.ru/documentation/quick-start.md`. Шаги 2 и 3 вы выполняете в браузере. Шаги 4–6 агент выполняет через API команды: один раз создайте для него токен, как описано в разделе [Подключение ИИ-агента](https://scansuite.ru/documentation/agent-setup), и он создаст продукт, запустит сканирование и прочитает результаты. ## Перед началом | Что нужно | Подробности | Проверка | |---|---|---| | Linux-сервер | Рекомендуется Ubuntu 22.04 или новее, учётная запись без root с правом sudo. Размеры и другие системы — в разделе «Технические требования». | . /etc/os-release; echo $ID $VERSION_ID | | Файл лицензии | Выдаёт ScanSuite: _.lic | ls *.lic в папке, из которой ставите | | Токен реестра | Выдаёт ScanSuite, начинается с dckr_pat_ | Вы вводите его, когда установщик спросит | | Модель ИИ | OpenAI-совместимый endpoint (облачный или в вашей сети) или Vertex AI (Claude) с API-ключом | Нужна на шаге 3 | | Репозиторий для сканирования | Любой ваш Git-репозиторий; для публичного URL по HTTPS ключ не нужен | — | Полные требования: [Технические требования](https://scansuite.ru/documentation/installation/technical-requirements). ## 1. Установка В папке, где лежит ровно один файл лицензии, выполните: ```bash bash -c "$(curl -sSL https://scansuite.ru/install-teams)" ``` > **Этот шаг выполняет человек:** Когда установщик выведет «Signing in to the image registry» и запросит Password, введите там токен реестра. > > Для этого AI-агент запускает установщик в терминале, в котором вы можете печатать; если установщик запущен без такого терминала, он останавливается с ошибкой «Registry sign-in failed», и его просто запускают снова в терминале. **Проверка:** вывод заканчивается строками `[+] All services healthy` и `[+] ScanSuite Teams is installed in /opt/scansuite`. Затем выполните: ```bash cd /opt/scansuite && ./scansuite doctor ``` Вывод заканчивается строкой `[+] No problems found`. Если нет — см. [Устранение неполадок](https://scansuite.ru/documentation/installation/troubleshooting). Все параметры установщика описаны в разделе [Установка ScanSuite Teams](https://scansuite.ru/documentation/installation/install-scansuite-server); для Google Cloud или Azure используйте вместо этого [Установка в Google Cloud](https://scansuite.ru/documentation/installation/install-on-google-cloud) или [Установка в Microsoft Azure](https://scansuite.ru/documentation/installation/install-on-azure). ## 2. Первая учётная запись > **Этот шаг выполняет человек:** Откройте в браузере `https:///setup` (один раз примите предупреждение о самоподписанном сертификате или сначала настройте сертификат: [Настройка SSL/TLS](https://scansuite.ru/documentation/installation/ssl-tls-setup)). Заполните поля **Название команды**, **Имя пользователя**, **Пароль** и **Подтвердите пароль** и нажмите **Создать первую учётную запись**. Пароль — не короче 8 символов, с заглавными и строчными буквами, цифрой и спецсимволом. > > Сделайте это сразу после установки: учётную запись получает тот, кто первым откроет страницу. **Проверка:** открывается страница входа, и вы можете войти. Эта учётная запись — администратор первой команды и администратор установки; страница `/setup` больше недоступна. ## 3. Подключение модели ИИ В формах сканирования по умолчанию выбраны ИИ-сканеры, и им нужна модель. Как администратор установки откройте меню пользователя (справа вверху) → **Настройки системы** → **Общие сервисы**: 1. **AI-подключения** → **Добавить подключение**: название, тип (**OpenAI-compatible** или **Vertex AI (Claude)**), URL API и API-ключ → **Сохранить**. 2. **AI-модели** → **Добавить модель**: название, подключение, идентификатор модели → **Сохранить**. Первая модель отвечает на все задачи ИИ. > **Этот шаг выполняет человек:** Введите API-ключ (или JSON сервисного аккаунта Vertex) в форму сами. Перед сохранением настроек ИИ ScanSuite может попросить войти ещё раз. **Проверка:** у модели статус **Доступна**, а **Системный ИИ** → **Проверить подключение** сообщает, что системный ИИ ответил. Все команды пользуются системным ИИ, если не зададут свой. Подробности, распределение задач по моделям и работа без передачи кода за пределы вашей сети: [Поставщики ИИ и стоимость](https://scansuite.ru/documentation/usage/ai-providers#connect-your-first-ai-provider). ## 4. Создание продукта Продукт объединяет всё, что сканируется для одного приложения. В боковом меню откройте **Продукты** → **Новый продукт**, введите **Название продукта** (уникальное в команде) и, если нужно, **URL репозитория** → **Создать продукт**. **Проверка:** появляется сообщение *Продукт создан или обновлён*, а продукт — в списке. Подробнее, в том числе о создании продуктов через API: [Продукты](https://scansuite.ru/documentation/usage/products). ## 5. Первое сканирование В боковом меню откройте **Анализ кода** → **Git-репозиторий**: 1. **Репозитории**: URL для клонирования, например `https://github.com//`. (Или **Загрузить ZIP** — для архива с кодом.) 2. **Привязка к продукту**: продукт из шага 4. 3. Остальное оставьте по умолчанию: полное сканирование, все поддерживаемые языки и ИИ-сканеры (AI Native SAST, секреты с проверкой ИИ, проверка зависимостей с анализом достижимости). 4. Нажмите **Запустить анализ**. **Проверка:** появляется сообщение *Сканирование создано*, открывается страница сканирования и показывает ход работы. Для закрытого репозитория сначала нужен SSH-ключ: [Аутентификация в Git-репозитории](https://scansuite.ru/documentation/usage/static-code-analysis/git-repository-authentication). Если в журнале сканирования сказано, что AI SAST не может запуститься, шаг 3 не выполнен. ## 6. Результаты - **Отчёт:** когда сканирование завершится, кнопка **Скачать отчёт** на странице сканирования (или **Отчёт** в его строке в **Истории сканирований**) отдаёт ZIP-архив с HTML, XLSX и JSON. - **Уязвимости:** пункт бокового меню **Уязвимости**, с выбранным продуктом. У каждой уязвимости есть вердикт проверки и доказательства, на которых он основан: [как читать уязвимость](https://scansuite.ru/documentation/usage/vulnerability-management#reading-a-finding). - **Секреты**, найденные в коде: пункт бокового меню **Учётные данные**. ## Что дальше - [Сканирование веб-приложений](https://scansuite.ru/documentation/usage/web-app-scanning): Сканирование сайтов и веб-API, с входом и без, классическими сканерами, AI DAST или агентом ИИ-пентеста; правила целей для любого сканирования. - [Проверки инфраструктуры](https://scansuite.ru/documentation/usage/infrastructure-checks): Поиск уязвимостей, обнаружение узлов в сети, контроль установки обновлений, OSINT по домену и образы контейнеров; по умолчанию — агент ИИ-пентеста. - [Команды и роли](https://scansuite.ru/documentation/administration/teams-and-roles): Что может каждая из четырёх ролей и как администратор команды её настраивает: цели, ИИ, учётные данные для сканирования, отчёты и API-токены. - [CI/CD и автоматизация](https://scansuite.ru/documentation/reference/cicd): Как запускать SAST, DAST и сканирование инфраструктуры из GitLab, GitHub, Jenkins, Azure DevOps, Bitbucket или скрипта по API-токену команды, проверять токен ключом --check и останавливать сборку, если найдены уязвимости. - [Подключение ИИ-агента](https://scansuite.ru/documentation/agent-setup): Одна строка для Claude Code, Codex, Copilot или Cursor: агент устанавливает навык ScanSuite и подключается к вашему серверу. - [Планирование сканирования](https://scansuite.ru/documentation/usage/schedule-the-scan): Сканирование веб-приложений, инфраструктуры и кода по расписанию, управление на странице «Расписания» и запуск по расписанию из CI. Сканирование веб-приложений и инфраструктуры запускается только против целей, разрешённых команде; их задаёт администратор команды на странице команды ([Команды и роли](https://scansuite.ru/documentation/administration/teams-and-roles)).