Rena / 开发者入门

让第一条知识,
在本地运行起来。

从启动服务,到写入和查询。
本指南使用 v0.3.0-beta,示例面向本地体验。

准备环境

准备可以运行的 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 仓库用户指南与发布记录,2026 年 9 月。镜像拉取和运行环境需由使用者自行准备。