Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 900+ contributors
SQLite Runtime Resolution (Norsk)
🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW
OmniRoute finner SQLite-driveren ved oppstart gjennom en reservekjede i fem trinn:
Medfølgende
better-sqlite3(viadependenciesipackage.json) — raskest, bruker en nativ binærfil og installeres avnpm installnår byggeverktøy er tilgjengelige.Kjøretidsinstallert
better-sqlite3(i~/.omniroute/runtime/) — installeres ved behov ved første kjøring ELLER avscripts/build/postinstall.mjs → scripts/postinstall.mjs. Validerer magiske byte i den native.node-filen (ELF / Mach-O / PE) før innlasting for å beskytte mot skadde binærfiler eller binærfiler for feil plattform.node:sqlite(Node ≥22.5-standardbiblioteket) — krever ingen nativ bygging og brukes når begge better-sqlite3-alternativene mislykkes. Begrenset funksjonssett.sql.js(WASM) — siste reservealternativ. Fungerer overalt, men er tregere og skriver data med jevne mellomrom i stedet for synkront.
Hvorfor denne kompleksiteten?
- Windows EBUSY:
npm install -g omniroute@latestkan mislykkes hvis den forrige versjonensbetter_sqlite3.nodeer låst av en kjørende prosess. Kjøretidsinstallasjonen i~/.omniroute/runtime/omgår den globale npm-hurtigbufferen. - Ingen byggeverktøy: Enkelte miljøer (Windows i bedrifter uten VS Build
Tools, minimale Docker-avbildninger) kan ikke kompilere
better-sqlite3. Kjøretidsinstallasjonsprogrammet henter en forhåndsbygd binærfil fra npm-registeret, mens reservedriverne sikrer at OmniRoute fortsatt starter selv om dette mislykkes. - Isolerte systemer: Hvis npm-registeret ikke er tilgjengelig, garanterer
node:sqliteellersql.jsgrunnleggende funksjonalitet.
Validering av magiske byte
Før en kjøretidsinstallert .node-fil lastes inn, leser OmniRoute de første 8
bytene og sammenligner dem med kjente plattformsignaturer:
| Plattform | Byte (hex) | Etikett |
|---|---|---|
| Linux | 7F 45 4C 46 |
elf |
| macOS 64-bit BE | FE ED FA CF |
macho |
| macOS 64-bit LE | CF FA ED FE |
macho-le |
| macOS fat (universell) | CA FE BA BE |
macho-fat |
| Windows | 4D 5A (MZ) |
pe |
En signatur som ikke samsvarer → filen ignoreres, og reservekjeden fortsetter til neste trinn.
Kontrollere den aktive driveren
import { getDriverInfo } from "@/lib/db/core";
const info = getDriverInfo();
// { source: "bundled" | "runtime" | "runtime-installed-now" | "node-sqlite" | "sql-js",
// kind: "better-sqlite3" | "node-sqlite" | "sql-js" }
Manuell kontroll
# Hopp over oppvarming etter installasjon (for raske CI-installasjoner)
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute
# Tving ny installasjon av better-sqlite3 for kjøretidsmiljøet
rm -rf ~/.omniroute/runtime
omniroute # installeres på nytt ved neste oppstart
# Kontroller hvilken driver som er aktiv
omniroute config db-info # (hvis CLI-kommandoen finnes)
Diagnostisering av synkrone blokkeringer
Med better-sqlite3 kan du angi OMNIROUTE_SQLITE_SLOW_MS=200 før oppstart for å
aktivere tidtaking av den synkrone adapteren. Dette er deaktivert som standard. En fullført operasjon som tar
minst så mange millisekunder, utløser en [SQLITE-SLOW]-advarsel, maksimalt én gang per
ti sekunder per adapter. Advarselen inneholder bare driveren, operasjonsklassen
(prepare, get, all, run, exec, pragma, transaksjon eller vedlikehold) og
forløpte millisekunder: ingen SQL, bindinger, rader, baner eller unntakstekst.
Dette er et diagnostisk hjelpemiddel, ikke et tidsavbrudd eller en spørringsoptimalisering. Det kan ikke rapportere en operasjon som aldri returnerer, skille CPU-arbeid fra venting på disk, identifisere den nøyaktige SQL-en eller observere operasjoner som utføres gjennom det rå driverhåndtaket. Varigheten til asynkron sikkerhetskopiering er bevisst utelatt; andre SQLite-drivere instrumenteres ikke av denne valgfrie funksjonen. Hvis variabelen deaktiveres, gjenopprettes den opprinnelige adapteren uten omsluttende tidtakingsfunksjoner. Databaseskjemaet og lagret konfigurasjon endres ikke.
Forsinkelsesadvarselen fra /healthz rapporterer hendelsesløkkens høyeste verdi siden forrige måling,
ikke gjennomsnittet for hele levetiden. Sammenlign tidsstemplene med advarsler om trege operasjoner
og verts-/lagringsmålinger før en blokkering tilskrives SQLite- eller diskfeil.
Referanse
Implementasjon:
bin/cli/runtime/magicBytes.mjs— hjelpefunksjoner for validering av binære magiske bytebin/cli/runtime/sqliteRuntime.mjs— femtrinns kjøretidsvelger + installasjonsprogram ved behovbin/cli/runtime/index.mjs— oppstartskoordinator (warmUpRuntimes())scripts/postinstall.mjs— npm-krok etter installasjon (ikke-kritisk oppvarming)src/lib/db/core.ts— eksportererensureDbInitialized()/getDriverInfo()
Topologi med én skriver (HA støttes ikke)
Reservekjeden for drivere ovenfor kjører fortsatt i én prosess. Med standardoppsettet for SQLite er OmniRoute en enkeltstående skriver:
- Ikke koble to OmniRoute-replikaer til den samme
storage.sqlite-filen. - Omstart av en container, Recreate-distribusjon, OOM-avslutning eller HEALTHCHECK-omstart avslutter alle aktive SSE-økter. Standardoppsettet har ingen nedtapping av økter.
- En livssjekk i orkestratoren som tolker en treg
/healthzsom utilgjengelig, vil avslutte den eneste replikaen. Foretrekk TCP-livssjekk + HTTP/healthz-beredskapssjekk. Se Docker-veiledning — tilgjengelighet og anbefalinger for Kubernetes-prober.