排查 Docker Desktop 问题

Table of contents

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

故障排查菜单

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

  • 选择 Docker 菜单 Docker 菜单 whale menu ，然后选择 故障排查。
  • 选择 Docker 仪表板右上角附近的 故障排查 图标。

故障排查 菜单包含以下选项：

  • 重启 Docker Desktop。

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

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

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

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

诊断

Tip

如果在故障排查中找不到解决方案，请浏览 GitHub 仓库或创建新问题：

从应用内诊断

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

      您必须登录 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 支持。
      Note

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

    • 如果您没有付费 Docker 订阅，您可以在 GitHub 上为 Mac、Windows 或 Linux 打开新的 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 上创建问题：

自诊断工具

Important

此工具已弃用。

查看日志

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

在 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

从控制台应用

Mac 提供了一个名为 控制台 的内置日志查看器，您可以使用它来检查 Docker 日志。

控制台位于 /Applications/Utilities。您可以使用 Spotlight 搜索找到它。

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

Mac 控制台搜索 Docker 应用

您可以使用控制台日志查询来搜索日志、以各种方式过滤结果并创建报告。

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

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

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

查看 Docker 守护进程日志

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

更多资源