PlotVault PDM

PlotVault PDM 安装部署指南 本文档介绍如何部署 PlotVault PDM 后端服务。PlotVault 支持多种部署方式，推荐使用 Docker Compose 进行一键部署。 前置要求 Docker 和 Docker Compose 至少 1GB 的磁盘空间 网络连接（用于拉取镜像） 方式 A：Docker Compose（推荐） 这是最简单的部署方式，只需几步即可完成。 步骤 1：准备配置文件 从仓库复制 docker-compose.yml 文件到你的部署目录： 1 2 git clone https://github.com/donniemarc/plotvault-PDM.git cd plotvault-PDM 步骤 2：配置环境变量 编辑 docker-compose.yml，替换所有 <...> 占位符： 占位符 说明 示例值 <DOCKERHUB_USER> Docker Hub 用户名 donniemarc <数据库密码> PostgreSQL 数据库密码 your_secure_password <API_TOKEN> 客户端连接用的访问令牌 your_api_token <HOST_PORT> 对外端口 8642 <DATA_HOST_PATH> 图纸数据宿主目录 /home/user/plotvault/data <CONFIG_HOST_PATH> 软件缓存宿主目录 /home/user/plotvault/config <PGDATA_HOST_PATH> 数据库数据宿主目录 /home/user/plotvault/pgdata 步骤 3：启动服务 1 docker compose up -d 启动后将运行三个容器： ...

PlotVault PDM 使用说明 本文档介绍如何使用 PlotVault PDM 桌面客户端来管理你的图纸文件。 客户端安装 Windows 客户端构建 在一台 Windows PC 上构建一次即可（安装包可分发给其他机器）。 前置要求： Rust（MSVC 工具链 + Visual Studio Build Tools C++ 工作负载） Node.js 18+ WebView2 运行时（Win10/11 一般自带） 构建步骤： 1 2 3 cd client npm install npm run tauri build 产物位于 client/src-tauri/target/release/bundle/。 开发调试： 1 2 cd client npm run tauri dev 首次连接 启动客户端 点击右上角 设置 按钮 填入服务器地址：http://<主机IP>:8642 填入 API Token（与服务端配置的 token 一致） 点击 测试连接 确认连接成功 点击 保存 基础操作 文件夹树 左侧显示文件夹树结构，点击文件夹可展开或收起子目录。 ...

PlotVault PDM 配置说明 本文档介绍 PlotVault PDM 的各项配置参数。 环境变量 核心配置 变量名 默认值 说明 DATA_DIR /data 图纸数据目录（library 真实目录 + blobs 版本归档），主机上可直接浏览 CONFIG_DIR /config 软件缓存目录（dxf_cache + tmp） DATABASE_URL postgres://postgres:postgres@localhost:5432/plotvault_pdm PostgreSQL 连接串（compose 里指向 db 容器） BIND 0.0.0.0:8642 监听地址 API_TOKEN 空 设置后所有 API 需 Authorization: Bearer <token> 即使是局域网私有环境，也建议设置 API_TOKEN。 Docker Compose 配置示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 version: '3.8' services: db: image: postgres:18 environment: POSTGRES_DB: plotvault_pdm POSTGRES_USER: postgres POSTGRES_PASSWORD: <数据库密码> volumes: - <PGDATA_HOST_PATH>:/var/lib/postgresql/data healthcheck: test: ["CMD-SHELL", "pg_isready -U postgres"] interval: 5s timeout: 5s retries: 5 plotvault-pdm: image: <DOCKERHUB_USER>/plotvault-pdm-server:latest depends_on: db: condition: service_healthy ports: - "<HOST_PORT>:8642" environment: DATABASE_URL: postgres://postgres:<数据库密码>@db:5432/plotvault_pdm API_TOKEN: <API_TOKEN> DATA_DIR: /data CONFIG_DIR: /config BIND: 0.0.0.0:8642 volumes: - <DATA_HOST_PATH>:/data - <CONFIG_HOST_PATH>:/config converter: image: <DOCKERHUB_USER>/plotvault-pdm-converter:latest ports: - "8000:8000" 数据目录结构 DATA_DIR（图纸数据） data/ ├── library/ # 真实目录结构，与客户端看到的文件夹树一致 │ ├── 项目A/ │ │ ├── 零件1.step │ │ └── 零件1.step │ └── 项目B/ │ └── 图纸1.dwg └── blobs/ # 版本归档 ├── v1/ │ └── <hash> └── v2/ └── <hash> CONFIG_DIR（软件缓存） config/ ├── dxf_cache/ # DWG 转 DXF 的缓存 └── tmp/ # 临时文件 安全建议 1. 设置 API Token 即使在局域网环境，也建议设置 API Token： ...