Skip to content
Dinox AI笔记

🖥️ 存储设置

存储设置使用指南

📖 什么是存储设置？

存储设置是 Dinox 中用于配置对象存储（S3）服务的功能，它可以帮助你将笔记中的图片、视频、音频等媒体文件上传到自己的云存储服务，实现数据的自主管理和备份。

简单理解：

  • ☁️ 对象存储：类似网盘，用于存储文件

  • 🔧 配置存储：设置你的云存储服务信息

  • 📤 自动上传：笔记中的媒体文件自动上传到你的存储

  • 🔗 自定义域名：可以使用自己的域名访问文件

举个例子：

  • 配置阿里云 OSS 作为对象存储

  • 创建笔记时，插入的图片会自动上传到 OSS

  • 可以通过配置的自定义域名访问这些图片

存储设置的优势：

  • ✅ 数据自主：文件存储在自己的云存储中

  • ✅ 节省空间：本地不存储大文件，节省设备空间

  • ✅ 快速访问：通过 CDN 加速，访问速度快

  • ✅ 灵活配置：支持多种云存储服务

🎯 存储设置的使用场景

场景一：使用自己的云存储

需求：希望文件存储在自己的云存储服务中

配置方式：

  • 添加云存储配置（如阿里云 OSS、腾讯云 COS）

  • 设置 API Host、Access Key 等信息

  • 激活该配置，作为默认上传目标

场景二：使用自定义域名

需求：希望使用自己的域名访问文件

配置方式：

  • 配置自定义域名（如 cdn.example.com）

  • 设置 CDN 加速

  • 文件会通过自定义域名访问

场景三：多存储配置

需求：需要多个存储配置，根据不同场景使用

配置方式：

  • 添加多个存储配置

  • 根据需要激活不同的配置

  • 同时只能有一个配置处于激活状态

🚀 如何进入存储设置？

第一步：进入设置页面

  1. 打开应用

    • 在应用主界面，点击底部导航栏最右侧的”设置”图标（⚙️）

    • 进入设置主页面

  2. 找到”存储设置”选项

    • 在设置页面中，向下滚动

    • 找到第三个设置卡片组（包含”通用设置”、“存储设置”、“同步设置”等）

    • 在这个卡片组中找到”存储设置”选项（带有 🖥️ 图标）

    • 点击”存储设置”这一行

  3. 进入存储设置页面

    • 页面顶部显示标题”对象存储”

    • 右上角有一个”+“按钮（加号图标）

    • 下方显示所有已配置的存储列表

📋 查看存储配置列表

存储配置卡片

显示内容：

每个存储配置卡片显示：

  • 名称：配置的别名（如”我的阿里云 OSS”）

  • 激活标签：如果已激活，显示”激活”标签

  • 官方标签：如果是官方存储，显示”官方”标签

  • 提供商：存储服务提供商（如”阿里云”、“腾讯云”）

查看配置详情

操作步骤：

  1. 找到要查看的配置

    • 在存储配置列表中，找到要查看的配置卡片

  2. 点击配置卡片

    • 点击任意配置卡片

    • 会进入编辑页面，查看和修改配置详情

➕ 添加存储配置

创建新配置

操作步骤：

  1. 点击创建按钮

    • 在存储设置页面右上角，点击”+“按钮

    • 会进入编辑页面，标题显示”新增存储配置”

  2. 填写配置信息

    • 设为激活：是否作为默认上传目标（开关）

    • 运营商：选择存储服务提供商（如”阿里云”、“腾讯云”）

    • 别名：给配置起一个名称（如”我的阿里云 OSS”）

    • 服务端点：API 服务地址（如 s3.bitiful.net 或 https://s3.bitiful.net）

    • 区域：存储区域（如 cn-east-1）

    • Bucket：存储桶名称（如 dinoxoss）

    • Access Key ID：访问密钥 ID

    • Secret Access Key：访问密钥（密码输入）

    • 路径前缀：文件存储的路径前缀（如 dinox_note/）

    • URL 风格：选择 URL 格式（Virtual Hosted 或 Path）

    • 自定义域名：自定义访问域名（如 https://cdn.example.com）

  3. 测试配置（可选）

    • 在配置页面底部，点击”开始测试连接”按钮

    • 会要求选择一张图片进行上传测试

    • 测试成功后会显示上传的图片预览和 URL

  4. 保存配置

    • 点击页面右上角的”保存”按钮（✓ 图标）

    • 配置会保存并添加到列表

    • 如果设置为激活，会自动激活该配置

