Windows 如何使用 WSL 2 搭建 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在 Windows 上做 NocoBase 本地开发推荐把开发环境放在 WSL 2 里在 WSL 的 Linux 发行版中安装 Node.js、Yarn 和 NocoBase CLI并从这里运行所有nb、yarn、docker命令。这样依赖安装、构建、启动和日志排查更接近常见的 Linux 部署环境也减少 Windows 原生环境里的路径格式、文件权限、软链接、原生依赖编译等问题。本文适用前提Windows 11 或 Windows 10 version 2004 及以上Build 19041 及以上如果你要用 Docker 安装 NocoBase还需安装 Docker Desktop for Windows。完成后的目标是在 WSL 终端中node -v、yarn -v、nb --version都能正常输出并且本地 NocoBase 应用可以通过浏览器打开并登录。前提检查Windows 版本与虚拟化检查 Windows 版本按Win R输入winver确认满足下面任一条件Windows 11Windows 10 version 2004 及以上Build 19041 及以上版本较旧时先升级 Windows再继续安装 WSL。检查虚拟化打开「任务管理器」进入「性能 / CPU」确认「虚拟化」显示为「已启用」。如果没有启用需要进入 BIOS / UEFI 打开虚拟化不同厂商的名称可能不同比如 Intel VT-x、Intel Virtualization Technology、AMD-V、SVM Mode。第一步安装 WSL 2用管理员身份打开 PowerShell开始菜单搜索PowerShell右键选择「以管理员身份运行」执行wsl --install安装完成后重启电脑。默认情况下这个命令会安装 Ubuntu首次启动 Ubuntu 时会要求创建 Linux 用户名和密码这个用户名和密码只用于 WSL 内部不需要和 Windows 账户一致。如果想安装指定发行版可以先查看列表再指定安装wsl --list --online wsl --install -d Ubuntu第二步确认发行版运行在 WSL 2在 PowerShell 中执行wsl --list --verbose确认VERSION是2文档示例输出NAME STATE VERSION * Ubuntu Running 2如果某个发行版还是 WSL 1转换为 WSL 2wsl --set-version Ubuntu 2建议把后续新安装的发行版默认设置为 WSL 2并更新一次 WSLwsl --set-default-version 2 wsl --update第三步可选安装 Docker Desktop 并启用 WSL 集成只有当你计划用 Docker 安装或运行 NocoBase 时才需要这一步如果直接用 Node.js 方式安装可以跳到第四步。从 Docker 官方页面下载并安装 Docker Desktop for Windows。安装时注意安装模式通常选择Per-user即可适合大多数个人开发场景配置页选择Use WSL 2 instead of Hyper-V安装完成后从 Windows 开始菜单启动 Docker Desktop首次启动时阅读并接受 Docker Desktop Subscription Service Agreement启动后确认 WSL 2 后端已启用进入「Docker Desktop / Settings / General」确认「Use the WSL 2 based engine」已打开点击「Apply」。然后开启发行版集成进入「Docker Desktop / Settings / Resources / WSL Integration」打开「Enable integration with my default WSL distro」在列表中找到你要使用的发行版比如Ubuntu并打开右侧开关点击「Apply restart」或「Apply」。验证 Docker先在 PowerShell 中执行再进入 WSLwsl后重复执行相同命令wsl --list --verbose docker version docker compose version docker run hello-world如果hello-world容器能正常拉取并运行说明 Docker Desktop 与 WSL 2 集成成功。第四步在 WSL 中安装 Node.js 22 和 Yarn 1.xWSL 本身不等于 Node.js 运行环境默认通过wsl --install安装的 Ubuntu 通常不会预装 Node.js 和 npm需要在 WSL 发行版里单独安装。NocoBase 本地开发要求 Node.js 22 和 Yarn 1.x。先从 PowerShell 进入 WSLwsl下面的命令都在 WSL 终端中执行。先检查是否已经安装node -v npm -v如果提示command not found从下面两种方式中选一种安装 Node.js 22。方式 A使用 NodeSource 安装推荐如果这台 WSL 环境只需要一个统一的 Node.js 版本推荐使用 NodeSourcesudo apt update sudo apt install -y curl curl -fsSL https://deb.nodesource.com/setup_22.x -o nodesource_setup.sh sudo -E bash nodesource_setup.sh sudo apt install -y nodejs方式 B使用 nvm 安装如果你需要在多个项目之间切换 Node.js 版本或者项目使用.nvmrc固定版本可以使用 nvmsudo apt update sudo apt install -y curl ca-certificates curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash source ~/.bashrc nvm install 22 nvm use 22如果需要项目固定 Node.js 22可以在项目根目录创建.nvmrc以后进入项目目录后执行nvm use即可切换echo 22 .nvmrc nvm install nvm use注意NodeSource 和 nvm 二选一即可不建议在同一个 WSL 用户环境里混用两套 Node.js 管理方式。安装完成后验证node -v npm -v npx -v然后安装 Yarn 1.x。Node.js 装好后可通过 Corepack 启用corepack enable corepack prepare yarn1.22.22 --activate yarn -v如果环境里没有 Corepack也可以用 npm 安装npm install -g yarn1.22.22 yarn -v第五步安装 NocoBase CLI 并初始化应用在 WSL 中全局安装 NocoBase CLInpm install -g nocobase/cli nb --version如果你会同时开多个终端或者要和 AI Agent 并行操作建议额外执行一次nb session setup让每个会话维护自己的current env避免互相影响。推荐通过 UI 向导初始化应用nb init --ui --locale zh-CN向导依次经过这几步「开始设置」——设置--env标识并选择「新安装」「应用环境信息」——设置应用的基础信息、存储位置和运行端口「应用来源和版本」——选择应用的获取方式以及要使用的来源和版本「配置数据库」——选择内置数据库或自定义数据库「创建管理员账号」——设置第一个管理员账号「连接与认证」——填写应用访问地址并选择认证方式如果更习惯终端交互可以直接运行nb init在脚本或 CI 里初始化可以用非交互模式nb init --yes --env app1第六步验证本地环境可用安装完成后确认三件事env 是否已经保存成功、应用是否已经正常启动、能否用管理员账号登录页面。常用命令nb env list nb env info nb app logs如果是本地默认安装浏览器通常可以直接打开http://localhost:13000用向导中设置的管理员账号登录即可。登录后如果要用 AI Agent 操作这个应用再新开或重启一次 AI Agent 会话。CLI 的配置默认保存在~/.nocobase/所以 AI Agent 通常可以在任意工作目录访问它。常见问题排查WSL 中提示找不到 docker 命令先确认发行版是 WSL 2wsl --list --verbose如果是 WSL 1 就转换wsl --set-version Ubuntu 2。然后回到 Docker Desktop 的「Settings / Resources / WSL Integration」打开对应发行版的集成开关并应用。WSL Integration 选项不存在通常是 Docker Desktop 当前处于 Windows containers 模式。点击 Windows 系统托盘里的 Docker 图标选择「Switch to Linux containers」等待 Docker Desktop 重启后再进入「Settings / Resources / WSL Integration」检查。Docker Desktop 启动失败或 WSL 状态异常可以先尝试wsl --shutdown wsl --update然后重新启动 Docker Desktop。WSL 里已经手动安装过 Docker EngineDocker 官方建议在安装 Docker Desktop 前卸载直接安装在 WSL Linux 发行版里的 Docker Engine 或 Docker CLI否则可能和 Docker Desktop 的 WSL 集成产生冲突。通常做法是在 WSL 发行版中卸载docker-ce、docker-ce-cli、containerd.io等包然后使用 Docker Desktop 提供的 Docker CLI 集成。项目文件放在哪里以及下一步推荐把项目放在 WSL 文件系统中比如~/projects/my-app不建议优先放在 Windows 挂载路径下如/mnt/c/Users/你的Windows用户名/projects/my-app这样通常能获得更好的文件系统性能也能减少软链接和权限问题对依赖文件较多的 Node.js 项目尤其明显。如果需要从 Windows 访问 WSL 文件可以在文件资源管理器中打开\\wsl$\Ubuntu\home\你的Linux用户名尖括号内替换为你自己的用户名。环境搭好之后按你的下一步继续管理应用的启动、停止、日志和升级见 管理应用让 AI Agent 连接并操作这个 NocoBase 应用见 AI Agent 接入指南如果这个应用后面要正式对外提供服务不建议长期直接使用IP port下一步通常是接入反向代理并启用 HTTPS部署给真实用户前先看 生产环境系统要求【免费下载链接】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），仅供参考 
长河君 · 2026/9/13 9:29:03 · 阅读 1.2k Windows 如何使用 WSL 2 搭建 NocoBase 本地开发环境
Windows 如何使用 WSL 2 搭建 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在 Windows 上做 NocoBase 本地开发推荐把开发环境放在 WSL 2 里在 WSL 的 Linux 发行版中安装 Node.js、Yarn 和 NocoBase CLI并从这里运行所有nb、yarn、docker命令。这样依赖安装、构建、启动和日志排查更接近常见的 Linux 部署环境也减少 Windows 原生环境里的路径格式、文件权限、软链接、原生依赖编译等问题。本文适用前提Windows 11 或 Windows 10 version 2004 及以上Build 19041 及以上如果你要用 Docker 安装 NocoBase还需安装 Docker Desktop for Windows。完成后的目标是在 WSL 终端中node -v、yarn -v、nb --version都能正常输出并且本地 NocoBase 应用可以通过浏览器打开并登录。前提检查Windows 版本与虚拟化检查 Windows 版本按Win R输入winver确认满足下面任一条件Windows 11Windows 10 version 2004 及以上Build 19041 及以上版本较旧时先升级 Windows再继续安装 WSL。检查虚拟化打开「任务管理器」进入「性能 / CPU」确认「虚拟化」显示为「已启用」。如果没有启用需要进入 BIOS / UEFI 打开虚拟化不同厂商的名称可能不同比如 Intel VT-x、Intel Virtualization Technology、AMD-V、SVM Mode。第一步安装 WSL 2用管理员身份打开 PowerShell开始菜单搜索PowerShell右键选择「以管理员身份运行」执行wsl --install安装完成后重启电脑。默认情况下这个命令会安装 Ubuntu首次启动 Ubuntu 时会要求创建 Linux 用户名和密码这个用户名和密码只用于 WSL 内部不需要和 Windows 账户一致。如果想安装指定发行版可以先查看列表再指定安装wsl --list --online wsl --install -d Ubuntu第二步确认发行版运行在 WSL 2在 PowerShell 中执行wsl --list --verbose确认VERSION是2文档示例输出NAME STATE VERSION * Ubuntu Running 2如果某个发行版还是 WSL 1转换为 WSL 2wsl --set-version Ubuntu 2建议把后续新安装的发行版默认设置为 WSL 2并更新一次 WSLwsl --set-default-version 2 wsl --update第三步可选安装 Docker Desktop 并启用 WSL 集成只有当你计划用 Docker 安装或运行 NocoBase 时才需要这一步如果直接用 Node.js 方式安装可以跳到第四步。从 Docker 官方页面下载并安装 Docker Desktop for Windows。安装时注意安装模式通常选择Per-user即可适合大多数个人开发场景配置页选择Use WSL 2 instead of Hyper-V安装完成后从 Windows 开始菜单启动 Docker Desktop首次启动时阅读并接受 Docker Desktop Subscription Service Agreement启动后确认 WSL 2 后端已启用进入「Docker Desktop / Settings / General」确认「Use the WSL 2 based engine」已打开点击「Apply」。然后开启发行版集成进入「Docker Desktop / Settings / Resources / WSL Integration」打开「Enable integration with my default WSL distro」在列表中找到你要使用的发行版比如Ubuntu并打开右侧开关点击「Apply restart」或「Apply」。验证 Docker先在 PowerShell 中执行再进入 WSLwsl后重复执行相同命令wsl --list --verbose docker version docker compose version docker run hello-world如果hello-world容器能正常拉取并运行说明 Docker Desktop 与 WSL 2 集成成功。第四步在 WSL 中安装 Node.js 22 和 Yarn 1.xWSL 本身不等于 Node.js 运行环境默认通过wsl --install安装的 Ubuntu 通常不会预装 Node.js 和 npm需要在 WSL 发行版里单独安装。NocoBase 本地开发要求 Node.js 22 和 Yarn 1.x。先从 PowerShell 进入 WSLwsl下面的命令都在 WSL 终端中执行。先检查是否已经安装node -v npm -v如果提示command not found从下面两种方式中选一种安装 Node.js 22。方式 A使用 NodeSource 安装推荐如果这台 WSL 环境只需要一个统一的 Node.js 版本推荐使用 NodeSourcesudo apt update sudo apt install -y curl curl -fsSL https://deb.nodesource.com/setup_22.x -o nodesource_setup.sh sudo -E bash nodesource_setup.sh sudo apt install -y nodejs方式 B使用 nvm 安装如果你需要在多个项目之间切换 Node.js 版本或者项目使用.nvmrc固定版本可以使用 nvmsudo apt update sudo apt install -y curl ca-certificates curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash source ~/.bashrc nvm install 22 nvm use 22如果需要项目固定 Node.js 22可以在项目根目录创建.nvmrc以后进入项目目录后执行nvm use即可切换echo 22 .nvmrc nvm install nvm use注意NodeSource 和 nvm 二选一即可不建议在同一个 WSL 用户环境里混用两套 Node.js 管理方式。安装完成后验证node -v npm -v npx -v然后安装 Yarn 1.x。Node.js 装好后可通过 Corepack 启用corepack enable corepack prepare yarn1.22.22 --activate yarn -v如果环境里没有 Corepack也可以用 npm 安装npm install -g yarn1.22.22 yarn -v第五步安装 NocoBase CLI 并初始化应用在 WSL 中全局安装 NocoBase CLInpm install -g nocobase/cli nb --version如果你会同时开多个终端或者要和 AI Agent 并行操作建议额外执行一次nb session setup让每个会话维护自己的current env避免互相影响。推荐通过 UI 向导初始化应用nb init --ui --locale zh-CN向导依次经过这几步「开始设置」——设置--env标识并选择「新安装」「应用环境信息」——设置应用的基础信息、存储位置和运行端口「应用来源和版本」——选择应用的获取方式以及要使用的来源和版本「配置数据库」——选择内置数据库或自定义数据库「创建管理员账号」——设置第一个管理员账号「连接与认证」——填写应用访问地址并选择认证方式如果更习惯终端交互可以直接运行nb init在脚本或 CI 里初始化可以用非交互模式nb init --yes --env app1第六步验证本地环境可用安装完成后确认三件事env 是否已经保存成功、应用是否已经正常启动、能否用管理员账号登录页面。常用命令nb env list nb env info nb app logs如果是本地默认安装浏览器通常可以直接打开http://localhost:13000用向导中设置的管理员账号登录即可。登录后如果要用 AI Agent 操作这个应用再新开或重启一次 AI Agent 会话。CLI 的配置默认保存在~/.nocobase/所以 AI Agent 通常可以在任意工作目录访问它。常见问题排查WSL 中提示找不到 docker 命令先确认发行版是 WSL 2wsl --list --verbose如果是 WSL 1 就转换wsl --set-version Ubuntu 2。然后回到 Docker Desktop 的「Settings / Resources / WSL Integration」打开对应发行版的集成开关并应用。WSL Integration 选项不存在通常是 Docker Desktop 当前处于 Windows containers 模式。点击 Windows 系统托盘里的 Docker 图标选择「Switch to Linux containers」等待 Docker Desktop 重启后再进入「Settings / Resources / WSL Integration」检查。Docker Desktop 启动失败或 WSL 状态异常可以先尝试wsl --shutdown wsl --update然后重新启动 Docker Desktop。WSL 里已经手动安装过 Docker EngineDocker 官方建议在安装 Docker Desktop 前卸载直接安装在 WSL Linux 发行版里的 Docker Engine 或 Docker CLI否则可能和 Docker Desktop 的 WSL 集成产生冲突。通常做法是在 WSL 发行版中卸载docker-ce、docker-ce-cli、containerd.io等包然后使用 Docker Desktop 提供的 Docker CLI 集成。项目文件放在哪里以及下一步推荐把项目放在 WSL 文件系统中比如~/projects/my-app不建议优先放在 Windows 挂载路径下如/mnt/c/Users/你的Windows用户名/projects/my-app这样通常能获得更好的文件系统性能也能减少软链接和权限问题对依赖文件较多的 Node.js 项目尤其明显。如果需要从 Windows 访问 WSL 文件可以在文件资源管理器中打开\\wsl$\Ubuntu\home\你的Linux用户名尖括号内替换为你自己的用户名。环境搭好之后按你的下一步继续管理应用的启动、停止、日志和升级见 管理应用让 AI Agent 连接并操作这个 NocoBase 应用见 AI Agent 接入指南如果这个应用后面要正式对外提供服务不建议长期直接使用IP port下一步通常是接入反向代理并启用 HTTPS部署给真实用户前先看 生产环境系统要求【免费下载链接】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），仅供参考