unillett/existdb-tei-publisher

镜像概述

这是一个预安装TEI-Publisher依赖的基础exist-db服务器镜像，不含TEI-Publisher应用本身或其分支，用户可轻松安装自定义.xar包。TEI-Publisher是基于exist-db的免费发布工具箱，用于处理和发布TEI（文本编码倡议）文档。

核心功能

1. 预安装TEI-Publisher所需依赖，简化自定义应用安装流程
2. 支持开发与生产环境的差异化部署配置
3. 提供自动部署xar包的功能
4. 灵活配置TEI-Publisher应用的上下文路径
5. 支持通过代理服务器增强生产环境安全性
6. 提供xQuery脚本执行与函数调用的方法

使用场景

• TEI文档的在线发布与管理
• 学术资源的数字化展示平台搭建
• 基于TEI标准的内容管理系统开发

配置说明

开发环境运行

1. 复制示例环境文件：cp example.env .env，修改必要值（需设置唯一容器名称避免冲突）
2. 启动服务器：docker compose up -d，服务默认在http://127.0.0.1:9010（可通过.env调整端口）

生产环境部署

1. 复制并重命名生产配置文件：

bash
cp example.env .env
cp docker-compose.override.yml.prod docker-compose.override.yml
cp conf/conf.xml.prod conf/conf.xml
cp conf/controller-config.xml.prod conf/controller-config.xml
cp conf/web.xml.prod conf/web.xml

2. 修改.env中的必要值（设置唯一容器名称）
3. 启动服务器：docker compose up -d
4. 执行init.sh脚本（仅需一次）以应用.env配置（如管理员密码）

更新镜像

1. 修改docker-compose中的镜像标签
2. 执行更新命令：

bash
docker compose down
docker compose pull
docker compose up -d

安装自定义包

1. 将.xar包放入autodeploy文件夹
2. 重启容器：docker compose restart

代理配置（推荐）

建议将应用置于代理后限制对exist-db dashboard的访问，示例Apache配置：

conf
ProxyPass / http://127.0.0.1:4200/exist/apps/<my-app>/ nocanon
ProxyPassReverse / http://127.0.0.1:4200/exist/apps/<my-app>/

（替换<my-app>为实际应用名称）

上下文路径配置

可通过以下方式设置TEI-Publisher上下文路径：

1. 在.env文件中设置TEIPUBLISHER_CONTEXT_PATH（推荐）
2. 启动jetty时添加参数-Dteipublisher.context-path=/path/to/my/app
3. 编辑应用源码modules/config.xqm修改$config:context-path变量

管理员登录

默认管理员用户为admin，密码为空。生产环境需执行init.sh修改密码。

执行xQuery操作

调用函数

bash
docker exec <容器名称> java org.exist.start.Main client -q -u admin -P '<密码>' -x "your xQuery function"

执行脚本

bash
docker exec <容器名称> java org.exist.start.Main client -q -u admin -P '<密码>' -F '/path/to/script.xq'

资源链接

• exist-db生产最佳实践：https://exist-db.org/exist/apps/doc/production_good_practice
• TEI-Publisher代理配置问题：[***]
• exist-db安全文档：https://exist-db.org/exist/apps/doc/security