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 (Deutsch)
🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇬🇷 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 · 🇳🇴 no · 🇮🇳 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 löst seinen SQLite-Treiber beim Start über eine 5-stufige Fallback-Kette auf:
Mitgeliefertes
better-sqlite3(überdependenciesinpackage.json) — am schnellsten, native Binärdatei, wird durchnpm installinstalliert, wenn Build-Werkzeuge vorhanden sind.Zur Laufzeit installiertes
better-sqlite3(in~/.omniroute/runtime/) — wird beim ersten Start verzögert ODER durchscripts/build/postinstall.mjs → scripts/postinstall.mjsinstalliert. Validiert vor dem Laden die Magic Bytes der nativen.node-Datei (ELF / Mach-O / PE), um vor beschädigten Binärdateien oder solchen für die falsche Plattform zu schützen.node:sqlite(Node ≥22.5-Standardbibliothek) — kein nativer Build erforderlich; wird verwendet, wenn beide better-sqlite3-Pfade fehlschlagen. Eingeschränkter Funktionsumfang.sql.js(WASM) — letzter Fallback. Funktioniert überall, ist jedoch langsamer und schreibt Daten in Intervallen statt synchron.
Warum diese Komplexität?
- Windows EBUSY:
npm install -g omniroute@latestkann fehlschlagen, wenn diebetter_sqlite3.node-Datei der vorherigen Version durch einen laufenden Prozess gesperrt ist. Die Laufzeitinstallation in~/.omniroute/runtime/umgeht den globalen npm-Cache. - Keine Build-Werkzeuge: Einige Umgebungen (Unternehmens-Windows ohne VS Build
Tools, minimale Docker-Images) können
better-sqlite3nicht kompilieren. Das Laufzeit- Installationsprogramm bezieht eine vorkompilierte Binärdatei aus der npm-Registry; die Fallback- Treiber stellen sicher, dass OmniRoute auch dann noch startet, wenn dies fehlschlägt. - Vom Netzwerk isolierte Systeme: Wenn die npm-Registry nicht erreichbar ist, garantieren
node:sqliteodersql.jseine grundlegende Funktionalität.
Magic-Byte-Validierung
Vor dem Laden einer zur Laufzeit installierten .node-Datei liest OmniRoute die ersten 8
Bytes und gleicht sie mit bekannten Plattform-Magic-Bytes ab:
| Plattform | Bytes (hex) | Bezeichnung |
|---|---|---|
| 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 |
Nicht übereinstimmende Magic Bytes → die Datei wird ignoriert, der Fallback wird mit dem nächsten Schritt fortgesetzt.
Aktiven Treiber prüfen
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" }
Manuelle Steuerung
# Postinstall-Aufwärmphase überspringen (für schnelle CI-Installationen)
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute
# Zur Laufzeit verwendetes better-sqlite3 zwangsweise neu installieren
rm -rf ~/.omniroute/runtime
omniroute # wird beim nächsten Start neu installiert
# Prüfen, welcher Treiber aktiv ist
omniroute config db-info # (falls der CLI-Befehl vorhanden ist)
Diagnose synchroner Blockierungen
Legen Sie bei better-sqlite3 vor dem Start OMNIROUTE_SQLITE_SLOW_MS=200 fest, um
die Zeitmessung des synchronen Adapters zu aktivieren. Standardmäßig ist sie deaktiviert. Ein abgeschlossener Vorgang,
der mindestens so viele Millisekunden dauert, erzeugt eine [SQLITE-SLOW]-Warnung, höchstens einmal
alle zehn Sekunden pro Adapter. Die Warnung enthält ausschließlich den Treiber, die Vorgangsklasse
(prepare, get, all, run, exec, pragma, Transaktion oder Wartung) und
die verstrichenen Millisekunden: kein SQL, keine Bindungen, Zeilen, Pfade oder Ausnahmetexte.
Dies ist ein Diagnosehilfsmittel, kein Timeout und keine Abfrageoptimierung. Es kann weder einen Vorgang melden, der nie zurückkehrt, noch CPU-Arbeit von Wartezeiten auf Datenträger unterscheiden, das genaue SQL identifizieren oder Vorgänge beobachten, die über das rohe Treiber-Handle ausgeführt werden. Die Dauer asynchroner Backups ist bewusst ausgeschlossen; andere SQLite-Treiber werden durch diese Opt-in-Funktion nicht instrumentiert. Durch Deaktivieren der Variable wird der ursprüngliche Adapter ohne Zeitmessungs-Wrapper wiederhergestellt. Das Datenbankschema und die gespeicherte Konfiguration bleiben unverändert.
Die Lag-Warnung von /healthz meldet den Höchstwert der Event-Loop-Verzögerung seit der vorherigen Messung,
nicht den Durchschnitt über die gesamte Laufzeit. Korrelieren Sie ihre Zeitstempel mit Warnungen zu langsamen Vorgängen
und Host-/Speichermetriken, bevor Sie eine Blockierung SQLite oder einem Datenträgerfehler zuschreiben.
Referenz
Implementierung:
bin/cli/runtime/magicBytes.mjs— Hilfsfunktionen zur Validierung binärer Magic Bytesbin/cli/runtime/sqliteRuntime.mjs— 5-stufiger Laufzeit-Resolver + verzögertes Installationsprogrammbin/cli/runtime/index.mjs— Start-Orchestrator (warmUpRuntimes())scripts/postinstall.mjs— npm-Postinstall-Hook (nicht kritische Aufwärmphase)src/lib/db/core.ts— Exporte vonensureDbInitialized()/getDriverInfo()
Single-Writer-Topologie (HA wird nicht unterstützt)
Die obige Treiber-Fallback-Kette wird weiterhin in einem Prozess ausgeführt. Mit standardmäßigem SQLite ist OmniRoute ein Single Writer:
- Verbinden Sie nicht zwei OmniRoute-Replikate mit derselben
storage.sqlite-Datei. - Ein Container-Neustart, Recreate-Deployment, OOM-Kill oder HEALTHCHECK-Neustart beendet jede laufende SSE-Sitzung. Im Standardpfad findet kein geordnetes Beenden der Sitzungen statt.
- Eine Orchestrator-Liveness-Prüfung, die einen langsamen
/healthz-Endpunkt als Ausfall interpretiert, beendet das einzige Replikat. Bevorzugen Sie TCP-Liveness + HTTP-/healthz-Readiness. Siehe Docker-Leitfaden — Verfügbarkeit und Empfehlungen für Kubernetes-Probes.