Обновлено 8 ноября 2026 г.
AI и языковые модели

RAGFlow

Чат по документам на своем сервере: загружаете технический PDF, задаете вопрос и открываете источник ответа. Развернули v1.0.0 на Fatmetal Cloud Server, замерили ресурсы и проверили ответы по таблице и руководству Raspberry Pi Pico.

Проверено на версии v1.0.0, 8 ноября 2026~14 минут чтенияFatmetal Team
Чат с документамиApache-2.0Docker ComposeЗапущен: v1.0.0

Вердикт

Подходит
  • Сервисному инженеру, который ищет параметры оборудования в PDF-инструкциях.
  • Поддержке, которой нужен ответ по регламенту с возможностью открыть исходную таблицу.
  • Команде, которая хочет отдельно управлять документами, поиском и провайдером моделей.
Не подходит
  • Для автоматических решений без проверки источника ответа.
  • Для личного блокнота без настройки сервера и моделей.
  • Если документы запрещено передавать внешнему провайдеру: в проверенной конфигурации он получает текст при индексации и ответе; полностью локальная работа моделей здесь не проверена
Рекомендуем: CPU6-RAM16-DISK100Сложность: hardДо первого ответа: около 20 минут с настройкойГлавный риск: ссылка может не подтверждать ответДля работы: после проверки своих документов и резервной копии
Что это

Как RAGFlow ищет ответы в PDF

RAGFlow разбирает файл модулем DeepDoc, делит его на фрагменты и строит поисковый индекс. Когда вы задаете вопрос, найденные фрагменты передаются языковой модели вместе с вопросом.

Embedding-модель превращает текст в числовые представления для поиска. Chat-модель формулирует ответ. Поэтому ключ только к чату еще не дает рабочую базу знаний.

Практический сценарий: у инженера есть инструкция с десятками страниц, а нужен один параметр. Вместо поиска по всему файлу он спрашивает и открывает указанный источник.

В контрольной инструкции таблица задавала предельную температуру 73 °C. RAGFlow нашел значение и дал ссылку; открытый PDF подтвердил число. Это учебный документ, не паспорт настоящего оборудования.

Чат RAGFlow на русском: ответ 73 °C по контрольной инструкции и ссылка на PDF
Ответ по контрольному PDF: 73 °C, ссылка на исходную инструкцию.

Переключение языка доступно в верхнем меню. Основные разделы переведены на русский, но часть подписей и настроек остается английской: например, List models и General.

Обновление

Что изменилось с прошлого разбора

После v0.26.4 образ RAGFlow уменьшился с 12,3 до 1,16 ГБ; весь набор образов занимает 4,62 ГБ на диске. Для проверенной конфигурации по-прежнему рекомендуем сервер с 16 ГБ RAM.

Embedding-модель для поиска и Chat-модель для ответа подключаются отдельно. Встроенных embeddings нет еще с v0.22.0; прежнее обещание их наличия было ошибкой.

Переход со старой версии требует необратимой миграции с промежуточными запусками v0.27.2 и v1.0.0-rc1 перед v1.0.0. Сначала сохраните резервную копию; инструкция ниже предназначена для чистой машины.

Также устранена уязвимость приватных агентов. Прежняя статья v0.26.4 сохранена в истории.

Сравнение

Сколько стоит свой чат и облачные аналоги

Открытая версия RAGFlow не требует лицензионной подписки. Но счет включает сервер, обращения к двум моделям, резервные копии и время администратора - это не фиксированная цена всех ответов.

ВариантЦена на 8 ноября 2026Что получаете
RAGFlow на VPS2500 руб./мес. за выбранный тариф; API отдельноСвои файлы, индекс и настройки; эксплуатация своими силами
RAGFlow Cloud StarterНа сайте $29/мес., рядом обычные $595 ГБ хранения, 5000 кредитов; срок скидки не указан
Chatbase Hobby$40/мес.; $32 при годовой оплате700 message credits, два участника

