So richten Sie einen Bun.js-Server mit Fastify ein: von null bis Produktion
Eine praktische Anleitung zum Erstellen eines produktionsreifen Bun.js-Servers mit Fastify. Installieren Sie Bun, erstellen Sie einen HTTP-Server, fügen Sie TypeScript-Routen hinzu, behandeln Sie Validierung, verbinden Sie eine Datenbank und deployen Sie — mit Benchmarks, die Leistungsunterschiede zwischen Bun + Fastify und Node.js + Fastify zeigen.
Bun Server-Einrichtungs anleitung 2026
Eine zweiteilige Anleitung zum Erstellen produktionsreifer Server mit Bun. Teil 1 behandelt Bun-Runtime-Grundlagen und Fastify-Einrichtung. Teil 2 behandelt NestJS auf Bun und Leistungsoptimierung.
Alle Artikel in diesem Guide
01
Bun.js-Server mit Fastify: von null bis Produktion
Installieren Sie Bun, erstellen Sie einen HTTP-Server, fügen Sie TypeScript-Routen mit Fastify hinzu, behandeln Sie Validierung, verbinden Sie eine Datenbank und deployen Sie mit Docker.
02
NestJS auf Bun.js: Einrichtung und Leistungsoptimierungen
Führen Sie NestJS auf Bun aus, konfigurieren Sie SWC, aktivieren Sie Lazy-Loading-Module, wechseln Sie zum Fastify-Adapter und wenden Sie Leistungsoptimierungen an.
Kurz gesagt
Dies ist eine praktische Anleitung von null bis zum funktionierenden Server. Keine vorherige Bun-Erfahrung erforderlich.
Bun.serve() (nativ) und fastify.listen() (Framework)bun:sqlite)Wenn Sie bisher Server mit Node.js gebaut haben, überträgt sich das meiste Wissen direkt. Die wichtigsten Unterschiede betreffen Engine-Architektur, integriertes Tooling und TypeScript-Verarbeitung.
| Comparison point | Bun 1.3 | Node.js 22/23 |
|---|---|---|
| JavaScript engine | JavaScriptCore (Safari/WebKit) | V8 (Chrome/Chromium) |
| Written in | Zig + C++ | C++ + JavaScript |
| TypeScript | Native (zero config, no transpile step) [1] | Experimental via --experimental-strip-types (Node 23) [2] |
| Package manager | Built-in (bun install) — 10-30x faster than npm [1] | npm, yarn, pnpm (external) |
| Bundler | Built-in (bun build) — Webpack-class features [1] | None built-in (requires Webpack, Vite, esbuild) |
| Test runner | Built-in (bun test) — Jest-compatible, ~20x faster [1] | Built-in node:test (basic, stable since v20) [2] |
| Cold start | 8-15ms | 40-120ms |
| HTTP throughput (Fastify) | ~95,200 req/s [3] | ~55,800 req/s [3] |
| Memory baseline | ~380MB | ~512MB |
| npm compatibility | ~98% of top 1000 packages | 100% (native) |
Fazit
Für neue Serverprojekte bietet Bun einen schnelleren Runtime, eine einfachere Toolchain und natives TypeScript. Die verbleibenden 2% npm-Inkompatibilität konzentrieren sich auf native C++-Addons wie bcrypt oder node-sass — die meisten Web-Frameworks und ORMs funktionieren ohne Änderung.
Bun wird als einzelne Binärdatei installiert. Kein Node.js, npm oder separate Build-Tools erforderlich.
Installieren via curl
curl -fsSL https://bun.sh/install | bashDies lädt die Bun-Binärdatei herunter, fügt sie zu Ihrem PATH hinzu und verifiziert die Installation. Führen Sie nach der Installation bun --version aus, um die Installation zu bestätigen.
Installieren via PowerShell
powershell -c "irm bun.sh/install.ps1|iex"Windows-Unterstützung erreichte den stabilen Status in Bun 1.3. Alle Kernfunktionen — Runtime, Paketmanager, Test-Runner und Bundler — funktionieren unter Windows. [1]
Installation bestätigen
bun --versionSie sollten 1.3.x oder neuer sehen. Bun ist jetzt bereit. Keine separate Node.js-Installation ist für Bun-Projekte erforderlich, obwohl eine parallele Installation von Node.js neben Bun üblich ist und konfliktfrei funktioniert.
Erstellen Sie das Projektverzeichnis, installieren Sie Fastify und schreiben Sie die erste Serverdatei — alles in TypeScript, alles ohne Build-Schritt.
Projekt erstellen und Abhängigkeiten installieren
mkdir my-bun-server && cd my-bun-server
bun init
bun add fastifybun init erstellt ein minimales package.json mit "type": "module". bun add fastify installiert Fastify von npm — Buns Paketmanager lädt und löst Abhängigkeiten 10-30x schneller als npm. [1]
Den Server-Einstiegspunkt erstellen
// server.ts
import Fastify from "fastify";
const fastify = Fastify({ logger: true });
fastify.get("/", async (request, reply) => {
return { hello: "world", runtime: "bun" };
});
fastify.get("/health", async (request, reply) => {
return { status: "ok", uptime: process.uptime() };
});
const start = async () => {
try {
await fastify.listen({ port: 3000, host: "0.0.0.0" });
console.log("Server running at http://localhost:3000");
} catch (err) {
fastify.log.error(err);
process.exit(1);
}
};
start();Dies ist Standard-Fastify-Code. Der einzige Unterschied zu Node.js: Sie führen ihn mit bun statt node aus, und die .ts-Erweiterung funktioniert direkt.
Den Server starten
bun run server.tsDas ist alles. Kein tsc, kein ts-node, kein nodemon, kein Build-Schritt. Bun liest die TypeScript-Datei, entfernt Typen zur Parse-Zeit und führt sie aus. Für die Entwicklung mit Hot Reload verwenden Sie bun --hot server.ts — Bun bewahrt den Anwendungszustand über Neuladungen hinweg, was schneller ist als Node.js' --watch-Flag, das den gesamten Prozess neu startet. [1]
Was gerade passiert ist
Sie haben einen funktionierenden Fastify-Server in TypeScript mit zwei Befehlen (bun init und bun add fastify) und einer Datei (server.ts) erstellt. Keine Konfigurationsdateien, keine Build-Tools, kein Transpilierungsschritt. Das ist der zentrale DX-Unterschied zwischen Bun und Node.js.
Bun bietet zwei Möglichkeiten, HTTP-Server zu erstellen: die native Bun.serve()-API und Drittanbieter-Frameworks wie Fastify. Beide laufen auf Buns Runtime, aber sie dienen unterschiedlichen Bedürfnissen.
Bun.serve() ist Buns integrierter HTTP-Server. Es ist die schnellste Option — Benchmarks zeigen ca. 180.000 Anfragen/Sekunde für Klartext-Antworten im Vergleich zu Node.js mit 65.000 Anfragen/Sekunde. Es ist ideal für einfache APIs, Microservices und leistungskritische Endpunkte, bei denen Sie minimalen Overhead wünschen. [1][3]
Fastify fügt eine strukturierte Schicht hinzu: JSON-Schema-Validierung, Serialisierungsoptimierung, Plugin-Architektur, Hooks und Decorators. Fastify auf Bun liefert Ihnen ~95.200 req/s im Vergleich zu ~55.800 req/s auf Node.js — ca. 70% mehr Durchsatz. Sie verlieren etwas Rohgeschwindigkeit gegenüber Bun.serve(), gewinnen aber ein produktionsreifes Framework mit Validierung, Fehlerbehandlung und Erweiterbarkeit. [3]
Für die meisten realen Anwendungen ist Fastify auf Bun die pragmatische Wahl. Der Framework-Overhead ist ein Bruchteil der gesamten Anfragezeit, wenn Sie Datenbankabfragen, Authentifizierung und Geschäftslogik hinzufügen. Die Schema-Validierung allein — die Fastify auf Framework-Ebene mit 2-3x Serialisierungsbeschleunigung handhabt — rechtfertigt oft die Wahl. [4][5]
Verwenden Sie Bun.serve(), wenn
Sie maximalen Rohdurchsatz für einfache Endpunkte benötigen. Einen leichten Proxy, einen Health-Check-Dienst, einen Webhook-Empfänger oder einen internen Microservice aufbauen. Den kleinstmöglichen Kaltstart für Serverless-Deployments wünschen. Sie Routing, Validierung und Fehlerbehandlung manuell übernehmen möchten.
Verwenden Sie Fastify auf Bun, wenn
Sie JSON-Schema-Validierung und Serialisierung benötigen. Ein Plugin-Ökosystem wünschen (CORS, Auth, Swagger, Rate Limiting). Sie eine REST- oder GraphQL-API mit mehreren Routen aufbauen. Strukturierte Fehlerbehandlung und Request-Lifecycle-Hooks benötigen. Produktionsreifes Entwickler-Tooling benötigen.
Vermeiden Sie Bun.serve(), wenn
Ihre API komplexe Validierungsanforderungen hat. Sie OpenAPI/Swagger-Dokumentationsgenerierung benötigen. Von frameworkspezifischen Plugins abhängig sind. Ihr Team Express/Fastify-Muster für Wartbarkeit erwartet.
Bun.serve() liefert den höchsten Rohdurchsatz, aber Fastify auf Bun bietet eine gute Balance aus Framework-Funktionen und Leistung. Die reale Lücke zwischen Fastify auf Bun und Fastify auf Node.js beträgt ca. 70%.
Screenshot des Abschnitts bun-serve-vs-fastifyFastifys Stärke ist die strukturierte Anfragevalidierung mit JSON Schema. So erstellen Sie validierte Routen auf Bun.
Ein validiertes Routenmodul erstellen
// routes/users.ts
import { FastifyPluginAsync } from "fastify";
export const userRoutes: FastifyPluginAsync = async (fastify) => {
const createUserBody = {
type: "object",
required: ["email", "name"],
properties: {
email: { type: "string", format: "email" },
name: { type: "string", minLength: 1, maxLength: 100 },
role: { type: "string", enum: ["admin", "user", "viewer"] },
},
} as const;
fastify.post("/users", {
schema: { body: createUserBody },
}, async (request, reply) => {
const { email, name, role } = request.body;
return {
id: crypto.randomUUID(),
email,
name,
role: role ?? "user",
createdAt: new Date().toISOString(),
};
});
fastify.get("/users/:id", {
schema: {
params: {
type: "object",
properties: { id: { type: "string" } },
required: ["id"],
},
},
}, async (request, reply) => {
const { id } = request.params as { id: string };
return { id, message: "User lookup placeholder" };
});
};Routen in der Hauptserverdatei registrieren
// server.ts
import Fastify from "fastify";
import { userRoutes } from "./routes/users";
const fastify = Fastify({ logger: true });
fastify.register(userRoutes);
fastify.setErrorHandler((error, request, reply) => {
if (error.validation) {
reply.status(400).send({
error: "Validation failed",
details: error.validation,
});
return;
}
fastify.log.error(error);
reply.status(500).send({ error: "Internal server error" });
});
const start = async () => {
try {
await fastify.listen({ port: 3000, host: "0.0.0.0" });
} catch (err) {
fastify.log.error(err);
process.exit(1);
}
};
start();Ausführen mit bun run server.ts. Ungültige Anfragebodys geben nun automatisch strukturierte 400-Fehler zurück.
Kernpunkt
Fastifys Schema-Validierung funktioniert identisch auf Bun und Node.js. Der einzige Unterschied ist, dass der validierte Handler auf Buns Runtime schneller ausgeführt wird. Wenn Ihre bestehenden Fastify-Routen JSON Schema verwenden, funktionieren sie auf Bun ohne Änderung.
Bun unterstützt zwei Datenbankpfade: sein integriertes bun:sqlite-Modul für leichtgewichtige lokale Speicherung und Standard-npm-Datenbanktreiber für PostgreSQL, MySQL, MongoDB und andere Datenbanken. Für PostgreSQL funktioniert der pg-Treiber auf Bun ohne Änderung. [1]
Für eine ORM-Schicht funktionieren Prisma, Drizzle ORM und TypeORM alle auf Bun. Prisma ist besonders gut getestet — das Prisma-Team hat Bun-Kompatibilität bestätigt und viele Produktionsdeployments nutzen Prisma + Bun + PostgreSQL. [1][2]
Buns integriertes SQLite-Modul (bun:sqlite) ist nützlich für Prototyping, Caching und Single-Instance-Deployments, bei denen eine externe Datenbank übertrieben wäre. Für Produktions-APIs ist PostgreSQL über pg oder ein ORM wie Prisma die Standardwahl.
Praktischer Rat
Verwenden Sie bun:sqlite für Prototyping und Single-Instance-Caching. Verwenden Sie PostgreSQL + Prisma oder Drizzle für Produktions-APIs. Beide funktionieren auf Bun ohne Konfigurationsänderungen über die Datenbank-Verbindungszeichenfolge hinaus.
Buns integrierter Test-Runner verwendet Jest-kompatible APIs. Die meisten bestehenden Testdateien funktionieren ohne Änderung.
Einen Routentest schreiben
Erstellen Sie eine Testdatei mit Buns integriertem Test-Runner. Importieren Sie describe, it und expect aus bun:test. Die API ist Jest-kompatibel, sodass bestehende NestJS/Fastify-Tests mit minimalen Änderungen migriert werden können. Verwenden Sie app.inject(), um Routen zu testen, ohne einen echten HTTP-Server zu starten. Führen Sie alle Tests mit bun test aus, das Dateien, die *.test.ts und *.spec.ts entsprechen, automatisch erkennt. Eine Testsuite von 500 Tests wird in ca. 1,2 Sekunden im Vergleich zu Jests 24 Sekunden abgeschlossen. [1]
Migrationshinweis
Wenn Ihr Projekt bereits Jest verwendet, können die meisten Testdateien ohne Änderungen zu bun test wechseln. Die API-Oberfläche ist nahezu identisch. Der Hauptunterschied ist die Geschwindigkeit: Tests, die mit Jest 30 Sekunden dauerten, sind mit Bun in ca. 1-2 Sekunden abgeschlossen.
Bun bietet offizielle Docker-Images, die kleiner sind und schneller starten als Node.js-Äquivalente.
Ein produktives Dockerfile erstellen
FROM oven/bun:1.3 AS base
WORKDIR /app
COPY package.json bun.lockb ./
RUN bun install --frozen-lockfile --production
COPY src ./src
EXPOSE 3000
CMD ["bun", "run", "src/server.ts"]Das Image bauen und den Container starten
docker build -t my-bun-server .
docker run -p 3000:3000 my-bun-serverDer Container startet in unter einer Sekunde. Buns Kaltstart-Vorteil (8-15ms vs. 40-120ms für Node.js) ist besonders wertvoll in Container-Orchestrierungsumgebungen, wo häufige Neustarts und Skalierungsereignisse normal sind.
Diese Benchmarks stammen aus mehreren unabhängigen Quellen, die Fastify auf Bun vs. Fastify auf Node.js mit identischer Hardware und Arbeitslast getestet haben.
Die Leistungslücke zwischen Bun und Node.js ist am deutlichsten beim rohen HTTP-Durchsatz und Kaltstarts. Wenn Framework-Overhead ins Spiel kommt (Fastify-Middleware, JSON-Serialisierung, Validierung), verengt sich die Lücke auf 40-70%. Bei realen APIs, bei denen Datenbankabfragen und Netzwerk-I/O dominieren, macht der Runtime weniger als 10% der Gesamtanfragezeit aus. Die größten praktischen Gewinne liegen in der Startgeschwindigkeit, CI/CD-Pipeline-Zeit und WebSocket-Nebenläufigkeit. [1][2][3]
95,200 vs 55,800
Bun liefert ~70% mehr Fastify-Durchsatz als Node.js auf identischer Hardware. [3]
156ms vs 245ms
Bun startet ~36% schneller und reduziert Serverless-Funktionskosten direkt. [2]
1.2M vs 680K
Bun bewältigt 76% mehr gleichzeitige WebSocket-Verbindungen auf derselben Hardware. [1]
380MB vs 512MB
Bun-Container verbrauchen ~25% weniger Speicher und ermöglichen mehr Pods pro Cluster. [1]
2s vs 30s
Buns Paketmanager installiert Abhängigkeiten 10-15x schneller als npm. [1]
1.2s vs 24s
Buns Test-Runner ist ~20x schneller als Jest mit kompatibler API. [1]
Wann die Zahlen am meisten zählen
Buns Leistungsvorteil ist am größten für Serverless-Funktionen (Kaltstart), CI/CD-Pipelines (Installations- und Testgeschwindigkeit) und WebSocket-intensive Anwendungen. Für Standard-REST-APIs, bei denen die Datenbank der Engpass ist, ist der Unterschied kleiner, aber immer noch bedeutsam — besonders im großen Maßstab.
Dies sind die Probleme, auf die Teams bei der Bereitstellung von Bun in der Produktion tatsächlich stoßen.
100% npm-Kompatibilität voraussetzen. Etwa 2% der Pakete — meist native C++-Addons, die mit node-gyp kompiliert wurden — funktionieren möglicherweise nicht. Häufige problematische Pakete sind bcrypt (verwenden Sie bcryptjs), bestimmte canvas-Implementierungen und node-sass (verwenden Sie sass). Führen Sie immer bun install && bun test durch, bevor Sie committen. [1][2]
Unterschiede in Buns Garbage Collector ignorieren. Bun verwendet JSCs Garbage Collector, der weniger erprobt ist für Prozesse, die 72+ Stunden kontinuierlich laufen, im Vergleich zu V8s. Überwachen Sie für Langzeitdienste das Speicherverhalten 24-48 Stunden nach der Migration. [2]
Vergessen, native Abhängigkeiten vor Docker-Builds zu prüfen. Ein Paket, das mit bun install auf macOS problemlos installiert wird, kann während Docker-Builds auf Linux fehlschlagen, wenn es plattformspezifische native Binärdateien enthält. Testen Sie die gesamte Build-Pipeline frühzeitig. [1]
Erwarten, dass die gesamte Express-Middleware unverändert funktioniert. Die meisten Express-Middleware funktioniert mit Fastify (über @fastify/express-Adapter), aber einige Pakete verlassen sich auf Express-spezifische Mutationen des Request/Response-Objekts. Testen Sie jede Middleware einzeln. [4]
Der sichere Migrationspfad
Beginnen Sie damit, Bun als Paketmanager und Test-Runner zu verwenden, während Node.js als Runtime beibehalten wird. Dies bringt Ihnen 80-90% des Geschwindigkeitsvorteils bei null Produktionsrisiko. Wechseln Sie die Runtime zu Bun erst, wenn Ihre vollständige Testsuite besteht und Sie das Speicherverhalten im Staging validiert haben.
Beide Runtimes sind 2026 produktionsreif. Die Wahl hängt von Ihren spezifischen Rahmenbedingungen ab.
Wählen Sie Bun für neue Projekte
Sie kontrollieren den Abhängigkeitsbaum. Sie wünschen natives TypeScript, schnellere CI/CD, niedrigere Serverless-Kosten oder maximalen HTTP-Durchsatz. Die Kompatibilität ist ausgezeichnet für Standard-Web-Frameworks (Fastify, Hono, Express) und ORMs (Prisma, Drizzle, TypeORM).
Behalten Sie Node.js für bestehende Projekte
Ihre Anwendung hat Hunderte von Abhängigkeiten, native C++-Addons oder Jahre von Produktionshärtung. Die Leistungsgewinne rechtfertigen selten die Migrationskosten, wenn die Runtime nicht der Engpass ist — Datenbankabfragen und Netzwerk-I/O dominieren meistens.
Verwenden Sie den Hybrid-Ansatz
Bun für Tooling (Paketverwaltung, Testing) + Node.js für Produktions-Runtime. Dies ist das pragmatische Enterprise-Muster: 80-90% schnellere CI/CD bei null Migrationsrisiko. Mehrere Fortune-500-Unternehmen haben 2026 genau dieses Muster übernommen.
Kurze Antworten auf häufige Fragen zum Betrieb von Fastify auf Bun.
Funktioniert Fastify auf Bun ohne Änderungen?
Brauche ich weiterhin tsconfig.json mit Bun?
Nicht für die Grundausführung. Bun führt .ts-Dateien nativ aus. Sie benötigen tsconfig.json nur, wenn Sie eine strenge Typüberprüfung in Ihrer IDE wünschen oder wenn andere Tools (ESLint, IDE-Autocomplete) darauf verweisen. Bun ignoriert tsconfig.json zur Laufzeit. [1]
Kann ich Prisma mit Bun verwenden?
Wie sieht es mit Hot Reload in der Entwicklung aus?
Bun bietet bun --hot, das den Anwendungszustand über Neuladungen hinweg bewahrt — schneller als Node.js' --watch-Flag, das den gesamten Prozess neu startet. Für Fastify bedeutet das, dass Ihr Server in Millisekunden statt Sekunden neu startet. [1]
Ist Bun 2026 sicher für die Produktion?
Wie vergleicht sich Bun mit Deno?
Bun ist schneller als Deno in den meisten Benchmarks. Deno hat ein stärkeres Sicherheitsmodell (integrierte Berechtigungen), aber langsamere Verbreitung. Für den Anwendungsfall dieser Anleitung (Fastify-Server) hat Bun bessere Framework-Kompatibilität und einen schnelleren Test-Runner. [2]
Quellen, die Aussagen über Bun-Runtime-Funktionen, Leistungsbenchmarks, Fastify-Kompatibilität und Ökosystem-Status belegen.
• 1. Bun — Offizielle Dokumentation (Runtime, Paketmanager, Test-Runner, bun:sqlite)
• 2. Tech Insider — Bun vs Node.js: 3x Schneller, aber ist es bereit? [2026]
• 3. fishuke/nest-bun — NestJS Express vs Bun Benchmarks (GitHub)
• 4. Fastify — Offizielle Dokumentation (Erste Schritte, Server, Validierung)
• 5. Strapi — Bun vs Node.js 2025: Leistung, Geschwindigkeit & Entwickler-Anleitung
• 6. daily.dev — Bun vs Node.js vs Deno: JavaScript-Runtimes im Vergleich 2026
Wenn Sie Bun für Ihr Backend-Stack evaluieren, kann PAS7 Studio Ihnen helfen, die Kompatibilität zu beurteilen, den Migrationspfad zu planen und einen produktionsreifen Bun + Fastify-Server mit Validierung, Datenbankintegration, Authentifizierung und Deployment-Automatisierung bereitzustellen.
Wir haben Erfahrung mit Bun, Fastify, NestJS, PostgreSQL, Docker und dem gesamten Backend-Stack. Egal, ob Sie neu starten oder von Node.js migrieren — wir können Ihnen helfen, die häufigen Fallstricke zu vermeiden und die Leistungsvorteile ohne Überraschungen zu nutzen.
Bun.js-Server mit Fastify: von null bis Produktion
Verwandte Artikel
AI SEO / GEO im Jahr 2026: Ihre nächsten Kunden sind nicht Menschen — sondern Agents
Suche verschiebt sich von Klicks zu Antworten. Bots und AI-Agents crawlen, zitieren, empfehlen — und kaufen zunehmend. Erfahren Sie, was AI SEO / GEO bedeutet, warum klassisches SEO nicht mehr reicht und wie PAS7 Studio Marken im agentischen Web sichtbar macht.
Der leistungsstärkste Chip von Apple? M5 Pro und M5 Max brechen Rekorde
Eine Analyse zu Apple M5 Pro und M5 Max im März 2026. Wir zeigen, warum diese Chips als die stärksten professionellen Laptop-SoCs von Apple gelten können, wie sie sich gegen M4 Pro, M4 Max, M1 Pro, M1 Max schlagen und was der Vergleich mit aktuellen Intel- und AMD-Chips zeigt.
Artemis II und der Code, der Menschen zum Mond trägt
Dieser Beitrag erklärt die NASA-Mission Artemis II, die am 1. April 2026 gestartet ist, und zeigt, was sie wirklich über moderne Technik erzählt: Flugsoftware, Backup-Logik, Simulationen, Telemetrie, menschliche Kontrolle und die vorsichtige Rolle von KI in Raumfahrtsystemen.
Automatisches Tagging und Suche für gespeicherte Links
Integration mit GDrive/S3/Notion für automatisches Tagging und schnelle Suche über Such-APIs
Professionelle Entwicklung für Ihr Geschäft
Wir erstellen moderne Web-Lösungen und Bots für Unternehmen. Erfahren Sie, wie wir Ihnen helfen können, Ihre Ziele zu erreichen.