terminusdb/terminusdb-server

TerminusDB Server Docker镜像文档

镜像概述

TerminusDB是一个开源的版本化图数据库，专为协作式数据建模和知识图谱构建设计。本Docker镜像提供TerminusDB服务器的便捷部署方案，简化环境配置流程，可快速启动高性能图数据库服务，支持复杂关系数据存储与查询。

核心功能与特性

图数据模型支持

• 基于RDF和属性图混合模型，支持节点、关系及属性的灵活定义
• 原生支持复杂数据类型，包括嵌套结构、数组及自定义类型

版本控制能力

• 完整的数据版本历史记录，支持时间点查询与数据回溯
• 分支与合并功能，支持多用户协作开发数据模型

协作功能

• 基于角色的访问控制（RBAC），支持多用户协同操作
• 变更追踪与冲突解决机制，保障协作数据一致性

高效查询能力

• 内置WOQL（Web Object Query Language）查询语言，支持复杂图遍历与模式匹配
• 优化的查询引擎，支持批量操作与增量更新

数据可靠性

• 符合ACID事务特性，保障数据操作原子性与一致性
• 自动数据校验与约束验证，确保数据模型合规性

开放集成

• REST API接口，支持多语言客户端集成
• 兼容SPARQL查询标准，可与语义网工具链无缝对接

使用场景与适用范围

知识图谱构建

• 企业知识管理系统、领域知识图谱（如***、***、电商）
• 语义搜索引擎与智能问答系统底层数据存储

协作式数据建模

• 多团队协同的数据架构设计与迭代
• 数据模型版本管理与变更审计

语义分析应用

• 自然语言处理结果存储与关系推理
• 实体关系抽取与关联分析

数据版本管理

• 需完整历史记录的业务数据存储（如供应链变更、合规审计）
• 实验数据版本追踪与对比分析

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name terminusdb-server \
  -p 6363:6363 \
  -v terminusdb-data:/app/data \
  docker.xuanyuan.run/terminusdb/terminusdb-server

参数说明：

• -p 6363:6363：映射容器6363端口（默认API端口）到主机
• -v terminusdb-data:/app/data：挂载数据卷以持久化存储数据库文件
• --name：指定容器名称，便于管理

Docker Compose配置示例

yaml
version: '3.8'
services:
  terminusdb:
    image: docker.xuanyuan.run/terminusdb/terminusdb-server
    container_name: terminusdb-server
    ports:
      - "6363:6363"
    volumes:
      - terminusdb-data:/app/data
    environment:
      - TERMINUSDB_ADMIN_USER=admin
      - TERMINUSDB_ADMIN_PASSWORD=secure_password
      - TERMINUSDB_LOG_LEVEL=info
    restart: unless-stopped

volumes:
  terminusdb-data:

环境变量配置

注意：首次启动时未指定TERMINUSDB_ADMIN_PASSWORD，密码会输出到容器日志，可通过docker logs <container_name>查看。

数据持久化

通过挂载数据卷确保数据持久化：

bash
docker volume create terminusdb-data
docker run -d \
  --name terminusdb-server \
  -p 6363:6363 \
  -v terminusdb-data:/app/data \
  docker.xuanyuan.run/terminusdb/terminusdb-server

网络配置

容器间通信

如需与其他容器通信（如应用服务器），可创建自定义网络：

bash
docker network create terminusdb-network
docker run -d --name terminusdb-server --network terminusdb-network -v terminusdb-data:/app/data docker.xuanyuan.run/terminusdb/terminusdb-server
# 应用容器连接至同一网络即可通过容器名访问：http://terminusdb-server:6363

外部访问控制

通过环境变量TERMINUSDB_ALLOWED_ORIGINS限制跨域访问：

bash
docker run -d \
  -e TERMINUSDB_ALLOWED_ORIGINS="https://app.example.com,http://localhost:3000" \
  --name terminusdb-server \
  -p 6363:6363 \
  -v terminusdb-data:/app/data \
  docker.xuanyuan.run/terminusdb/terminusdb-server

验证部署

服务启动后，可通过以下方式验证：

1. 访问API端点：http://localhost:6363/api/version，返回版本信息
2. 访问Web控制台：http://localhost:6363，使用管理员账号登录
3. 执行基础查询：

bash
curl -u admin:<password> http://localhost:6363/api/db/system

维护与升级

版本更新

bash
docker pull docker.xuanyuan.run/terminusdb/terminusdb-server:latest
docker stop terminusdb-server
docker rm terminusdb-server
docker run -d --name terminusdb-server -p 6363:6363 -v terminusdb-data:/app/data docker.xuanyuan.run/terminusdb/terminusdb-server:latest

日志查看

bash
docker logs -f terminusdb-server  # 实时查看日志
docker logs --tail=100 terminusdb-server  # 查看最近100行日志