fastify:基于 Node.js 的高性能 Web 框架项目

Fast and low overhead web framework, for Node.js

Files	Last commit	Last update
.github	docs: fix broken links in Style-Guide.md (#6966)	16 days ago
build	refactor!: remove FSTDEP024 deprecation (#6912) Remove the deprecated top-level requestIdLogLabel option. Configure the request ID log label through LogController instead. BREAKING CHANGE: requestIdLogLabel is no longer supported as a top-level Fastify option. Pass it to LogController and provide the instance through logController.	26 days ago
docs	docs: fix broken links in Style-Guide.md (#6966)	16 days ago
examples	perf: use native WebStream API instead of Readable.fromWeb wrapper (#6444)	7 months ago
integration	chore: add missing `use strict` directives (#5106)	2 years ago
lib	fix: callNotFound should run not-found preHandler regardless of registration order (#6965) setContext() in four-oh-four.js takes a detached shallow snapshot of the selected not-found context. When a route that calls reply.callNotFound() is registered before setNotFoundHandler(), the snapshot is taken before the not-found handler's preReady callback populates its lifecycle hooks, so the copied context retains preHandler: null. reply.callNotFound() then dispatches the not-found handler directly, skipping the preHandler that setNotFoundHandler() declares. This change uses the selected context as the prototype of the route-specific 404 context instead of copying it, keeping the route's own onSend value, so the route-specific context stays linked to the live one and later hook population is visible. Adds a regression test covering the route-first declaration order. --------- Co-authored-by: mcollina <mcollina@users.noreply.github.com>	13 days ago
scripts	ci: add node 26 to test matrices (#6728)	2 months ago
test	fix: callNotFound should run not-found preHandler regardless of registration order (#6965) setContext() in four-oh-four.js takes a detached shallow snapshot of the selected not-found context. When a route that calls reply.callNotFound() is registered before setNotFoundHandler(), the snapshot is taken before the not-found handler's preReady callback populates its lifecycle hooks, so the copied context retains preHandler: null. reply.callNotFound() then dispatches the not-found handler directly, skipping the preHandler that setNotFoundHandler() declares. This change uses the selected context as the prototype of the route-specific 404 context instead of copying it, keeping the route's own onSend value, so the route-specific context stays linked to the live one and later hook population is visible. Adds a regression test covering the route-first declaration order. --------- Co-authored-by: mcollina <mcollina@users.noreply.github.com>	13 days ago
types	refactor(types)!: remove ResSerializerReply type (#6911) * refactor(types)!: remove ResSerializerReply type Inline the partial reply shape used by response serializers and remove the exported alias. BREAKING CHANGE: ResSerializerReply is no longer exported from types/logger. * docs: fix types/logger.d.ts Co-authored-by: KaKa <23028015+climba03003@users.noreply.github.com> Signed-off-by: Jean Michelet <110341611+jean-michelet@users.noreply.github.com> * test: fix pino test --------- Signed-off-by: Jean Michelet <110341611+jean-michelet@users.noreply.github.com> Co-authored-by: KaKa <23028015+climba03003@users.noreply.github.com> Co-authored-by: KaKa <kaka@kakang.dev>	25 days ago
.borp.yaml	chore: setup borp reporter for switch to node test (#5720) * chore: setup borp reporter for switch to node test * chore: update scripts and test-reporter * update scripts * fix * bump borp to v0.18.0 * pr feedback * pr feedback * fix file name to .borp.yaml	1 year ago
.editorconfig	docs: Migration Guide v3 (#2140) Co-Authored-By: Manuel Spigolon <behemoth89@gmail.com> Co-Authored-By: James Sumners <james@sumners.email>	6 years ago
.gitattributes	style(.gitattributes): standardise style across fastify repos (#5816) Signed-off-by: Frazer Smith <frazer.dev@icloud.com>	1 year ago
.gitignore	Ignore agents config files (#6474)	7 months ago
.gitpod.yml	chore: gitpodify (#5168)	2 years ago
.markdownlint-cli2.yaml	chore: updated dependencies to latest versions (#5422) * updated all the packages which required minor / patch version bumps * updated: @typescript-eslint/eslint-plugin @typescript-eslint/parser * updated: c8 ajv-formats * updated: markdownlint-cli2 * fully working eslint config * removed some unused deps * removed some unused deps * updated: tsd undici --------- Co-authored-by: Giovanni Bucci <giovanni.bucci@nearform.com>	2 years ago
.npmignore	chore: npm ignore AI related files (#6447) * chore: npm ignore AI related files * chore: update .npmignore Co-authored-by: Matteo Collina <hello@matteocollina.com> Signed-off-by: KaKa <23028015+climba03003@users.noreply.github.com> * chore: ide setting Signed-off-by: Manuel Spigolon <behemoth89@gmail.com> * chore: ignore log file Signed-off-by: Manuel Spigolon <behemoth89@gmail.com> --------- Signed-off-by: KaKa <23028015+climba03003@users.noreply.github.com> Signed-off-by: Manuel Spigolon <behemoth89@gmail.com> Co-authored-by: Matteo Collina <hello@matteocollina.com> Co-authored-by: Manuel Spigolon <behemoth89@gmail.com>	7 months ago
.npmrc	chore(.npmrc): add min-release-age (#6873) Signed-off-by: Frazer Smith <frazer.dev@icloud.com>	1 month ago
.prettierignore	Add rc files for dx improvement (#2269)	6 years ago
CODE_OF_CONDUCT.md	docs: repoint readers to shared `.github` files (#5268)	2 years ago
CONTRIBUTING.md	docs: update contribution rules (#6670) * docs: update contribution rules * fix: update link * fix: update link * docs: update CONTRIBUTING.md Co-authored-by: James Sumners <321201+jsumners@users.noreply.github.com> Signed-off-by: Antonio Tripodi <Tony133@users.noreply.github.com> * chore: update CONTRIBUTING.md Co-authored-by: James Sumners <321201+jsumners@users.noreply.github.com> Signed-off-by: Antonio Tripodi <Tony133@users.noreply.github.com> --------- Signed-off-by: Antonio Tripodi <Tony133@users.noreply.github.com> Co-authored-by: James Sumners <321201+jsumners@users.noreply.github.com>	4 months ago
EXPENSE_POLICY.md	docs: fix broken and redirected links (#6817)	2 months ago
GOVERNANCE.md	docs: repoint readers to shared `.github` files (#5268)	2 years ago
LICENSE	chore(license): standardise license notice (#6511) See https://github.com/fastify/point-of-view/pull/497, easier to maintain if they all use the same style. Signed-off-by: Frazer Smith <frazer.dev@icloud.com>	6 months ago
PROJECT_CHARTER.md	docs: fix broken and redirected links (#6817)	2 months ago
README.md	ci!: increase minimum runtime version (#6904)	30 days ago
SECURITY.md	docs: remove HackerOne reporting link (#6735) * docs: remove HackerOne reporting link * Update SECURITY.md Co-authored-by: Frazer Smith <frazer.dev@icloud.com> Signed-off-by: Joaquim Peixoto <34003264+jhcpeixoto@users.noreply.github.com> --------- Signed-off-by: Joaquim Peixoto <34003264+jhcpeixoto@users.noreply.github.com> Co-authored-by: Frazer Smith <frazer.dev@icloud.com>	2 months ago
SPONSORS.md	chore(sponsor): add testmu ai (#6922)	28 days ago
eslint.config.js	style(types): enforce max line length (#6864) * style(types): enforce max line length * style(types): improve declaration formatting	1 month ago
fastify.d.ts	fix: disable numeric trustProxy hop-count trust	17 days ago
fastify.js	Bumped v6.0.0-alpha.2 Signed-off-by: Matteo Collina <hello@matteocollina.com>	17 days ago
package.json	Bumped v6.0.0-alpha.2 Signed-off-by: Matteo Collina <hello@matteocollina.com>	17 days ago

Auto Translate

高效的服务器意味着更低的基础设施成本、更强的负载响应能力，以及更满意的用户体验。如何在不牺牲安全验证和便捷开发的前提下，高效地管理服务器资源，以处理尽可能多的请求？

Fastify 应运而生。Fastify 是一个高度专注于提供最佳开发者体验、同时保持极低开销并具备强大插件架构的 Web 框架。它借鉴了 Hapi 和 Express 的设计理念，并且据我们所知，它是目前同类 Web 框架中速度最快的之一。

main 分支对应 Fastify v6 版本。若需 v5 版本，请查看 5.x 分支。

快速开始

创建一个文件夹并将其设为当前工作目录：

mkdir my-app
cd my-app

使用 npm init 生成一个 Fastify 项目：

npm init fastify

安装依赖：

npm i

以开发模式启动应用：

npm run dev

生产模式下：

npm start

在底层，npm init 会下载并运行 Fastify Create，而后者又会使用 Fastify CLI 的生成功能。

安装

要在现有项目中将 Fastify 作为依赖项安装：

npm i fastify

示例

// Require the framework and instantiate it

// ESM
import Fastify from 'fastify'

const fastify = Fastify({
  logger: true
})
// CommonJS
const fastify = require('fastify')({
  logger: true
})

// Declare a route
fastify.get('/', (request, reply) => {
  reply.send({ hello: 'world' })
})

// Run the server!
fastify.listen({ port: 3000 }, (err, address) => {
  if (err) throw err
  // Server is now listening on ${address}
})

使用 async-await：

// ESM
import Fastify from 'fastify'

const fastify = Fastify({
  logger: true
})
// CommonJS
const fastify = require('fastify')({
  logger: true
})

fastify.get('/', async (request, reply) => {
  reply.type('application/json').code(200)
  return { hello: 'world' }
})

fastify.listen({ port: 3000 }, (err, address) => {
  if (err) throw err
  // Server is now listening on ${address}
})

想了解更多信息吗？请前往 快速入门。如果您更喜欢通过阅读代码来学习，可以探索官方示例。

注意

.listen 默认绑定到本地主机 localhost 接口（127.0.0.1 或 ::1，具体取决于操作系统配置）。如果您在容器（Docker、GCP 等）中运行 Fastify，可能需要绑定到 0.0.0.0。监听所有接口时请务必谨慎，这会带来固有的安全风险。更多信息请参见文档。

核心特性

高性能：据我们所知，Fastify 是目前速度最快的 Web 框架之一，根据代码复杂度不同，每秒可处理超过 76,000 个请求。
可扩展：Fastify 可通过其钩子、插件和装饰器进行完全扩展。
基于 Schema：尽管并非强制要求，但我们建议使用 JSON Schema 来验证路由并序列化输出。Fastify 内部会将 Schema 编译为高性能函数。
日志：日志极为重要，但成本较高；我们选择了最佳的日志工具 Pino，以尽可能降低这一成本！
开发者友好：该框架设计得非常直观，能在不牺牲性能和安全性的前提下，助力开发者日常使用。