Referencia de ajustes

Esta referencia documenta los ajustes de Docker Desktop que los administradores pueden configurar utilizando la Gestión de Ajustes. Utiliza esta página para comprender qué ajustes están disponibles, sus valores aceptados, la compatibilidad con plataformas y qué métodos de configuración se aplican.

Note

Esta página solo cubre los ajustes configurables para administradores que están desplegando Docker Desktop en su organización. Para ver la lista completa de ajustes para el usuario de Docker Desktop, consulta Cambiar ajustes.

General

Enviar estadísticas de uso (Send usage statistics)

Controla si Docker Desktop recopila y envía estadísticas de uso local e informes de fallos a Docker. No afecta a la telemetría del lado del servidor recopilada a través de Docker Hub u otros servicios de backend, como las marcas de tiempo de inicio de sesión, descargas (pulls) o compilaciones (builds).

Note

Las organizaciones que utilicen el panel de Insights (Insights Dashboard) pueden necesitar tener este ajuste habilitado para garantizar que la actividad de los desarrolladores sea totalmente visible. Si los usuarios optan por no participar y el ajuste no está bloqueado, su actividad puede quedar excluida de las vistas analíticas.

Buscar actualizaciones automáticamente (Automatically check for updates)

Controla si Docker Desktop busca actualizaciones y notifica a los usuarios sobre las mismas. Cuando se establece en true, se desactivan las búsquedas de actualizaciones y las notificaciones.

Note

En entornos con seguridad reforzada (hardened), habilita este ajuste y bloquéalo. Esto garantiza que solo se instalen las versiones validadas internamente.

Actualizar componentes automáticamente (Automatically update components)

Permite a Docker Desktop actualizar automáticamente los componentes que no requieren un reinicio, como Docker Compose, Docker Scout y la CLI de Docker.

Habilitar Gordon (Enable Gordon)

Important

Los clientes de Docker Business deben establecer esto en "Enabled" o "Always Enabled" en la Consola de administración. Establecerlo en "User Defined" por sí solo no activará Gordon.

Bloquear docker load (Block docker load)

Evita que los usuarios carguen imágenes locales de Docker utilizando el comando docker load, lo que impone la procedencia de las imágenes al requerir que todas provengan de registros.

Note

En entornos con seguridad reforzada, habilita y bloquea este ajuste. Esto obliga a que todas las imágenes provengan de tu registro seguro y analizado.

Ocultar la encuesta de incorporación (Hide onboarding survey)

Evita que la encuesta de incorporación se muestre a los nuevos usuarios.

Habilitar la terminal de Docker (Enable Docker terminal)

Permite o restringe el acceso a la terminal integrada para interactuar con el sistema host. Cuando se establece en false, los usuarios no pueden utilizar la terminal de Docker para interactuar con la máquina host ni ejecutar comandos directamente desde Docker Desktop.

Exponer la API de Docker en TCP 2375 (Expose Docker API on TCP 2375) Windows únicamente

Expone la API de Docker a través de un socket TCP sin autenticación en el puerto 2375. Solo se recomienda para entornos aislados y protegidos. Admite integraciones heredadas que requieren acceso a la API por TCP.

Note

En entornos con seguridad reforzada, deshabilita y bloquea este ajuste. Esto garantiza que la API de Docker solo sea accesible a través del socket interno seguro.

Extensiones (Extensions)

Habilitar extensiones de Docker (Enable Docker extensions)

Controla si los usuarios pueden instalar y ejecutar extensiones de Docker (Docker Extensions).

Note

En entornos con seguridad reforzada, deshabilita y bloquea este ajuste. Esto evita que se instalen complementos de terceros o no verificados.

Permitir únicamente extensiones distribuidas a través de Docker Marketplace (Allow only extensions distributed through the Docker Marketplace)

Evita la instalación de extensiones de terceros o desarrolladas localmente.

Habilitar un mercado privado (Enable a private marketplace)

Garantiza que Docker Desktop se conecte al contenido definido y controlado por el administrador en lugar del mercado público de Docker (Docker Marketplace).

IA (AI)

Habilitar Docker Model Runner (Enable Docker Model Runner)

Habilita la funcionalidad de Docker Model Runner para ejecutar modelos de IA en contenedores.

