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
⚠️ 重要注意事项
- 跨大版本升级(例如 v1→v2):官方会自动迁移 H2 数据库,但建议先备份
extraConfigs,升级失败可以回滚备份目录 + 换回旧镜像Stirling-P… - 升级后打不开页面:看
docker logs s-pdf,大概率数据库迁移报错;这时停容器,删掉新生成的 db 文件,把extraConfigs.bak.*恢复回去,重新启动旧镜像回滚。 - 镜像名称变化:
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
