Docker镜像构建成功启动无报错静默失败问题排查

核心是transmission-daemon默认运行模式和Docker容器生命周期规则冲突：

• transmission-daemon默认启动时会自动fork为后台守护进程，启动动作完成后前台的初始进程直接退出。
• Docker容器的生命周期与PID 1主进程强绑定：只要PID 1进程退出，无论后台是否有其他运行中的进程，容器都会立刻终止。
• 无报错、无日志的静默失败现象，就是因为初始启动的transmission进程完成后台fork后直接退出，容器同步终止，还没来得及输出任何运行日志。

进入容器交互式shell手动执行启动命令时能正常运行，是因为此时交互式shell本身是PID 1进程，即使transmission切换到后台运行，shell进程持续存活，容器不会退出，因此可以看到transmission正常工作。将启动命令封装为bash脚本仍然失败的逻辑完全一致：脚本执行完transmission启动命令后就会运行结束，作为PID 1的脚本进程退出，容器会直接终止。

• 给transmission-daemon添加-f（长参数为--foreground）启动参数，强制其在前台持续运行，作为PID 1进程保持存活，容器就不会意外退出。
• 启动命令中全部使用绝对路径，指定正确的配置目录（原Dockerfile中创建的/transmission/config目录未被正确引用），避免相对路径因工作目录变化引发文件找不到的异常。
• 使用exec格式（JSON数组格式）书写CMD指令，避免额外的shell进程作为PID 1，导致Docker的停止、重启信号无法正常传递给transmission进程，引发异常退出、信号无响应问题。

修正后的启动指令：

CMD ["transmission-daemon", "-f", "-c", "/transmission", "--config-dir", "/transmission/config"]

完整可用的Dockerfile参考：

FROM alpine:3

RUN apk --no-cache add transmission-cli transmission-daemon \
    && mkdir -p /transmission/config \
    && chmod -R 777 /transmission 

RUN apk add --no-cache --upgrade bash
RUN wget -P /transmission/ https://speed.hetzner.de/100MB.bin

ENV TRACKER_URL="http://104.219.73.18:6969/announce"
RUN echo tracker url is: ${TRACKER_URL}
RUN transmission-create -t ${TRACKER_URL} -o /transmission/testfile.torrent /transmission/100MB.bin

CMD ["transmission-daemon", "-f", "-c", "/transmission", "--config-dir", "/transmission/config"]

补充说明：前台模式下transmission会直接将运行日志输出到容器标准输出，无需额外配置日志重定向，直接使用docker logs命令即可查看所有运行日志。

内容的提问来源于stack exchange，提问作者n1cK