Pascal Editor本地部署3种方式全对比：npx CLI、Bun源码与Docker快速选型指南
【免费下载链接】editorCreate and share 3D architectural projects.项目地址: https://gitcode.com/GitHub_Trending/editor93/editor
Pascal Editor是一款免费开源的 3D 建筑编辑器，基于 React Three Fiber 与 WebGPU 构建，用来创建和分享 3D 建筑项目。本文对比Pascal Editor 本地部署的 3 种方式：npx CLI、Bun 源码运行与 Docker 容器化，帮你 5 分钟选出最合适的方案。
三种部署方式速览：一张表看懂
| 对比项 | npx CLI | Bun 源码 | Docker |
|---|---|---|---|
| 适合人群 | 新手、普通用户 | 开发者、贡献者 | 服务器/团队环境 |
| 前置要求 | Node.js 22.13+ | Bun 1.3+、Node 20.9+ | Docker |
| 是否需克隆仓库 | ❌ 不需要 | ✅ 需要 | ✅ 需要 |
| 访问地址 | http://pascal.localhost:<动态端口> | http://localhost:3002 | http://localhost:3000 |
| 数据存储 | ~/.pascal/data/pascal.db | 浏览器 IndexedDB | pascal-data数据卷 |
| 内置 MCP（AI 接入） | ✅ 自带 | ❌ | ❌ |
方式一：npx CLI 一键启动（新手首选）
这是最简单的 Pascal Editor 本地部署方式：不克隆仓库、不编译构建，一条命令即可在后台安装并启动完整编辑器。
使用步骤：
确认已安装 Node.js 22.13 或更新版本
在终端执行：
npx @pascal-app/cli editor首次运行时会自动完成：本地存储初始化 → 运行时安装 → 自动选择无冲突的本地端口 → 启动编辑器与 MCP 服务 → 健康检查，随后浏览器自动打开
http://pascal.localhost:<端口>
几个实用特性：
- 项目独立存放在本地 SQLite 数据库
~/.pascal/data/pascal.db，升级 CLI 不会覆盖你的作品 - 内置鉴权的本地 MCP 服务，可直接接入 Codex、Claude Code、Cursor 等 AI 客户端：
pascal mcp setup codex - 一键体检命令
pascal doctor可诊断 Node 环境、存储、运行时与 MCP 状态 - 支持
--no-open（无头环境）与--port <n>（指定端口）参数
CLI 的完整命令与存储参考见 packages/cli/ 目录下的 README 说明。
方式二：Bun 源码运行（开发、二开场景）
如果你想阅读源码、修改功能或参与贡献，推荐用 Bun 在本地跑开发服务器，可获取全包的实时热更新（hot reload）。
快速配置步骤：
安装 Bun 1.3+（同时需要 Node.js 20.9+）
获取源码仓库（克隆地址：https://gitcode.com/GitHub_Trending/editor93/editor ）
在仓库根目录执行：
bun install bun dev浏览器打开
http://localhost:3002即可开始建模
为什么必须从根目录运行？因为bun dev会同时构建并监听@pascal-app/core与@pascal-app/viewer两个核心包，只有根目录运行才能保证你修改packages/core/src/等目录时触发热重载。
该项目采用 Turborepo 单体仓库结构，核心模块划分如下：
packages/core：节点 Schema、场景状态（Zustand）、空间查询packages/viewer：React Three Fiber 3D 渲染运行时packages/editor：编辑工具、选区与直接操作 UIpackages/nodes：内置节点定义与渲染器apps/editor：独立的 Next.js 宿主应用
开发常用命令：bun check（Lint）、bun check-types（类型检查）、bun run test（全量测试）。详细环境配置见 SETUP.md。
方式三：Docker 容器化部署（服务器与团队环境）
在服务器上部署，或希望与本机开发环境完全隔离时，Docker 是最省心的选择——一条命令完成生产级构建与启动。
一键安装步骤：
获取源码仓库（克隆地址：https://gitcode.com/GitHub_Trending/editor93/editor ）
在项目根目录执行：
docker compose up -d浏览器访问
http://localhost:3000
两个关键注意事项：
- 端口必须保持 3000。
/scenes页面通过构建时内联的 URL 调用自身 API，把宿主机端口映射成其他值会导致页面返回 500 - 数据保存在
pascal-data数据卷中，即使执行docker compose down，已保存的场景也不会丢失
如果要在非本地域名托管，可通过环境变量MINT_PASCAL_HOST_ORIGIN覆盖公共访问源（例如自签名的 HTTPS 域名）。编排细节见项目根目录的 docker-compose.yml 与 Dockerfile。
怎么选？按场景直接抄作业
- 只想体验、建模、分享项目→ npx CLI，零配置、带 AI MCP，5 分钟上手
- 想改代码、研究 WebGPU 渲染架构、提 PR→ Bun 源码，享受全仓库热重载
- 团队共用一台服务器、或需要生产化运行→ Docker，环境一致、数据卷持久化
💡 小贴士：三种方式的数据彼此独立，建议先从 npx CLI 开始体验，等熟悉了 3D 建筑建模工作流后再切换到源码模式深入定制。
【免费下载链接】editorCreate and share 3D architectural projects.项目地址: https://gitcode.com/GitHub_Trending/editor93/editor
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
