| 用途 | 声明容器停止时使用的信号 |
|---|---|
| 语法 | STOPSIGNAL SIGQUIT（或信号编号） |
| 优先级 | run --stop-signal 覆盖镜像声明 |
示例
示例
STOPSIGNAL SIGQUIT
# nginx 官方镜像即使用该配置实现平滑退出信号要跟应用实际处理的逻辑匹配；应用没实现 SIGQUIT 处理时容器会等到超时被 SIGKILL。
本包目录（366 条）
基础命令50 条
镜像与构建107 条
- docker build 构建镜像
- Dockerfile 结构与构建流程
- FROM 指定基础镜像
- docker images 列出本地镜像
- RUN 执行构建命令
- docker tag 给镜像打标签
- docker pull 拉取镜像
- COPY 复制文件进镜像
- 多阶段构建组织镜像
- docker build -t 命名与多标签
- docker push 推送镜像到仓库
- ENV 设置环境变量
- CMD 默认启动命令
- 层缓存原理与指令排序
- RUN 合并命令减少层体积
- ENTRYPOINT 固定入口点
- .dockerignore 排除构建上下文
- docker rmi 删除本地镜像
- docker login 登录镜像仓库
- WORKDIR 设置工作目录
- ENTRYPOINT 与 CMD 组合用法
- docker build --build-arg 传递构建参数
- docker image inspect 查看镜像元数据
- ARG 构建期变量与 --build-arg
- USER 指定运行用户
- HEALTHCHECK 容器健康检查
- Debian/Ubuntu 镜像中的 apt 安装
- 镜像非 root 运行实践
- 构建期密钥：ARG 的风险与 secret 替代
- EXPOSE 声明端口
- RUN --mount=type=cache 构建缓存挂载
- Node 镜像中的 npm 安装
- docker build -f 指定 Dockerfile
- buildx build 构建与导出规则
- 多架构镜像构建与推送
- docker image prune 清理未使用镜像
- COPY --chown 设置属主
- COPY --from 引用外部镜像文件
- Node 多阶段构建示例
- RUN --mount=type=secret 构建期机密
- Python 镜像中的 pip 安装
- docker build --no-cache 全量重建
- docker history 查看镜像构建历史
- FROM 结合 ARG 参数化基础镜像
- RUN 两种形式的语义差异
- COPY 通配符与多源复制
- VOLUME 声明数据卷挂载点
- Go 多阶段构建示例
- 构建上下文与传输
- Alpine 基础镜像的取舍
- 完整示例：前端构建 + Nginx 运行镜像
- docker build --target 只建到指定阶段
- 按平台构建与 --load 导出
- buildx 构建器实例管理
- 用 registry:2 搭建私有镜像仓库
- FROM --platform 多架构构建选择
- JSON 数组形式的写法细节
- 基础镜像版本固定策略
- docker build --pull 刷新基础镜像
- docker save 导出镜像为 tar
- Dockerfile 语法声明 # syntax
- ADD 与 COPY 的差异
- 统一 UID/GID 数字避免权限错位
- registry-mirrors 配置镜像加速
- COPY --link 独立层复制
- COPY 源与目标的路径语义
- docker build --progress 构建日志形态
- 构建缓存导出导入（registry 缓存）
- docker images --format 定制输出
- docker load 导入镜像归档
- LABEL 镜像元数据标签
- STOPSIGNAL 声明停止信号
- Dockerfile heredoc 多行写法
- distroless 运行镜像
- ENV 与 RUN export 的区别
- buildx imagetools 查看清单
- 镜像瘦身手段与验收
- SHELL 指令切换构建 shell
- ARG 作用域与重新声明
- docker build 构建期网络模式
- docker build --check 构建检查
- 悬空镜像 dangling 的成因与处理
- RUN --mount=type=ssh 转发 SSH 代理
- scratch 空镜像构建
- ENTRYPOINT 结合 tini 做 PID1
- docker build -q 安静模式
- docker history 定位体积大头
- insecure-registries 配置（内网 HTTP 仓库）
- buildx bake 多目标构建
- 内联缓存 BUILDKIT_INLINE_CACHE
- docker push --all-tags 批量推送标签
- 按 digest 引用镜像内容
- ONBUILD 延迟触发指令
- 从 stdin 提供 Dockerfile 或上下文
- ~/.docker/config.json 认证与客户端配置
- docker manifest inspect 查看多架构清单
- docker logout 退出仓库登录
- 镜像标签规范与回滚策略
- Docker Hub 拉取限流的识别与缓解
- docker save 一次导出多个镜像
- docker buildx du 查看构建缓存占用
- 镜像 OCI 标签与元数据
- 离线环境镜像搬运流程
- save/load 与 export/import 的区别
- docker search 检索 Docker Hub 镜像
- buildx 输出到本地目录或 OCI 归档
- 构建溯源声明与 SBOM 附加信息
STOPSIGNAL 声明停止信号
指定 docker stop 发送的停止信号（不写时默认 SIGTERM）；nginx 等应用用 SIGQUIT 触发平滑关闭。
易错点
- 信号与编排行为相关：Compose/K8s 停止容器都会采用该声明，改动前回归验证
- 把 STOPSIGNAL 设成应用不支持的信号只是把强杀时间推迟到超时点
数据来源与参考
- Docker 官方文档：Dockerfile STOPSIGNAL（docs.docker.com）