• 简体中文

      • nb plugin import

      把插件压缩包或 npm 插件包导入 storage/plugins。这个命令只负责把插件放到目标目录，不会自动启用插件。

      用法

      nb plugin import <archive> [flags]

      参数

      参数类型说明
      <archive>string插件来源，必填。支持本地 .tgz 路径、远程 http(s) 压缩包地址，或者 npm 包名 / tag
      --env, -estringCLI env 名称。省略时通常使用当前 env；如果显式传了 --storage-path，也可以不传
      --yes, -yboolean当显式 --env 指向的 env 与当前 env 不一致时，跳过交互确认
      --storage-pathstring覆盖目标 storage 根目录。实际导入目录是 <storage-path>/plugins
      --npm-registrystring当来源是 npm 包名或 tag 时，指定要使用的 npm registry

      示例

      # 远程压缩包
nb plugin import https://github.com/nocobase/plugin-auth-cas/releases/download/v1.4.0/plugin-auth-cas-1.4.0.tgz

# 本地压缩包
nb plugin import /your/path/plugin-auth-cas-1.4.0.tgz

# npm 包名或 tag
nb plugin import @my-scope/plugin-auth-cas@beta

# 私有 npm 源
nb plugin import @my-scope/plugin-auth-cas@beta --npm-registry=https://registry.example.com

# 不依赖当前 env，直接写入一个本地 storage 路径
nb plugin import ./plugin-auth-cas-1.4.0.tgz --storage-path ./storage

      说明

      如果你已经选好了目标 env，默认直接导入这个 env 的 storage/plugins 就行。

      如果你只想把插件放进某个本地 storage 目录，可以显式传 --storage-path。这时 --env 可以省略，CLI 会直接把插件写入 <storage-path>/plugins。

      导入完成后，通常来说下一步是重启应用，再决定是否启用插件。其中：

      • 第一次安装插件，通常先执行 nb app restart，再执行 nb plugin enable
      • 如果只是重新导入一个新版本，通常先重启，再继续验证插件是否已经正常加载

      如果来源是私有 npm registry，通常来说先登录，再执行导入：

      npm login --registry=https://registry.example.com
nb plugin import @my-scope/plugin-auth-cas@beta --npm-registry=https://registry.example.com
      注意

      这里不需要手动解压到 storage/plugins。nb plugin import 会自动把插件放到正确目录。

      相关命令