Цены и лимиты: RAGFlow Cloud, Chatbase. Кредиты разных сервисов не равны числу одинаковых запросов, поэтому прямую окупаемость из этой таблицы считать нельзя.

Для российского покупателя VPS оплачивается в рублях. Chatbase указывает карты и ACH; поддержка российских карт в опубликованных условиях не подтверждена. Его политика описывает обработку в США.

Файлы и индекс нашей установки хранятся на VPS. При внешних моделях Embedding API получает текст документов, Chat API - вопрос и найденные фрагменты. Свой сервер сам по себе не делает обработку полностью локальной.

Устройство

Из чего состоит установка

На стенде работают семь контейнеров: RAGFlow, Elasticsearch, MySQL, S3-хранилище, Kvrocks, NATS и Caddy. Caddy принимает HTTPS и передает запросы локальному веб-порту приложения.

Elasticsearch хранит поисковый индекс, MySQL - учетные записи и метаданные, S3-служба - исходные файлы. Kvrocks обслуживает кеш, NATS - очередь заданий. Эти данные нужны вместе при восстановлении.

Go / DeepDocElasticsearch 8.11.3MySQL 8.0.40pgsty/siloKvrocks 2.16.0NATS 2.14.2Caddy 2.10.2

Документы разбираются на CPU; GPU в этой установке нет. Chat и Embedding выполняются у внешнего провайдера. Запросы самого RAGFlow к моделям проверены через прокси Fatmetal.

Лицензия проекта - Apache-2.0. За сервером и данными следите вы: открытая лицензия не включает договорную поддержку.

Сервер

Какую конфигурацию взять

Для повторения инструкции возьмите CPU6-RAM16-DISK100 и Ubuntu 24.04. На стенде было шесть vCPU, 16 ГБ RAM и 100 ГБ диска; Docker установлен из официального репозитория.

РесурсЧто закладывать
CPU6 vCPU в проверенной конфигурации
RAM16 ГБ: нужен запас сверх занятой памяти
Диск100 ГБ; после тестов занято около 12 ГиБ вместе с ОС и swap
МоделиКлюч провайдера с доступом к Chat и Embedding
СетьДомен на IP сервера, открытые 80/443 для HTTPS

Вендор рекомендует начать с четырех CPU, 16 ГБ памяти и 50 ГБ свободного диска. Наш результат подтверждает выбранные 16 ГБ, а не универсальный минимум для любого корпуса.

На 36-страничном PDF тома выросли примерно на 22 МиБ. Основной прирост пришелся на исходник и результаты разбора в S3; один размер загружаемого файла расход диска не описывает.

В маркетплейсе Fatmetal

Не хотите ставить руками?

Этот стек есть в маркетплейсе Fatmetal - можно не повторять установку из этого разбора вручную. Заказываете сервер, за пару минут получаете рабочий домен, валидный TLS и файл с доступами.

Рекомендуемая конфигурация:
6 vCPU · 16 ГБ RAM · 200 ГБ NVMe от 1 980 ₽/мес

В маркетплейс →
Установка

Развертывание на Fatmetal Cloud Server

