Outline Backup 系统 - 使用攻略

📚 目录

• 系统简介
• 快速开始
• 功能详解
  • 1. 登录系统
  • 2. 配置 Outline 服务器
  • 3. 配置 WebDAV 存储
  • 4. 执行手动备份
  • 5. 设置定时任务
  • 7. 修改密码
• 常见使用场景
• 常见问题

---

系统简介

Outline Backup 是一个专业的 Outline 知识库备份管理系统，提供以下核心功能：

✨ 核心特性

• 🔄 自动/手动备份 Outline 文档
• ☁️ WebDAV 云存储支持（坚果云、Nextcloud、群晖 NAS 等）
• 🔒 AES-256-GCM 加密保护
• ⏰ 灵活的定时任务
• 📊 完整的备份历史记录

---

快速开始

📱 访问系统

打开浏览器访问系统地址

默认账户

• 用户名: 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. 管理员可以通过命令行重置:

   # 进入应用容器
   ./reset_admin
   

3. 重置后密码恢复为默认值: admin
4. 登录后立即修改密码

---

💾 备份建议

1. 备份频率

• 重要数据: 每天备份
• 一般数据: 每周备份
• 归档数据: 每月全量备份

2. 备份策略

• 平时使用增量备份（省空间）
• 定期执行全量备份（便于恢复）
• 重要更新后手动备份一次

3. 存储管理

• 配置至少 2 个 WebDAV 存储（异地备份）
• 定期下载重要备份到本地
• 每月清理过期的旧备份
• 保留最近 7 天的每日备份
• 保留最近 4 周的每周备份
• 保留最近 12 个月的每月备份

4. 数据安全

• 敏感数据必须使用加密存储
• 定期测试解密和恢复流程
• 妥善保管加密密码

---

🎉 祝您使用愉快！如有问题可以留言或者微信群联系我。