---
source_url: https://docs.dolphindb.cn/zh/db_distr_comp/cfg/standalone.html
fetched_at: 2026-05-19T09:00:15Z
category: db_distr_comp
title: 单节点模式
sha1: 9979efe465982d6bdff0c46ef3c171933e7e6a5a
---

# 单节点模式

执行安装包 server 目录的可执行文件，可以快速启动单节点模式。单节点模式可以帮助用户试用并快速上手 DolphinDB。

## 启动指令

单节点部署，直接启动执行文件即可。以下是不同系统的启动指令示例：

- Linux 系统

  ```dolphindb
  // 启动本地节点
  ./dolphindb -localSite localhost:8900:local8900
  ```
- Windows 系统

  在 Windows 环境中，直接双击运行 dolphindb.exe
  进行启动。或者在命令行终端输入以下指令启动：

  ```dolphindb
  // 启动本地节点
  dolphindb.exe -localSite localhost:8900:local8900
  ```

## 启动 DolphinDB 终端

DolphinDB 终端是一个命令行交互式工具，用于连接到远程的 DolphinDB 服务器执行命令。

Linux 系统使用以下命令启动 DolphinDB 终端：

```dolphindb
rlwrap -r ./dolphindb -remoteHost 192.168.1.135 -remotePort 8848
```

Windows 系统使用以下命令启动 DolphinDB 终端：

```dolphindb
dolphindb.exe -remoteHost 192.168.1.135 -remotePort 8848
```

退出终端：

```dolphindb
quit
```

命令行中支持以 "-" + “配置项” 的格式指定配置参数。不频繁修改的配置项建议在配置文件中指定。命令行通常用于指定一些灵活可变的参数，如 server 的 ip
和端口号、最大内存上限等。需要注意的是，存在部分参数只支持在命令行指定，见下表：

| 配置参数 | 解释 |
| --- | --- |
| remoteHost | DolphinDB 远端服务器的 IP 地址。 |
| remotePort | DolphinDB 远端服务器的端口号。 |
| stdoutLog | 设置输出系统日志到日志文件（dolphindb.log）或者标准输出（控制台）。取值为0（默认），表示输出到日志文件；取值为1，表示输出到 stdout；取值为2，表示同时输出到日志文件和标准输出。 |
| uid | DolphinDB 远端服务器的用户名。 |
| pwd | DolphinDB 远端服务器的密码。 |
| run | 启动时发送到远端的 DolphinDB 服务器执行的位于本地的 DolphinDB 脚本文件。该文件在系统执行 startup 参数指定的文件后执行。默认情况下，该文件应该位于 <HomeDir>。它以命令行方式运行一个任务。注意：该文件执行完后，系统将会自动退出。若文件执行成功，则返回0；否则返回非0值。 |
| maxLogSize=1024 | 当日志文件达到指定大小（单位为 MB）时，系统会将其存档。默认值是1024，最小值是100。原日志文件名添加前缀作为存档的文件名。前缀的格式为 <date><seq>。例如，20181109000有三位数字，从000开始。 |
| console=true | 表示是否启动 DolphinDB 命令行窗口的布尔值，默认值是 true。该参数只能在命令行中指定。 |

还有部分仅命令行支持的配置项由于在文中已进行了说明，这里仅列出名字：home, logFile, config, clusterConfig,
nodesFile。

## 启动流程

DolphinDB 系统的启动流程如下图所示：

![](../../images/startup.png)

该流程中涉及到三个启动脚本的执行，脚本路径的配置参数如下：

| 配置参数 | 解释 |
| --- | --- |
| init=dolphindb.dos | 该文件在系统启动时执行。默认文件是 <HomeDir>/dolphindb.dos。它通常包含了对所有用户可见并且不能被改写的系统级函数的定义。 |
| startup=startup.dos | 该文件在系统启动后执行。默认文件是 <HomeDir>/startup.dos。它可以包含加载插件、加载分布式表、定义并加载流数据表等脚本。 |
| postStart=postStart.dos | 该文件在初始化定时任务模块之后执行。默认文件是 <HomeDir>/postStart.dos。它可以在启动 DolphinDB 时加载定时作业相关的任务。 |

此外，DolphinDB 还支持启动时预加载模块和插件，通过配置项 preloadModules 指定。若

- 预加载插件：必须写上 "plugins::"，比如预加载 mysql 插件，必须指定为
  plugins::mysql，系统会到 pluginDir 目录加载插件。
- 预加载模块：只能指定相对于 moduleDir 的文件路径。比如存放于 moduleDir（默认为
  modules）的 system/log/fileLog.dos 模块，必须指定为 system::log::fileLog。

| 配置参数 | 解释 |
| --- | --- |
| preloadModules=plugins::mysql,system::log::fileLog | 系统启动后自动加载的模块或插件。如果需要加载多个模块或插件，使用逗号分隔。 |
