Share feedback
Answers are generated based on the documentation.

排查 Docker Desktop 问题

Table of contents

本页包含有关如何诊断和排查 Docker Desktop 问题的信息，以及如何查看日志。

排查菜单

要导航到排查，请执行以下任一操作：

  • 选择 Docker 菜单 Docker 菜单 whale menu ，然后选择排查。
  • 选择 Docker Dashboard 右上角附近的排查图标。

排查菜单包含以下选项：

  • 重启 Docker Desktop。

  • 重置 Kubernetes 集群。选择此选项将删除所有堆栈和 Kubernetes 资源。有关更多信息，请参阅 Kubernetes。

  • 清理/清除数据。此选项将重置所有 Docker 数据，但不会重置为出厂默认设置。选择此选项将导致现有设置丢失。

  • 重置为出厂默认设置：选择此选项可将 Docker Desktop 上的所有选项重置为其初始状态，与首次安装 Docker Desktop 时相同。

如果您是 Mac 或 Linux 用户，还可以选择从系统中卸载 Docker Desktop。

诊断

[!提示]

如果在排查过程中未找到解决方案，请浏览 GitHub 仓库或在 Docker Desktop 问题跟踪器 上创建新问题。

从应用内诊断

  1. 在排查中，选择获取支持。这将打开应用内支持页面并开始收集诊断信息。
  2. 当诊断信息收集过程完成后，选择上传以获取诊断 ID。
  3. 当诊断信息上传后，Docker Desktop 会打印一个诊断 ID。请复制此 ID。
  4. 使用您的诊断 ID 获取帮助：
    • 如果您拥有付费 Docker 订阅，请选择联系支持。这将打开 Docker Desktop 支持表单。填写所需信息，并将您在步骤三中复制的 ID 添加到诊断 ID 字段中。然后，选择提交工单以请求 Docker Desktop 支持。

      [!注意]

      您必须登录 Docker Desktop 才能访问支持表单。有关 Docker Desktop 支持涵盖的内容，请参阅 支持。

    • 如果您没有付费 Docker 订阅，请选择报告 Bug 以在 GitHub 上打开新的 Docker Desktop 问题。填写所需信息，并确保添加您在步骤三中复制的诊断 ID。

从错误消息诊断

  1. 当出现错误消息时，选择收集诊断信息。
  2. 当诊断信息上传后，Docker Desktop 会打印一个诊断 ID。请复制此 ID。
  3. 使用您的诊断 ID 获取帮助：
    • 如果您拥有付费 Docker 订阅，请选择联系支持。这将打开 Docker Desktop 支持表单。填写所需信息，并将您在步骤三中复制的 ID 添加到诊断 ID 字段中。然后，选择提交工单以请求 Docker Desktop 支持。

      [!注意]

      您必须登录 Docker Desktop 才能访问支持表单。有关 Docker Desktop 支持涵盖的内容，请参阅 支持。

    • 如果您没有付费 Docker 订阅，您可以在 GitHub 上打开新的 Docker Desktop 问题。填写所需信息，并确保添加步骤二中打印的诊断 ID。

从终端诊断

在某些情况下，自行运行诊断很有用，例如当 Docker Desktop 无法启动时。

  1. 找到 com.docker.diagnose 工具：

    $ C:\Program Files\Docker\Docker\resources\com.docker.diagnose.exe

  2. 创建并上传诊断 ID。在 PowerShell 中运行：

    $ & "C:\Program Files\Docker\Docker\resources\com.docker.diagnose.exe" gather -upload

诊断完成后，终端会显示您的诊断 ID 和诊断文件的路径。诊断 ID 由您的用户 ID 和时间戳组成。例如 BE9AFAAF-F68B-41D0-9D12-84760E6B8740/20190905152051。

  1. 找到 com.docker.diagnose 工具：

    $ /Applications/Docker.app/Contents/MacOS/com.docker.diagnose

  2. 创建并上传诊断 ID。运行：

    $ /Applications/Docker.app/Contents/MacOS/com.docker.diagnose gather -upload

诊断完成后，终端会显示您的诊断 ID 和诊断文件的路径。诊断 ID 由您的用户 ID 和时间戳组成。例如 BE9AFAAF-F68B-41D0-9D12-84760E6B8740/20190905152051。

  1. 找到 com.docker.diagnose 工具：

    $ /opt/docker-desktop/bin/com.docker.diagnose

  2. 创建并上传诊断 ID。运行：

    $ /opt/docker-desktop/bin/com.docker.diagnose gather -upload

诊断完成后，终端会显示您的诊断 ID 和诊断文件的路径。诊断 ID 由您的用户 ID 和时间戳组成。例如 BE9AFAAF-F68B-41D0-9D12-84760E6B8740/20190905152051。

要查看诊断文件的内容：

  1. 解压文件。在 PowerShell 中，将诊断文件的路径复制并粘贴到以下命令中，然后运行它。它应该类似于以下示例：

    $ Expand-Archive -LiteralPath "C:\Users\testUser\AppData\Local\Temp\5DE9978A-3848-429E-8776-950FC869186F\20230607101602.zip" -DestinationPath "C:\Users\testuser\AppData\Local\Temp\5DE9978A-3848-429E-8776-950FC869186F\20230607101602"

  2. 在您首选的文本编辑器中打开文件。运行：

    $ code <path-to-file>

运行：

$ open /tmp/<your-diagnostics-ID>.zip

运行：

$ unzip –l /tmp/<your-diagnostics-ID>.zip

使用您的诊断 ID 获取帮助

如果您拥有付费 Docker 订阅，请选择联系支持。这将打开 Docker Desktop 支持表单。填写所需信息，并将您在步骤三中复制的 ID 添加到诊断 ID 字段中。然后，选择提交工单以请求 Docker Desktop 支持。

如果您没有付费 Docker 订阅，请在 GitHub 上创建问题。

自诊断工具

[!重要]

此工具已被弃用。

查看日志

除了使用诊断选项提交日志外，您还可以自行浏览日志。

在 PowerShell 中运行：

$ code $Env:LOCALAPPDATA\Docker\log

这将在您首选的文本编辑器中打开所有日志供您探索。

从终端

要在命令行中查看 Docker Desktop 日志的实时流，请从您首选的 shell 运行以下脚本。

$ pred='process matches ".*(ocker|vpnkit).*" || (process in {"taskgated-helper", "launchservicesd", "kernel"} && eventMessage contains[c] "docker")'
$ /usr/bin/log stream --style syslog --level=debug --color=always --predicate "$pred"

或者，要将最近一天的日志 (1d) 收集到文件中，请运行：

$ /usr/bin/log show --debug --info --style syslog --last 1d --predicate "$pred" >/tmp/logs.txt

使用 Console 应用

Mac 提供了一个名为 Console 的内置日志查看器，可用于检查 Docker 日志。

Console 位于 /Applications/Utilities 目录中。您可以通过 Spotlight 搜索来查找它。

要读取 Docker 应用日志消息，请在 Console 窗口的搜索栏中输入 docker 并按回车键。然后选择 ANY 以展开 docker 搜索条目旁边的下拉列表，并选择 Process。

Mac Console 搜索 Docker 应用

您可以使用 Console 日志查询功能来搜索日志、以各种方式筛选结果，并创建报告。

您可以通过运行以下命令访问 Docker Desktop 日志：

$ journalctl --user --unit=docker-desktop

您还可以在 $HOME/.docker/desktop/log/ 目录中找到 Docker Desktop 包含的内部组件的日志。

查看 Docker 守护进程日志

请参阅 阅读守护进程日志部分，了解如何查看 Docker 守护进程日志。

更多资源