配置项说明

设为激活

  • 用途：是否作为默认上传目标

  • 说明：激活后，笔记中的媒体文件会自动上传到此存储

  • 注意：同时只能有一个配置处于激活状态

运营商

  • 用途：选择存储服务提供商

  • 选项：阿里云、腾讯云、AWS S3、缤纷云等

  • 说明：选择对应的服务提供商

服务端点

  • 用途：API 服务地址

  • 格式：可以带或不带协议（如 s3.bitiful.net 或 https://s3.bitiful.net）

  • 示例：

    • 阿里云：oss-cn-beijing.aliyuncs.com

    • 腾讯云：cos.ap-beijing.myqcloud.com

区域

  • 用途：存储区域

  • 示例：cn-east-1、us-west-2

  • 说明：根据你的存储服务选择对应的区域

Bucket

  • 用途：存储桶名称

  • 示例：dinoxoss、my-bucket

  • 说明：在存储服务中创建的存储桶名称

Access Key ID 和 Secret Access Key

  • 用途：访问凭证

  • 获取方式：在存储服务的管理控制台中获取

  • 注意：Secret Access Key 是密码输入，不会显示明文

路径前缀

  • 用途：文件存储的路径前缀

  • 默认值：dinox_note/

  • 说明：用于将文件分类存放，可以不填

URL 风格

  • 用途：选择 URL 格式

  • 选项：

    • Virtual Hosted：https://bucket.endpoint/{key}

    • Path：https://endpoint/{bucket}/{key}

  • 说明：根据存储服务的要求选择

自定义域名

  • 用途：使用自己的域名访问文件

  • 格式：https://your.cdn.domain

  • 说明：需要先配置 CDN 和域名解析

✏️ 编辑存储配置

修改配置

操作步骤：

  1. 进入编辑页面

    • 在存储配置列表中，点击要编辑的配置卡片

    • 会进入编辑页面，标题显示”编辑存储配置”

  2. 修改配置信息

    • 修改任意配置项（名称、端点、密钥等）

    • 可以添加或修改自定义域名

  3. 测试配置（可选）

    • 修改后可以测试配置是否正确

  4. 保存修改

    • 点击页面右上角的”保存”按钮

    • 配置会更新

激活/取消激活

操作步骤：

  1. 在编辑页面

    • 找到”设为激活”开关

  2. 切换开关

    • 点击开关，可以激活或取消激活

    • 激活：该配置会成为默认上传目标

    • 取消激活：该配置不会作为上传目标

  3. 保存设置

    • 点击”保存”按钮保存设置

注意：

  • 激活一个配置时，其他配置会自动取消激活

  • 同时只能有一个配置处于激活状态

🗑️ 删除存储配置

删除操作

操作步骤：

  1. 进入编辑页面

    • 在存储配置列表中，点击要删除的配置卡片

    • 会进入编辑页面

  2. 点击删除按钮

    • 在编辑页面右上角，找到删除按钮（🗑️ 图标）

    • 点击后会弹出确认对话框：“确认删除「XXX」吗？”

  3. 确认删除

    • 点击”删除”按钮确认

    • 点击”取消”按钮取消操作

  4. 删除成功

    • 删除后会返回列表页面

    • 该配置会从列表中消失

注意：

  • 删除配置不会删除已上传的文件

  • 如果删除的是激活配置，需要先激活其他配置或添加新配置

🧪 测试存储配置

测试连接

操作步骤：

  1. 在编辑页面

    • 找到”开始测试连接”按钮

    • 位于配置项下方

  2. 点击测试按钮

    • 点击”开始测试连接”按钮

    • 会要求选择一张图片进行上传测试

  3. 选择图片

    • 会打开相册选择界面

    • 选择一张图片

  4. 等待测试

    • 系统会上传图片到配置的存储

    • 显示”正在上传…”状态

  5. 查看结果

    • 测试成功后会显示：

      • 上传的图片预览

      • 图片的访问 URL

    • 如果失败，会显示错误提示

