RAGFlow
Чат по документам на своем сервере: загружаете технический PDF, задаете вопрос и открываете источник ответа. Развернули v1.0.0 на Fatmetal Cloud Server, замерили ресурсы и проверили ответы по таблице и руководству Raspberry Pi Pico.
Вердикт
- Сервисному инженеру, который ищет параметры оборудования в PDF-инструкциях.
- Поддержке, которой нужен ответ по регламенту с возможностью открыть исходную таблицу.
- Команде, которая хочет отдельно управлять документами, поиском и провайдером моделей.
- Для автоматических решений без проверки источника ответа.
- Для личного блокнота без настройки сервера и моделей.
- Если документы запрещено передавать внешнему провайдеру: в проверенной конфигурации он получает текст при индексации и ответе; полностью локальная работа моделей здесь не проверена
Как RAGFlow ищет ответы в PDF
RAGFlow разбирает файл модулем DeepDoc, делит его на фрагменты и строит поисковый индекс. Когда вы задаете вопрос, найденные фрагменты передаются языковой модели вместе с вопросом.
Embedding-модель превращает текст в числовые представления для поиска. Chat-модель формулирует ответ. Поэтому ключ только к чату еще не дает рабочую базу знаний.
Практический сценарий: у инженера есть инструкция с десятками страниц, а нужен один параметр. Вместо поиска по всему файлу он спрашивает и открывает указанный источник.
В контрольной инструкции таблица задавала предельную температуру 73 °C. RAGFlow нашел значение и дал ссылку; открытый PDF подтвердил число. Это учебный документ, не паспорт настоящего оборудования.
Переключение языка доступно в верхнем меню. Основные разделы переведены на русский, но часть подписей и настроек остается английской: например, 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 на VPS | 2500 руб./мес. за выбранный тариф; API отдельно | Свои файлы, индекс и настройки; эксплуатация своими силами |
| RAGFlow Cloud Starter | На сайте $29/мес., рядом обычные $59 | 5 ГБ хранения, 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 - очередь заданий. Эти данные нужны вместе при восстановлении.
Документы разбираются на CPU; GPU в этой установке нет. Chat и Embedding выполняются у внешнего провайдера. Запросы самого RAGFlow к моделям проверены через прокси Fatmetal.
Лицензия проекта - Apache-2.0. За сервером и данными следите вы: открытая лицензия не включает договорную поддержку.
Какую конфигурацию взять
Для повторения инструкции возьмите CPU6-RAM16-DISK100 и Ubuntu 24.04. На стенде было шесть vCPU, 16 ГБ RAM и 100 ГБ диска; Docker установлен из официального репозитория.
| Ресурс | Что закладывать |
|---|---|
| CPU | 6 vCPU в проверенной конфигурации |
| RAM | 16 ГБ: нужен запас сверх занятой памяти |
| Диск | 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, остановитесь: команды клонирования и смены секретов предназначены для первой установки, а не для переноса данных.
Установите 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Закрепите версию и подготовьте память
Тег репозитория должен совпадать с образом: из репозитория монтируется 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Замените секреты и запретите открытую регистрацию
Для каждого секрета создается отдельное случайное значение. Пароль администратора останется в .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Закройте внутренние порты и подключите прокси
Снаружи остаются 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Добавьте 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Запустите стек
Дождитесь 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. Выбор сохраняется автоматически.
Провайдера выбираете вы; в тесте использован OpenRouter. Прокси Fatmetal уже задан командами установки и входит в стоимость VPS, но запросы и токены оплачиваются выбранному провайдеру отдельно.
Загрузите PDF и проверьте ответ
Создайте датасет с выбранной Embedding-моделью и способом разбора General. Нажмите Add file → Upload file, выберите PDF и сохраните. Для повторения скачайте учебную инструкцию FM-Q17 с таблицей; это синтетический пример.
В строке файла нажмите треугольник запуска разбора. Дождитесь завершения и ненулевого числа фрагментов: сама загрузка еще не означает, что материал доступен поиску.
Создайте чат, откройте его настройки через шестеренку, выберите этот датасет и Chat-модель, нажмите Save. Для обычного вопроса по документам оставьте режим Naive.
Спросите: «Какая максимальная температура жидкости для насоса FM-Q17? Укажи единицы и источник». После ответа откройте ссылку, затем исходный PDF. Сверьте число, единицы и условия применения с текстом документа.
Сохраните несколько таких вопросов с заранее известными ответами для своих инструкций. После смены модели или повторного разбора прогоняйте их снова: наличие ответа само по себе ничего не говорит о качестве поиска.
Что происходит на настоящем руководстве
Измеряли 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. На новых версиях результаты могут отличаться.
Где может сломаться
Причина. Суперпользователь входит в панель управления, а не в обычный чат.
Решение. Откройте /admin, создайте пользователя в Users и войдите им через обычный экран.
Причина. Имя с пробелом Fatmetal API отклоняется при сохранении.
Решение. Используйте Fatmetal_API. Завершите настройку кнопкой Save, а не Add instance.
Причина. Загрузка и индексация - разные действия.
Решение. Нажмите запуск разбора в строке файла. Проверьте выбранную Embedding-модель и ее ключ; затем посмотрите журнал приложения.
cd /opt/ragflow/docker
docker compose logs --tail=100 ragflow-cpu
docker compose psПричина. Одна из проверенных причин - слишком маленький 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-9256 | Critical по GitHub; nginx до 1.31.2 / 1.31.0 | Обновления nginx в RAGFlow 0.27.0; опасные rewrite/map-конструкции в прежнем штатном конфиге не найдены |
| CVE-2026-119337 | High, RAGFlow 0.25.2-0.27.2 | 0.27.3: API-ключ и чужой UUID позволяли запускать приватного агента |
| CVE-2025-21521 | High; MySQL ≤8.0.39 | RAGFlow 0.27.0 обновляет MySQL; применимость зависит от Thread Pooling |
| CVE-2025-67221, CVE-2026-0994, CVE-2026-26209 | High; 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-59939 | High; azure-core <1.38, curl_cffi <0.15, httplib2 <0.32 | Зависимости обновлены в 0.27.0 |
| CVE-2026-42033 | High; axios 1.x <1.15.1 | 0.27.0; эксплуатация требует отдельного источника prototype pollution |
| CVE-2025-69534, CVE-2026-53533 | Medium; Markdown <3.8.1, aiosmtplib ≤5.1.0 | Зависимости обновлены в 0.27.0 |
Список исправлений зависимостей опубликован в релизе 0.27.0. Наличие старой библиотеки не доказывает воспроизводимость каждой атаки в конкретной установке.
В новой установке секреты заменены, регистрация закрыта, внутренние порты привязаны к localhost. Административная панель остается доступна по HTTPS и защищается отдельным паролем.
Когда это НЕ ваш выбор
Нужна безошибочная ссылка на источник
На руководстве Pico ответ «115200 бод» оказался правильным, но ссылка [2] открыла фрагмент без этого числа. В других найденных фрагментах число было. Для технических решений ответ и цитату проверяйте отдельно.
Документы запрещено передавать внешним моделям
Приведенная конфигурация отправляет текст провайдеру при индексации и ответе. Полностью локальная обработка требует другого размещения обеих моделей; их ресурсы в выбранный тариф этим тестом не обоснованы.
Нужен простой личный блокнот
Здесь нужно обслуживать несколько хранилищ, ждать разбора PDF и настраивать модели. Если задача ограничивается несколькими файлами, семь контейнеров могут стоить больше времени, чем принесут пользы.
С чем сочетать и что выбрать вместо
AnythingLLM стоит рассмотреть для общего сценария «рабочий чат с документами». RAGFlow имеет смысл выбирать по результату разбора ваших PDF, а не по обещанию одинакового качества для любых файлов.
Open WebUI подойдет как точка сравнения, если сначала нужен интерфейс к моделям, а обработка технических руководств - дополнительная задача.
Существующие регламенты и PDF можно начать переносить небольшой подборкой. Сначала выберите документы с известными таблицами и параметрами, затем проверьте извлечение до загрузки всего архива.
Частые вопросы
Нужна ли видеокарта?
В проверенной установке 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 ₽/мес.
Этот стек у нас запущен на тарифе CPU6-RAM16-DISK100. Нашли баг в гайде - напишите, поправим в течение дня.