## 前言
Stirling PDF工具部署是很多技术爱好者关注的方向。本教程零基础手把手教你完成全部操作，跟着做就能成功。
## 一、前期准备
### 环境要求
– Docker已安装并运行（版本20+）
– 至少2GB可用内存
– 足够的磁盘空间
### Docker安装
curl -fsSL https://get.docker.com | sh
sudo systemctl start docker && sudo systemctl enable docker
### 国内镜像加速
{
“registry-mirrors”: [
“https://docker.1panel.live”,
“https://hub.rat.dev”,
“https://docker.m.daocloud.io”
]
}
## 二、下载与安装
### 1. 拉取镜像
docker pull 应用镜像名:latest
如果拉取失败，配置Docker镜像加速器。
### 2. 创建配置文件
创建docker-compose.yml，按需修改端口和目录映射。
### 3. 启动服务
docker compose up -d
### 4. 验证运行
docker ps 确认容器状态为运行中
浏览器访问对应端口验证服务正常
## 三、配置步骤
### 目录结构
创建应用所需目录：
mkdir -p /docker/应用名/config
mkdir -p /docker/应用名/data
### Docker Compose配置
按官方文档编写docker-compose.yml，注意：
– volumes路径映射正确
– 端口不冲突
– 环境变量填写完整
– TZ设为Asia/Shanghai
### 启动和验证
docker compose up -d
docker compose ps # 确认运行状态
浏览器访问对应端口验证
### 数据备份
定期备份config目录和数据库文件
## 四、常见报错解决
| 报错 | 原因 | 解决方案 |
|——|——|———|
| 镜像拉取超时 | 国内网络 | 配置镜像加速器 |
| 数据库连接失败 | 密码错误 | 检查环境变量 |
| 端口被占用 | 端口冲突 | 更换映射端口 |
| 数据丢失 | 未挂载卷 | 添加volumes映射 |
| 权限错误 | PUID/PGID | 设置为0（root） |
## 五、避坑总结
1. 数据目录必须挂载不然丢数据
2. 国内环境先配镜像加速
3. PUID/PGID设0避免权限问题
4. 定期备份config目录
5. 端口映射别冲突
本教程由技术保姆网原创，转载请注明出处。