Bun 开箱即用地支持 TLS,由 BoringSSL 提供支持。通过为 key 和 cert 传递值来启用 TLS;两者都需要启用 TLS。
ts
Bun.serve({
tls: {
key: Bun.file("./key.pem"),
cert: Bun.file("./cert.pem"),
},
});key 和 cert 字段期望你的 TLS 密钥和证书的_内容_,而不是路径。这可以是字符串、BunFile、TypedArray 或 Buffer。
ts
Bun.serve({
tls: {
key: Bun.file("./key.pem"), // BunFile
key: fs.readFileSync("./key.pem"), // Buffer
key: fs.readFileSync("./key.pem", "utf8"), // 字符串
key: [Bun.file("./key1.pem"), Bun.file("./key2.pem")], // 上述数组
},
});密码短语
如果你的私钥使用密码短语加密,提供 passphrase 值来解密它。
ts
Bun.serve({
tls: {
key: Bun.file("./key.pem"),
cert: Bun.file("./cert.pem"),
passphrase: "my-secret-passphrase",
},
});CA 证书
可选地,你可以通过为 ca 传递值来覆盖受信任的 CA 证书。默认情况下,服务器将信任由 Mozilla 策划的知名 CA 列表。当指定 ca 时,Mozilla 列表会被覆盖。
ts
Bun.serve({
tls: {
key: Bun.file("./key.pem"), // TLS 密钥路径
cert: Bun.file("./cert.pem"), // TLS 证书路径
ca: Bun.file("./ca.pem"), // 根 CA 证书路径
},
});Diffie-Hellman
要覆盖 Diffie-Hellman 参数:
ts
Bun.serve({
tls: {
dhParamsFile: "/path/to/dhparams.pem", // Diffie-Hellman 参数路径
},
});服务器名称指示 (SNI)
要配置服务器的服务器名称指示 (SNI),在 tls 对象中设置 serverName 字段。
ts
Bun.serve({
tls: {
serverName: "my-server.com", // SNI
},
});要允许多个服务器名称,传递对象数组给 tls,每个对象都有 serverName 字段。
ts
Bun.serve({
tls: [
{
key: Bun.file("./key1.pem"),
cert: Bun.file("./cert1.pem"),
serverName: "my-server1.com",
},
{
key: Bun.file("./key2.pem"),
cert: Bun.file("./cert2.pem"),
serverName: "my-server2.com",
},
],
});