entrypoint脚本语法错误会导致容器反复崩溃重启，表现为状态闪退或“restarting”；应先覆盖entrypoint验证镜像基础可用，再通过docker logs --previous查报错、sh -n检查语法、修正exec "$@"缺失、引号包裹变量及shebang兼容性等陷阱。
当 entrypoint 脚本存在语法错误（比如未闭合的引号、错用括号、无限递归调用自身等），容器启动后可能无法正常进入主进程，反而反复崩溃重启，表现为 docker ps 中状态快速闪退、docker logs 显示报错后立即退出，或 docker inspect 显示 "status": "restarting" —— 这本质不是“死循环”，而是容器因脚本解析失败或执行异常而持续崩溃重启。
确认是否真由 ENTRYPOINT 脚本引发
先排除其他原因（如 CMD 错误、基础镜像缺失依赖、权限问题）：
- 运行容器时临时覆盖 ENTRYPOINT：
docker run --entrypoint /bin/sh your-image -c 'echo OK'
若能成功输出 OK，说明镜像基础可用，问题大概率在原 ENTRYPOINT 脚本 - 查看最后一次崩溃日志：
docker logs --tail 50 --previous your-container-name
注意末尾是否有syntax error near unexpected token、command not found、Segmentation fault或重复出现的报错行
进入容器调试（适用于已启动但卡住/快速退出的场景）
如果容器能短暂存活（哪怕只有几百毫秒），可尝试强制分配伪终端并挂起进程：
OpenClaw Docker Setup
下载
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
- 加
--init和-it启动，并用sleep拖住入口点：docker run -it --init --entrypoint /bin/sh your-image -c 'sleep 10; exec /path/to/your/entrypoint.sh' - 另起终端，在 sleep 窗口期内执行：
docker exec -it <container-id> /bin/sh</container-id>
进去后手动检查脚本语法：sh -n /path/to/entrypoint.sh # 仅语法检查，不执行cat -n /path/to/entrypoint.sh # 查看行号定位问题
修复脚本常见陷阱
多数循环/崩溃源于以下写法：
-
脚本末尾忘记
exec "$@"或等效逻辑：导致 ENTRYPOINT 执行完就退出，Docker 认为主进程结束而销毁容器（看似“闪退”）；正确写法应确保最终把控制权交给 CMD 或用户命令 -
递归调用自身且无退出条件：例如脚本里写了
./entrypoint.sh "$@"却没判断环境或加 guard，每次启动都再拉起一个自己 -
变量未引号包裹引发单词拆分：如
if [ $1 = "start" ]; then ...，当$1为空或含空格时会报语法错；应写作[ "$1" = "start" ] -
使用了 Bash 特有语法但 shebang 是
#!/bin/sh：比如[[ ]]、$(( ))、数组等，在 Alpine 等默认 sh 环境下直接报错；统一用 POSIX 兼容写法，或明确写#!/bin/bash并确保镜像含 bash
快速验证与发布修复
改完脚本后别急着重推镜像：
- 本地构建并交互式测试：
docker build -t test-fix . && docker run -it --rm test-fix - 若仍失败，追加调试信息到脚本开头：
set -x # 开启命令回显echo "Args: $@"echo "PWD: $(pwd)" - 确认修复后，打新标签发布：
docker tag test-fix your-registry/your-image:v1.2.3-fix
