Platformsgrundlag
Libre WebUI har en lokal solo-profil og en delt team-profil. Solo bruger SQLite, krypterede lokale blobs, krypterede indlejrede vektorer, lokal koordinering og en indlejret vedvarende worker. Team bruger PostgreSQL, private S3-kompatible blobs, PGVector, Redis-koordinering og en ekstern vedvarende worker. Blandede profiler afvises ved opstart i stedet for stiltiende at opdele tilstanden mellem lokale og delte backends.
Aktuel milepæl
| Område | Implementeret grundlag | Resterende arbejde for kaldere |
|---|---|---|
| Persistens | SQLite- og PostgreSQL-repositories, uforanderlige migreringer, transaktioner med forbindelsespuljer | Nye domæner skal bruge repository-grænser |
| Blobs | Krypterede lokale og S3-kompatible streaminglagre, byteintervaller, checksummer, vedvarende kvoter | Flyt chatvedhæftninger, avatarer og øvrige resterende inline-binærfelter |
| Vektorer | Krypterede indlejrede vektorer, PGVector-ACL'er og sletningssikre genopbygninger af dokumentindekset | Nye embedding-kaldere skal bevare samme autoritets- og livscykluskontrakt |
| Koordinering | Lokale og Redis-baserede events, cache, leases, rate limits, invalidering og health | Redis må ikke blive autoritativ |
| Jobs/events | SQLite-/PostgreSQL-køer, transaktionelle events, workers, genforsøg, annullering, administration | Hver ny sideeffekt kræver et design med idempotens eller outbox |
| Drift | Health-gates, signerede/krypterede backuparkiver, gendannelse til et rent mål, verifikation | Afprøv gendannelse og accept på tværs af replikaer i hvert driftsmiljø |
Runtime-profiler
LIBRE_PLATFORM_MODE=solo er standard. Den vælger SQLite, lokale blobs, indlejrede vektorer, lokal koordinering og den indlejrede vedvarende worker. Redis kan vælges i solotilstand, men det gør ikke SQLite eller lokale filer sikre at dele mellem replikaer.
LIBRE_PLATFORM_MODE=team kræver alle delte afhængigheder på én gang:
DATABASE_BACKEND=postgresmedDATABASE_URL;BLOB_STORE_BACKEND=s3;VECTOR_STORE_BACKEND=pgvector;COORDINATION_BACKEND=redismedREDIS_URL; ogJOB_WORKER_MODE=external.
Disse valg hører sammen. Teamopstarten mislykkes, når en delt afhængighed mangler, eller når en lokal backend er blandet ind i profilen.
Migrer en eksisterende solo-installation
Stop alle Libre-programmer og workers før migreringen. Eksemplerne bruger den installerede libre-webui-kommando fra global npm eller Homebrew. Uden global installation erstatter du den med npx --yes libre-webui@latest. Fra en kildekode-checkout bygger du én gang og erstatter libre-webui migrate-postgres med npm run migrate:postgres --. Konfigurer PostgreSQL, S3 og versionerede krypteringsnøgler for målet præcis som den kommende teaminstallation, og kør først den skrivebeskyttede analyse:
libre-webui migrate-postgres \
--source /absolute/path/to/data.sqlite \
--plugins /absolute/path/to/plugins \
--mode dry-run
Anvend kun på det tomme mål, som rapporten identificerer. En mislykket kørsel efterlader en importjournal beskyttet med checksum; genoptag samme kilde og mål i stedet for at starte en uafhængig import:
libre-webui migrate-postgres \
--source /absolute/path/to/data.sqlite \
--plugins /absolute/path/to/plugins \
--mode apply
# Only after an interrupted apply of this exact source and target:
libre-webui migrate-postgres \
--source /absolute/path/to/data.sqlite \
--plugins /absolute/path/to/plugins \
--mode apply --resume
libre-webui migrate-postgres \
--source /absolute/path/to/data.sqlite \
--plugins /absolute/path/to/plugins \
--mode validate
Fuldførelsesmarkøren skrives først, når relationsrækker, plugin-definitioner, lokale krypterede blobs, indlejrede vektorer og legacy-personavektorer alle er overført og autentificeret i PostgreSQL/S3/PGVector. Kommandoen opfinder aldrig en krypteringsnøgle for kilden: ENCRYPTION_KEY skal matche kildens .encryption_key, og STORAGE_ENCRYPTION_KEYS skal indeholde den konfigurerede aktive nøgle plus den tilsvarende legacy-post.
Kør den medfølgende teamprofil
MinIO udgiver ikke længere container-images. Teamprofilen og CI henter Chainguards byg af MinIO-server og MinIO-klient fra cgr.dev/chainguard, fastlåst via digest. Værter, der begrænser adgangen til registre, skal tillade cgr.dev. Serveren kører som root, ligesom det tidligere officielle image gjorde, så volumener, der blev oprettet før skiftet, forbliver skrivbare.
Start fra den medfølgende skabelon, der fejler lukket. Opbevar den udfyldte miljøfil uden for repositoryet, og begræns adgangen til dens operatør:
cp deploy/team/.env.example /absolute/path/to/libre-team.env
chmod 600 /absolute/path/to/libre-team.env
Erstat alle REPLACE_*-værdier før opstart. Generér PostgreSQL-adgangskoden med et URL-sikkert alfabet (for eksempel openssl rand -hex 32), fordi samme streng både er serverens adgangskode og en del af DATABASE_URL. ENCRYPTION_KEY og hver værdi i STORAGE_ENCRYPTION_KEYS skal være præcis 64 hexadecimale tegn. På en ny installation skal legacy-posten være lig med ENCRYPTION_KEY; ved SQLite-migrering skal begge være lig med kildenøglen. Brug en anden aktiv nøgle til nye blobskrivninger, og behold gamle nøgler, indtil objektopgørelsen viser, at de ikke længere bruges.
Samme fil kan angive POSTGRES_MIGRATION_MODE, POSTGRES_POOL_MAX, de understøttede PostgreSQL-timeouts, REDIS_CONNECT_TIMEOUT_MS, OLLAMA_BASE_URL, OLLAMA_TIMEOUT, OLLAMA_LONG_OPERATION_TIMEOUT og OLLAMA_MAX_CONTEXT; det delte Compose-miljø sender hver værdi uændret til både programmet og den eksterne worker. Udbyder-timeouts accepterer 1.000-3.600.000 millisekunder, maksimal kontekst accepterer 128-2.097.152 tokens, og den lange timeout kan ikke være kortere end standardtimeouten. Ugyldige værdier får begge serverens entrypoints til at fejle, før der oprettes tilstand. Node-lokale Agent CLI-binærfiler og Codex OAuth-tokenfiler understøttes ikke af eksterne vedvarende workers, så teamprofilen slår begge udbyderveje fra, og opstarten afviser forsøg på at aktivere dem. Start derefter programreplikaerne, den eksterne vedvarende worker, PostgreSQL/PGVector, Redis, den versionerede MinIO-bucket og gatewayen:
docker compose --env-file /absolute/path/to/libre-team.env \
-f docker-compose.team.yml up --build --scale libre-webui=3 -d
docker compose --env-file /absolute/path/to/libre-team.env \
-f docker-compose.team.yml ps
Grundprofilen for team monterer bevidst ingen Docker-socket, så Docker-baseret Work er ikke tilgængelig. Aktivér den kun ved at medtage det medfølgende produktionsoverlay i hver livscykluskommando:
docker compose --env-file /absolute/path/to/libre-team.env \
-f docker-compose.team.yml -f docker-compose.team.work.yml \
up --build --scale libre-webui=3 -d
docker compose --env-file /absolute/path/to/libre-team.env \
-f docker-compose.team.yml -f docker-compose.team.work.yml ps
Overlayet peger både program- og worker-processer på én filtreret Docker-socketproxy på et rent internt netværk. Ingen af processerne modtager den rå socket eller medlemskab af socketgruppen, og Work-arbejdsområder i værtsmapper forbliver deaktiveret. Proxyen eksponerer kun info, images, containers, exec, volumes, networks og de skrivemetoder, som disse livscykluskald kræver. Det indsnævrer API-overfladen, men gør ikke Docker til en tenantgrænse: oprettelse af containere kan stadig bind-mounte værtsstier. Brug en dedikeret VM eller en rootless/separat Work-daemon, når værtsisolering er vigtig.
Eksponér ikke de PostgreSQL-, Redis- og MinIO-tjenester, som Compose ejer, direkte. Til administrerede afhængigheder bruger du Helm-teamprofilen og bevarer verificeret TLS; Compose-filen slår kun PostgreSQL-TLS fra på sit private projektnetværk. Readiness forbliver mislykket, indtil der findes en ekstern worker.
Den indbyggede Strands-motor gemmer sidens sessioner som filer under <DATA_DIR>/strands/, ikke i programmets database. Dens Work-driver opretter ikke et lokalt varigt lager. Works eksisterende SQL-poster for opgaver, kørsler, beskeder og godkendelser samt varige jobs er fortsat autoritative, også ved gendannelse på en ekstern worker. Et motorvalg gemmes sammen med den valgte model som strands:<model> (kørsler, der er gemt med det ældre præfiks dsh:<model>, åbnes som Strands-kørsler) og bevarer den eksisterende udbyderidentitet og runtimeautorisation.
Persistens- og migrationsgrænse
Identitet og autorisation bruger nu asynkrone repositories. Repositoryets transaktionscallback modtager en unit of work, der er bundet til samme databaseforbindelse; brug af det globale repository inde fra denne callback afvises. Det er den transaktionsgrænse, som PostgreSQL-forbindelsespuljen bruger, samtidig med at den nuværende SQLite-adfærd bevares.
SQLite-migrationskoordinatoren overtager kun eksisterende installationer efter at have valideret det krævede skema. Den registrerer et nummereret migrationsnavn og en checksum, verificerer dem ved hver opstart, afviser nyere, ukendte eller uoverensstemmende ledgers og stopper opstarten, når migrering eller skemavalidering mislykkes. Readiness og gendannelsesopgørelsen bruger samme kanoniske inspektionskontrakt.
Før tilstandsfulde programtjenester importeres, kopierer opstarten den eksisterende SQLite-database og de aktive WAL/SHM-filer til en privat scratch-mappe og validerer kopien. PLATFORM_PREFLIGHT_TMP_DIR skal have plads nok til databasen plus dens WAL. De medfølgende Docker- og Helm-installationer monterer dedikeret diskbaseret midlertidig lagring dér; opstarten er ikke afhængig af den begrænsede /tmp-tmpfs. En manglende legacy-krypteringsnøgle eller en historisk indlejret datamappe blokerer opstarten, før en erstatningsnøgle, database eller plugin-tilstand kan oprettes.
En vellykket opstart gemmer en verifikationsmarkør knyttet til databasefilen og skemaet. Senere opstarter genbruger den, indtil filen eller skemaet ændres. Filidentifikatorer gemmes som præcise decimalstrenge, også store Windows/NTFS-identifikatorer. En ældre numerisk markør udløser én fuld verifikation, før den erstattes.
Skema v4 tilføjer et nøglebaseret lighedstoken for krypterede identitets-e-mails. Gendannelse kræver, at hvert token findes og matcher sin autentificerede e-mail. Opstarten tillader et manglende token med en autentificeret e-mail eller en legacy-værdi uden envelope i det korte crashvindue efter v4-commit, så repository-initialiseringen kan fuldføre backfill af kryptering og tokens. Ældre udgivelser accepterede vilkårlige e-mailstrenge og brugte tomme værdier til at rydde feltet; overtagelsen bevarer ikke-tomme værdier og normaliserer tomme værdier til NULL. Beskadigede værdier med envelope-form og enhver uoverensstemmelse, der ikke er null, får stadig preflight til at fejle.
Programtjenester bruger asynkrone dialekt-repositories. Native SQLite er begrænset til SQLite-adaptere, migrations- og gendannelsesinspektion samt eksplicit injicerede health checks. Runtime-lagringen initialiseres fra den valgte Persistence; aktivering af PostgreSQL falder aldrig tilbage til SQLite-singletonen eller historiske JSON-filer, der afhænger af cwd.
Den fælles runtime til vedvarende jobs forbliver også driverneutral. Aktørautorisation læses gennem det valgte identitets-repository, mens konstruktion af native job-repositories er begrænset til én grænse for adaptersammensætning. Transaktionelle domæne-publishers modtager en uigennemsigtig synkron executor i SQLite og en transaktionsbundet executor i PostgreSQL; de modtager aldrig et better-sqlite3-handle. Testen af persistensgrænsen afviser native driver-handles i de fælles kontrakter for jobs, ressourcer, identitet, chat og Work.
Grundlag for blob- og vektorlagring
Genererede gallerimedier og dokumentkildefiler bruger BlobStore; dokument-RAG og personahukommelse bruger VectorStore. Legacy-galleririækker i SQLite dobbeltlæses og overtages som blobreferencer ved første adgang. Relationelle metadata og en vedvarende reference er autoritative; udbyder-URL'er og fysiske S3-nøgler gemmes aldrig som programindhold. Chatvedhæftninger, avatarer og øvrige resterende inline-binærfelter bruger endnu ikke blob-lageret og må ikke beskrives som migrerede.
Gendannelsesgaten autentificerer hvert vedvarende objekt og hver envelope for indlejrede vektorer sekventielt under eksplicitte samlede grænser. Den autentificerer også strengt genkendelige legacy-tekstenvelopes og hver binær envelope for gemte stemmer med programmets ENCRYPTION_KEY; den bruger aldrig runtimens kompatibilitetsfallback, der dekrypterer eller returnerer originalen. Den initialiserer, reparerer, omskriver eller sletter ikke kildelageret. Beskadiget chiffertekst, ukendte eller forkerte nøgler, ikke-kanoniske blob-layouts og overskredne verifikationsgrænser blokerer snapshottet.
Standardgrænserne for gendannelse er 250.000 lokale objekter, 64 GiB krypterede og ukrypterede blobbytes, 250.000 vektorrækker, 4 GiB serialiseret vektorchiffertekst og 500 millioner vektorkomponenter. Tests og indlejrede kaldere kan tilsidesætte grænserne pr. kørsel via RecoveryInventoryOptions; CLI'en tager aldrig stiltiende stikprøver og springer aldrig overskydende tilstand over.
Verifikation af legacy-chiffertekst har som standard en grænse på én million udfyldte kandidatfelter og 16 GiB for henholdsvis samlede lagrede bytes og autentificerede klartekstbytes. Klartekstrækker fra gamle skemagenerationer forbliver kompatible, fordi legacy-tekstenvelopes ikke har nogen vedvarende markør; rapporten tæller kun autentificerede envelopes. Envelopes for gemte stemmer er entydige og autentificeres altid med profil-, ejer- og feltidentitet som yderligere data.
Krypterede lokale blobs
BlobStore er afgrænset pr. ejer og tilbyder streaming put/read, metadata/stat, inklusive byteintervaller og idempotent sletning. LocalEncryptedBlobStore skriver uigennemsigtige objekter med UUID-nøgler under en rod, som programmet angiver; integrationsmålet er ${DATA_DIR}/blobs. Den bruger eksklusive stagingfiler, fsync og en atomisk rename på samme filsystem med mapper i 0700 og filer i 0600.
Hvert objekt har en tilfældig 256-bit datanøgle. AES-256-GCM krypterer private metadata og autentificerer hver begrænset chunk af indholdet for sig. Yderligere autentificerede data binder blob-ID, ejer, formål, chunkindeks og klartekstlængde. Den versionerede nøglering for lagring omslutter hver datanøgle. Descriptoren registrerer klartekststørrelse, SHA-256, content type, oprettelsestid, formatversion og krypteringsnøglens ID. Fulde læsninger verificerer SHA-256; intervallæsninger autentificerer hver berørt chunk.
Kvotekontrakten reserverer kapacitet før streaming, forbruger de faktiske bytes, committer først efter atomisk synlighed og frigiver mislykkede reservationer. SQLite bruger BEGIN IMMEDIATE; PostgreSQL bruger serializable transaktioner og rækkelåse. S3-objektmetadata og kvoteforbrug committes eller rulles tilbage i én databasetransaktion. Opstarten afstemmer udløbne reservationer og kvoteobjekter, hvis fysiske blob mangler. BLOB_QUOTA_BYTES_PER_USER sætter den vedvarende grænse pr. ejer, og BLOB_QUOTA_RESERVATION_TTL_MS begrænser forladte reservationer.
BLOB_STORE_BACKEND=s3 bruger en privat S3-kompatibel bucket. Libre uploader uigennemsigtige objektnøgler og chunkstrømme, som programmet har krypteret, opbevarer krypterede descriptors i PostgreSQL, understøtter inklusive HTTP-intervaller, verificerer SHA-256-digests for både klartekst og chiffertekst og udfører idempotent sletning. En række under sletning forbliver vedvarende, indtil den fysiske sletning og den atomiske fjernelse af metadata og kvote lykkes; afstemningen gentager afbrudte sletninger og fjerner gamle fysiske forældreløse objekter. MinIO-testsuiten, der kræver Docker, dækker læsning og sletning på tværs af replikaer, tenantisolering, kvotekonkurrence, ikke-forbrugte strømme og injicerede databasefejl ved commit- og sletningsgrænser.
Krypterede indlejrede vektorer
VectorStore kræver en aktør ved hver forespørgsel og mutation. Poster bærer et namespace, et uigennemsigtigt tenantafgrænset ID, ejer, ressource-ID, embeddingmodel, dimensioner, version, kilderevision, lighedsattributter og valgfrie tildelinger til brugere og grupper.
SQLite anvender prædikater for namespace, model, dimension og version, ejer eller tildeling, ressource og attributter, før krypterede embeddings forlader databasen. Kun det begrænsede sæt af autoriserede kandidater dekrypteres og får en cosine-score. Samme uigennemsigtige vektor-ID isoleres pr. ejer uden at afsløre, at en anden tenant findes. Upserts erstatter embeddings, ACL'er og attributter atomisk; sletninger er afgrænset pr. ejer og kaskaderer til relaterede rækker.
Embeddings bruger AES-256-GCM, hvor identitet og modelmetadata er bundet som yderligere autentificerede data. Forespørgselsbare identitets-, tildelings-, model-, versions-, revisions- og filtermetadata forbliver klartekst, så kaldere må ikke lægge hemmeligheder i filterattributter. Selve embeddings er følsomme afledte data.
VECTOR_STORE_BACKEND=pgvector anvender prædikater for namespace, model, dimensioner, version, ressource, attribut, ejer og tildeling i samme SQL-sætning som afstandssorteringen og LIMIT. Efterfiltrering af globale nærmeste naboer er forbudt. Gruppeautorisation afgøres for hver forespørgsel ud fra en betroet resolver for aktuelt medlemskab; groupIds angivet af kalderen ignoreres. Tilbagekaldelse slår derfor igennem med det samme, og forfalskede gruppekrav kan ikke hente kandidater.
Dokumentindlæsning og vedligeholdelsesendpointet til regenerering af embeddings indfanger én uforanderlig kørselsspecifikation, før arbejdet begynder: aktiveret tilstand, model, vektorversion, chunkerversion, chunkstørrelse, overlap og lighedstærskel. Den samme specifikation styrer chunkgenerering, relationel udgivelse, vektor-upsert og semantisk forespørgsel; en ændret præference under en kørsel kan ikke give chunks fra blandede modeller eller forespørge en vektor med en anden tærskel. De udgivne dokumentmetadata registrerer den samlede chunkrevision og specifikationen, så SQL forbliver det autoritative indeksmanifest.
Regenerering holder en coordinator-lease, der fornyes automatisk, for hvert dokument og kontrollerer igen den ejerafgrænsede række og dens permanente sletnings-tombstone før relationel udgivelse samt før og efter vektormutation. En sletning kan committes, mens en upsert er i gang; autoritetskontrollen efter upsert fjerner så de genskabte vektorer. Semantiske læsninger i PostgreSQL/team muterer aldrig PGVector. SQLite må kun genudgive relationelle embeddings efter behov, når det gemte manifest beviser præcis den aktuelle model og chunkkonfiguration; denne valgfrie mutation genindlæser rækken og dens chunks, mens den holder samme dokument-lease. En optaget eller erstattet revision springes over og kan stadig bruges til fallback med nøgleordssøgning eller til en eksplicit regenerering.
Dokumentindekser erstattes i kompenserede batches på højst 1.000 vektorer, og kontroller af det præcise indeks gennemgår hele ressourcemanifestet side for side i stedet for at antage, at én mutationsbatch er hele dokumentet. Et dokument kan højst udgive 100.000 chunks, så intet enkelt dokument overskrider det portable arkivs samlede loft for dokumentchunks. Indlæsningen afviser chunk nummer 100.001 før embedding og før relationel udgivelse og vektorudgivelse og sender det vedvarende job til dead letter uden genforsøg; øg chunkstørrelsen for embeddings, eller fjern overflødige afsnitsskift, før du uploader igen.
Solodatabaser fra før manifestet kan indeholde autentificerede inline-dokumentvektorer uden nogen registrering af den model eller chunker, der skabte dem. Første semantiske brug behandler kun deres tilstedeværelse som et opgraderingssignal: den opdeler den autoritative dokumenttekst i chunks igen og genererer hver vektor på ny under den aktuelle indfangede specifikation, mens den holder dokumentets lease. Den kopierer aldrig legacy-payloaden og mærker den aldrig med dagens præference. En udbyderfejl eller en optaget lease efterlader legacy-rækken uændret og søgbar med nøgleord.
Migrering fra SQLite til team fejler lukket, når et sådant legacy-dokument ikke er fuldt dækket af autentificerede metadata fra det aktuelle manifest og et præcist krypteret platformsvektorindeks. Aktuelle præferencer beviser ikke en historisk vektors model. Når dry-run rapporterer denne blokering, starter du den aktuelle udgivelse i solo-/SQLite-tilstand med samme DATA_DIR og ENCRYPTION_KEY, aktiverer og vælger den ønskede embeddingmodel, bruger Indstillinger -> Dokumenter -> Regenerer embeddings for hver berørt ejer og kører migreringens dry-run igen. Først derefter må teamets repository-læsninger ignorere den bevarede inline-chiffertekst, mens de beviste vektorer flyttes til PGVector.
Fortroligheden afhænger af backend. Indlejret SQLite krypterer embeddings med programmets AES-256-GCM efter at have anvendt ACL-prædikater på metadata. PGVector skal arbejde på den numeriske embedding og krypterer derfor ikke kolonnen på programniveau. Behandl embeddings som følsomme afledte data: kræv TLS, krypterede PostgreSQL-diskenheder og backups, en programrolle med mindst mulige rettigheder, begrænset databaseadministration og SQL-logs, der aldrig indeholder vektor- eller kildeindhold. Kildetekst, indhold i personahukommelse, gallerimetadata og blob-descriptors forbliver envelope-krypteret. Vektorattributter er forespørgselsbar klartekst og må aldrig indeholde hemmeligheder.
Krypteringsnøgler til lagring
I den nuværende periode, hvor kaldere migreres, skal installationer, der aktiverer en versioneret nøglering, sætte en stabil ENCRYPTION_KEY på 64 tegn, medtage den samme nøgle under den præcise legacy-post i STORAGE_ENCRYPTION_KEYS og sætte STORAGE_ENCRYPTION_ACTIVE_KEY_ID til én af posterne. Skrivninger bruger den aktive nøgle; læsninger accepterer alle konfigurerede nøgle-ID'er for at understøtte trinvis rotation. Dette midlertidige legacy-krav forhindrer, at den eksisterende krypteringstjeneste selvstændigt opretter en anden nøgle. Behold gamle nøgler, indtil hvert objekt og hver vektor er omskrevet eller genindpakket og verificeret.
Når kortet mangler, accepterer adapteren den eksisterende ENCRYPTION_KEY på 64 tegn som nøgle-ID legacy eller læser den eksisterende fil ${DATA_DIR}/.encryption_key, når miljønøglen mangler. Lagringsfabrikken accepterer kun en almindelig nøglefil med private rettigheder, som ikke er et symlink; den opretter, omskriver eller erstatter aldrig filen. Hvis eksplicit miljøkonfiguration er i konflikt med den vedvarende nøgle, fejler opstarten lukket. Under rotation skal en fundet legacy-nøgle fra miljø eller fil forblive i det versionerede kort under det præcise nøgle-ID legacy, indtil gamle envelopes er omskrevet og verificeret. Manglende, misdannede, uoverensstemmende og ukendte nøgler fejler lukket.
Forespørgsler mod indlejrede vektorer anvender ACL- og metadataprædikater i SQLite og opsummerer derefter antal kandidater, krypterede bytes og scoringsarbejde pr. dimension, før nogen chiffertekst returneres til Node til dekryptering. Forespørgsler, der overskrider et budget, fejler lukket og skal indsnævres med ressource- eller metadataafgrænsning.
Koordinering
Koordinatorkontrakten tilbyder events, cacheposter med udløb, fenced leases og forbrug af rate limits med faste vinduer. Den lokale implementering er kun til soloprofilen med én replika. Redis-implementeringen bruger separate klienter til kommandoer og abonnementer, begrænsede payloads, health checks, namespacing af nøgler, atomiske scripts, unikke ejertokens, udløb af leases og fencing-tokens. Den falder aldrig tilbage til lokal koordinering efter en Redis-fejl.
Redis er ikke sandhedskilden. Autorisation, vedvarende jobs og events, der kan afspilles igen, skal forblive i databasen; Redis er et lag til vækning, cacheinvalidering, presence, kvoter og koordinering. Kritisk arbejde skal også validere sin databaselease eller sit fencing-token, før en sideeffekt committes.
Programmets ticketing, caches, delt invalidering, forbindelsesgrænser, Work-events og distribuerede runtime-låse bruger denne grænse. At vælge Redis alene gør stadig ikke lokal persistens delbar; teamtilstand kræver hele den delte profil.
Vedvarende jobs og events
SQLite-migrering v3 leverer tabeller for vedvarende jobs, forsøg, hoveder for event-streams og ordnede events. Tjenestekontrakten understøtter idempotent enqueue, begrænsede genforsøg, annullering, fremdrift, lease-heartbeat/reclaim, dead letter-tilstand og genafspilning efter global cursor. Krypterede JSON-payloads bruger platformens nøglering med job- og eventidentitet som autentificerede data; payloadreferencer er uigennemsigtige, begrænsede identifikatorer.
SQLite-migrering v13 og PostgreSQL-migrering v12 tilføjer det matchende indeks (stream_id, subject_id, global_cursor), som bruges til generationsafgrænset genafspilning af chat. Stream- og subject-filtre anvendes før catch-up-grænsen, så en lang sessions tidligere generationer hverken bruger af den aktuelle generations genafspilningsbudget eller fremtvinger en fuld scanning af event-streamen.
Opstarten af programmet og den selvstændige worker registrerer auditerede handlers til dokumentindlæsning, mediefortsættelse og oprydning af ressourcer, som kan gentages. Administrationsgrænsen giver begrænset inspektion og annullering. Enqueue er idempotent, og relationelle stier til oprettelse og sletning indsætter deres vedvarende job i samme SQLite-/PostgreSQL-transaktion. Ressourceoprydning fjerner vektorer, private blobs, vedvarende referencer, cacheposter og køet arbejde rettet mod ressourcen gennem operationer, der er sikre at gentage.
Gendannelsesopgørelsen tæller hver jobtilstand og hvert forsøgsudfald, registrerer event-streams og deres seneste cursor, blokerer usikkert kørende arbejde og autentificerer krypterede payloads under samlede grænser. Gendannelsen afviser også uoverensstemmelser i stream-hoveder og huller i sekvenserne pr. stream.
Monotone lease-tokens afskærer forældede workers fra senere database-commits. Fencing giver ikke exactly-once-udførelse: en worker kan fuldføre en ekstern sideeffekt og fejle, før succesen registreres. Handlers kræver derfor idempotensnøgler hos udbyderen eller en transaktionel outbox/inbox-protokol samt fornyet validering af aktørens autorisation umiddelbart før hver sideeffekt.
SQLite-migrering v4 tilføjer et unikt nøglebaseret opslagstoken for e-mail ved siden af randomiseret identitetschiffertekst. Tokenet er en HMAC under programmets krypteringsnøgle: det genopretter atomisk håndhævelse af unikke e-mails uden at gemme klartekst eller bruge deterministisk kryptering. Opstarten autentificerer og backfiller hver legacy-identitets-e-mail, før der tages imod trafik.
Sundhedstjek og gendannelse
Udrulningsprober skelner nu mellem, om processen kører, og om afhængighederne er klar:
/healthog/health/livegælder kun processen;/health/readykontrollerer databasen, den kanoniske skemaledger, skrivbar datalagring og registrerede påkrævede afhængigheder og skjuler detaljerne. Den venter ikke på valgfrie udbydere; og/health/deepkræver en aktuel administrator og kører SQLite-integritets- og fremmednøglekontroller i en begrænset worker uden for HTTP-eventloopet. Den samler også valgfrie udbyderprober på serverniveau, såsom Ollama, som advarsler uden at ændre kernens readiness.
Kør libre-webui recovery-check --json; fra en kildekode-checkout bygger du backend én gang og bruger npm run recovery:check -- --json. Opgørelsen er skrivebeskyttet. Den rapporterer skema- og nøgleidentiteter, den lokale blobrod og antal legacy- og platformsvektorer; den autentificerer lokal platformschiffertekst for blobs og vektorer, legacy-chiffertekst for programmet og gemte stemmer samt krypterede payloads for vedvarende jobs og events; og den rapporterer datastørrelser, plugin-definitioner og om de ligger inden for backuproden, indlejrede medier, Work-ressourcer og præcise ejerskabsetiketter, checkpoints for jobs, forsøg og events, aktive Work-kørsler, forhåndsvisninger og jobs, blokeringer og kendte undtagelser. Den er en gate før backup, ikke en komplet backup. Se Gendannelsesberedskab.
Certificeret drift med flere replikaer
Teamprofilen er certificeret til tre eller flere programreplikaer plus mindst én ekstern vedvarende worker, forudsat at alle delte afhængigheder er konfigureret sammen: PostgreSQL, PGVector, Redis, S3-kompatible blobs, stabile delte hemmeligheder og JOB_WORKER_MODE=external. Helm-chartet håndhæver disse forudsætninger, når det renderes. Et replikaantal over én uden den komplette teamprofil får renderingen til at fejle i stedet for at udrulle en usikker topologi, og skemamigreringer vælger én leder via en PostgreSQL advisory lock, så replikaer med forskellige versioner aldrig kappes om ledgeren.
Certificeringen kan køres og er ikke blot en hensigt: udgivelsespipelinen kører en øvelse med tre replikaer (npm run test:team-platform), der bygger det rigtige image og afprøver genoptagelse af streams på tværs af replikaer, worker-død midt i en skrivning med deterministisk genafspilning, fallback til autoritativ SQL ved Redis-nedbrud, håndhævelse af tilbagekaldelse under tab af koordinatoren, konsistente delte rate limits, genforsøg af S3-sletning og tenantisolering under belastning. Operatører kan hærde pods yderligere med secrets.existingSecret (henvis til en Secret, som operatøren administrerer, i stedet for at rendere chart-værdier ind i en) og networkPolicy.enabled (afvis som standard indgående trafik ud over programmets port; den vedvarende worker accepterer ingen indgående trafik). Podsikkerhedens standarder forbliver strenge uanset hvad: non-root, skrivebeskyttet rodfilsystem, fjernede capabilities, seccomp RuntimeDefault og ingen privilege escalation.
Kendte resterende overgange
Grundlaget betyder ikke, at hvert binært felt allerede er en blob. Lyd fra gemte stemmer, chatvedhæftninger, avatarer og fremtidige binære ressourcer defineret af plugins kræver eksplicitte referencemetadata, dobbeltlæsning/backfill, opbevaring og sletningstests, før de kan flyttes. Ligeledes skal hver fremtidig embedding-kalder føre model, dimensioner, version, kilderevision, ejer, ressourceafgrænsning og betroede tildelinger gennem VectorStore; direkte adgang til vektortabellen er ikke en accepteret genvej.
Nye langvarige eller eksternt synlige sideeffekter skal registrere et vedvarende ressourcemål, understøtte annullering og genforsøg og bruge en transaktionel enqueue/outbox-grænse sammen med den relationelle mutation, der ejer dem. Tilføj hver ny ressource til accepttestene på tværs af replikaer for upload, læsning, søgning og sletning samt backup og gendannelse, før den aktiveres i teaminstallationer.