Работайте на новой VM. Если сервер уже содержит RAGFlow, остановитесь: команды клонирования и смены секретов предназначены для первой установки, а не для переноса данных.

  1. Установите Docker

    Войдите по SSH с реквизитами из панели, выполните sudo -i и продолжайте в одной root-сессии. Команды рассчитаны на чистую Ubuntu 24.04.

    apt-get update
    apt-get install -y ca-certificates curl git openssl python3-yaml
    install -m 0755 -d /etc/apt/keyrings
    curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
    chmod a+r /etc/apt/keyrings/docker.asc
    printf 'deb [arch=%s signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu noble stable\n' "$(dpkg --print-architecture)" > /etc/apt/sources.list.d/docker.list
    apt-get update
    apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  2. Закрепите версию и подготовьте память

    Тег репозитория должен совпадать с образом: из репозитория монтируется entrypoint. Системный параметр нужен Elasticsearch; swap оставляем как страховку.

    git clone --depth 1 --branch v1.0.0 https://github.com/infiniflow/ragflow.git /opt/ragflow
    printf 'vm.max_map_count=262144\n' > /etc/sysctl.d/90-ragflow.conf
    sysctl -p /etc/sysctl.d/90-ragflow.conf
    fallocate -l 4G /swapfile && chmod 600 /swapfile
    mkswap /swapfile && swapon /swapfile
    printf '/swapfile none swap sw 0 0\n' >> /etc/fstab
    cd /opt/ragflow/docker
  3. Замените секреты и запретите открытую регистрацию

    Для каждого секрета создается отдельное случайное значение. Пароль администратора останется в .env, доступном только root.

    umask 077
    for key in ADMIN_DEFAULT_PASSWORD SECRET_KEY ELASTIC_PASSWORD MYSQL_PASSWORD MINIO_PASSWORD REDIS_PASSWORD; do
      sed -i "/^${key}=/d" .env; printf '%s=%s\n' "$key" "$(openssl rand -hex 24)" >> .env
    done
    chmod 600 .env
    sed -i -e 's/^REGISTER_ENABLED=.*/REGISTER_ENABLED=0/' -e 's/^ENABLE_REGISTER=.*/ENABLE_REGISTER=0/' .env
  4. Закройте внутренние порты и подключите прокси

    Снаружи остаются SSH и HTTPS. Прокси Fatmetal входит в VPS; NO_PROXY сохраняет прямую связь с базами внутри Docker.

    sed -i -e 's/^SVR_WEB_HTTP_PORT=.*/SVR_WEB_HTTP_PORT=8080/' -e 's/^SVR_WEB_HTTPS_PORT=.*/SVR_WEB_HTTPS_PORT=8443/' .env
    python3 - <<'PYCONF'
    from pathlib import Path
    import yaml
    for name in ('docker-compose.yml', 'docker-compose-base.yml'):
        path = Path(name); conf = yaml.safe_load(path.read_text())
        for service in conf['services'].values():
            if 'ports' in service:
                service['ports'] = [p if str(p).startswith(('127.0.0.1:', '${VB_BIND_ADDR')) else '127.0.0.1:' + str(p) for p in service['ports']]
        path.write_text(yaml.safe_dump(conf, sort_keys=False))
    PYCONF
    cat >> .env <<'ENV'
    HTTP_PROXY=http://api-proxy.fatmetal.net:8080
    HTTPS_PROXY=http://api-proxy.fatmetal.net:8080
    NO_PROXY=localhost,127.0.0.1,::1,10.0.0.0/8,172.16.0.0/12,es01,mysql,minio,kvrocks,nats,ragflow-cpu
    ENV
  5. Добавьте HTTPS

    Заранее направьте A-запись своего домена на IP сервера и откройте входящие 80/443. Вместо ваш-домен подставьте это имя; Caddy выпустит сертификат автоматически.

    cat > Caddyfile <<'CADDY'
    ваш-домен {
      reverse_proxy 127.0.0.1:8080
    }
    CADDY
    cat > compose.proxy.yml <<'YAML'
    services:
      caddy:
        image: caddy:2.10.2
        network_mode: host
        restart: unless-stopped
        volumes:
          - ./Caddyfile:/etc/caddy/Caddyfile:ro
          - caddy_data:/data
          - caddy_config:/config
    volumes:
      caddy_data:
      caddy_config:
    YAML
    printf 'COMPOSE_FILE=docker-compose.yml:compose.proxy.yml\n' >> .env
  6. Запустите стек

    Дождитесь healthy у баз и ответа HTTPS без предупреждения сертификата. Повторяйте проверку вручную, пока заканчивается первый запуск; пароль из последней команды никому не пересылайте.

    docker compose pull
    docker compose up -d
    docker compose ps
    curl -fsS https://ваш-домен/ -o /dev/null
    grep '^ADMIN_DEFAULT_PASSWORD=' .env