测试的作用：

  • 验证配置是否正确

  • 验证网络连接是否正常

  • 验证访问权限是否有效

💡 使用技巧和最佳实践

1. 选择合适的存储服务

  • 国内用户：推荐阿里云 OSS、腾讯云 COS

  • 国外用户：推荐 AWS S3、Google Cloud Storage

  • 考虑因素：价格、速度、稳定性

2. 配置自定义域名

  • 使用自己的域名，更专业

  • 配置 CDN 加速，访问更快

  • 需要先配置域名解析和 CDN

3. 使用路径前缀

  • 设置路径前缀，方便管理文件

  • 例如：dinox_note/、images/、videos/

  • 可以将不同类型的文件分类存放

4. 定期测试配置

  • 定期测试存储配置，确保可用

  • 如果配置失效，及时更新

  • 检查存储空间和费用

5. 备份重要配置

  • 记录配置信息，避免丢失

  • 特别是 Access Key 和 Secret Access Key

  • 建议保存在安全的地方

❓ 常见问题

Q1: 支持哪些存储服务？

A:

  • 支持所有兼容 S3 API 的存储服务

  • 包括：阿里云 OSS、腾讯云 COS、AWS S3、Google Cloud Storage、缤纷云等

  • 选择”OpenAI 兼容”规范，可以连接私有部署的服务

Q2: 如何获取 Access Key？

A:

  • 在存储服务的管理控制台中获取

  • 通常位于”访问控制”或”密钥管理”页面

  • 需要创建 Access Key 和 Secret Access Key

Q3: 自定义域名如何配置？

A:

  1. 在存储服务中配置自定义域名

  2. 配置 CDN 加速（可选）

  3. 在应用设置中填写自定义域名

  4. 格式：https://your.cdn.domain

Q4: 可以同时使用多个存储配置吗？

A:

  • 可以添加多个存储配置

  • 但同时只能有一个配置处于激活状态

  • 激活的配置会作为默认上传目标

Q5: 删除配置会影响已上传的文件吗？

A:

  • 不会！删除配置不会删除已上传的文件

  • 文件仍然存储在云存储中

  • 只是应用无法再使用该配置上传新文件

Q6: 测试连接失败怎么办？

A:

  • 检查服务端点是否正确

  • 检查 Access Key 和 Secret Access Key 是否正确

  • 检查网络连接是否正常

  • 检查存储服务的访问权限设置

Q7: URL 风格应该选择哪个？

A:

  • 根据存储服务的要求选择

  • 大多数服务支持 Virtual Hosted 风格

  • 如果不确定，可以查看存储服务的文档

Q8: 路径前缀可以不填吗？

A:

  • 可以！路径前缀是可选的

  • 如果不填，默认使用 dinox_note/

  • 建议设置路径前缀，方便管理文件

🎓 进阶使用

配置 CDN 加速

如果使用自定义域名，可以配置 CDN 加速：

  1. 在存储服务中配置 CDN

    • 在存储服务的管理控制台中配置 CDN

    • 设置 CDN 域名和加速规则

  2. 在应用中填写自定义域名

    • 填写 CDN 域名（如 https://cdn.example.com）

    • 文件会通过 CDN 访问，速度更快

迁移存储配置

如果需要更换存储服务：

  1. 添加新配置

    • 添加新的存储配置

    • 测试配置是否正确

  2. 激活新配置

    • 激活新配置作为默认上传目标

    • 新文件会上传到新存储

  3. 保留旧配置（可选）

    • 可以保留旧配置，不删除

    • 旧文件仍然可以通过旧配置访问

📝 总结

存储设置功能是 Dinox 中一个非常实用的功能，它可以帮助你：

✅ 数据自主：文件存储在自己的云存储中

✅ 节省空间：本地不存储大文件，节省设备空间

✅ 快速访问：通过 CDN 加速，访问速度快

✅ 灵活配置：支持多种云存储服务

开始使用：

  1. 进入存储设置页面

  2. 点击”+“按钮添加配置

  3. 填写存储服务信息

  4. 测试配置是否正确

  5. 保存并激活配置

需要帮助？ 如果遇到问题，可以：

  • 查看应用内的帮助文档

  • 查看存储服务的官方文档

  • 联系客服获取支持

祝你使用愉快！🎉