dhuniwien/stemmaweb

Stemmaweb文本传统工具Docker镜像

镜像概述

本镜像封装了Stemmaweb文本传统工具，提供即开即用的部署方案，旨在简化文本传统研究中谱系分析、多版本文本比较等工作的环境配置。通过Docker容器化，用户可快速搭建Stemmaweb运行环境，无需手动处理复杂依赖，专注于文本传统数据的分析与研究。

核心功能与特性

核心功能

• 文本传统数据处理：支持导入多版本文本数据，进行结构化解析与标准化处理
• 谱系构建与可视化：自动或手动构建文本传统谱系关系，并生成交互式谱系图
• 多版本文本比较：提供文本差异比对引擎，高亮显示不同版本间的内容异同
• 数据导出与共享：支持将分析结果、谱系图导出为PNG、SVG、JSON等多种格式

特性

• 便捷部署：容器化封装，一键启动，省去依赖安装与环境配置步骤
• 跨平台兼容：支持Linux、macOS、Windows等主流操作系统的Docker环境
• 灵活配置：通过环境变量与挂载配置文件实现自定义参数调整
• 数据持久化：支持本地目录挂载，确保分析数据长期保存不丢失

使用场景

• 学术研究：文献学、历史学领域学者用于文本传统（如古典文献、宗教文本）的谱系演化分析
• 教育教学：高校相关专业（古典学、文献学）教学中演示文本谱系构建过程
• 文化遗产项目：文化机构在古籍数字化、口头传统研究等项目中进行文本关系可视化
• 数据验证：验证文本传播路径假设，辅助文本校勘与版本源流考证

使用方法与配置说明

前提条件

• 已安装Docker Engine（推荐20.10及以上版本）
• 网络环境可访问Docker Hub（用于拉取镜像）

获取镜像

bash
docker pull stemmaweb/text-tradition-tools:latest

快速启动

使用默认配置启动容器，映射端口8080：

bash
docker run -d -p 8080:8080 --name stemmaweb-instance stemmaweb/text-tradition-tools:latest

服务启动后，通过浏览器访问 http://localhost:8080 即可进入Stemmaweb工具界面。

自定义配置

环境变量配置

通过 -e 参数设置环境变量调整服务参数，常用变量如下：

示例：指定服务端口为8081，日志级别为DEBUG：

bash
docker run -d \
  -p 8081:8081 \
  -e PORT=8081 \
  -e LOG_LEVEL=DEBUG \
  --name stemmaweb-custom \
  stemmaweb/text-tradition-tools:latest

数据持久化配置

通过 -v 参数挂载本地目录至容器 DATA_DIR，实现分析数据持久化：

bash
docker run -d \
  -p 8080:8080 \
  -v /path/to/local/data:/app/data \
  --name stemmaweb-persistent \
  stemmaweb/text-tradition-tools:latest

注意：本地目录需提前创建并赋予读写权限（如 mkdir -p /path/to/local/data && chmod 755 /path/to/local/data）

高级配置（配置文件挂载）

如需自定义工具核心参数（如谱系算法、可视化样式），可挂载配置文件至容器 /app/config 目录：

bash
docker run -d \
  -p 8080:8080 \
  -v /path/to/local/config:/app/config \
  --name stemmaweb-advanced \
  stemmaweb/text-tradition-tools:latest

配置文件格式与参数说明可参考 https://stemmaweb.github.io/docs/config%E3%80%82

服务访问与管理

访问服务

• Web界面：http://<主机IP>:<映射端口>（如 http://localhost:8080）
• API接口：通过 http://<主机IP>:<映射端口>/api/v1 访问（接口文档可在Web界面「帮助」菜单中查看）

容器管理

bash
# 查看容器状态
docker ps --filter "name=stemmaweb"

# 停止容器
docker stop stemmaweb-instance

# 重启容器
docker restart stemmaweb-instance

# 删除容器（需先停止）
docker rm stemmaweb-instance

注意事项

• 首次启动容器时，后台会初始化工具依赖与示例数据，可能需要30秒至2分钟（取决于硬件性能）
• 高并发或大数据量分析场景下，建议通过 --memory=4g --cpus=2 参数限制容器资源（如 docker run -d --memory=4g --cpus=2 ...）
• 如需升级工具版本，建议先备份挂载的本地数据目录，再拉取新版本镜像并重建容器

版本信息

• 镜像标签：latest（对应Stemmaweb稳定版）、dev（开发版，含最新功能但稳定性未验证）
• 工具版本：镜像内置Stemmaweb版本信息可通过容器日志查看（docker logs stemmaweb-instance | grep "Version"）