Готовый адрес - https://ваш-домен. Команды установки проверены на отдельной чистой машине, включая обычную проверку сертификата без отключения TLS.

Первый вход

Создайте пользователя и подключите две модели

Откройте https://ваш-домен/admin. Войдите как admin@ragflow.io с ADMIN_DEFAULT_PASSWORD из .env. В Users нажмите New user и задайте свой email и пароль.

Выйдите из панели и откройте обычный адрес приложения. Войдите созданным пользователем: суперпользователь для этого экрана не подходит. Открытая регистрация в нашей конфигурации выключена.

В настройках откройте «Провайдеры моделей», выберите OpenAI-API-Compatible. Для повторения теста: имя экземпляра Fatmetal_API, Base URL https://openrouter.ai/api/v1 и ваш ключ OpenRouter.

Через меню рядом с List models выберите Add custom model. Укажите openai/text-embedding-3-small, тип Embedding и Max context length 8191; подтвердите. Chat-модель openai/gpt-4o-mini найдите в списке.

Отметьте нужные модели и нажмите Save вверху экземпляра. Затем в «Установить модели по умолчанию» выберите их для Chat и Embedding. Выбор сохраняется автоматически.

Модели по умолчанию RAGFlow: gpt-4o-mini для чата и text-embedding-3-small для индексации
Модели по умолчанию: отдельно для ответа и для индексации.

Провайдера выбираете вы; в тесте использован OpenRouter. Прокси Fatmetal уже задан командами установки и входит в стоимость VPS, но запросы и токены оплачиваются выбранному провайдеру отдельно.

Первый документ

Загрузите PDF и проверьте ответ

Создайте датасет с выбранной Embedding-моделью и способом разбора General. Нажмите Add file → Upload file, выберите PDF и сохраните. Для повторения скачайте учебную инструкцию FM-Q17 с таблицей; это синтетический пример.

В строке файла нажмите треугольник запуска разбора. Дождитесь завершения и ненулевого числа фрагментов: сама загрузка еще не означает, что материал доступен поиску.

Датасет RAGFlow с руководством Raspberry Pi Pico на 70 фрагментов и контрольным PDF на 3 фрагмента
Руководство Pico разобрано на 70 фрагментов; рядом контрольный PDF с таблицей.

Создайте чат, откройте его настройки через шестеренку, выберите этот датасет и Chat-модель, нажмите Save. Для обычного вопроса по документам оставьте режим Naive.

Спросите: «Какая максимальная температура жидкости для насоса FM-Q17? Укажи единицы и источник». После ответа откройте ссылку, затем исходный PDF. Сверьте число, единицы и условия применения с текстом документа.

Просмотр исходной инструкции FM-Q17 из ссылки в ответе RAGFlow
В контрольной инструкции открытый источник подтвердил 73 °C. Документ специально создан для теста.

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

Замеры

Что происходит на настоящем руководстве

Измеряли v1.0.0 на CPU6-RAM16-DISK100, Ubuntu 24.04.4, Docker 29.9.3 и Compose 5.7.0. Корпус - два PDF; основная нагрузка - руководство Pico на 36 страниц.

ИзмерениеРезультат
Размер руководства3,16 МБ
Разбор до 70 фрагментов304 секунды, около пяти минут
Полный ответ на вопрос3,7 секунды, включая внешний API
RAM контейнеров после прогрева7,16 ГиБ
RAM контейнеров на пике теста7,18 ГиБ
Память машины вместе с ОС на пике7,98 ГиБ
Перезапуск до готовности всех проверок28 секунд, с существующими данными

Больше всего памяти занимают Elasticsearch и RAGFlow: примерно 4,29 и 2,23 ГиБ после прогрева. Во время теста swap не использовался, убийств процессов из-за нехватки памяти не было.

Стек занял меньше памяти до загрузки большого PDF: 5,35 ГиБ. Для выбора сервера полезнее учитывать состояние после обработки документов, а не только первый экран пустой установки.

