NocoBase CLI:nb proxy nginx info 命令深度解析——查看 Nginx 代理 driver、配置路径与运行信息 📅 发布时间:2026/9/13 18:51:19 👁 浏览次数: NocoBase CLInb proxy nginx info 命令深度解析——查看 Nginx 代理 driver、配置路径与运行信息【免费下载链接】nocobaseNocoBase is an open-source AI no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.项目地址: https://gitcode.com/GitHub_Trending/no/nocobasenb proxy nginx info是 NocoBase CLInb中 Nginx 反向代理 provider 的信息查看命令。它一次性输出当前 Nginx 代理的 driverlocal/docker、主配置文件路径、snippets 目录、运行根目录、上游地址以及二进制/容器信息是排查“代理配置生成到哪里”“当前用的是本机 nginx 还是 Docker 容器”这类问题的第一入口。读完本文你可以掌握该命令的完整输出字段含义、它在源码中的取值链路以及如何结合nb proxy nginx status、current等命令完成一套完整的代理信息核查流程。命令用途该命令用于查看当前 Nginx provider 的 driver、配置路径和运行信息属于nb proxy nginx命令组Nginx provider 的驱动选择、配置生成与运行控制中的只读诊断命令。适用场景包括切换 driver 后确认当前生效的是local还是docker排查nb proxy nginx generate生成的配置文件实际落在哪个路径在 Docker 模式下核对容器名与镜像是否符合预期便于与docker ps对照排查在 local 模式下核对将要调用的 nginx 可执行文件路径。用法nb proxy nginx info该命令不接受必填参数执行后直接在终端打印一行一个字段的纯文本信息。输出字段详解命令通常输出以下字段字段含义driver当前生效的 Nginx 运行方式local或dockerconfigFile生成的 Nginx 主配置文件路径snippetsDir按 env 生成的站点片段server 块所在目录runtimeRootCLI 运行根目录运行时视角下的NB_CLI_ROOTupstreamHost代理转发的上游主机地址Nginx 将请求转发到的目标nginxBin仅localdriver本地 nginx 可执行文件路径container仅dockerdriverNginx 代理容器名image仅dockerdriver使用的 Nginx 镜像其中两个 driver 相关的字段互斥出现localdriver 下显示nginxBindockerdriver 下显示container和image。各字段的取值来源源码级印证命令实现在 info.ts 中其字段组装链路如下const runtimeContext await resolveNginxProxyRuntimeContext(); const lines formatNginxProxyInfoLines({ driver: runtimeContext.driver, configFile: await mapProxyPathFromCliRoot(resolveEnvProxyMainOutputPath(), { runtimeCliRoot: runtimeContext.runtimeCliRoot, }), snippetsDir: await mapProxyPathFromCliRoot(resolveEnvProxyNginxSnippetsOutputDir(), { runtimeCliRoot: runtimeContext.runtimeCliRoot, }), upstreamHost: runtimeContext.upstreamHost, nginxBinary: await getCliConfigValue(bin.nginx), runtimeRoot: runtimeContext.runtimeCliRoot, containerName: await resolveNginxProxyContainerName(), image: resolveNginxProxyImage(), }); this.log(lines.join(\n));从源码结构看各字段分别来自driver、runtimeRoot、upstreamHost由resolveNginxProxyRuntimeContext()解析出的运行上下文driver 对应保存在 CLI 配置项proxy.nginx-driver中默认值为localconfigFile/snippetsDir由 env-proxy.ts 中的resolveEnvProxyMainOutputPath()与resolveEnvProxyNginxSnippetsOutputDir()解析并通过mapProxyPathFromCliRoot()映射为运行时根目录下的实际路径nginxBin读取 CLI 配置项bin.nginx默认值为nginx即从 PATH 中解析container/image由 proxy-nginx.ts 中的resolveNginxProxyContainerName()与resolveNginxProxyImage()解析容器名默认形如docker.container-prefix-nginx-proxy镜像默认为nginx:latest。输出行的 driver 分支逻辑真正决定打印哪些行的是 proxy-nginx.ts 中的formatNginxProxyInfoLines()const lines [ driver: ${info.driver}, configFile: ${info.configFile}, snippetsDir: ${info.snippetsDir}, runtimeRoot: ${info.runtimeRoot}, upstreamHost:${info.upstreamHost}, ]; if (info.driver local) { lines.push(nginxBin: ${info.nginxBinary}); } else { lines.push(container: ${info.containerName}); lines.push(image: ${info.image}); }可见nginxBin与container/image的互斥输出是硬编码分支local只追加二进制路径docker追加容器名与镜像名。这与 NginxProxyStatus 类型定义 中nginxBinary?、containerName?、image?三个可选字段的语义一致。示例local driver默认nb proxy nginx info典型输出形如driver: local configFile: /path/to/NB_CLI_ROOT/proxy/nginx/nginx.conf snippetsDir: /path/to/NB_CLI_ROOT/proxy/nginx/snippets runtimeRoot: /path/to/NB_CLI_ROOT upstreamHost:127.0.0.1:13000 nginxBin: nginxdocker driver先切换 driver 再查看nb proxy nginx use docker nb proxy nginx info输出变为driver: docker configFile: /path/to/NB_CLI_ROOT/proxy/nginx/nginx.conf snippetsDir: /path/to/NB_CLI_ROOT/proxy/nginx/snippets runtimeRoot: /path/to/NB_CLI_ROOT upstreamHost:127.0.0.1:13000 container: container-prefix-nginx-proxy image: nginx:latest注以上输出值根据源码的字段格式与默认配置整理实际值以你机器上的NB_CLI_ROOT、docker.container-prefix与已生成的 env 为准。与其他命令的配合排查流程在nb proxy nginx命令组的典型工作流见 nb proxy nginx 文档中info位于流程末端用于“生成并启动后确认一切落在预期位置”nb proxy nginx use docker nb proxy nginx generate --env app1 --host app1.example.com nb proxy nginx start nb proxy nginx status nb proxy nginx info推荐的排查组合确认 driver 生效nb proxy nginx current见 nb proxy nginx current只输出 driver适合脚本化判断info则给出全量上下文。确认代理在跑nb proxy nginx status见 nb proxy nginx status输出运行状态若显示未运行用info检查configFile是否存在、nginxBinlocal或containerdocker是否符合预期。确认配置来源configFile是nb proxy nginx generate的主输出snippetsDir存放每个 env 的站点片段核对这两个路径即可判断generate是否真的刷新了文件。Docker 模式下进一步验证拿到container与image后可用docker ps与docker inspect container交叉验证容器实际端口映射从源码看Docker 容器启动时会把宿主机NB_CLI_ROOT挂载到容器内运行根目录见 proxy-nginx.ts 中ensureDockerNginxProxyContainer()的挂载逻辑因此info中的路径在容器内会被映射为另一组路径排查挂载问题时以runtimeRoot为基准。相关文档nb proxy nginx currentnb proxy nginx statusnb proxy nginxnb proxy小结nb proxy nginx info本身是纯只读的轻量命令但它把 NocoBase CLI 托管 Nginx 代理的关键状态driver、配置路径、运行根、上游、二进制/容器聚合在一处是理解nb proxy nginx generate/start/status实际落点的最快途径。理解其输出字段的源码取值链路——driver 来自proxy.nginx-driver配置、路径来自 env-proxy 输出路径解析、nginxBin来自bin.nginx配置、容器名与镜像来自 provider 解析函数——能让你在切换 driver 或调整 CLI 根目录后快速验证环境是否按预期工作。【免费下载链接】nocobaseNocoBase is an open-source AI no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.项目地址: https://gitcode.com/GitHub_Trending/no/nocobase创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考