
Openship桌面应用本地数据管理位置、备份与迁移完整指南【免费下载链接】openshipSelf-hosted deployment platform项目地址: https://gitcode.com/GitHub_Trending/ope/openshipOpenship 是一个开源的自托管部署平台self-hosted deployment platform内置 CI/CD可以指向代码仓库完成构建、部署、路由与 TLS 证书管理。它的 Openship 桌面应用把整套控制平面API 仪表盘 内嵌数据库都跑在你自己的电脑上只有打开应用时服务才运行。搞清楚Openship 桌面应用本地数据存在哪里、怎么备份、如何迁移到新电脑是每个单机用户必懂的三件事。本指南用最短的篇幅讲清这三点。Openship 桌面应用的数据存放位置桌面应用基于 Electron 构建所有用户数据都放在 Electron 标准的userData 目录下不同系统路径如下操作系统本地数据目录 macOS~/Library/Application Support/Openship Windows%APPDATA%\Openship Linux~/.config/Openship目录中的核心内容data/—— 最重要的部分。这是PGlite 内嵌数据库的数据目录存放项目、服务器连接、部署记录等全部业务数据。桌面端启动时通过环境变量PGLITE_DATA_DIR把它指向该目录见 services.ts。config.json—— 应用的最小化 JSON 配置。ports.json—— 记住上次使用的 API/仪表盘端口。端口稳定是登录状态跨重启存活的关键会话 Cookie 绑定在localhost:端口上见 services.ts。auth-secret—— 首次启动生成并持久化的会话密钥保证重启后登录不被作废。 顺带一提如果你用的是 CLI / 自托管模式openship up内嵌数据库默认在~/.openship/data可用PGLITE_DATA_DIR覆盖逻辑见 client.tsCLI 的连接上下文存在~/.openship/config.json与桌面应用目录相互独立。三步完成 Openship 本地数据备份PGlite 的数据目录就是一个可整体拷贝的文件夹备份思路非常直接完全退出 Openship 桌面应用托盘图标也要退出。PGlite 是单写者数据库同一时刻只允许一个进程打开数据目录应用运行中拷贝容易得到不一致的数据。把整个 userData 目录打包例如 macOS 上压缩~/Library/Application Support/Openship。重点保障data/子目录完整auth-secret、ports.json建议一并保留。把压缩包放到异地网盘、外置硬盘均可。data/目录通常只有几十到几百 MB备份频率建议每周一次或在批量删除项目前立即做一次。 防误删提醒数据目录里有postmaster.pid这类内部文件不要手动删除data/里的任何内容应用重启时会自动处理陈旧的锁状态见 pglite-lock.ts 的锁机制说明。如何把 Openship 数据迁移到新电脑迁移本质上是把旧机器的数据目录还原到新机器的相同位置在新电脑安装同版本或更高版本的 Openship 桌面应用首次启动一次后再完全退出让目录结构初始化完成。关闭新电脑上的应用将旧机器备份的 userData 目录内容整体复制到新系统对应路径data/、config.json、auth-secret、ports.json全部覆盖。重新启动应用项目、服务器连接、部署历史即完整恢复。常见问题版本兼容数据库迁移migrations在启动时自动向前执行见 client.ts 的说明因此旧数据 → 新版本应用没有问题反向用新数据装旧版本则不受支持。登录状态桌面模式默认免登录仅绑定本机回环地址一般直接可用ports.json缺失时应用会重新分配端口只是可能需要重新登录一次数据不受影响。注意区分迁移对象迁移桌面应用只迁移控制平面数据。你部署到远程服务器的应用本身、服务器上的数据与证书都在目标服务器上与桌面电脑无关。相关资料桌面端服务启动与数据目录逻辑apps/desktop/src/main/services.tsPGlite 数据目录解析规则packages/db/src/client.ts数据库单进程锁机制packages/db/src/pglite-lock.ts打包配置userData 之外还包含哪些资源forge.config.js完整安装文档docs/installation.md掌握以上三点你就完全可以自主管理 Openship 桌面应用的本地数据——放心重装系统也不怕数据丢失。【免费下载链接】openshipSelf-hosted deployment platform项目地址: https://gitcode.com/GitHub_Trending/ope/openship创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考