Stirling-PDF(s-pdf)升级方案

Stirling-PDF(s-pdf)升级方案(你是 docker run 单容器方式,不是 compose)

重点:/home/docker/s-pdf/extraConfigs 里存数据库、账号配置,升级不会丢,但是升级前务必备份Stirling-P…

1. 先备份(必做)

# 备份配置目录
cp -r /home/docker/s-pdf/extraConfigs /home/docker/s-pdf/extraConfigs.bak.$(date +%Y%m%d)

2. 拉取最新镜像

旧镜像名 frooodle/s-pdf,新版官方已经迁移到 stirlingtools/stirling-pdf(两个都可以,推荐官方新镜像)

# 拉最新
docker pull stirlingtools/stirling-pdf:latest

如果你继续想用老仓库:

docker pull frooodle/s-pdf:latest

3. 停止 + 删除旧容器(容器本身可以删,宿主机挂载目录不动)

docker stop s-pdf
docker rm s-pdf

4. 重建容器(务必保证挂载参数和原来一模一样)

先查看你原来完整启动命令,防止漏参数:

docker inspect s-pdf --format '{{.Config.Cmd}} {{.HostConfig.Binds}} {{.NetworkSettings.Ports}}'

下面给适配你当前挂载的参考模板,按需补端口、环境变量:

docker run -d \
  --name s-pdf \
  -p 8080:8080 \
  -v /home/docker/s-pdf/extraConfigs:/configs \
  -v /home/docker/s-pdf/logs:/logs \
  -v /home/docker/s-pdf/trainingData:/usr/share/tesseract-ocr/5/tessdata \
  stirlingtools/stirling-pdf:latest

如果之前有 -e SECURITY_ENABLELOGIN=true 或者其他环境变量,原样加上。

5. 验证启动

docker ps
docker logs -f s-pdf

等日志看到服务启动完成,浏览器访问,原有账号、设置保留(大版本跨版本升级有可能数据库自动迁移)。

6. 清理旧镜像(可选)

docker image prune

如果你用 docker-compose 的方式升级(备选)

cd /home/docker/s-pdf
docker compose pull
docker compose up -d

⚠️ 重要注意事项

  1. 跨大版本升级(例如 v1→v2):官方会自动迁移 H2 数据库,但建议先备份 extraConfigs,升级失败可以回滚备份目录 + 换回旧镜像Stirling-P…
  2. 升级后打不开页面:看 docker logs s-pdf,大概率数据库迁移报错;这时停容器,删掉新生成的 db 文件,把 extraConfigs.bak.* 恢复回去,重新启动旧镜像回滚。
  3. 镜像名称变化:frooodle/s-pdf 是旧镜像仓库,新项目统一 stirlingtools/stirling-pdf,两者都还能拉取。

可选:自动升级工具 Watchtower

以后不用手动敲命令升级容器,一次性运行:

docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower s-pdf --interval 86400

每天自动检测并更新 s-pdf 容器。

你把 docker inspect s-pdf | grep -A 20 "HostConfig" 的输出发我,我可以直接给你复制即用的完整 docker run 命令

Docker部署开源Stirling PDF工具处理软件:https://www.hao0564.com/4534.html

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注