Тариф на 8 ГБ оставил бы слишком мало пространства между наблюдаемым потреблением машины и ее емкостью. Количество одновременных пользователей из обработки двух файлов вывести нельзя.

Проверено на версии v1.0.0, 8 ноября 2026. На новых версиях результаты могут отличаться.

Диагностика

Где может сломаться

super admin should not login to this page.

Причина. Суперпользователь входит в панель управления, а не в обычный чат.

Решение. Откройте /admin, создайте пользователя в Users и войдите им через обычный экран.

Некорректное имя экземпляра провайдера

Причина. Имя с пробелом Fatmetal API отклоняется при сохранении.

Решение. Используйте Fatmetal_API. Завершите настройку кнопкой Save, а не Add instance.

Файл загружен, но фрагментов 0

Причина. Загрузка и индексация - разные действия.

Решение. Нажмите запуск разбора в строке файла. Проверьте выбранную Embedding-модель и ее ключ; затем посмотрите журнал приложения.

cd /opt/ragflow/docker
docker compose logs --tail=100 ragflow-cpu
docker compose ps
Elasticsearch не становится healthy

Причина. Одна из проверенных причин - слишком маленький vm.max_map_count.

Решение. Проверьте sysctl vm.max_map_count; примените файл sysctl -p /etc/sysctl.d/90-ragflow.conf и повторите docker compose up -d.

Эксплуатация

Резервная копия и восстановление

Остановите весь стек, чтобы MySQL, индекс, очередь и файлы попали в одну согласованную копию. Следующие команды выполняйте в root-сессии; во время копирования приложение недоступно.

cd /opt/ragflow/docker
docker compose stop
tar -czf /root/ragflow-backup.tgz -C / opt/ragflow -C /var/lib/docker/volumes docker_mysql_data docker_esdata01 docker_minio_data docker_kvrocks_data docker_nats_data docker_caddy_data docker_caddy_config
docker compose start

Архив содержит секреты и ключи провайдера из базы: храните его с ограниченным доступом и переносите копию за пределы VM. Архив только на том же диске не защищает от потери сервера.

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

cd /opt/ragflow/docker
tar -tzf /root/ragflow-backup.tgz > /dev/null
docker compose down -v
tar -xzf /root/ragflow-backup.tgz -C /opt/ragflow --strip-components=2 opt/ragflow
docker compose create
tar -xzf /root/ragflow-backup.tgz -C /var/lib/docker/volumes --exclude=opt
docker compose up -d

После восстановления войдите прежним пользователем, проверьте список документов и повторите контрольный вопрос. Такой цикл проверен на отдельной машине; для другого сервера нужны та же версия и тома с теми же именами.

Обычный перезапуск выполняется командой docker compose restart. Перед обновлением сохраняйте весь набор данных; не запускайте старый установщик поверх рабочей базы.

Безопасность

Уязвимости прошлых версий

Команды этой статьи ставят v1.0.0 с подтвержденным исправлением доступа к приватным агентам. Для старой v0.26.4 исправленная ветка 0.x начинается с v0.27.3; переход на 1.0 требует промежуточных миграций.

БюллетеньУровень и затронутые версииИсправление и действие
CVE-2026-42533, CVE-2026-9256Critical по GitHub; nginx до 1.31.2 / 1.31.0Обновления nginx в RAGFlow 0.27.0; опасные rewrite/map-конструкции в прежнем штатном конфиге не найдены
CVE-2026-119337High, RAGFlow 0.25.2-0.27.20.27.3: API-ключ и чужой UUID позволяли запускать приватного агента
CVE-2025-21521High; MySQL ≤8.0.39RAGFlow 0.27.0 обновляет MySQL; применимость зависит от Thread Pooling
CVE-2025-67221, CVE-2026-0994, CVE-2026-26209High; orjson <3.11.6, protobuf 5.29.5, cbor2 ≤5.8.0Зависимости прежней 0.26.4 обновлены в 0.27.0
CVE-2026-21226, CVE-2026-33752, CVE-2026-59939High; azure-core <1.38, curl_cffi <0.15, httplib2 <0.32Зависимости обновлены в 0.27.0
CVE-2026-42033High; axios 1.x <1.15.10.27.0; эксплуатация требует отдельного источника prototype pollution
CVE-2025-69534, CVE-2026-53533Medium; Markdown <3.8.1, aiosmtplib ≤5.1.0Зависимости обновлены в 0.27.0

