• Español

      • nb config

      Gestiona los valores de configuración predeterminados de la CLI. Las claves compatibles actualmente se agrupan principalmente así:

      • La propia CLI: locale, update.policy, license.pkg-url
      • Runtime de Docker: docker.network, docker.container-prefix
      • Imágenes oficiales de NocoBase: nb-image-registry, nb-image-variant
      • Ejecutables externos: bin.docker, bin.caddy, bin.git, bin.nginx, bin.pnpm, bin.yarn
      • Generación de proxy: proxy.nb-cli-root, proxy.upstream-host, proxy.nginx-driver, proxy.caddy-driver

      La mayoría de los proyectos solo necesitan unas pocas de estas claves. En la práctica, las más habituales son:

      • update.policy
      • docker.network
      • docker.container-prefix
      • nb-image-registry
      • nb-image-variant
      • bin.nginx o bin.caddy
      • proxy.nginx-driver o proxy.caddy-driver

      Claves de configuración comunes

      ClaveValor predeterminadoDescripción
      localese resuelve según las reglas actuales de la CLISobrescribe el idioma usado por la CLI
      update.policypromptPolítica de actualización al iniciar: prompt, auto u off
      license.pkg-urlhttps://pkg.nocobase.com/Sobrescribe la URL de descarga de paquetes de extensiones comerciales
      docker.networknocobaseRed predeterminada para aplicaciones Docker gestionadas por la CLI
      docker.container-prefixnbPrefijo predeterminado para contenedores Docker gestionados por la CLI
      nb-image-registrydockerhubFamilia de registry predeterminada para imágenes oficiales de NocoBase: dockerhub o aliyun
      nb-image-variantfullVariante de tag predeterminada para imágenes oficiales de app de NocoBase: standard, no-nginx, full o full-no-nginx
      bin.dockerdockerSobrescribe la ruta del ejecutable de Docker
      bin.caddycaddySobrescribe la ruta del ejecutable de Caddy
      bin.gitgitSobrescribe la ruta del ejecutable de Git
      bin.nginxnginxSobrescribe la ruta del ejecutable de Nginx
      bin.pnpmpnpmSobrescribe la ruta del ejecutable de pnpm
      bin.yarnyarnSobrescribe la ruta del ejecutable de Yarn
      proxy.nb-cli-rootraíz de la CLI, normalmente el directorio home del usuario actualSobrescribe la ruta raíz visible para la configuración de proxy generada cuando el proceso del proxy y la CLI no ven la misma raíz del sistema de archivos
      proxy.upstream-host127.0.0.1Sobrescribe el host usado por el proxy para reenviar tráfico a la aplicación NocoBase
      proxy.nginx-driverlocalDriver de runtime predeterminado usado por nb proxy nginx
      proxy.caddy-driverlocalDriver de runtime predeterminado usado por nb proxy caddy

      Uso

      nb config <command>

      Subcomandos

      ComandoDescripción
      nb config getLeer el valor efectivo de una clave de configuración
      nb config setEstablecer una clave de configuración
      nb config deleteEliminar una clave de configuración definida explícitamente
      nb config listListar las claves de configuración definidas explícitamente en este momento

      Ejemplos

      nb config list
nb config get update.policy
nb config set update.policy auto
nb config get proxy.nb-cli-root
nb config set proxy.nb-cli-root /workspace
nb config set proxy.upstream-host host.docker.internal
nb config set proxy.nginx-driver docker
nb config set proxy.caddy-driver local
nb config get docker.network
nb config set docker.network nocobase
nb config get nb-image-registry
nb config set nb-image-registry aliyun
nb config set nb-image-variant full-no-nginx
nb config set bin.nginx /usr/sbin/nginx
nb config set bin.git /usr/bin/git
nb config set bin.pnpm /usr/local/bin/pnpm
nb config delete docker.container-prefix

      Notas

      • bin.nginx y bin.caddy solo afectan al driver local de nb proxy nginx y nb proxy caddy
      • bin.pnpm se usa cuando los comandos necesitan ejecutar pnpm directamente, como al actualizar una instalación global de la CLI gestionada por pnpm con nb self update
      • nb-image-registry solo afecta a los valores predeterminados de imágenes oficiales de NocoBase que usa la CLI. dockerhub usa la imagen de app nocobase/nocobase, mientras que aliyun usa registry.cn-shanghai.aliyuncs.com/nocobase/nocobase
      • nb-image-variant solo afecta a los tags de las imágenes oficiales de app de NocoBase. Con la versión 1.7.14, la CLI resuelve standard como 1.7.14, no-nginx como 1.7.14-no-nginx, full como 1.7.14-full y full-no-nginx como 1.7.14-full-no-nginx
      • Cuando nb-image-registry=aliyun, la CLI también cambia las imágenes predeterminadas de base de datos integrada a los mirrors oficiales de Aliyun para PostgreSQL, MySQL, MariaDB y Kingbase
      • proxy.nginx-driver y proxy.caddy-driver almacenan el driver predeterminado usado por cada proveedor
      • proxy.nb-cli-root y proxy.upstream-host son overrides avanzados del proxy. La mayoría de los entornos local o docker gestionados por la CLI pueden usar directamente los valores predeterminados
      • Si solo quieres cambiar el driver activo del proxy, normalmente es más claro usar nb proxy nginx use o nb proxy caddy use que establecer la clave manualmente

      Comandos relacionados