跳到主要内容

部署单机版 NineData 服务

本文档介绍 NineData 5.0.0 的单机部署方式。历史版本的部署步骤请在页面顶部的版本下拉菜单中切换到“历史版本”查看。

操作步骤​

  1. 获取 NineData 安装包，并进入包含 install.sh 的目录。

  2. 执行安装脚本：

    ./install.sh --data-dir=<数据目录> --params='-e NODE_NAME=<节点名称>'
    参数说明
    • --data-dir：NineData 数据目录。
    • NODE_NAME：节点名称，可选。未指定时由安装程序生成随机名称；在同一集群中不得与其他节点重复。

  3. 查看容器日志确认安装状态：

    docker logs -f ninedata

  4. 日志出现安装完成信息后，访问 http://<主机IP>:9999 打开控制台。初始账号密码为 admin/admin，首次登录时必须修改密码。

其他配置​

本文介绍 NineData 5.0.0 安装包支持的外置 MetaDB 和 Docker 网段配置。涉及生产环境配置变更时，请先备份配置并安排维护窗口。

使用外置 MetaDB​

NineData 可在安装时通过 META_DB 环境变量指定外部 MySQL MetaDB。参数格式如下：

-e META_DB=<数据库账号>:<数据库密码>@<数据库Host>:<数据库端口>

安装示例：

./install.sh --data-dir=<数据目录> \
  --params='-e META_DB=<数据库账号>:<数据库密码>@<数据库Host>:<数据库端口> -e NODE_NAME=<节点名称>'

使用自建 MySQL 时，MySQL 版本应为 8.0 或更高版本。部署主机必须能够访问外部 MySQL MetaDB；如果数据库账号没有 CREATE DATABASE 权限，请预先创建安装所需数据库并授予安装账号相应权限。

安全提示

请将数据库密码仅作为受控命令参数使用，不要提交到代码仓库、文档、截图或日志。示例中的占位符必须替换为实际值。

修改 Docker 网段​

当前手册记录了 Docker 和 NineData 的默认网段。由于这些网段可能与用户现有网络冲突，请以当前安装包和主机配置中实际使用的值为准，并在部署前完成冲突检查。

如果默认网段与现有网络冲突，可以修改 Docker 服务配置：

  1. 备份 Docker 服务文件。文件通常位于 /usr/lib/systemd/system/docker.service 或 /etc/systemd/system/docker.service。

  2. 在 Docker 服务的 ExecStart 配置中添加以下参数，并将占位符替换为规划好的网段：

    --bip=<DOCKER_SUBNET>

    <DOCKER_SUBNET> 应使用 x.x.x.1 作为网段的第一个可用主机地址。

  3. 修改前确认新网段不会与主机、节点间通信或数据源访问网络冲突。已有容器的网络连接可能受影响，请在变更前完成评估和备份。

当前手册未固化适用于所有发行版的 Docker 重启命令。修改服务文件后，请按照目标主机的 systemd 运维规范重载并重启 Docker，再检查 Docker 使用的网段。