Docker入口脚本启动Screen会话后无法持久化的问题排查

一、手动执行screen -list看不到入口脚本启动的会话原因 #

Docker入口脚本的运行环境和docker exec进入容器的交互式环境存在差异：

• screen默认将套接字文件存在$HOME/.screen目录，但入口脚本执行时可能未正确设置$HOME变量（比如部分基础镜像的root用户HOME路径异常，或入口脚本环境变量被覆盖），导致screen创建的套接字路径与手动exec时的路径不匹配，因此看不到会话。
• 入口脚本作为容器PID1运行时，进程的会话组、终端环境和交互式终端不同，也会导致screen套接字的权限或路径不兼容。

解决办法 #

1. 强制指定统一的screen套接字目录：
   修改入口脚本中的screen命令为：

   SCREENDIR=/var/run/screen screen -S my_screen -dm bash -c 'cd project && npm run start'
   

   后续手动进容器查看时，执行SCREENDIR=/var/run/screen screen -list即可看到会话。
2. 显式指定HOME变量：
   在screen命令前设置HOME=/root，确保screen使用默认的/root/.screen目录：

   HOME=/root screen -S my_screen -dm bash -c 'cd project && npm run start'
   

二、添加npm run dev后会话无法持久化的原因 #

npm run dev通常是前台运行的开发服务，若入口脚本环境下该进程异常退出（比如依赖缺失、配置错误、端口冲突），screen会因子进程结束自动终止会话。而手动执行脚本正常，是因为交互式环境下的环境变量、终端配置更完整，且能实时看到报错信息，入口脚本中后台启动的screen未捕获进程报错日志，导致无法定位问题。

解决办法 #

1. 捕获npm进程日志排查问题：
   修改screen启动命令，将stdout和stderr写入日志文件：

   SCREENDIR=/var/run/screen screen -S my_dev_screen -dm bash -c 'cd project && npm run dev > /var/log/npm_dev.log 2>&1'
   

   进入容器查看/var/log/npm_dev.log，即可找到npm进程退出的具体原因。
2. 让screen会话在子进程退出后保持存活：
   在bash命令末尾添加exec bash，即使npm dev进程退出，screen仍会保留交互式shell：

   SCREENDIR=/var/run/screen screen -S my_dev_screen -dm bash -c 'cd project && npm run dev; exec bash'
   

   这样会话不会消失，方便进入screen排查问题。
3. 修复Docker PID1环境问题：
   使用tini作为容器PID1，处理信号和进程环境异常。在Dockerfile中添加：

   RUN apt-get update && apt-get install -y tini
   ENTRYPOINT ["tini", "--"]
   CMD ["./your-entry-script.sh"]
   

   让进程环境更接近手动执行的交互式环境。

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