★ FEATURED ARTICLE 【免费下载链接】poznotePowerful note-taking without the hassle.项目地址https://gitcode.com/gh_mirrors/po/poznote点击查看免费下载Poznote 是一款免费、自托管、开源的笔记应用而Poznote 备份是每位自建用户必须掌握的基本功。本文带你完整掌握 Poznote 备份与灾难恢复的全部玩法手动导出 ZIP、服务器本地定时备份、S3 存储桶备份、脚本 cron 自动化以及数据丢失后如何用备份一键回滚最后还包括管理员专属的“重建主数据库”灾难恢复操作。Poznote 备份包里到底有什么Poznote 的四种备份方式产出的都是同一种 ZIP 归档内部结构统一内容说明database/poznote_backup.sql当前用户的 SQLite 数据库转储笔记文件按工作区workspace和文件夹组织的 Markdown / HTML 笔记附件图片、PDF、音频等可点击链接访问index.html归档根目录的离线浏览入口有两个关键区别需要分清按用户备份上述 ZIP 只包含单个账户的数据。每个用户都能备份和恢复自己的账户管理员可以指定任意账户。完整系统备份包含主配置账户、全局设置、共享链接和所有用户。做法是直接打包整个数据目录tar -czvf poznote-full-backup.tar.gz data/另外恢复流程对 SQL 转储做了严格校验只接受 DROP/CREATE TABLE、INSERT 等安全语句并禁止ATTACH、PRAGMA等危险操作见 backup_sql_restore.php不用担心恶意或损坏的备份文件破坏服务器。方法一手动备份一键下载 ZIP最简单的起点适合初次体验和数据量不大的场景打开Settings Backup / Export设置 备份/导出点击 Complete Backup完整备份等待进度条走完浏览器自动开始下载poznote_backup_用户名_时间戳.zip。几个值得了解的细节归档由后台 worker 进程构建而不是在 HTTP 请求里同步生成所以大账户也不会撞上浏览器或反向代理超时中途离开页面也没关系准备完成后下载会自动开始。生成好的归档在服务器上保留24 小时可随时重新下载也可以点按钮立刻删除。解压后直接用浏览器打开index.html即可得到一个只读的离线笔记站点——出差、断网时照样能翻阅。如果只是想把单篇笔记带走用笔记工具栏的Export按钮即可富文本笔记可导出 HTML 或内嵌图片的单文件 HTMLMarkdown 笔记可导出 Markdown / HTML任务列表还额外支持原始 JSON 导出。方法二定时备份到服务器本地文件夹推荐日常方案这是“零外部依赖”的自动备份方案不需要对象存储、不需要 cron、不需要脚本全部在 Poznote 内部完成。配置入口在Settings Local Backups仅管理员可见前端逻辑见 local_backup_settings.php。配置项一览选项说明Backup folder服务器上的绝对路径留空则默认存到data/backups已包含在数据卷中用户选择勾选需要备份的用户默认全选且全选状态下新账户自动纳入Back up now手动触发逐个用户生成最新归档即使自动备份关闭也能用自动备份频率每天 / 每周 / 每月每月按 30 天计启用后几分钟内就会跑第一次保留份数每个用户只保留最近 N 份旧的自动从文件夹删除填 0 表示全部保留补充要点归档按{user id}/子目录存放页面里可直接下载或删除想把备份放到另一块硬盘或 NAS 上在容器里挂载共享目录然后把容器内路径填进 Backup folder 即可例如volumes: - ./data:/var/www/html/data - /mnt/nas/poznote-backups:/backups若附件存放在 S3S3 Attachment Storage它们会在备份时从存储桶实时拉取并打包进去注意删除某个账户时其备份归档也会一并删除服务实现位于 LocalBackupService.php。方法三定时备份到 S3 存储桶异地容灾首选本地备份的归档和 Poznote 在同一台服务器上遇到磁盘故障就全没了。把备份送到 S3 兼容存储桶才是真正的容灾。配置入口在Settings S3 Backups仅管理员页面实现见 s3_backup_settings.php。核心能力独立配置S3 备份的桶与“S3 附件存储”互不干扰可以指向不同的提供商或桶连接配置Endpoint URL、Region、Bucket、Access Key、Secret Key内置一键连接测试Endpoint 示例https://s3.amazonaws.com、http://minio:9000主开关 自动备份与本地备份相同的频率选项和保留策略归档存放在桶内backups/{user id}/路径下用户自助桶配置完成后每个普通用户的备份页也会出现 “S3 Backups” 区块可以自行上传、下载、删除自己账户的归档恢复页还有 “Restore from S3” 直接从桶恢复租户隔离可通过两个开关“备份页面上的 S3 备份”“恢复页面上的 S3 恢复”对非管理员关闭自助功能服务端强制执行直接调 API 也会被拒绝。 小贴士附件本就在 S3 上时可勾选“不打包附件”选项让归档更小、备份更快。方法四脚本 cron 完全自动化如果你希望在 Poznote 所在机器之外另一台服务器、CI 任务拉取备份仓库自带了一个 Bash 脚本backup-poznote.sh。⚠️ 注意通过 API 创建备份仅限管理员。密码要用你用于 API 认证的管理员账户的当前密码全新安装未改过密码时默认密码是admin。基本用法无需知道用户 ID填用户名即可# 备份自己的账户 bash backup-poznote.sh https://poznote.example.com admin admin_password admin /backups 30 # 管理员备份其他用户Nina的账户 bash backup-poznote.sh https://poznote.example.com admin admin_password Nina /backups 30参数说明Poznote 地址管理员用户名管理员密码目标用户名备份父目录保留份数。脚本的完整工作流用管理员凭据认证并校验is_admin通过/api/v1/users/lookup/用户名自动解析目标用户 ID调用POST /api/v1/backups带X-User-ID头创建备份把 ZIP 下载到本地backups-poznote-用户名/目录用file命令校验下载文件确实是合法 ZIP本地保留最近 N 份并顺手清理服务器上的旧备份超过 N 份时通过 API 删除。配合 crontab 即可实现定时任务例如每天 0 点和 12 点各备份一次0 0,12 * * * bash /root/backup-poznote.sh https://poznote.example.com admin admin_password Nina /root/backups 30回滚实操从备份恢复数据的 3 条路径备份只有能恢复才有意义。Poznote 的恢复入口统一在Settings Restore / Import设置 恢复/导入页面为 restore_import.php路径 1上传 ZIP 完整恢复最常用上传任意一种方式生成的备份 ZIP即可替换该用户的数据库、恢复全部笔记和附件所有工作区一次到位上传采用分片传输失败的片会自动重试而不是整包重来服务端重组后由后台 worker 解压恢复浏览器全程显示进度条上传 → 解压 → 数据库 → 笔记 → 附件没有实际大小上限恢复完成后 Poznote 会让你选择要打开的工作区。路径 2从 S3 桶直接恢复如果开启了 S3 备份恢复页会出现 “Restore from S3” 区块直接从桶里选一个归档恢复同样走后台任务大文件拉取不怕超时。路径 3SSH 直传兜底如果连上传都做不到比如 Web 入口受限可以通过 SSH 把归档文件复制到容器内精确路径/tmp/backup_restore.zip然后刷新恢复页从该文件恢复。灾难恢复重建主数据库管理员专属极端情况下——master.db存储账户信息、公开共享链接、全局设置的主数据库丢失或损坏或者恢复备份后某些公开链接失灵——管理员还有一个兜底工具以管理员登录进入Settings 维护Maintenance Disaster Recovery灾难恢复卡片弹窗即 “Rebuild Master Database”重建主数据库点击Rebuild工具会扫描data/users目录自动重新注册所有账户、从各用户的个人数据库恢复真实姓名并重建全部公开共享链接弹窗实现见 settings.php旧的独立页面 disaster-recovery.php 会重定向到这里。建议的操作顺序先做完整系统备份打包data/目录→ 恢复 → 如共享链接异常 → 跑一次重建。此外恢复、删除账户、清空回收站等敏感操作都会记录在Activity Log活动日志中方便事后审计。4 种方法怎么选一张表帮你决定方案权限要求自动化异地容灾适合场景手动 ZIP 下载每个用户❌取决于你存哪偶发导出、迁移前存档本地定时备份管理员✅ 每日/每周/每月❌ 同机日常保底、快速回滚S3 定时备份管理员✅ 每日/每周/每月✅ 异地生产环境主力容灾脚本 cron管理员API✅ 完全自定义✅ 异地多实例、CI 集成、精细控制推荐组合S3 定时备份每日保留 14 份作为主力 每月一次完整data/目录打包存档 每次大更新前手动 ZIP 备份一份。遵循“备份至少存两份、其中一份在异地”的原则你的 Poznote 数据就有了真正的安全底线。更多细节可参考仓库 README.md 的 “Backup / Export” 与 “Restore / Import” 章节以及 API-REST.md 中关于/api/v1/backups接口的说明。赞分享【免费下载链接】poznotePowerful note-taking without the hassle.项目地址https://gitcode.com/gh_mirrors/po/poznote点击查看免费下载相关推荐如何为btrfs-progs贡献代码内核风格开发流程与CI测试完全指南如何为btrfs progs贡献代码内核风格开发流程与CI测试完全指南 btrfs progs 是 Linux 下管理 btrfs 文件系统的用户态工具集包存储运维加密货币交易的AI革命awesome-deep-trading中的区块链量化策略终极指南 加密货币交易的AI革命awesome deep trading中的区块链量化策略终极指南 在当今快速发展的数字资产市场中 加密货币交易的AI革命 正在PhpRedis备份与恢复策略自动化脚本与灾难恢复PhpRedis备份与恢复策略自动化脚本与灾难恢复 你是否曾因Redis数据丢失而导致服务中断是否在手动备份时因操作失误造成数据损坏本文将通过PhpRed后端上一篇昇腾GE获取C图构建器API下一篇终极指南如何使用 Riverpod 实现 Flutter 高效状态管理创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