Список исправлений зависимостей опубликован в релизе 0.27.0. Наличие старой библиотеки не доказывает воспроизводимость каждой атаки в конкретной установке.

В новой установке секреты заменены, регистрация закрыта, внутренние порты привязаны к localhost. Административная панель остается доступна по HTTPS и защищается отдельным паролем.

Ограничения

Когда это НЕ ваш выбор

Нужна безошибочная ссылка на источник

На руководстве Pico ответ «115200 бод» оказался правильным, но ссылка [2] открыла фрагмент без этого числа. В других найденных фрагментах число было. Для технических решений ответ и цитату проверяйте отдельно.

Ответ RAGFlow про UART 115200 бод со ссылкой [2], не подтверждающей указанное число
Отрицательный пример: число в ответе верно, но выбранная ссылка его не подтверждает.

Документы запрещено передавать внешним моделям

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

Нужен простой личный блокнот

Здесь нужно обслуживать несколько хранилищ, ждать разбора PDF и настраивать модели. Если задача ограничивается несколькими файлами, семь контейнеров могут стоить больше времени, чем принесут пользы.

Рядом

С чем сочетать и что выбрать вместо

AnythingLLM стоит рассмотреть для общего сценария «рабочий чат с документами». RAGFlow имеет смысл выбирать по результату разбора ваших PDF, а не по обещанию одинакового качества для любых файлов.

Open WebUI подойдет как точка сравнения, если сначала нужен интерфейс к моделям, а обработка технических руководств - дополнительная задача.

Существующие регламенты и PDF можно начать переносить небольшой подборкой. Сначала выберите документы с известными таблицами и параметрами, затем проверьте извлечение до загрузки всего архива.

FAQ

Частые вопросы

Нужна ли видеокарта?

В проверенной установке PDF разбирается на CPU, а обе модели работают через внешний API. Видеокарта на VPS не нужна.

Почему недостаточно ключа только к Chat?

Индексация требует Embedding-модели. Подключите ее и выберите по умолчанию до создания датасета.

Где пароль администратора?

В /opt/ragflow/docker/.env, строка ADMIN_DEFAULT_PASSWORD. Вход суперпользователя - /admin, вход в чат - созданным обычным пользователем.

Почему после загрузки нет ответа?

Дождитесь завершения разбора, ненулевого числа фрагментов и выберите датасет в настройках чата. На руководстве Pico индексация заняла пять минут.

Нужен ли отдельный платеж за прокси?

Нет, прокси к внешним API входит в VPS Fatmetal. Счет за использование моделей остается у выбранного провайдера. Повторите контрольный вопрос после подключения своего ключа.

Какой архив нужен для восстановления?

Сохраняйте /opt/ragflow и семь томов из команды резервирования вместе. После восстановления проверьте вход, документы и ответ со ссылкой.

Итог

RAGFlow полезен инженеру, который ищет ответы в технических PDF и готов проверять их по источнику. Начните с нескольких инструкций и вопросов с известным ответом, затем решайте, переносить ли весь архив.

Рекомендуемая конфигурация для установки:
6 vCPU · 16 ГБ RAM · 200 ГБ NVMe

Не хотите устанавливать вручную?

Запустите RAGFlow на этой конфигурации автоматически - от 1 980 ₽/мес.

Запустить RAGFlow →
Анонсы новых разборов в Telegram-канале Новые гайды и карточки в маркетплейсе первыми @fatmetal_channel →

Этот стек у нас запущен на тарифе CPU6-RAM16-DISK100. Нашли баг в гайде - напишите, поправим в течение дня.