secoresearch/fuseki

Jena Fuseki Docker 镜像

镜像概述与主要用途

本镜像为 Apache Jena Fuseki 的 Docker 封装，包含 SeCo 扩展，灵感源自 https://github.com/stain/jena-docker/tree/master/jena-fuseki%E3%80%82

Docker Hub 地址：https://hub.docker.com/r/secoresearch/fuseki/

主要用途：提供基于 TDB 的 RDF 数据存储与查询服务，支持 SPARQL 1.1 端点、文本索引、持久化存储及 SHACL 验证等功能，适用于构建语义数据服务或作为 RDF 数据集的分发载体。

核心功能与特性

• 默认数据集配置：预配置 ds 数据集，使用 TDB 存储引擎，集成 Lucene 文本索引
• 灵活的图查询：默认启用 tdb:unionDefaultGraph=true，支持默认图查询匹配所有命名图的并集（默认图本身除外）
• 多端点支持：内置 SPARQL 查询、更新、图存储及 SHACL 验证端点，可按需启用
• 数据加载工具：包含 tdbloader、textindexer、tdbstats 等脚本，支持批量加载 RDF 数据
• 持久化存储：支持卷挂载（运行时数据更新）和自定义镜像（静态数据集）两种持久化方案
• 可配置参数：支持通过环境变量调整管理员密码、查询超时、端点访问权限等

使用场景与适用范围

• 开发与测试环境：快速部署 Fuseki 服务，验证 SPARQL 查询或 RDF 数据模型
• 数据服务部署：作为后端服务提供 SPARQL 端点，支持应用程序查询 RDF 数据
• 静态数据集分发：通过自定义 Docker 镜像打包数据集，简化部署与版本控制
• 语义应用集成：与需要 RDF 存储和查询能力的应用（如知识图谱系统）集成

使用方法与配置说明

默认配置

• 管理界面：访问 http://localhost:3030，管理员密码通过 ADMIN_PASSWORD 环境变量设置
• 数据集特性：
  • 使用 TDB 存储引擎，默认启用文本索引
  • tdb:unionDefaultGraph=true：默认图查询匹配所有命名图的并集（注意：存储的默认图不属于此并集，需通过 <urn:x-arq:DefaultGraph> 显式访问）
• 查询超时：默认 60 秒，可通过 QUERY_TIMEOUT 环境变量调整（单位：毫秒）

数据访问端点

基础端点（默认启用）

• SPARQL 1.1 查询：http://localhost:3030/ds/sparql（支持 SELECT/ASK/CONSTRUCT/DESCRIBE）
• 图存储 HTTP 协议（只读）：http://localhost:3030/ds/data（支持 RDF 数据读取）

可启用端点

通过环境变量启用（详见「环境变量配置」）：

• SPARQL 1.1 更新：http://localhost:3030/ds/update（支持 INSERT/DELETE 操作）
• 图存储 HTTP 协议（可写）：http://localhost:3030/ds/data（支持 RDF 数据写入）
• SHACL 验证：http://localhost:3030/ds/shacl（支持 SHACL 约束验证）

数据加载工具

容器内置 tdbloader、textindexer、tdbstats 脚本，用于将 RDF 数据加载到 TDB 模型。示例可参考 https://github.com/SemanticComputing/congress-legislators/blob/master/Dockerfile%E3%80%82

持久化存储

默认情况下，容器删除后数据会丢失，可通过以下方式实现持久化：

方案 1：卷/绑定挂载（推荐运行时数据更新）

挂载 /fuseki-base/databases 目录至宿主机，适用于需动态更新数据或保持镜像轻量化的场景：

bash
# 示例：绑定宿主机 ./fuseki-data 目录到容器数据库目录
docker run ... --mount type=bind,source="$(pwd)"/fuseki-data,target=/fuseki-base/databases ...

方案 2：自定义 Dockerfile（推荐静态数据集）

基于本镜像构建新镜像，在构建阶段加载数据，适用于静态、只读数据集分发：

dockerfile
FROM secoresearch/fuseki
# 复制 RDF 数据到镜像
COPY data.rdf /data/
# 使用 tdbloader 加载数据到 TDB
RUN tdbloader --loc /fuseki-base/databases/ds /data/data.rdf

环境变量配置

构建镜像

bash
docker build --squash -t secoresearch/fuseki .

运行容器

基础运行命令

bash
docker run --rm -it -p 3030:3030 --name fuseki \
  -e ADMIN_PASSWORD=your_secure_password \
  -e ENABLE_DATA_WRITE=true \
  -e ENABLE_UPDATE=true \
  -e QUERY_TIMEOUT=30000 \
  --mount type=bind,source="$(pwd)"/fuseki-data,target=/fuseki-base/databases \
  secoresearch/fuseki

支持通过管理 UI 添加新数据集

bash
# 创建本地目录
mkdir fuseki-data fuseki-configuration
# 复制默认配置文件并修改（按需启用端点）
cp -p assembler.ttl fuseki-configuration/
# 运行容器，挂载数据和配置目录
docker run --rm -it -p 3030:3030 --name fuseki \
  -e ADMIN_PASSWORD=your_secure_password \
  --mount type=bind,source="$(pwd)"/fuseki-data,target=/fuseki-base/databases \
  --mount type=bind,source="$(pwd)"/fuseki-configuration,target=/fuseki-base/configuration \
  secoresearch/fuseki

Docker Compose 示例

yaml
version: '3'
services:
  fuseki:
    image: secoresearch/fuseki
    ports:
      - "3030:3030"
    environment:
      - ADMIN_PASSWORD=your_secure_password
      - ENABLE_UPDATE=true
      - QUERY_TIMEOUT=60000
    volumes:
      - ./fuseki-data:/fuseki-base/databases
      - ./fuseki-configuration:/fuseki-base/configuration
    restart: unless-stopped

OpenShift 环境注意事项

若在 OpenShift 中以非 root 用户运行，需确保数据目录权限：

dockerfile
# 在自定义 Dockerfile 中添加（构建阶段）
RUN chgrp -R 0 $FUSEKI_BASE \
    && chmod -R g+rwX $FUSEKI_BASE

Note：若通过绑定挂载自定义 assembler.ttl，不建议使用环境变量（如 ENABLE_DATA_WRITE）修改端点权限，可能导致文件权限错误。此时应直接编辑 assembler.ttl 配置端点。