seafile在飞牛下docker部署重启设备后seahub异常无法启动的解决方案

发表于 分类于 阅读次数：
解决飞牛重启设备后docker下seafile启动异常的问题

问题描述

seafile13 在飞牛下docker部署正常运行，但在重启设备后日志报错seahub启动异常

问题抽象

程序环境：AMD64架构 +飞牛OS + Docker + DockerCompose + seafile13(seafileltd/seafile-mc:13.0-latest + notification-server:13.0-latest + 移除其他模块) + MySQL8(独立部署，8.4.7) + Redis(独立部署，最新版)

这类问题我使用了多种方法（wait-for-it脚本等待redis、mysql）避免其他错误的发生，但依旧百分百出现，并且只有docker-compose清除重置才能解决，由此必定是seafile遗留什么文件导致无法直接重启容器恢复，总需要手动重置不是我想要的解决方案，经研究发现是因为设备重启后seafile容器中/opt/seafile/pids/seahub.pid文件的残留导致无法正常重启容器来恢复服务。

解决方案

开机命令清除容器中的pid文件

通过在/etc/systemd/system目录下增加一个docker-clean-pid-and-restart.service开机脚本来清除容器中的pid文件并重启容器来实现自动恢复

1
sudo vim /etc/systemd/system/docker-clean-pid-and-restart.service

其中我的容器名称为seafile，映射出来的端口号是9605可以用于容器是否启动过得判断，毕竟只有启动了才能进去删除指定文件，具体开机脚本如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
[Unit]
# 服务描述，可自定义
Description=Docker Clean PID File and Restart Container
# 确保 Docker 服务先启动，避免容器操作失败
After=docker.service network.target
Requires=docker.service

[Service]
# 一次性任务类型，等待所有命令执行完成
Type=oneshot
# 执行完成后仍标记服务为激活状态，便于查看状态
RemainAfterExit=yes
# 核心命令：先删除 PID 文件 → 再重启容器（根据情况替换 容器名seafile  端口号9605）
ExecStart=/bin/bash -c 'CONTAINER_NAME="seafile"; HOST_PORT="9605"; until nc -z localhost "$HOST_PORT"; do echo "Waiting for $CONTAINER_NAME (host port $HOST_PORT) to be available..."; sleep 1; done; docker exec $CONTAINER_NAME rm -f /opt/seafile/pids/seahub.pid && docker restart $CONTAINER_NAME'
# 可选：执行失败后重试（避免偶发网络/ Docker 就绪问题）
Restart=on-failure
RestartSec=5s
# 超时时间，避免命令卡死
TimeoutStartSec=60s

[Install]
# 开机启动关联多用户模式
WantedBy=multi-user.target

重启daemon刷新读取开机脚本，并设置开机器自启

1
2
3
4
5
6
sudo systemctl daemon-reload
sudo systemctl enable docker-clean-pid-and-restart.service
# 校验运行
sudo systemctl start docker-clean-pid-and-restart.service
# 查看运行结果，如果容器名、端口没写错很快就能刷出来
sudo systemctl status docker-clean-pid-and-restart.service

也可以在重启下飞牛试试