Habilitar el soporte TCP en el lado del host (Enable host-side TCP support)

Habilita la conectividad TCP para los servicios de Docker Model Runner, permitiendo que aplicaciones externas se conecten a Model Runner a través de TCP.

Puerto (Port)

Especifica el puerto utilizado para las conexiones TCP de Model Runner.

Orígenes permitidos por CORS (CORS Allowed Origins)

Controla el uso compartido de recursos de origen cruzado (CORS) para la integración web de Model Runner.

Habilitar inferencia respaldada por GPU (Enable GPU-backed inference) Windows únicamente

Habilita la inferencia respaldada por GPU. Los componentes adicionales se descargarán en ~/.docker/bin/inference.

Compartición de archivos y emulación (File sharing and emulation)

Directorios para compartir archivos (File sharing directories)

Define a qué directorios del host pueden acceder los contenedores para los flujos de trabajo de desarrollo.

VirtioFS Mac únicamente

Utiliza VirtioFS para una compartición de archivos rápida y nativa entre el host y los contenedores. Si tanto VirtioFS como gRPC FUSE se establecen en true, VirtioFS tiene precedencia.

gRPC FUSE Mac únicamente

Habilita gRPC FUSE para la compartición de archivos en macOS.

Rosetta Mac únicamente

Utiliza Rosetta para la emulación de x86_64/amd64 en Apple Silicon.

Scout

Habilitar el análisis de imágenes con Scout (Enable Scout image analysis)

Activa el análisis de vulnerabilidades y la lista de materiales de software (SBOM) para las imágenes de contenedor.

Habilitar la indexación SBOM de Scout en segundo plano (Enable background Scout SBOM indexing)

Mantiene actualizados los metadatos de las imágenes realizando la indexación durante el tiempo de inactividad o después de operaciones con imágenes.

Proxy

Script PAC incrustado (Embedded PAC script)

Especifica un script de Autoconfiguración de Proxy (PAC) incrustado. Por ejemplo: "embeddedPac": "function FindProxyForURL(url, host) { return \"DIRECT\"; }".

URL del archivo PAC (PAC file URL)

Especifica la URL de un archivo PAC para que lo utilice Docker Desktop al enrutar el tráfico de red. Por ejemplo: "pac": "http://proxy/proxy.pac".

Anular el puerto "dockerd" de Windows (Override Windows "dockerd" port) Windows únicamente

Expone localmente el proxy interno de Docker Desktop en este puerto para que se conecte el daemon de Docker de Windows. Si se establece en 0, se elige un puerto libre de forma aleatoria. Si el valor es mayor que 0, se utiliza ese valor exacto para el puerto.

Habilitar la autenticación Kerberos y NTLM (Enable Kerberos and NTLM authentication)

Habilita el soporte de autenticación proxy empresarial para los protocolos Kerberos y NTLM.

Omisión de proxy (Proxy bypass)

Define las direcciones de red que los contenedores deben omitir al utilizar los ajustes de proxy.

Proxy de contenedores (Containers proxy)

Proxy para contenedores en entornos aislados (Air-gapped container proxy)

Configura un proxy HTTP/HTTPS para contenedores en entornos aislados (air-gapped), proporcionando un acceso a la red controlado en entornos de red desconectados o restringidos.

"containersProxy": {
  "locked": true,
  "mode": "manual",
  "http": "",
  "https": "",
  "exclude": [],
  "pac": "",
  "transparentPorts": ""
}

Para obtener más información, consulta Contenedores en entornos aislados (Air-Gapped).

VM Linux (LinuxVM)

Habilitar el motor WSL (Enable WSL engine) Windows únicamente

Cuando se establece en true, Docker Desktop utiliza el motor basado en WSL 2. Anula cualquier bandera de backend establecida en la instalación mediante --backend=<nombre_backend>.

Opciones del daemon de Docker (Docker daemon options)

Anula la configuración del daemon de Docker utilizada en los contenedores, sin modificar los archivos de configuración locales.

VPNKit CIDR Mac únicamente

Establece la subred de red utilizada para los servicios internos de DHCP/DNS de VPNKit de Docker Desktop. Evita conflictos de direcciones IP en entornos con subredes de red superpuestas.

