Outline Backup 备份你的Outline笔记

# Outline Backup 系统 - 使用攻略  ## 📚 目录 - [系统简介](#系统简介) - [快速开始](#快速开始) - [功能详解](#功能详解) - [1. 登录系统](#1-登录系统) - [2. 配置 Outline 服务器](#2-配置-outline-服务器) - [3. 配置 WebDAV 存储](#3-配置-webdav-存储) - [4. 执行手动备份](#4-执行手动备份) - [5. 设置定时任务](#5-设置定时任务) - [7. 修改密码](#6-修改密码) - [常见使用场景](#常见使用场景) - [常见问题](#常见问题) --- ## 系统简介 **Outline Backup** 是一个专业的 Outline 知识库备份管理系统，提供以下核心功能： ✨ **核心特性** - 🔄 自动/手动备份 Outline 文档 - ☁️ WebDAV 云存储支持（坚果云、Nextcloud、群晖 NAS 等） - 🔒 AES-256-GCM 加密保护 - ⏰ 灵活的定时任务 - 📊 完整的备份历史记录 --- ## 快速开始 ### 📱 访问系统 https://appstore.lazycat.cloud/#/shop/detail/app.tx1ee.outlinebackup 打开浏览器访问系统地址 **默认账户** - 用户名: `admin` - 密码: `admin` > ⚠️ **安全提示**: 首次登录后请立即修改默认密码！ 当然你也可以使用单点登录，这里使用的是懒猫的OIDC认证。 --- ## 功能详解 ### 1. 登录系统 #### 1.1 账号密码登录 1. 打开浏览器访问系统地址 2. 输入用户名和密码 3. 点击「登录」按钮  --- ### 2. 配置 Outline 服务器 > 📍 **导航路径**: 侧边栏 → Outline 设置 #### 2.1 获取 Outline API Key 1. 登录你的 Outline 系统 2. 进入 **设置 → API** 3. 点击「创建新的 API 密钥」 4. 复制生成的密钥  #### 2.2 填写配置信息 在 Outline 配置页面填写以下信息： | 字段 | 说明 | 示例 | |------|------|------| | **Outline URL** | Outline 服务器地址 | `https://outline.example.com` | | **API Key** | Outline API 密钥 | `ol_api_xxxxxxxxxxxxx` |  #### 2.3 测试并保存 1. 填写完成后，点击「测试连接」按钮 - ✅ **成功**: 显示「连接成功」提示 - ❌ **失败**: 检查 URL 格式和 API Key 是否正确 2. 确认连接成功后，点击「保存配置」按钮 --- ### 3. 配置 WebDAV 存储 > 📍 **导航路径**: 侧边栏 → WebDAV 配置 WebDAV 是用于存储备份文件的云存储协议，支持大多数网盘服务。 #### 3.1 支持的 WebDAV 服务 | 服务商 | WebDAV 地址示例 | |--------|----------------| | **坚果云** | `https://dav.jianguoyun.com/dav/` | | **Nextcloud** | `https://cloud.example.com/remote.php/dav/files/username/` | | **ownCloud** | `https://owncloud.example.com/remote.php/webdav/` | | **Synology NAS** | `https://nas.example.com:5006/` | | **群晖 NAS** | `http://192.168.1.100:5005/` >当然还支持懒猫的webdav #### 3.2 添加 WebDAV 配置 点击「添加配置」按钮，填写以下信息： | 字段 | 说明 | 示例 | |------|------|------| | **配置名称** | 自定义名称 | `我的坚果云` | | **WebDAV URL** | 服务器地址 | `https://dav.jianguoyun.com/dav/` | | **用户名** | WebDAV 账号 | `user@example.com` | | **密码** | WebDAV 密码 | `••••••••` | | **备份目录** | 远程存储路径 | `/outline-backups/` | #### 3.3 坚果云配置示例  > 💡 **提示**: 坚果云需要在设置中生成应用密码，不能使用登录密码 #### 3.4 测试并保存 1. 保存前点击「测试连接」，确保配置正确 - ✅ 连接成功: 可以创建目录和写入文件 - ❌ 连接失败: 检查 URL、用户名、密码是否正确 2. 点击「保存」按钮 #### 3.5 管理多个 WebDAV 配置 系统支持配置多个 WebDAV 存储，每次备份时可选择目标存储。 ``` WebDAV 配置列表 ┌────────────────────────────────────────────────┐ │ 名称 │ URL │ 操作 │ ├────────────────────────────────────────────────┤ │ 我的坚果云 │ dav.jianguoyun.com │ [编辑][删除] │ │ 公司NAS │ 192.168.1.100:5005 │ [编辑][删除] │ │ Nextcloud │ cloud.example.com │ [编辑][删除] │ └────────────────────────────────────────────────┘ [+ 添加配置] ``` --- ### 4. 执行手动备份 > 📍 **导航路径**: 侧边栏 → 手动备份 #### 4.1 配置备份选项 在手动备份页面，可以配置以下选项： | 选项 | 说明 | 建议 | |------|------|------| | **备份类型** | 全量/增量备份 | 首次选择「全量备份」 | | **存储方式** | 安全存储/加密存储 | **敏感数据选择「加密存储」** | | **加密密码** | 用于加密备份文件 | 使用强密码（16位以上） | | **WebDAV 目标** | 上传到的存储位置 | 选择已配置的 WebDAV | | **备份范围** | 全部文档/指定集合 | 根据需要选择 |  #### 4.2 执行备份 1. 点击「开始备份」按钮 2. 系统显示备份进度条 3. 等待备份完成（时间取决于数据量）  #### 4.3 下载备份文件 点击备份记录的「下载」按钮，可以下载备份文件到本地。 - **安全存储**: 下载 `.zip` 格式压缩包，可直接解压使用 - **加密存储**: 下载 `.zip` 格式加密文件，需使用设置的密码进行解密 --- ### 5. 设置定时任务 > 📍 **导航路径**: 侧边栏 → 定时任务 #### 5.1 创建定时任务 点击「新建任务」，配置自动备份计划： | 字段 | 说明 | 示例 | |------|------|------| | **任务名称** | 自定义名称 | `每日凌晨备份` | | **执行时间** | Cron 表达式 | `0 2 * * *` | | **备份类型** | 全量/增量 | `增量备份` | | **存储方式** | 安全/加密 | `加密存储` | | **WebDAV** | 存储位置 | `我的坚果云` | | **启用状态** | 开/关 | ✅ 启用 | #### 5.2 Cron 表达式示例 **常用时间表达式:** | 表达式 | 说明 | 执行时间 | |--------|------|----------| | `0 2 * * *` | 每天凌晨 2 点 | 02:00 | | `0 */6 * * *` | 每 6 小时 | 00:00, 06:00, 12:00, 18:00 | | `0 0 * * 0` | 每周日午夜 | 周日 00:00 | | `30 1 1 * *` | 每月 1 号 1:30 | 每月 1 日 01:30 | | `0 9-18 * * 1-5` | 工作日 9-18 点整点 | 周一到周五，每小时 | > 💡 **提示**: 可以使用在线工具 https://crontab.guru/ 验证 Cron 表达式 #### 5.3 定时任务配置界面  #### 5.4 管理定时任务 ``` 定时任务列表 ┌─────────────────────────────────────────────────────────────┐ │ 任务名称 │ 执行时间 │ 下次执行 │ 状态 │ 操作 │ ├─────────────────────────────────────────────────────────────┤ │ 每日凌晨备份 │ 0 2 * * * │ 2025-12-18 02:00│ 启用 │[编辑][删除][执行]│ │ 每周全量备份 │ 0 0 * * 0 │ 2025-12-21 00:00│ 启用 │[编辑][删除][执行]│ │ 每月归档 │ 0 0 1 * * │ 2026-01-01 00:00│ 禁用 │[编辑][删除][执行]│ └─────────────────────────────────────────────────────────────┘ [+ 新建任务] ``` #### 5.5 立即执行任务 点击任务的「执行」按钮，可以手动触发定时任务，无需等待计划时间。 --- ### 6. 修改密码 > 📍 **导航路径**: 侧边栏 → 修改密码 #### 6.1 修改登录密码 ``` 修改密码 ┌──────────────────────────────────────────────┐ │ 当前密码: │ │ ┌────────────────────────────────────────┐ │ │ │ •••••••• │ │ │ └────────────────────────────────────────┘ │ │ │ │ 新密码: │ │ ┌────────────────────────────────────────┐ │ │ │ •••••••••••••••• │ │ │ └────────────────────────────────────────┘ │ │ 密码强度: ▓▓▓▓▓▓▓▓░░ 强 │ │ │ │ 确认新密码: │ │ ┌────────────────────────────────────────┐ │ │ │ •••••••••••••••• │ │ │ └────────────────────────────────────────┘ │ │ │ │ [确认修改] [取消] │ └──────────────────────────────────────────────┘ ``` **密码安全要求:** - ✅ 至少 8 位字符 - ✅ 包含大小写字母 - ✅ 包含数字 - ✅ 建议包含特殊字符 --- ## 常见使用场景 ### 场景 1: 首次使用，进行初始备份 ``` 第一步: 配置 Outline → 进入 "Outline 配置" → 填写 URL 和 API Key → 测试连接并保存 第二步: 配置 WebDAV → 进入 "WebDAV 配置" → 添加存储配置（例如坚果云） → 测试连接并保存 第三步: 执行备份 → 进入 "手动备份" → 选择 "全量备份" → 选择 "加密存储" → 设置强密码（务必记住！） → 开始备份 第四步: 验证备份 → 查看备份历史 → 确认备份成功 → 测试下载文件 ``` --- ### 场景 2: 设置每日自动备份 ``` 第一步: 创建定时任务 → 进入 "定时任务" → 点击 "新建任务" → 任务名称: "每日自动备份" 第二步: 配置时间 → Cron 表达式: 0 2 * * * → 说明: 每天凌晨 2:00 执行 第三步: 配置备份 → 备份类型: 增量备份 → 存储方式: 加密存储 → 加密密码: (使用强密码并妥善保管) → WebDAV: 选择已配置的存储 第四步: 启用任务 → 勾选 "启用" → 保存任务 → 手动执行测试一次 ``` --- ### 场景 3: 定期清理旧备份 ``` 第一步: 查看备份历史 → 进入 "手动备份" → 查看备份列表 第二步: 删除旧备份 → 找到不需要的旧备份 → 点击 "删除" 按钮 → 确认删除 第三步: 整理 WebDAV 存储 → 定期清理 WebDAV 中的旧文件 → 释放存储空间 ``` --- ## 常见问题 ### ❓ 问题 1: 无法连接到 Outline **症状**: 测试连接失败，提示 "连接超时" 或 "无法访问" **解决方法**: 1. 检查 Outline URL 是否正确（需要包含 `https://`） 2. 确认 API Key 没有复制错误（注意前后空格） 3. 重新生成 API Key 后再试 4. 检查Outline API KEY作用域是否填写正确 --- ### ❓ 问题 2: WebDAV 上传失败 **症状**: 备份完成但提示 "上传到 WebDAV 失败" **常见原因和解决方法**: | 原因 | 解决方法 | |------|----------| | **坚果云密码错误** | 使用应用密码，不是登录密码 | | **目录格式错误** | 确保路径以 `/` 开头和结尾，如 `/outline-backups/` | | **网络问题** | 检查网络连接，重新测试 | **坚果云正确配置**: ``` ✅ URL: https://dav.jianguoyun.com/dav/ ✅ 用户名: 邮箱地址 ✅ 密码: 应用密码（在坚果云设置中生成） ✅ 目录: /outline-backups/ ``` --- ### ❓ 问题 3: 定时任务不执行 **症状**: 定时任务已启用，但到了时间没有执行 **解决方法**: 1. 检查任务是否已启用（勾选框是否打钩） 2. 查看"下次执行"时间是否正确 3. 使用 https://crontab.guru/ 验证 Cron 表达式 4. 点击"执行"按钮手动测试任务 --- ### ❓ 问题 4: 忘记登录密码 **症状**: 无法登录系统 **解决方法**: 1. 联系系统管理员重置密码 2. 管理员可以通过命令行重置: ```bash # 进入应用容器 ./reset_admin ``` 3. 重置后密码恢复为默认值: `admin` 4. 登录后立即修改密码 --- ### 💾 备份建议 **1. 备份频率** - 重要数据: 每天备份 - 一般数据: 每周备份 - 归档数据: 每月全量备份 **2. 备份策略** - 平时使用增量备份（省空间） - 定期执行全量备份（便于恢复） - 重要更新后手动备份一次 **3. 存储管理** - 配置至少 2 个 WebDAV 存储（异地备份） - 定期下载重要备份到本地 - 每月清理过期的旧备份 - 保留最近 7 天的每日备份 - 保留最近 4 周的每周备份 - 保留最近 12 个月的每月备份 **4. 数据安全** - 敏感数据必须使用加密存储 - 定期测试解密和恢复流程 - 妥善保管加密密码 --- **🎉 祝您使用愉快！如有问题可以留言或者微信群联系我。**