> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yahont.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Объектное хранилище

> Настройка встроенного объектного хранилища SeaweedFS

## Обзор

Объектное хранилище — это S3-совместимый сервис,
который Yahont с самостоятельным размещением поставляет для хранения файлов: вложений чата, загрузок,
вложений коннекторов, снимков Craft и других файлов, которые Yahont держит вне PostgreSQL.
Он запускает [SeaweedFS](https://github.com/seaweedfs/seaweedfs) одним процессом и заменяет встроенный MinIO.
Обновление с MinIO выполняется автоматически. См.
[Миграция объектного хранилища](https://docs.yahont.ai/admins/advanced_configs/object_store_migration.md).

Вместо него можно использовать AWS S3, Google Cloud Storage, Azure Blob Storage или любой S3-совместимый сервис.
Задайте `FILE_STORE_BACKEND` и соответствующие переменные из [справочника по
конфигурации](https://docs.yahont.ai/deployment/configuration/configuration.md) и оставьте объектное хранилище выключенным.
Yahont Lite хранит файлы в PostgreSQL (`FILE_STORE_BACKEND=postgres`) и не запускает объектное хранилище.

## Docker Compose

Сервис `object-store` входит в профиль `s3-filestore` Compose,
который `.env` включает по умолчанию (`COMPOSE_PROFILES=s3-filestore`).
Приложение обращается к нему по `S3_ENDPOINT_URL=http://object-store:8333` и аутентифицируется парой
`S3_AWS_ACCESS_KEY_ID` / `S3_AWS_SECRET_ACCESS_KEY`, которую хранилище использует как учётные данные администратора.
Установщик Yahont CLI генерирует эту пару. Если вы пишете `.env` вручную, смените значение по умолчанию `minioadmin`,
прежде чем переходить в работу.

Данные лежат в томе `object_store_data`. Из контейнера наружу выходит только порт S3. Порты filer,
master и volume SeaweedFS принимают запросы без учётных данных, поэтому внутри контейнера они слушают loopback.

`.env` из выпуска до v5.0 всё ещё указывает на MinIO (`S3_ENDPOINT_URL=http://minio:9000`).
`onyx-cli deploy upgrade` переписывает его.
Для обновления вручную задайте `S3_ENDPOINT_URL=http://object-store:8333` и `S3_LEGACY_ENDPOINT_URL=http://minio:9000`,
затем держите сервис `minio`, пока копирование не завершится.

## Использование собственного хранилища

Чтобы работать без объектного хранилища, выключите его и укажите приложению ваше хранилище.

В Compose уберите `s3-filestore` из `COMPOSE_PROFILES` и задайте в `.env` те же переменные: `FILE_STORE_BACKEND=s3`,
`S3_FILE_STORE_BUCKET_NAME` и пару `S3_AWS_ACCESS_KEY_ID` / `S3_AWS_SECRET_ACCESS_KEY` для вашего хранилища.
Чтобы хранить файлы в PostgreSQL, задайте `FILE_STORE_BACKEND=postgres`.

## Размер

Хранилищу нужно столько места на диске, сколько занимают ваши файлы, плюс столько же во время миграции с MinIO,
пока оба хранилища содержат все файлы. Потребности в процессоре и памяти невелики.
Копирование миллиона файлов заняло около двух ядер и менее 2 ГБ памяти. В покое нужно намного меньше.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.