Pascal Editor Docker数据持久化pascal-data卷与场景数据保障【免费下载链接】editorOpen-source 3D architectural editor with a local CLI, MCP tools, and practical workflows for humans and AI agents.项目地址: https://gitcode.com/GitHub_Trending/editor93/editorPascal Editor 是一款开源 3D 建筑编辑器支持用 Docker 一键部署到自托管服务器。本文将带你理解 Docker 数据持久化的核心机制——pascal-data命名卷以及它如何保障你的场景数据在容器重建、升级、停机后依然安全可用避免容器一删、项目全丢的常见坑。为什么 Docker 部署必须关心数据持久化容器有一个天性易失。容器内部的文件系统属于临时层一旦执行docker compose down或删除重建容器容器内写入的文件会随之消失。如果场景数据直接写在容器的文件系统里你花几个小时搭建的 3D 户型、摆放的家具、绘制的墙体都会在一次例行升级后灰飞烟灭。Pascal Editor 的官方 Docker 方案通过一个命名卷named volume彻底解决了这个问题 ️。pascal-data 卷三层配置共同生效数据持久化不是靠一行配置完成的而是由三个文件层层配合Dockerfile— 在镜像构建阶段声明/data目录为VOLUME并赋予运行时用户bun写权限保证场景数据库在首次写入时能顺利创建docker-compose.yml— 定义PASCAL_DATA_DIR: /data环境变量并把命名卷pascal-data挂载到容器的/datasqlite-scene-store.ts— 运行时根据PASCAL_DATA_DIR环境变量把 SQLite 数据库落到/data/pascal.db。场景数据到底存在哪里所有已保存场景都以结构化数据节点、材质、集合、安装的插件等写入 SQLite 数据库文件pascal.db。数据库路径的解析优先级为PASCAL_DB_PATH→PASCAL_DATA_DIR/pascal.db→ 系统默认用户目录。Docker 部署时通过PASCAL_DATA_DIR/data命中第二级数据因此落在命名卷中而不是容器临时层。一键部署最快配置方法在仓库根目录执行docker compose up -d完成后编辑器运行在http://localhost:3000。注意两点容器端口必须保持 3000/scenes页面在构建期内联了自身 API 的基础 URL把宿主端口重映射到别的值会导致页面 500自定义部署域名如MINT_PASCAL_HOST_ORIGINhttps://pascal.example.com docker compose up -d用于 Mint 登录与同源检查。更多说明见 SETUP.md 的 Docker 章节。如何验证场景数据不会被丢失官方文档明确承诺已保存场景位于pascal-data卷中docker compose down后依然存活。你可以这样验证保存一个包含墙体、房间和家具的场景执行docker compose down注意是down不要加down -v-v会连带删除卷再次docker compose up -d打开/scenes页面确认场景仍在 ✅日常升级重新docker compose buildup -d同样安全——卷与镜像解耦重建只替换代码层数据层原封不动。常见问题FAQ问忘记挂载卷会怎样容器内仍会创建pascal.db但写入的是容器临时层容器重建即丢失。这正是 docker-compose.yml 注释中警告的情况。问pascal-data卷和数据卷有什么区别命名卷由 Docker 统一管理生命周期docker compose down默认不删除它而绑定挂载依赖宿主机目录路径可移植性较差。问非 Docker 场景下数据存在哪本地 CLI 运行时场景保存在~/.pascal/data/pascal.db与运行时版本相互独立同样支持回滚旧版本而不丢数据见 SETUP.md。相关资源部署文档SETUP.md镜像构建与数据卷声明Dockerfile场景存储与数据库路径解析packages/mcp/src/storage/sqlite-scene-store.ts场景存储服务端封装apps/editor/lib/scene-store-server.ts掌握pascal-data卷后你就可以放心地在生产环境长期运行 Pascal Editor——代码随便升级场景数据稳稳落盘 。【免费下载链接】editorOpen-source 3D architectural editor with a local CLI, MCP tools, and practical workflows for humans and AI agents.项目地址: https://gitcode.com/GitHub_Trending/editor93/editor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考