@bedrock/server

中文文档
5.2.1发布于 2026/09/18Apache-2.0ES Module近 30 天下载 4106

Bedrock 核心服务器模块

中文使用文档
文档目录7 节
  1. 所需资源
  2. 快速示例
  3. 配置
  4. 设置
  5. 贝德洛克事件
  6. 如何运作
  7. 许可证

基岩服务器

A 类 基石 模块提供了基本的 HTTP 和 HTTPS 服务器。 其它 模块,例如 基石表达,通常提供一个路由框架 和编写 Web 应用程序的其他功能,但取决于此模块 用于核心低级功能,如监听接入的连接, 将HTTP流量重定向到HTTPS端口,并配置SSL/TLS.

所需资源

这个软件需要并支持维持了最新版本的Node.js. 更新可能会去除对旧的未维护的平台版本的支持. 请使用 依赖版本锁定文件和测试以确保与此兼容 软件.

快速示例

npm install @bedrock/server

Bedrock 后将自定义请求处理器附加到服务器的示例 准备.

import * as bedrock from '@bedrock/core';
import * as server from '@bedrock/server';

// once bedrock is ready, attach request handler
bedrock.events.on('bedrock.ready', function() {
  // attach to TLS server
  server.servers.https.on('request', function(req, res) {
    res.writeHead(200, {'Content-Type': 'text/plain'});
    res.end('Hello World\n');
  });
});

bedrock.start();

默认, @bedrock/server 将重定向 HTTP 请求到 HTTPS 。 改为: 替换此默认行为, 执行以下操作:

import * as server from '@bedrock/server';

// once bedrock is ready, attach request handler
bedrock.events.on('bedrock.ready', function() {
  // attach to HTTP server
  server.servers.http.on('request', function(req, res) {
    res.writeHead(200, {'Content-Type': 'text/plain'});
    res.end('Hello World\n');
  });
});

bedrock.start();

配置

关于服务器配置的文档,见 配置( j)。 。 。 .

设置

  1. [可选 微调配置
  2. 地图 bedrock.localhost 主机名( 或您配置的任意) 到您的 机器 :
    1. 编辑 /etc/hosts 文件为管理员/ root .
    2. 添加一个 IP 地址映射条目 bedrock.localhost。 。 。 . 例如: 127.0.0.1 localhost bedrock.localhost。 。 。 . (如果外部访问服务器,可能需要使用 IP 地址) ,您的主要网络设备.

当基德运行时访问服务器:

  1. 访问:https://bedrock.localhost:18443/
  2. 证书警告对于开发模式是正常的. 接受它,并 继续.

贝德洛克事件

排放清单 贝德洛克事件数字 :

  • 基础服务器. 准备状态检查
    • 在任何端口开始监听前被接收 .
  • 地基-服务器. http. listen
    • 参数数字 :
      • {address, port}: 带有地址和端口以收听的对象.
    • 在HTTP端口监听前发送.
  • 基础服务器. http.listing
    • 参数数字 :
      • {address, port}: 地址和端口的对象正在监听.
    • 在 HTTP 端口听完后发送 .
  • 地基服务器. https. listen
    • 参数数字 :
      • {address, port}: 带有地址和端口以收听的对象.
    • 在HTTPS端口监听前被接收.
  • 基础服务器. https.listing
    • 参数数字 :
      • {address, port}: 地址和端口的对象正在监听.
    • 在 HTTPS 端口听完后被接收 .
  • 基础服务员,准备好了
    • 听完后就放出来了.

如何运作

开始

许可证

Apache 许可证,2.0版本 版权所有 2011-2024 Digital Bazaar, Inc.

其他贝德罗克图书馆可使用非商业许可证 诸如自学、研究、个人项目或评价目的. 见 Bedrock 非商业许可证 v1.0 详细情况.

商业许可证和通过联系获得支助 数字集市 支持@ digitalbazaar.com。 。 。 .

版本与发布记录

@bedrock/server 共发布 7 个版本,首次发布于 2022/04/02;过去 12 个月发布了 2 个版本。

版本发布日期距今
5.2.1latest2026/09/181 个月前
5.2.02026/08/222 个月前
5.1.02024/02/292 年前
5.0.02022/04/294 年前
4.1.02022/04/214 年前
4.0.12022/04/024 年前

关于 @bedrock/server 的常见问题

@bedrock/server 是什么?

Bedrock 核心服务器模块

如何安装 @bedrock/server?

在项目目录运行 npm install @bedrock/server,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@bedrock/core(^6.3.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@bedrock/server 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/bedrock__server 是否存在。

@bedrock/server 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@bedrock/server 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@bedrock/server 可以商用吗?

@bedrock/server 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@bedrock/server 的下载量有多少?

根据 npm 官方下载统计,@bedrock/server 在 2026/10/08 – 2026/11/06 这 30 天内被下载 4,106 次,日均约 137 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@bedrock/server 还在维护吗?

最新版本 5.2.1 发布于 2026/09/18(1 个月前);至今共发布 7 个版本,其中过去 12 个月发布了 2 个;首次发布于 2022/04/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。