existdb/teipublisher

TEI Publisher Docker镜像文档

镜像概述

TEI Publisher Docker镜像是一个预配置的容器化解决方案，无需手动安装eXist数据库，即可快速运行TEI Publisher。该镜像已包含TEI Publisher核心功能及莎士比亚、梵高演示应用，通过Docker简化部署流程，提供开箱即用的TEI文档发布与管理环境。

核心功能与特性

• 预配置环境：已集成TEI Publisher及莎士比亚、梵高演示应用，无需额外配置即可使用
• 简化部署：通过Docker容器化技术，省去手动安装eXist数据库的复杂步骤
• 数据持久化：支持通过Docker卷（Volume）存储数据库数据，避免容器更新或删除导致数据丢失
• 端口映射：可灵活映射本地端口至容器内eXist的HTTP（8080）和HTTPS（8443）端口

使用场景

• 快速部署TEI Publisher进行功能演示或教学展示
• TEI文档发布系统的开发与测试环境
• 需要隔离环境的TEI Publisher应用部署

使用方法

前提条件

安装Docker环境：

• Windows和Mac用户可下载Docker Desktop应用
• Linux用户可通过官方包管理器安装Docker Engine

拉取镜像

在终端执行以下命令拉取最新版镜像：

bash
docker pull existdb/teipublisher:latest

运行容器

镜像下载完成后，使用以下命令启动容器：

bash
docker run -p 8081:8080 -p 8444:8443 -v exist-data:/exist/data --name teipublisher existdb/teipublisher:latest

参数说明

• -p：端口映射，格式为本地端口:容器内端口

  • 8081:8080：将本地8081端口映射到容器内eXist的HTTP端口（8080）
  • 8444:8443：将本地8444端口映射到容器内eXist的HTTPS端口（8443）
    若本地8081/8444端口被占用，可修改前一个数字使用其他端口

• -v：创建命名卷存储数据库数据
  exist-data:/exist/data表示创建名为exist-data的卷，将容器内/exist/data目录（数据库数据）持久化到卷中。若省略此参数，容器删除或更新后数据将丢失

• --name：为容器分配名称（此处为teipublisher），便于后续通过名称操作容器

访问应用

容器启动后，在浏览器中访问：
http://localhost:8081

通过eXist仪表盘可点击TEI Publisher、莎士比亚或梵高图标打开对应应用。

常用容器命令

• 停止容器：

  bash
  docker stop teipublisher
  

• 重新启动容器：

  bash
  docker start teipublisher
  

• 查看容器日志：
  （容器重启后默认后台运行，可通过日志查看输出）

  bash
  docker logs teipublisher
  

• 列出所有容器（含运行/停止状态）：

  bash
  docker container ps -a
  

• 列出所有卷（含数据库数据卷）：

  bash
  docker volume ls
  

• 备份数据库数据：
  （需先停止容器）将卷中数据复制到本地当前目录：

  bash
  docker cp teipublisher:/exist/data .
  

  注：复制的是eXist生成的原始数据库文件，非XML文档的直接导出

• 删除数据库数据卷（重置环境）：

  bash
  docker volume rm exist-data
  

参考资料

更多Docker命令可参考Docker官方文档及Docker命令速查表。