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
  • 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
  • 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
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 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
  • 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