共计 2945 个字符,预计需要花费 8 分钟才能阅读完成。
最近我发现了这个 Stirling PDF 项目,正好我可以写一篇记录一下,也可以给我自己的工具网站增加工具来使用。
Stirling PDF 简介
Stirling PDF 基于 Web 的 PDF 操作工具。能够对PDF文件进行各种操作,包括分割、合并、转换、重组、添加图像、旋转、压缩等。支持多语言,功能还是挺多的。
GitHub地址:https://github.com/Stirling-Tools/Stirling-PDF
其他Docker项目:https://blog.ioacx.com/category/docker/
Stirling PDF 安装
需要安装 Docker、Docker-compose环境,如果已经有跳过这个。
安装 Docker、Docker-compose环境:https://blog.ioacx.com/docker
创建项目文件夹
sudo -i
mkdir -p /root/data/docker_data/stirling_pdf
进入文件夹
cd /root/data/docker_data/stirling_pdf
创建文件修改
vim docker-compose.yml
按 i 修改,修改完成后按 ESC,输入 :wq 保存退出。
填入以下内容:
version: '3.3'
services:
stirling-pdf:
image: frooodle/s-pdf:latest
ports:
- '8080:8080' # 端口
volumes:
- /location/of/trainingData:/usr/share/tessdata #Required for extra OCR languages
- /location/of/extraConfigs:/configs
# - /location/of/customFiles:/customFiles/
# - /location/of/logs:/logs/
environment:
- DOCKER_ENABLE_SECURITY=false
- INSTALL_BOOK_AND_ADVANCED_HTML_OPS=false
- 如果您想要启用用户登录模式,请将DOCKER_ENABLE_SECURITY设置为true,并参考https://github.com/Stirling-Tools/Stirling-PDF上的Login authentication”来进行设置。默认情况下,该值为false。
- INSTALL_BOOK_AND_ADVANCED_HTML_OPS也可以保持默认值。这个选项会将calibre下载到stirling-pdf,以支持PDF到书籍和高级HTML转换。如果您需要这些功能,请打开该选项。
- 端口为8080,按需要修改(8080端口被占用),可保持默认
在docker-compose.yml目录下输入
docker-compose up -d
等待一下,然后访问ip地址:设置的端口,我这里设置的端口是8080,所以访问ip地址:8080。
如果无法打开请查看是否没有打开防火墙!
可以看到:
Stirling PDF 使用
语言设置:
可以使用的功能挺多的这里就不一一介绍了。可以看下图:
定制化 Stirling PDF
Stirling PDF 允许轻松定制应用程序。包括类似的东西
- 自定义应用程序名称
- 自定义标语、图标、图像,甚至自定义 HTML(通过文件覆盖)
匹配文件位置 /location/of/extraConfigs:/configs
打开settings.yml
可以修改默认语言
可以修改成这样的
# Welcome to settings file
# Remove comment marker # if on start of line to enable the configuration
# If you want to override with environment parameter follow parameter naming SECURITY_INITIALLOGIN_USERNAME
security:
enableLogin: false # 是否登入才可以使用 true/flase
csrfDisabled: true
loginAttemptCount: 5 # lock user account after 5 tries
loginResetTimeMinutes : 120 # lock account for 2 hours after x attempts
system:
defaultLocale: 'zh-CN' # 默认语言修改,这里我这里成简体中文
googlevisibility: flase # 是否允许Google爬虫 true/flase
enableAlphaFunctionality: false # Set to enable functionality which might need more testing before it fully goes live (This feature might make no changes)
#ui:#这里有注释请删除
# appName: exampleAppName # 应用程序的可见名称
# homeDescription: I am a description # 主页上显示的简短说明
# appNameNavbar: navbarName # 导航栏显示的名称
endpoints:
toRemove: [] # List endpoints to disable (e.g. ['img-to-pdf', 'remove-pages'])
groupsToRemove: [] # List groups to disable (e.g. ['LibreOffice'])
metrics:
enabled: true # 'true' to enable Info APIs (`/api/*`) endpoints, 'false' to disable
- 设置登入后,用户名:admin 密码:stirling,登录时,会强制将密码更改为新密码。
- 您还可以使用环境变量
SECURITY_INITIALLOGIN_USERNAME
并SECURITY_INITIALLOGIN_PASSWORD
立即设置自己的环境变量(建议在创建用户后将其删除)。
其他设置请参考GITHUB。
利用宝塔面板反向代理
新建一个站点,什么都不用设置,纯静态即可。确保你已经完成了域名解析。
用宝塔自带的反向代理功能
查看上图的设置方法目标URL改成你实际使用的端口
Stirling PDF 更新与卸载
更新:
cd /root/data/docker_data/stirling_pdf # 进入docker-compose所在的文件夹
docker-compose pull # 拉取最新的镜像
docker-compose up -d # 重新更新当前镜像
卸载:
sudo -i
cd /root/data/docker_data/stirling_pdf # 进入docker-compose所在的文件夹
docker-compose down # 停止容器,此时不会删除映射到本地的数据
cd ~
rm -rf /root/data/docker_data/stirling_pdf # 完全删除映射到本地的数据
总结
使用docker安装还是方便的,这个Stirling PDF功能挺多的,可以安装来使用,满足您的所有PDF需求。