安装
在Linux上安装
了解如何在Linux上安装deepstream
下载最新的服务器安装包deepstream.io-linux-VERSION.tar.gz并将其解压缩。
启动deepstream
您可以在控制台上简单的键入如下命令启动deepstream
./deepstream
了解deepstream 命令行界面及其配置文件的更多信息。
一些提示
- deepstream的配置文件可以用YAML或JSON编写。deepstream将根据文件扩展名自动选择正确的解析器。
- 一些核心配置选项可以被命令行参数覆盖，例如--host，--port或--disable-auth。完整列表，请运行
deepstream start --help
- 配置文件中有相对路径，例如 ./permissions.yml或users.yml，这些路径是相对于主配置文件所在目录的。如果您从其他位置运行，请确保对其进行更新。
安装为服务
从2.4开始，deepstream在支持init.d或systemd的计算机上可作为服务自动运行。
安装服务非常简单
sudo deepstream service add
然后，您可以使用常规服务命令启动它
sudo service deepstream start
或直接通过deepstream启动
sudo deepstream service start
对于那些希望注册多个服务（在一台机器上运行多个deepstream）的用户，可用指定名称并提供唯一的配置文件来实现。
sudo deepstream service add --service-name deepstream-6020 -c ~/path1/to/config sudo deepstream service add --service-name deepstream-6030 -c ~/path2/to/config
避免sudo
如果要验证服务器配置，或者不想用sudo操作，可以加--dry-run选项打印出服务脚本以进行配置检查或手动安装。
deepstream service add --dry-run
在OSX上安装
了解如何在OS X上安装deepstream
下载最新的服务器安装包deepstream.io-mac-VERSION.zip并将其解压缩。
启动deepstream
您可以在控制台上简单的键入如下命令启动deepstream
./deepstream
了解deepstream 命令行界面及其配置文件的更多信息。
一些提示
- deepstream的配置文件可以用YAML或JSON编写。deepstream将根据文件扩展名自动选择正确的解析器。
- 一些核心配置选项可以被命令行参数覆盖，例如--host，--port或--disable-auth。完整列表，请运行
deepstream start --help
- 配置文件中有相对路径，例如 ./permissions.yml或users.yml，这些路径是相对于主配置文件所在目录的。如果您从其他位置运行，请确保对其进行更新。
Homebrew
Homebrew尚未与V5版本保持同步。如果您能够帮助进行更新，请与我们联系！
在Windows上安装
了解如何在Windows上安装deepstream
下载最新的服务器安装包deepstream.io-windows-VERSION.zip并将其解压缩。
启动deepstream
您可以通过双击可执行文件或通过CMD启动服务器
deepstream.exe start
了解deepstream 命令行界面及其配置文件的更多信息。
一些提示
- deepstream的配置文件可以用YAML或JSON编写。deepstream将根据文件扩展名自动选择正确的解析器。
- 一些核心配置选项可以被命令行参数覆盖，例如--host，--port或--disable-auth。完整列表，请运行
deepstream start --help
- 配置文件中有相对路径，例如 ./permissions.yml或users.yml，这些路径是相对于主配置文件所在目录的。如果您从其他位置运行，请确保对其进行更新。
Node / NPM / Yarn[编辑]
通过NPM和Node.js安装deepstream
deepstream也可以作为NPM软件包安装，并提供Node.js API进行编程交互。这对自定义身份验证或许可逻辑很有用。您可以查看完整的Node.js API 。
通过npm安装服务器[编辑]
npm install @deepstream/server
创建一个js文件，例如具有以下内容的start.js
const { Deepstream } = require('@deepstream/server')
/* The server can take 1) a configuration file path 2) null to explicitly use defaults to be overriden by server.set() 3) left empty to load the base configuration from the config file located within the conf directory. 4) pass some options, missing options will be merged from the base configuration. */ const server = new Deepstream()
// start the server server.start()
用node运行文件
node start.js
在Node.js中使用Deepstream客户端
可以通过NPM安装deepstream javascript客户端并在Node.js中使用。
npm install @deepstream/client
const { DeepstreamClient } = require('@deepstream/client') const client = new DeepstreamClient('localhost:6020') client.login()
Docker Image
了解如何从docker镜像运行deepstream的独立容器。本教程还将说明如何手动构建映像。
什么是Docker？
Docker是一个开源项目，可自动在软件容器内部署应用程序。Docker在Linux上提供了OS虚拟化的抽象层和自动化层。
在Docker基础映像上执行操作时，将以如下方式创建并记录联合文件系统层，即每个层都完全描述了如何重新创建操作。该策略使Docker支持轻量级映像，因为仅更新的层需要传播（而不是整个VM）。
为什么要在Deepstream上使用Docker？
Docker提供了一个轻量级的解决方案来启动deepstream服务器。它封装了所有必要的设置，并降低了大规模微服务部署的复杂性。
如何在Docker中启动deepstream？
要使deepstream服务器快速运行，您可以执行以下操作：
docker run -p 6020:6020 deepstreamio/deepstream.io
仅此而已！
如果要覆盖某些配置或在后台运行deepstream，请继续阅读。
首先，通过运行以下命令从DockerHub注册表中安装镜像：
docker pull deepstreamio/deepstream.io
然后，用该镜像创建一个容器，并将容器命名为deepstream.io：
docker create -t -p 6020:6020 \ --name deepstream.io \ -v $(pwd)/conf:/usr/local/deepstream/conf \ -v $(pwd)/var:/usr/local/deepstream/var \ deepstreamio/deepstream.io
现在您可以通过以下方式启动容器
docker start -ia deepstream.io
这将在前台启动容器。您可以按Ctrl+C但是该容器仍然有效。要停止容器，您需要运行
docker stop deepstream.io
如果您想在后台启动它，只需忽略-ia选项。
您可以使用以下命令显示日志：
docker logs -f deepstream.io
该-f选项将使保持进程活性并跟踪输出。
如果您想要的不仅仅是一个deepstream节点，请转至Docker Compose教程，该教程介绍了deepstream该如何连接数据库，高速缓存和搜索容器，这些容器充当deepstream的高速缓存和存储层。