NocoBase 如何安装、启用和升级插件【免费下载链接】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当你拿到一个第三方插件包远程.tgz下载地址、本地.tgz文件或已发布到 npm 的包名需要把它装进一个已在运行的 NocoBase 应用并启用或者插件已启用需要换成新版本。本文基于 NocoBase 官方文档给出「导入 → 重启 → 启用 → 验证」这条完整路径并覆盖已启用插件的升级、内置插件和商业插件的对应处理方式。适用对象是通过nbCLI 管理应用的环境npm/Git env、Docker env 或 HTTP env其中 npm/Git env 在本地执行插件命令Docker env 在已保存的应用容器中执行HTTP env 在可用时回退到 API见 nb plugin 命令参考。准备先切到目标环境如果本地管理了多个应用先切到目标 env 再操作nb env use app1后续所有nb plugin、nb app命令省略--env时都作用于当前 env。只有在显式传入--env指向另一个 env 时CLI 才会检查它是否与当前 env 一致交互终端会先确认在非交互终端脚本或 AI agent 场景下要么自己追加--yes要么先执行nb env use name再重试见 第三方插件安装与升级、nb plugin enable。安装用nb plugin import导入插件包nb plugin import支持三类来源远程压缩包、本地压缩包、npm 包名或 tag。注意它只负责把插件导入storage/plugins不会自动启用插件也不需要手动解压到storage/pluginsCLI 会自动放到正确目录见 nb plugin import# 远程压缩包 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-casbeta其中/your/path/plugin-auth-cas-1.4.0.tgz是文档中的占位路径替换为实际.tgz文件的完整路径即可。两个可选分支插件发布在私有 npm registry 时先登录再指定 registrynpm login --registryhttps://registry.example.com nb plugin import my-scope/plugin-auth-casbeta --npm-registryhttps://registry.example.com如果已经知道目标应用的storage根目录可以显式传--storage-path此时不依赖当前 env、也可以不传--env插件会写入storage-path/pluginsnb plugin import /your/path/plugin-auth-cas-1.4.0.tgz --storage-path ./storage导入之后先重启导入完成后先重启目标应用让插件目录重新加载nb app restart也可以显式传入-e env指定要重启的环境。nb app restart会先停止再启动应用并在适用时先自动同步当前授权允许使用的商业插件只要 CLI 需要等待应用就绪就会检查__health_check接口先输出一条等待日志之后每 10 秒输出一条进度提示直到应用可用或超时见 nb app restart。等到应用通过健康检查重启才算完成。第一次安装后启用插件重启通过后第一次安装需要显式启用nb plugin enable nocobase/plugin-auth-casnb plugin enable支持一次传入多个插件包名nb plugin enable nocobase/plugin-a nocobase/plugin-b第一次启用时会自动完成安装见 第三方插件安装与升级。停用则用对应的nb plugin disable packages...见 nb plugin disable。验证确认插件已出现在当前应用nb plugin listnb plugin list会列出当前 env 已安装的插件用于确认导入的插件包名出现在列表中见 nb plugin list。结合上一步重启时的__health_check等待结果——CLI 在应用就绪前每 10 秒输出一次进度提示、就绪或超时才结束——即可判断本次安装是否成功加载。升级一个已启用的插件如果插件已经启用这次只是换成新版本只需要两步导入新包然后重启nb plugin import /your/path/plugin-auth-cas-1.5.0.tgz nb app restart导入的是 npm 包时同理nb plugin import my-scope/plugin-auth-caslatest nb app restart也就是说升级场景不需要再额外执行nb plugin enable——把新包导入进去、重启应用即可。如果你的应用是在源码目录内用yarn nocobase系列命令管理的安装与升级插件给出的是另一条等价路径yarn pm pull https://github.com/nocobase/plugin-auth-cas/releases/download/v1.4.0/plugin-auth-cas-1.4.0.tgz # 或本地包 yarn pm pull /your/path/plugin-auth-cas-1.4.0.tgz如果应用已安装该插件且需要升级执行yarn nocobase upgrade --skip-code-update离线场景目标机器不能直接访问下载地址先把.tgz上传到目标机器任意目录再本地导入或者手动上传并解压到./storage/plugins目录。文档要求如果插件已启用在手动上传并解压完成后执行yarn nocobase upgrade --skip-code-update并且为避免缓存问题执行前确保 NocoBase 应用已停止运行。正确的手动解压方式避免产生多余的package目录层级mkdir -p /my-nocobase/storage/plugins/nocobase/plugin-auth-cas \ tar -xvzf /downloads/plugin-auth-cas-1.4.0.tgz \ -C /my-nocobase/storage/plugins/nocobase/plugin-auth-cas \ --strip-components1其中/my-nocobase和/downloads/plugin-auth-cas-1.4.0.tgz按你机器上的实际应用根目录和上传位置替换。解压后该目录下应直接是插件内容package.json、server.js、dist/等而不是多包一层package目录。内置插件与商业插件内置插件随内核版本自动更新无需手动操作。升级应用内核时使用nb app upgrade它默认依次执行nb app stop、nb source download --replace、nb license plugins sync --skip-if-no-license、nb app start并在需要时保存新的downloadVersion、刷新 env runtime非交互终端下必须显式传入--force否则命令会被拒绝并输出一条可直接复制的重跑命令见 nb app upgradenb app upgrade nb app upgrade --env local --force商业插件先为当前 env 激活商业 license key支持直接传 key、从文件读取或在交互终端粘贴激活成功后需要重启应用让授权和商业插件状态真正生效CLI 会在重启前自动同步当前授权允许使用的商业插件见 nb license、nb license activatenb license activate --env app1 --key-file ./license.txt nb app restart也可以用nb license plugins list查看当前授权对应的商业插件列表用nb license plugins sync将其同步到本地见 nb license plugins。边界说明nb plugin import只导入不启用导入后必须重启第一次安装还要再执行nb plugin enable升级场景则不需要重复 enable。非交互环境下跨 env 操作显式--env与当前 env 不一致需要追加--yesnb app upgrade还需要--force两者是独立的确认参数。重启、升级过程中 CLI 对__health_check的等待存在超时行为超时即说明应用未在预期时间内就绪此时应结合nb app logs一类的排查手段继续定位本文不展开。【免费下载链接】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），仅供参考
