bun实现HTTP服务器

Bun 提供了原生 Bun.serve API。它实现了 fetch 以及Node.js的 http 和 https 模块。

这些模块已被重新实现，以使用 Bun 的快速内部 HTTP 基础设施。随意直接使用这些模块;像 Express 这样依赖于这些模块的框架应该开箱即用。有关详细的兼容性信息，请参阅运行时> Node.js API。

要使用纯净的 API 启动高性能 HTTP 服务器，推荐的方法是 Bun.serve。

`Bun.serve`

使用 Bun.serve 启动 HTTP 服务器。

Bun.serve({fetch(req) {return new Response("Bun!");},
});

fetch 用来处理传入请求。它接收 Request 对象并返回 Response 或 Promise<Response>。

Bun.serve({fetch(req) {const url = new URL(req.url);if (url.pathname === "/") return new Response("Home page!");if (url.pathname === "/blog") return new Response("Blog!");return new Response("404!");},
});

配置服务器监听的端口和主机名：

Bun.serve({port: 8080, // defaults to $BUN_PORT, $PORT, $NODE_PORT otherwise 3000hostname: "mydomain.com", // defaults to "0.0.0.0"fetch(req) {return new Response("404!");},
});

监听 unix 域套接字：

Bun.serve({unix: "/tmp/my-socket.sock", // path to socketfetch(req) {return new Response(`404!`);},
});

错误处理

若要激活开发模式，请设置 development: true。默认情况下，除非NODE_ENV === production，否则将启用开发模式。

Bun.serve({development: true,fetch(req) {throw new Error("woops!");},
});

在开发模式下，Bun 会在浏览器中显示带有内置错误页面的错误。

若要处理服务器端错误，请实现error处理程序。此函数应返回一个 Response，以便在发生错误时提供给客户端。此响应将取代 Bun 在development模式下的默认错误页面。

Bun.serve({fetch(req) {throw new Error("woops!");},error(error) {return new Response(`<pre>${error}\n${error.stack}</pre>`, {headers: {"Content-Type": "text/html",},});},
});

对 Bun.serve 的调用将返回一个 Server 对象。若要停止服务器，请调用 .stop() 方法。

const server = Bun.serve({fetch() {return new Response("Bun!");},
});server.stop();

TLS

Bun 支持开箱即用的 TLS，由 BoringSSL 提供支持。通过传入 key 和 cert 的值来启用 TLS；两者都是启用 TLS 所必需的。

Bun.serve({fetch(req) {return new Response("Hello!!!");},tls: {key: Bun.file("./key.pem"),cert: Bun.file("./cert.pem"),}
});

key 和 cert 字段需要 TLS 密钥和证书的内容，而不是它的路径。这可以是字符串、BunFile、TypedArray 或 Buffer。

Bun.serve({fetch() {},tls: {// BunFilekey: Bun.file("./key.pem"),// Bufferkey: fs.readFileSync("./key.pem"),// stringkey: fs.readFileSync("./key.pem", "utf8"),// array of abovekey: [Bun.file("./key1.pem"), Bun.file("./key2.pem")],},
});

如果您的私钥是使用密码加密的，请为 passphrase 提供一个值来解密它。

Bun.serve({fetch(req) {return new Response("Hello!!!");},tls: {key: Bun.file("./key.pem"),cert: Bun.file("./cert.pem"),passphrase: "my-secret-passphrase",}
});

（可选）您可以通过传递 ca 的值来覆盖受信任的 CA 证书。默认情况下，服务器将信任 Mozilla 策划的知名 CA 列表。指定 ca 时，Mozilla 列表将被覆盖。

Bun.serve({fetch(req) {return new Response("Hello!!!");},tls: {key: Bun.file("./key.pem"), // path to TLS keycert: Bun.file("./cert.pem"), // path to TLS certca: Bun.file("./ca.pem"), // path to root CA certificate}
});

要覆盖 Diffie-Hellman 参数，请执行以下操作：

Bun.serve({// ...tls: {// other configdhParamsFile: "/path/to/dhparams.pem", // path to Diffie Hellman parameters},
});

对象语法

到目前为止，本页的示例使用了显式的 Bun.serve API。Bun 还支持替代语法。

import {type Serve} from "bun";export default {fetch(req) {return new Response("Bun!");},
} satisfies Serve;

不要将服务器选项传递到 Bun.serve，而是export default。此文件可以按原样执行；当 Bun 看到一个default fetch 处理程序的文件时，它会将其传递到后台的 Bun.serve。

流式处理文件

若要流式传输文件，请返回一个 Response 对象，并将 BunFile 对象作为正文。

Bun.serve({fetch(req) {return new Response(Bun.file("./hello.txt"));},
});

⚡️ 速度 — Bun 在可能的情况下自动使用 sendfile(2) 系统调用，在内核中启用零拷贝文件传输 — 发送文件的最快方式。

可以使用 Bun.file 对象上的 slice(start, end) 方法发送文件的一部分。这会自动设置 Response 对象上的 Content-Range 和 Content-Length 标头。

Bun.serve({fetch(req) {// parse `Range` headerconst [start = 0, end = Infinity] = req.headers.get("Range") // Range: bytes=0-100.split("=") // ["Range: bytes", "0-100"].at(-1) // "0-100".split("-") // ["0", "100"].map(Number); // [0, 100]// return a slice of the fileconst bigFile = Bun.file("./big-video.mp4");return new Response(bigFile.slice(start, end));},
});

基准

下面是一个简单 HTTP 服务器的 Bun 和 Node.js 实现，它响应每个传入 Request Bun!。

// bunBun.serve({fetch(req: Request) {return new Response("Bun!");},port: 3000,
});// noderequire("http").createServer((req, res) => res.end("Bun!")).listen(8080);

Bun.serve 服务器每秒处理的请求量大约是 Linux 上Node.js 的 2.5 倍。