Contenedores de Windows (Windows containers)

Opciones del daemon de Docker (Docker daemon options)

Anula la configuración del daemon de Docker utilizada en los contenedores de Windows, sin modificar los archivos de configuración locales.

Kubernetes

Habilitar Kubernetes (Enable Kubernetes)

Habilita la integración del clúster de Kubernetes local con Docker Desktop.

Mostrar contenedores del sistema (Show system containers)

Controla la visibilidad de los contenedores del sistema de Kubernetes en el Panel (Dashboard) de Docker Desktop.

Repositorio de imágenes de Kubernetes (Kubernetes image repository)

Especifica un registro utilizado para las imágenes del plano de control de Kubernetes en lugar de Docker Hub. Anula la porción [registro[:puerto]/][espacio_nombres] de los nombres de imágenes. Las imágenes deben estar duplicadas (mirrored) desde Docker Hub con etiquetas coincidentes.

Note

Las imágenes deben estar duplicadas desde Docker Hub con etiquetas coincidentes. Las imágenes requeridas dependen del método de aprovisionamiento del clúster.

Important

Al utilizar repositorios de imágenes personalizados con el Aislamiento de Contenedores Mejorado, añade estas imágenes a la lista de permitidos de ECI: [imagesRepository]/desktop-cloud-provider-kind:* y [imagesRepository]/desktop-containerd-registry-mirror:*.

Método de aprovisionamiento del clúster (Cluster provisioning method)

Controla la topología del clúster de Kubernetes y la configuración de los nodos.

Versión del nodo (Node version)

Fija la versión de Kubernetes utilizada para los nodos del clúster.

Número de nodos (Nodes count)

Establece el número de nodos en los clústeres de Kubernetes multinodo.

Características en desarrollo (Features in development)

Acceso a características beta (Access beta features)

Controla si los usuarios pueden acceder a todas las características de Docker Desktop que se encuentran en fase beta pública.

Habilitar Docker MCP Toolkit (Beta) [Enable Docker MCP Toolkit (Beta)]

Habilita Docker MCP Toolkit en Docker Desktop para flujos de trabajo de desarrollo de modelos de IA.

Aislamiento de contenedores mejorado (Enhance container isolation)

Habilitar el Aislamiento de Contenedores Mejorado (Enable Enhanced Container Isolation)

Evita que los contenedores modifiquen la configuración de la VM de Docker Desktop o accedan a áreas sensibles del host.

Control de acceso al socket de Docker [Docker socket access control (ECI exceptions)]

Define las imágenes y comandos específicos autorizados a utilizar el socket de Docker cuando el Aislamiento de Contenedores Mejorado está activo. Admite herramientas como Testcontainers, LocalStack o sistemas de CI que necesitan acceso al socket de Docker mientras se mantiene la seguridad.

"enhancedContainerIsolation": {
  "locked": true,
  "value": true,
  "dockerSocketMount": {
    "imageList": {
      "images": [
        "docker.io/localstack/localstack:*",
        "docker.io/testcontainers/ryuk:*"
      ]
    },
    "commandList": {
      "type": "deny",
      "commands": ["push"]
    }
  }
}

Red (Network)

Modo de red (Networking mode)

Establece el protocolo IP predeterminado que se utiliza cuando Docker crea nuevas redes.

Para obtener más información, consulta Redes.

Inhibir la resolución DNS para IPv4/IPv6 (Inhibit DNS resolution for IPv4/IPv6)

Filtra tipos de registros DNS no admitidos para mejorar la fiabilidad en entornos donde solo se admite IPv4 o IPv6. Requiere Docker Desktop 4.43 y posteriores.

Para obtener más información, consulta Redes.

Comportamiento de vinculación de puertos (Port binding behavior)

Especifica cómo se manejan las vinculaciones de puertos para los nuevos contenedores.

Otro (Other)

Habilitar Docker Offload (Enable Docker Offload)

Controla la disponibilidad de Docker Offload. Cuando está habilitado, los usuarios ven el interruptor de Docker Offload en la cabecera de Docker Desktop.

Note

Este ajuste solo está disponible cuando la capacidad de Docker Offload está habilitada para la organización.