atomgraph/fuseki

fuseki-docker 镜像文档

概述

fuseki-docker是Apache Jena Fuseki（v2）三元组存储服务器的Docker镜像。Fuseki是一款高效的RDF（资源描述框架）数据存储服务器，主要用于存储、管理三元组数据，并提供SPARQL查询、更新及图存储接口，适用于构建语义网应用和RDF数据服务。

核心功能和特性

主要服务端点

基于数据集路径/ds的典型端点如下（可通过配置重新定义）：

• SPARQL查询：http://localhost:3030/ds/sparql
• SPARQL更新：http://localhost:3030/ds/update
• 图存储（读写）：http://localhost:3030/ds/data
• 图存储（只读）：http://localhost:3030/ds/get

关键特性

• 灵活的端点配置：支持通过https://jena.apache.org/documentation/fuseki2/fuseki-configuration.html#defining-the-service-name-and-endpoints-available自定义服务名称和端点。
• 端口映射：需映射容器3030端口至主机，才能通过主机访问服务（详见https://docs.docker.com/engine/reference/commandline/run/#publish-or-expose-port--p---expose）。
• 无UI版本：镜像内置无用户界面的Fuseki服务器，专注于服务能力。

使用场景和适用范围

• 语义网应用开发：作为后端存储服务，提供RDF数据的SPARQL接口。
• RDF数据管理：存储三元组数据，支持高效查询与更新。
• SPARQL服务部署：快速搭建标准化的SPARQL端点，适用于数据共享或集成场景。

使用方法和配置说明

基本使用规则

镜像名称为atomgraph/fuseki，镜像名称后的参数将直接作为https://jena.apache.org/documentation/fuseki2/fuseki-main.html的启动参数。

使用示例

1. 空内存数据集

创建一个临时的空内存数据集，路径为/ds：

bash
docker run --rm -p 3030:3030 docker.xuanyuan.run/atomgraph/fuseki --mem /ds

• --rm：容器退出后自动删除
• -p 3030:3030：映射容器3030端口至主机
• --mem /ds：使用内存存储，数据集路径为/ds

2. 从文件加载数据集

从本地文件data.nt加载数据集（需将当前目录挂载至容器）：

bash
docker run --rm -p 3030:3030 -v $(pwd):/usr/share/data docker.xuanyuan.run/atomgraph/fuseki --file=/usr/share/data/data.nt /ds

• -v $(pwd):/usr/share/data：将主机当前目录挂载至容器内/usr/share/data
• --file=/usr/share/data/data.nt：指定从容器内路径加载RDF文件

3. 查看帮助（所有运行选项）

获取Fuseki服务器的所有启动参数说明：

bash
docker run --rm docker.xuanyuan.run/atomgraph/fuseki --help

性能分析（Profiling）

如需进行性能分析，可使用Dockerfile.profiler构建镜像，并配置JMX监控：

1. 使用Dockerfile.profiler构建镜像：

   bash
   docker build -f Dockerfile.profiler -t atomgraph/fuseki:profiler .
   

2. 启动容器时，添加以下JAVA_OPTIONS环境变量配置JMX：

   bash
   docker run --rm -p 3030:3030 -p 9991:9991 -e "JAVA_OPTIONS=-Dcom.sun.management.jmxremote=true \
   -Djava.rmi.server.hostname=127.0.0.1 \
   -Dcom.sun.management.jmxremote.host=0.0.0.0 \
   -Dcom.sun.management.jmxremote.port=9991 \
   -Dcom.sun.management.jmxremote.rmi.port=9991 \
   -Dcom.sun.management.jmxremote.ssl=false \
   -Dcom.sun.management.jmxremote.registry.ssl=false \
   -Dcom.sun.management.jmxremote.authenticate=false \
   -Djava.net.preferIPv4Stack=true" atomgraph/fuseki:profiler --mem /ds
   

3. 使用https://visualvm.github.io/创建JMX连接至`127.0.0.1:9991`进行监控（已在Windows 10的VisualVM与WSL2中的Docker容器环境测试通过）。