插件管理

通过插件管理界面，管理员用户可以在任一节点上统一管理集群中的插件，包括查看插件版本、一键安装与加载插件，从而确保插件版本与集群中部署的 DolphinDB server 版本一致，避免节点间插件版本不一致的问题。

查看插件信息

在集群中任一节点以管理员身份登录 Web 客户端，即可从侧边栏进入插件管理页面。

集群总览

插件管理的主页面展示了当前集群中所有已安装的插件列表，包括每个插件在集群中的最低版本、已安装该插件的节点以及当前已加载该插件的节点等信息。用户可以通过顶部的搜索栏快速查找特定插件。

注：
未启动的节点将统一显示在待安装节点下。请确保所有节点正常运行，再进行插件管理。
图 1. 图 1 插件总览

节点详情

点击插件前的“+”按钮，可查看该插件在各个节点的安装和加载情况：

图 2. 图 2 插件管理节点详情

加载已安装插件

如需将某一插件加载到集群中所有已安装该插件的节点，可选择目标插件并点击右上角加载插件。

如需将插件加载到集群中特定节点，可展开目标插件下的二级菜单，选择要加载的节点，并点击右上角加载插件。

图 3. 图 3 加载插件
注：
若节点所安装的插件版本与 DolphinDB server 的大版本（如 2.00.x 和 3.00.x）不一致，则插件无法加载。与 DolphinDB 大版本不一致的插件将显示在列表顶部，可参考后文“安装或更新插件”一节解决。

安装或更新插件

插件管理页面提供三种插件的安装/更新方式，用户可根据需要进行选择。

点击页面右上角安装插件，即可打开弹窗界面。

图 4. 图 4 安装或更新插件界面

离线安装

适用于离线环境无法在线安装，或安装自己开发的插件的场景。官方插件安装包可以在 DolphinDB 插件市场下载。若安装自己开发的插件，需要确保插件 ZIP 包命名符合 DolphinDB 插件市场命名格式，插件开发教程详见官方文档。插件安装包命名规则如下：

<插件名>-<操作系统>-<CPU 架构>-<Server 版本号>-<插件版本号>[-<编译标识>].zip

  • 插件名：字母和数字的组合
  • 操作系统：Linux 或 Windows
  • CPU 架构：X86, ARM32 或 ARM64
  • Server 版本号：安装包所适配的目标 Server 版本，3 个数字段，以 . 号分隔，例如 3.00.2
  • 插件版本号：插件自身的版本，3 到 5 个数字段，以 . 号分隔，例如 3.00.2 或 3.00.2.1.1
  • 编译标识（可选）：表示安装包的编译类型，可以是 JIT 或 ABI。普通版安装包不带编译标识；在 Linux 中，不带 ABI 标识的普通版安装包对应 ABI=0，带 -ABI 标识的安装包对应 ABI=1。

离线安装时，应根据目标 Server 选择插件安装包。文件名中的操作系统、CPU 架构和 Server 版本必须与目标 Server 匹配；Linux 环境还必须保证 ABI 类型一致。每次升级 Server 时，都应使用与目标 Server 匹配的安装包更新插件，不得继续使用升级前的安装包。

跨越 3.00.6 版本边界时，还应根据目标平台注意以下变化：

  • Linux x86_64：

    • 3.00.6 之前：JIT Server 发布包随包提供的插件采用 ABI=0。
    • 自 3.00.6 起：JIT 功能由 ABI 版 Server 提供，该发布包默认不附带插件。应单独安装与其匹配的 ABI=1 插件；不再提供独立的 JIT 插件安装包。

  • Linux ARM64：

    • 自 3.00.6 起：Server 的 ABI 由 ABI=0 调整为 ABI=1；应单独安装与其匹配的 ABI=1 插件。

  • Windows x86_64：

    • 自 3.00.6 起：Windows 不再支持 JIT。

以目标 Server 版本 3.00.6、插件版本 3.00.6.0 为例，常见安装包的完整文件名如下。其中 pluginName 表示实际插件名。

Server 版本 插件安装包完整文件名示例
Linux x86_64 3.00.6 普通版（ABI=0） pluginName-Linux-X86-3.00.6-3.00.6.0.zip
Linux x86_64 3.00.6 ABI 版 pluginName-Linux-X86-3.00.6-3.00.6.0-ABI.zip
Linux ARM64 3.00.6 ABI 版 pluginName-Linux-ARM64-3.00.6-3.00.6.0-ABI.zip
Windows x86_64 3.00.6 普通版 pluginName-Windows-X86-3.00.6-3.00.6.0.zip

在弹窗中选择离线安装。选择目标节点并上传 ZIP 包后，点击安装或更新即可。

在线安装

用户可通过在线安装的方式，直接获取 DolphinDB 官方提供的最新（或指定）版本插件。在线安装时节点所在机器必须能够访问 DolphinDB 官方的插件市场，默认访问国内的插件市场。

在弹窗中选择在线安装，选择要安装/更新的插件、目标节点、插件版本（默认为与当前 DolphinDB server 匹配的最新版本）和插件仓库，点击安装或更新即可。此方式与使用内置函数installPlugin效果相同，详情可参见函数文档。在线安装时，系统会根据目标节点当前 Server 的操作系统、CPU 架构和 ABI 类型自动匹配对应的安装包，用户无需根据文件名手动判断安装包类型。

注：
插件仓库分为国内与国外两个地址，使用在线安装时必须确保节点所在机器能够访问至少其中一个仓库（默认为国内仓库）。若节点位于海外，建议选择国外仓库以提升速度。

从其他节点同步

若集群中某一节点安装了插件，或节点之间安装的插件版本不一致时，可以使用同步功能将指定节点的插件同步到其他节点。

在弹窗中选择从某节点同步，选择要安装/更新的插件、目标节点、源节点，点击安装或更新即可。