Самостоятелно хостване

Node и директория с права за запис са цялото изискване. Твърденията по-долу са прочетени от файловете, посочени до тях; всичко, което не можа да бъде потвърдено, не е тук.

Входни точки

• package.json изисква Node >= 22.5. SQLite хранилището е собственият модул node:sqlite на Node.
• Изобщо няма списък със зависимости: приложенията, пакетите, скриптовете и тестовете работят със стандартната библиотека на Node, а Dockerfile не инсталира нищо.
• Съществуват три процеса; всеки отваря базата данни и изпълнява миграцията при стартиране.

node apps/web/server/main.mjs                   # hub + console + embedded API
API_EMBED=false node apps/api/src/main.mjs    # API only, no pages
node apps/worker/src/run.mjs                  # probes, latency, rollup, housekeeping

Хранилище за данни

DATABASE_URL=sqlite:./data/llmeu.db не се нуждае от сървър, а директорията и файлът се създават при първо отваряне. Хендълът работи в WAL режим с включени външни ключове и 5 s изчакване при заетост.

packages/shared/src/db/schema.sql е схемата. Тя е само за създаване и идемпотентна, така че повторното ѝ изпълнение е безопасно; колона, добавена към съществуваща таблица, също трябва да бъде декларирана в добавъчната стъпка в packages/shared/src/db/index.mjs.

CLI за оператор

node scripts/db.mjs чете DATABASE_URL и не се нуждае от услуги. Команди:

Среда

Групирани както ги групира .env.example.

Docker

Compose и изображението са незадължителни: собственият набор от тестове на хранилището не изисква Docker, а основният път е локален процес без услуги.

• Профилът по подразбиране стартира web: портове 3000 и 8088, SQLite на том llmeu-data в /app/data, вграденото API и проверка на състоянието на /healthz.
• Същото изображение стартира worker с node apps/worker/src/run.mjs, изчаквайки web да стане здрав и споделяйки тома llmeu-data.
• Два допълнителни профила са изключени по подразбиране: postgres (postgres:16-alpine) и redis (redis:7-alpine, резервиран и не се чете от кодовия път v1).
• Профилът gpu стартира vllm/vllm-openai с резервация на NVIDIA устройство и монтира тегла само за четене от хоста; не е разрешен по подразбиране, защото твърдение за извод в ЕС без GPU би било невярно.
• Dockerfile е FROM node:24-alpine с tini, без стъпка за изграждане и без инсталиране на зависимости, работи като потребител node, записва само под /app/data, експонира 3000 и 8088 и стартира apps/web/server/main.mjs.

Резервни копия

node scripts/backup.mjs без флагове записва ./backups/llmeu-<stamp>.db. SQLite се копира с VACUUM INTO, никога cp, защото жива WAL база данни, копирана с cp, може да доведе до разкъсано или остаряло състояние.

node scripts/backup.mjs                                  # ./backups/llmeu-<stamp>.db
node scripts/backup.mjs --out /srv/backups/              # explicit destination
node scripts/backup.mjs --verify ./backups/llmeu-<stamp>.db
node scripts/backup.mjs --restore ./backups/llmeu-<stamp>.db --yes
node scripts/backup.mjs --list

Всяко резервно копие на SQLite се проверява, преди скриптът да отчете успех: възстановява се във временно копие, PRAGMA integrity_check трябва да върне ok, схемата се прилага отново и се отпечатват броят на редовете за модели, организации и потребители.

С URL postgres:// скриптът използва pg_dump --format=custom и се нуждае от pg_dump в PATH; дъмп не може да бъде отворен като база данни, така че броят на редовете му изисква временно възстановяване.

Поща

Транзакционната поща — нулиране на парола, проверка на адрес, покани — използва MAIL_SMTP_* или MAIL_API_URL с MAIL_FROM. Транспортът се избира еднократно при стартиране и се отчита на всяка страница, която се нуждае от поща.

Внедряване без нито едно от двете е поддържано състояние: регистрацията, входът, смяната на парола, екипите и поканите работят, но пощата за нулиране на парола и за проверка не може да бъде обработена там. Страниците го казват, а node scripts/db.mjs passwd <email> е пътят за възстановяване.

Бекендове за инференция

Всеки ред за endpoint посочва среда за изпълнение и регион, а регистърът на бекендовете избира адаптера по регион, така че даден endpoint може да бъде обслужен само от машина в региона, който посочва.

• INFERENCE_MOCK=true запазва детерминистичния mock бекенд, който не се нуждае от GPU и от тегла.
• GPU_ENABLED=false изключва управляваните бекендове; при GPU_ENABLED=true VLLM_BASE_URL се прилага за единствения регион, посочен от VLLM_REGION.
• Внедряване с няколко региона задава по една променлива за регион, именувана по slug на региона (например VLLM_BASE_URL_DE_FRA). Endpoint в регион без конфигуриран бекенд се отказва, вместо да бъде обслужен от машина в друг регион.
• Партньорските бекендове идват от PARTNER_BASE_URL_<REGION> и използват PARTNER_SOVEREIGNTY и PARTNER_API_KEY; сървърът разрешава използване на партньори, когато PARTNER_BASE_URL е зададен.