容器运行时云原生【免费下载链接】docker-ce:warning: This repository is deprecated and will be archived (Docker CE itself is NOT deprecated) see the https://github.com/docker/docker-ce/blob/master/README.md :warning:项目地址https://gitcode.com/gh_mirrors/do/docker-ce点击查看免费下载docker start是 Docker CE 中用于启动一个或多个已停止stopped容器的基础命令与docker run不同它不会创建新容器而是重新运行既有容器中已配置的进程。本文以 start.md 官方参考文档为主体结合 docker-ce 仓库中 CLI 与 engine 的源码实现系统讲解docker start的完整用法、参数语义、前台挂载attach模式、分离键detach keys配置以及从命令行到守护进程daemon的底层调用链帮助读者在掌握命令实操的同时理解其内部工作机制与常见错误处理逻辑。命令概览与核心语法docker start的完整语法定义在 CLI 源码 start.go 中Usage: docker start [OPTIONS] CONTAINER [CONTAINER...] Start one or more stopped containers Options: -a, --attach Attach STDOUT/STDERR and forward signals --detach-keys string Override the key sequence for detaching a container --help Print usage -i, --interactive Attach containers STDIN在源码实现中命令通过cobra.Command注册其Use字段为start [OPTIONS] CONTAINER [CONTAINER...]Short描述为Start one or more stopped containers。参数校验使用cli.RequiresMinArgs(1)见 required.go即至少传入一个容器 ID 或名称否则命令会报错并提示用法。这一设计与docker run只需一个容器不同docker start天然支持一次操作多个容器。需要特别说明的是docker start面向的对象是已停止的容器状态为exited。正在运行的容器、已暂停paused的容器、正在移除或已处于 dead 状态的容器都无法被启动具体校验逻辑将在后文「daemon 端状态校验」一节展开。基础用法启动单个或多个已停止容器启动单个容器官方参考文档给出的最简示例$ docker start my_containermy_container是容器的名称也可以使用容器 ID 或 ID 前缀。命令成功执行后CLI 会在标准输出打印该容器的名称或 ID作为启动成功的确认。同时启动多个容器由于语法中支持CONTAINER [CONTAINER...]可以一次启动多个容器$ docker start web_server db_server redis_cache web_server db_server redis_cache多个容器逐个、顺序发起启动请求。从源码实现看start.go 的startContainersWithoutAttachmentsCLI 遍历容器列表对每个容器调用ContainerStart启动成功的容器名称会被打印到标准输出而启动失败的容器名称会被记录最终返回一条汇总错误Error: failed to start containers: 失败容器名列表这意味着当你批量启动时即便某个容器因状态异常启动失败其余容器依然会被正常启动最终的错误信息会明确列出失败名单便于排查。前置条件容器必须是 stopped 状态docker start只能启动已停止的容器因此在使用前通常先通过以下命令确认容器状态$ docker ps -adocker ps -a会列出包括 exited 在内的全部容器。容器进入 stopped 状态的常见途径包括docker stop/docker kill主动停止docker run启动的进程自然退出exit主机重启后未配置--restart策略而停止的容器。docker start与docker run的本质区别在于run是创建 启动新容器而start是复用 重启既有容器后者不会重新解析docker run的参数而是使用容器创建时固化在配置中的设置镜像、命令、端口映射、卷、网络等。前台模式--attach与--interactive默认情况下docker start在后台启动容器后立即返回。如果你希望像docker attach那样重新挂接到容器的标准输出/错误流并转发本地信号则需要使用-a, --attach选项若容器进程需要从标准输入接收交互指令可配合-i, --interactive选项挂接 STDIN。选项语义选项完整形式作用-a--attach挂接容器的 STDOUT/STDERR并转发本地信号如 CtrlC到容器-i--interactive挂接容器的 STDIN允许向容器进程交互式输入典型交互场景示例——启动一个之前以交互模式创建、现已退出的容器$ docker start -a -i my_container这会同时挂接标准输入输出使容器前台运行、直接接收键盘输入。源码中的 attach 流程从 start.go 的runStart实现可以看出当指定了--attach或--interactive时CLI 会进入挂接启动分支其关键流程如下单容器限制挂接模式下只允许启动一个容器若同时传入多个容器CLI 直接报错you cannot start and attach multiple containers at oncestart.go。先 inspect 后 attachCLI 先通过ContainerInspect查询容器详情拿到容器 ID 与Config.Tty等配置再发起 attach。若容器未启用 TTY!c.Config.TtyCLI 会启动信号转发协程ForwardAllSignals将本地终端的信号转发给容器进程start.go。构造挂接请求ContainerAttachOptions中Stdin取值为opts.openStdin c.Config.OpenStdin即--interactive生效的前提是容器在创建时已配置OpenStdin例如docker run -i创建的容器Stdout/Stderr恒为truestart.go。hijacked 流式传输attach 响应通过hijackedIOStreamer在 CLI 的 stdin/stdout/stderr 与容器之间进行双向流式数据传输start.go。等待退出与移除waitExitOrRemoved并行监听容器退出状态。对于 API 1.30 及以上版本使用ContainerWait等待NextExit或Removed条件对于更老的 daemon则退化为通过 Events API 监听die、detach、destroy事件获取退出码utils.go。TTY 尺寸同步若容器启用了 TTY 且当前 CLI 输出是终端MonitorTtySize会持续同步本地终端窗口尺寸start.go。退出码透传挂接模式下容器退出码会作为docker start命令自身的退出码返回cli.StatusError{StatusCode: status}见 start.go。因此docker start -a非常适合在脚本中判断容器进程的执行结果。信号转发细节ForwardAllSignalssignals.go会将本地收到的所有信号通过ContainerKill转发给容器但有三个例外被过滤掉SIGCHLD与SIGPIPE属于 CLI 自身运行机制的信号不转发运行时信号如 Go 1.14 的SIGURG用于支持可抢占系统调用同样不转发信号名映射查不到的信号直接忽略。这一机制使得用户在挂接状态下按 CtrlC 时信号可以传递到容器内主进程容器以 TTY 模式运行时更常见的行为保证前后台交互体验与docker attach一致。分离键序列--detach-keysdocker start -a挂接容器后默认可以通过CTRL-p CTRL-q分离键序列脱离容器而不停止它。当该默认序列与本地其他应用冲突时可用--detach-keys覆盖$ docker start -a --detach-keys ctrl-a my_container--detach-keys接受单个字母或ctrl-value形式的组合键其中value支持a-z单个小写字母、 符号、[左方括号、\\两个反斜杠、_下划线、^脱字符。合法的键序列示例包括a、ctrl-a、X、ctrl-\等。该语法说明详见 man 文档 attach.md。从源码实现看CLI 支持两种设置方式start.go命令行覆盖--detach-keys选项直接写入 CLI 的配置对象dockerCli.ConfigFile().DetachKeys配置文件默认值如果命令行未指定则使用配置文件中的detachKeys字段file.go。该字段存在于 Docker CLI 配置文件中默认位置为~/.docker/config.json可以设置全局默认分离键。分离键最终会随 attach 请求发送给 daemonContainerAttachOptions.DetachKeys当用户在挂接状态下按下该键序列时会触发term.EscapeErrorCLI 将其识别为用户主动脱离正常返回且不报错start.go。实验性选项checkpoint 与 checkpoint-dirdocker start还支持两个实验性选项当前文档的--help输出中未列出但源码中已注册见 start.go选项作用标注--checkpoint string从指定 checkpoint 恢复容器experimental、仅 Linux--checkpoint-dir string使用自定义 checkpoint 存储目录experimental、仅 Linux使用时需要 daemon 开启实验模式experimental: true否则 daemon 端会返回错误checkpoint is only supported in experimental mode见 daemon/start.go。当指定--checkpoint时同样只允许操作单个容器you cannot restore multiple containers at once且该分支不会挂接终端start.go。此外从 daemon 实现看checkpoint-dir目前会返回custom checkpointdir is not supporteddaemon/start.go因此实际使用中通常只依赖--checkpoint。源码级调用链从 CLI 到 daemon 的完整旅程docker start命令虽然直观但其背后是一整套完整的请求链路。梳理这条链路有助于理解命令行为与故障排查方向CLI 命令层runStart依据选项选择三条分支start.go--attach/--interactive→ 挂接启动分支如前文所述--checkpoint→ 恢复分支其余情况 → 批量启动分支startContainersWithoutAttachments。Go SDK 客户端层dockerCli.Client().ContainerStart(ctx, container, options)构造 HTTP POST 请求。CheckpointID/CheckpointDir会作为checkpoint、checkpoint-dir查询参数拼接到 URL 中最终请求POST /containers/{id}/startcontainer_start.go。API Server 路由层engine 侧将路由注册为POST /containers/{name:.*}/startcontainer.go处理器为postContainersStart。该处理器解析checkpoint与checkpoint-dir表单参数后调用后端ContainerStart成功时返回204 No Contentcontainer_routes.go。注意自 API v1.24 起start 请求体中不再允许携带 hostConfigbodyOnStartError见 container_routes.go所有运行配置都应在docker run/docker create阶段固化。daemon 后端层Daemon.ContainerStart执行状态校验后调用containerStart后者完成存储、网络、cgroup 等运行环境准备最终向容器进程发出启动信号daemon/start.go。daemon 端状态校验与常见错误docker start最常遇到的失败都源于容器状态不满足启动条件。daemon 的校验逻辑集中在 daemon/start.go容器状态处理错误信息Paused已暂停拒绝启动cannot start a paused container, try unpause insteadRunning运行中拒绝重复启动返回containerNotModifiedError提示容器已在运行RemovalInProgress移除中拒绝启动container is marked for removal and cannot be startedDead已死拒绝启动container is marked for removal and cannot be started因此实际排查时可遵循以下顺序$ docker ps -a # 查看容器状态 $ docker inspect container # 查看详细状态字段State.Status / State.Paused $ docker unpause container # 若为 paused 状态先解除暂停另外两类值得注意的边界行为--rm容器与自动移除若容器以--rm创建启动失败时 daemon 会继续等待容器被移除CLI 端通过waitExitOrRemoved与c.HostConfig.AutoRemove配合确保挂接模式下的等待/移除流程正确收尾start.go。hostConfig 不再支持向已停止容器补充 hostConfig 的做法在 Linux 上已标记为废弃Docker 1.12 起移除Windows 上则直接拒绝。所有主机配置必须在docker create/docker run时指定daemon/start.go。实战要点小结后台重启docker start my_container是最常用形式适合重启退出状态的容器并立即返回前台观察输出docker start -a my_container可重新观察容器 stdout/stderr信号会实时转发交互式会话恢复docker start -a -i my_container可恢复交互式终端前提是容器创建时启用了-i/-t脚本内判断结果docker start -a会把容器退出码透传为命令退出码便于自动化流程捕获执行结果批量启动docker start c1 c2 c3顺序启动多个容器单个失败不影响其他容器自定义分离键--detach-keys ctrl-x可解决默认CTRL-p CTRL-q的键位冲突也可通过~/.docker/config.json的detachKeys字段设置全局默认值。延伸阅读命令参考文档原文start.mdCLI 命令实现start.go等待退出/移除辅助逻辑utils.go信号转发实现signals.goSDK 客户端实现container_start.goAPI Server 路由注册与处理器container.go、container_routes.godaemon 端启动逻辑daemon/start.go分离键序列说明attach.md、配置文件detachKeys字段定义file.go赞分享容器运行时云原生【免费下载链接】docker-ce:warning: This repository is deprecated and will be archived (Docker CE itself is NOT deprecated) see the https://github.com/docker/docker-ce/blob/master/README.md :warning:项目地址https://gitcode.com/gh_mirrors/do/docker-ce点击查看免费下载相关推荐深入解析 Docker CLI 的 docker attach 命令用法、参数与源码实现深入解析 Docker CLI 的 docker attach 命令用法、参数与源码实现 docker attach 是 Docker CLI 中用于将本地标CLI开发工具Docker CLI 插件升级实战docker plugin upgrade 命令用法与源码原理深度解析Docker CLI 插件升级实战 docker plugin upgrade 命令用法与源码原理深度解析 本篇技术指南以 Docker CLI 官方参考文档CLI开发工具Docker CE docker logs 命令完全指南从基础用法到源码级日志读取原理Docker CE docker logs 命令完全指南从基础用法到源码级日志读取原理 docker logs 是 Docker CE 中最常用的容器运维命令容器运行时云原生上一篇Ice macOS 菜单栏管理教程3步搞定把挤满图标的状态栏变清爽下一篇3个简单步骤用JavaScript让手机自动工作告别重复点击创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考