Files
ssw-ontology/README.md
T
admin 993f74c2b2 feat: Docker 单镜像分发 + 默认端口统一 8081 + seed 极简化
新增 Dockerfile + docker/entrypoint.sh:
- 基础 crpi-.../ssw188/postgres:16-alpine + ontology 二进制,单镜像
- 默认端口 8081 / 库 ssw-ontology / 用户 ssw / 密码 ssw
- /data/pg 自动挂 PG 数据,/data/archive 挂文档根目录
- trap 收尸保证 PG + ontology 同生命周期

seed 极简化为 1 个对象类型「合作企业」+ 3 条示例
(尚数网/腾讯/阿里巴巴),便于演示也便于清理。

默认 HTTP_PORT 统一为 8081(覆盖 server/config.go、run.sh、
vite.config.js、importer/import-from-xeo.js、docs/README.md、
docs/USAGE.md、docs/IMPORT.md、.env.example 等所有文档/代码)。

docs/README.md / .env.example 默认 DATABASE_URL 改为
ssw/[email protected]:5432/ssw-ontology(与 Docker 镜像自带 PG 一致);
run.sh 删 dacli 硬编码 fallback,改从 .env 读(不存在则报错退出)。

README 重整:分「方式 A Docker 镜像 / 方式 B 本机 ./run.sh」,
新增 AI 智能导入(-e AI_*)与管理接口鉴权(-e MANAGER_API_KEY)说明。
2026-08-13 15:59:27 +08:00

3.6 KiB
Raw Blame History

尚数网本体管理平台 · ShangShu Ontology

面向数据要素与可信数据空间的统一本体元数据平台。把业务实体、属性、关系、动作、函数与接口统一纳入本体元数据,并通过访问控制与运行时审计控制信息的安全使用。

详细的项目说明、架构与接口文档请见 docs/README.md。

文档

快速开始

平台强依赖 PostgreSQL。表结构由代码在启动时自动创建(server/db.go 的 migrate() + server/access_control.go 的 ensureAccessControlSchema()),并自动灌入极简种子(1 个对象类型「合作企业」+ 3 条示例:尚数网、腾讯、阿里巴巴),因此只要有可用的 Postgres 空库,即可直接运行,无需手动建表或导入。

两种用法:

方式 A:Docker 一键镜像(自带 PG,推荐用于部署/分发)

# 已有镜像直接跑(无需本地构建)
mkdir -p ~/ssw-ontology-data/pg ~/ssw-ontology-data/archive
docker run -d --name ssw-ontology -p 8081:8081 \
  -v ~/ssw-ontology-data:/data --restart unless-stopped \
  crpi-yscq976uwza88qap.cn-shenzhen.personal.cr.aliyuncs.com/ssw188/ssw-ontology:1.0.0
  • 自带 PostgreSQL(容器内 5432,本体后端映射到宿主机 8081)
  • 默认账户:数据库 ssw-ontology / 用户 ssw / 密码 ssw
  • 挂 -v /host/x:/data 后,/data/pg 存 PG 数据、/data/archive 存文档;不挂则匿名卷,重启丢
  • 健康检查:镜像内置 wget --spider http://127.0.0.1:8081/api/v1/connector/object-types, docker ps 看 STATUS 列是否 (healthy)
  • 详见 Dockerfile 与 docker/entrypoint.sh

方式 B:本机 ./run.sh(开发用)

./build.sh && ./run.sh    # 监听 http://127.0.0.1:8081

需要本机有 PostgreSQL(可以是 Docker 镜像外的任意实例)。DATABASE_URL 与其他配置都在仓库根 .env 里设置(参考 .env.example),不在仓库里出现真实凭据。

快速起本地 PG 示例:

docker compose up -d    # 起 jnpf-postgres,端口 15432 映射

Docker 镜像配置

覆盖 PG 账户:

docker run ... -e POSTGRES_USER=myuser -e POSTGRES_PASSWORD=mypwd -e POSTGRES_DB=mydb ...

启用 AI 智能导入(默认 AI_ENABLED=false 走启发式抽取,只能识别引号实体;开启后大模型会建对象类型/属性/链接类型/动作类型/实例/关系):

docker run -d --name ssw-ontology -p 8081:8081 \
  -v ~/ssw-ontology-data:/data --restart unless-stopped \
  -e AI_ENABLED=true \
  -e AI_BASE_URL=https://api.minimaxi.com/anthropic \
  -e AI_KEY=<your-key> \
  -e AI_MODEL=MiniMax-M3 \
  crpi-yscq976uwza88qap.cn-shenzhen.personal.cr.aliyuncs.com/ssw188/ssw-ontology:1.0.0
  • URL 含 /anthropic 子串 → Anthropic Messages 协议;其余按 OpenAI Chat Completions 兼容协议(DeepSeek / 通义千问 / Ollama 等均可)
  • 4 个变量必须全设;只设 KEY 但 AI_ENABLED=false 仍走启发式
  • 适用接口:POST /api/v1/ai/ingest(粘贴文本摄取)、POST /api/v1/km/extract(从 archive 文件摄取)

启用管理接口鉴权(默认开放给所有请求,生产环境建议开启):

docker run ... -e MANAGER_API_KEY=<your-key> ...   # 调用管理接口需带 X-API-Key: <key>

本地构建镜像(如需):

docker build -t ssw-ontology:1.0.0 .