准备环境
准备可以运行的 Docker 和 curl。下方命令按 Bash / zsh 格式编写;Windows 用户可以使用 Git Bash 或 WSL。需要 PowerShell 时,将多行命令合并为一行,并使用 curl.exe。
镜像来自 Rena 仓库文档中的官方地址。端口仅绑定本机回环地址,避免将演示实例直接开放到公网。
1. 启动 Rena
启动服务
docker run --rm --name rena-demo \
-p 127.0.0.1:3030:3045 \
-v rena-data:/data \
quay.io/xingdongweitu/rena:0.3.0-beta \
serve --storage disk --dir /data --port 3045服务在容器内监听 3045,映射至本机 3030。数据保存在 Docker 命名卷 rena-data 中。
另开一个终端检查服务:
检查服务
curl http://localhost:3030/$/health正常情况下返回 {"status":"ok"}。浏览器可打开 http://localhost:3030/ui 查看本地控制台。
2. 写入一段知识
创建 UTF-8 文件 demo.ttl,写入下面的关系:
demo.ttl
@prefix ex: <http://example.org/> .
ex:alice ex:knows ex:bob, ex:carol .
ex:bob ex:knows ex:dave .在文件所在目录执行装载:
装载 Turtle 数据
curl -X POST "http://localhost:3030/dataset/default/data?default" \
-H "Content-Type: text/turtle" \
--data-binary @demo.ttl这段示例描述了三条“认识”关系:Alice 认识 Bob 和 Carol,Bob 认识 Dave。
3. 执行第一个查询
SPARQL 查询
curl -X POST "http://localhost:3030/dataset/default/sparql" \
-H "Content-Type: application/sparql-query" \
--data-binary 'SELECT ?s ?o WHERE {
?s <http://example.org/knows> ?o
} ORDER BY ?s ?o'响应中的 results.bindings 应包含这三组关系。你可以继续替换实体与关系,尝试自己的知识模型。
这是本地使用指引。
本官网不连接、代理或执行你的 Rena 实例。代码中的 localhost 指访问者自己的电脑。
本官网不连接、代理或执行你的 Rena 实例。代码中的 localhost 指访问者自己的电脑。
下一步
从数据结构开始,明确应用需要查询哪些关系、校验哪些约束,再逐步连接到实际业务。
- 正式部署前配置认证、访问控制及网络边界。
- 为持久数据制定备份与恢复方案。
- 确认实际版本的协议与功能范围,再接入应用。
整理依据:Rena 仓库用户指南与发布记录,2026 年 9 月。镜像拉取和运行环境需由使用者自行准备。