FoomClous 存储源配置指南 ☁️
FoomClous 支持多种存储后端。您可以根据对速度、容量和成本的需求，选择本地存储或云存储。
1. 本地存储 (Local Storage)
文件直接保存在运行 FoomClous 的服务器硬盘上，速度最快，但受限于服务器磁盘大小。
- 配置: 无需特殊操作。
- 持久化: 如果使用 Docker，请确保挂载了挂载卷（默认已集成在
docker-compose.yml 中）。
2. Microsoft OneDrive
适合拥有 Office 365 订阅的用户，提供 1TB - 5TB 的廉价高速存储。
获取凭据
- 访问 Azure Portal。
- 创建“新注册”，重定向 URI 选择
Web 并填写：https://您的域名/api/storage/onedrive/callback。
- 获取 Client ID 和 Tenant ID（通常为
common）。
- 在“证书和密码”中生成 Client Secret。
开启功能
- 设置 -> 存储源 -> OneDrive，输入凭据并点击“保存并授权”。
3. S3 兼容存储 (AWS S3, MinIO, R2)
支持所有兼容 S3 协议的对象存储，如 Cloudflare R2, Backblaze B2, MinIO 等。
配置信息
- Endpoint: 节点地址 (如
https://s3.us-east-1.amazonaws.com)。
- Region: 区域 (如
us-east-1)。
- AccessKey / SecretKey: 访问密钥。
- Bucket: 存储桶名称。
- Force Path Style: 如果使用 MinIO 或某些私有云，可能需要勾选。
4. WebDAV (坚果云, InfiniCLOUD)
最通用的网络存储协议。
配置信息
- URL: WebDAV 服务器地址 (如
https://dav.jianguoyun.com/dav/)。
- Username: 登录账号。
- Password: 应用专用口令（非登录密码）。
5. Google Drive
适合需要大量存储空间且拥有 Google 账号的用户。
第一步：创建 Google Cloud 项目
- 访问 Google Cloud Console。
- 点击屏幕顶部的项目选择器，选择 “新建项目”。
- 输入项目名称（如
FoomClous-Storage），点击 “创建”。
第二步：启用 Google Drive API
- 在控制台左侧菜单中，选择 “API 和服务” > “库”。
- 搜索
Google Drive API 并点击进入，点击 “启用”。
第三步：品牌塑造 (重要)
- 在左侧菜单选择 “API 和服务” > “OAuth 权限请求页面” > “品牌塑造”。
- 在应用信息里填入 应用名称 和 用户支持邮箱。
- 在 “已获授权的网域” 填入您自己的域名。
- 点击 “保存并继续”。
第四步：目标对象
- 在 “目标对象” 板块，点击 “+ ADD USERS”。
- 添加您自己的 Google 邮箱地址。
- 提示：如果不添加测试用户，在授权时会遇到
403: access_denied 错误。
第五步：创建凭据 (Client ID & Secret)
- 在左侧菜单选择 “API 和服务” > “凭据”。
- 点击顶部 “创建凭据” > “OAuth 客户端 ID”。
- 应用类型选择 “Web 应用程序”。
- 已授权的重定向 URI：
- 点击 “添加 URI”，输入：
https://您的域名/api/storage/google-drive/callback
- 注意：必须与您面板显示的一致，支持 https。
- 点击 “创建”，记录下 客户端 ID 和 客户端密钥。
- 提示：建议点击 “下载 JSON” 备份，密钥一旦关闭窗口将无法再次查看完整内容。
第六步：在 FoomClous 中完成授权
- 登录 FoomClous，进入 “设置” > “存储源” > “Google Drive”。
- 填入 Client ID 和 Client Secret，点击 “保存并授权”。
- 在授权页面，点击 “高级” 或 “继续”（如遇安全警告）并完成授权。
6. 阿里云 OSS
国内用户推荐，响应速度快，成本低。
详细配置步骤
1. 创建存储桶 (Bucket)
- 登录 阿里云 OSS 控制台。
- 点击 “创建 Bucket”。
- 名称: 自定义（如
foomclous-data）。
- 地域: 选择距离您最近的地域（例如：华东 1 上海）。
- 重要: 记住地域 ID，如
oss-cn-shanghai。
- 读写权限: 建议选择 “私有”（FoomClous 会通过后端签名访问，确保安全）。
2. 获取 AccessKey (推荐使用 RAM 用户)
- 进入 RAM 访问控制台。
- 创建一个 “用户”，勾选 “OpenAPI 调用访问”。
- 创建成功后，保存好 AccessKey ID 和 AccessKey Secret。
- 添加权限: 给该用户授予
AliyunOSSFullAccess 权限。
3. 填写配置项
- Region: 您的地域 ID (例如
oss-cn-shanghai)。
- AccessKey ID: 您保存的 ID。
- AccessKey Secret: 您保存的 Secret。
- Bucket: 您创建的存储桶名称。
🔄 如何切换活动账户？
- 进入 设置 -> 存储源设置。
- 在列表中找到您想使用的账户。
- 点击 “切换到此账户”。
- 提示：新上传的文件会存入新账户，已上传的文件仍会通过原路径访问。
返回文档中心