# @deepstream/server 中文文档

规范地址：https://npmcn.com/package/%40deepstream/server/

版本：10\.2\.4
npm 元数据更新时间：2026-10-12T01:02:52.679Z
中文译文更新时间：2026-11-11T21:35:55.905Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40deepstream/server
原文对照：https://npmcn.com/package/%40deepstream/server/?lang=original
项目主页：https://deepstreamio.github.io/
源码仓库：https://github.com/deepstreamIO/deepstream.io

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.5 MB，456 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.0\.0
- 运行依赖：20 个
- 首次发布：2019-05-28T07:57:28.820Z
- 最新版本发布：2026-10-12T01:02:52.446Z
- 近 30 天下载量：3278（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：105（近 12 个月 14 个）

## 中文简介

实时网络应用的可缩放服务器

## 安装

```sh
npm install @deepstream/server
```

也可以使用：`pnpm add @deepstream/server`、`yarn add @deepstream/server`、`bun add @deepstream/server`

## README

# 深流 - 打开的实时服务器 [![deepstream](https://npmcn.com/package/%40deepstream/server/elton-square.png)](https://deepstreamio.github.io/)

深流是一个由金融交易技术背后的概念所启发的开源服务器. 它允许客户端和后端服务同步数据,发送消息,并以极高的速度和规模制作rpc.

[![npm version](https://badge.fury.io/js/%40deepstream%2Fserver.svg)](https://badge.fury.io/js/%40deepstream%2Fserver)[![Docker Stars](https://img.shields.io/docker/pulls/deepstreamio/deepstream.io.svg)](https://hub.docker.com/r/deepstreamio/deepstream.io/)

深流有三种核心概念,有利于实时应用开发

-   **记录** (单位:千美元)[实时文档同步](https://deepstreamio.github.io/docs/tutorials/core/datasync/records)(中文(简体) )

记录是没有计划的、持久的文件,可以被操纵和观察。 任何更改都会以毫秒的速度与所有连接的客户端和后端进程同步. 记录可以相互参照,并按列表排列,以便建立关系数据模型

-   **事件** (单位:千美元)[发布订阅消息](https://deepstreamio.github.io/docs/tutorials/core/pubsub/events)(中文(简体) )

事件允许高性能,多对多信息。 深流提供基于主题的从发件人到订阅者的路由,数据序列化和订阅收听.

-   **转写** (单位:千美元)[请求响应工作流程](https://deepstreamio.github.io/docs/tutorials/core/request-response/rpc)(中文(简体) )

远程程序要求允许安全且可大量利用的请求响应通信。 深流处理负载平衡,故障处理,数据传输和消息通路.

-   **警卫** (单位:千美元)[认证](https://deepstreamio.github.io/docs/tutorials/core/auth/auth-introduction) 财务报告和审定财务报表 [权限](https://deepstreamio.github.io/docs/tutorials/core/permission/valve-introduction)(中文(简体) )

深流提供了不同认证机制的组合,它具有强大的权限语言"Valve",允许您指定哪个用户可以执行哪个动作的数据.

### 开始 :

1.  [教学 何为深流](https://deepstreamio.github.io/docs/tutorials/concepts/what-is-deepstream)
2.  [安装深流](https://deepstreamio.github.io/docs/tutorials/install/linux)
3.  [快速启动](https://deepstreamio.github.io/docs/tutorials/getting-started/javascript)
4.  [文档](https://deepstreamio.github.io/docs/docs)

### 社区链接

1.  [叠叠流](https://stackoverflow.com/questions/tagged/deepstream.io)
2.  [Github 讨论](https://github.com/deepstreamIO/deepstreamIO.github.io/discussions)

### 捐款

深流开发是进入构建演艺家Node.js应用程序的好方法,而贡献总是受到很多QQ的欢迎. 为深流做出贡献就像安装了Node.js(10+)和TypeScript(3+)一样简单,克隆了回波并做了一些修改.

```
~ » git clone git@github.com:deepstreamIO/deepstream.io.git
~ » cd deepstream.io
~/deepstream.io » git submodule update --init
~/deepstream.io » npm i
~/deepstream.io » npm start
      _                     _
   __| | ___  ___ _ __  ___| |_ _ __ ___  __ _ _ __ ____
  / _` |/ _ \/ _ \ '_ \/ __| __| '__/ _ \/ _` | '_ ` _  \
 | (_| |  __/  __/ |_) \__ \ |_| | |  __/ (_| | | | | | |
  \__,_|\___|\___| .__/|___/\__|_|  \___|\__,_|_| |_| |_|
                 |_|
 =====================   starting   =====================
```

从这里你可以做你的改变, 检查单位测试通过:

```
~/deepstream.io » npm t
```

如果你的改变是实质性的,你也可以运行我们广泛的端到端测试框架:

```
~/deepstream.io » npm run e2e
```

对于想要确保二进制工作的电力用户,您可以运行 `sh scripts/package.sh true`。您需要下载通常的 [节点-gyp](https://github.com/nodejs/node-gyp) 构建此操作的环境,我们只支持最新编译的 LTS 版本. 通常不需要此步骤, 除非您修改资源文件或更改依赖性 .

## 常见问题

### @deepstream/server 是什么？

实时网络应用的可缩放服务器

### 如何安装 @deepstream/server？

在项目目录运行 npm install @deepstream/server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 deepstream，可以用 npx deepstream 直接运行。

### @deepstream/server 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @deepstream/server 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @deepstream/server 需要什么版本的 Node\.js？

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

### @deepstream/server 可以商用吗？

@deepstream/server 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @deepstream/server 的下载量有多少？

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

### @deepstream/server 还在维护吗？

最新版本 10\.2\.4 发布于 2026/10/12（30 天前）；至今共发布 105 个版本，其中过去 12 个月发布了 14 个；首次发布于 2019/05/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。