Serverless OneDrive & SharePoint Function.
或许是国内访问最快的 OneDrive 免服务器图床程序(或视频床、音乐床、...床)，专为世纪互联用户打造
注：SharePoint 文档储存功能和 OneDrive 网盘类似，本说明将他们统称为 OneDrive。
-
使用
sstore项目缓存access_token，省去复杂的数据库配置和不必要带宽开销 -
与现有免费图床服务的区别：我们有 OneDrive 😎，所以 sosf 可以托管任何文件(图片、视频、下载链接)，并且无储存空间限制(几乎，你甚至还 8000 可以用 SharePoint 扩展空间)
-
提供 API 接口，供二次开发：sosf 命名范围很广，肯定不能浪得虚名。因此我们提供了 API 接口来扩展应用功能，例如：
一个列出 OneDrive 根目录所有文件的示例
const fetch = require('node-fetch') const { getToken, drive_api } = require('./api') async function handler() { /** * Grab access_token */ const { access_token } = await getToken() /** * Using access_token to access graph api, drive_api is equivalent to the: * - `/sites/{site-id}/drive` in sharepoint * - `/me/drive` in onedrive */ const res = await fetch(`${drive_api}/root/children`, { headers: { Authorization: `bearer ${access_token}`, }, }) if (res.ok) { return await res.json() } } exports.main = handler
-
访问速度快：
sosf使用国内 Serverless 供应商提供的免费服务(一般带有 CDN)，访问国内的世纪互联，速度自然有质的飞跃 -
CLI 配置，简单快速：微软 Graph 的授权过程比较麻烦，为此我提供了一个 cli 工具来加快部署。用户填入所有的配置项后，该工具自动写入配置文件，无需多余操作
-
设计从简：
sosf只验证并获取 Onedrive 文件直链，并重定向过去(这也意味着它没有前端页面，如果你恰好有这种需求，onedrive-cf-index 为不二之选) -
教程完备：本说明带有十分详细的部署教程，各个平台都囊括其中
-
多平台部署支持：腾讯 TCB 、LeanCloud、Vercel
-
Leancloud 云引擎开发版 (🎉)：每天 1GB 外网出流量，
sosf流量消耗少，我相信 1GB 完全够用了。此外，公网访问必须绑定备案域名，详见 定价；缺点是它有个休眠策略 -
腾讯云开发免费额度 (⚡)：就速度而言它应该是最快的，缺点是每月有使用量限制
执行内存(GB) * 执行时间(s)为 1000 GBs，云函数公网访问月流量限制为 1 GB，详见 免费额度。如果你觉得服务不错，也可按量付费表示支持 -
Vercel Serverless Func (🌸)：它是国外服务器，速度不如前两家；不过国内访问速度也不错，不需要备案，免费额度也绝对够用：云函数使用量限制
执行内存(GB) * 执行时间(h)为 100 GB-Hrs，月流量 100 GB, 详见 Fair Use Policy
-
-
遵守合理使用规范：在我们使用这些云服务商表示支持的同时，也要
优雅薅羊毛合理使用
-
Azure 控制台顶栏搜索
应用注册⇢ 新注册 ⇢ 受支持的账户类型填入任何组织目录(任何 Azure AD 目录 - 多租户)中的帐户⇢ 重定向 uri 填入http://localhost⇢ 获取应用程序(客户端) ID (client_id) -
授权
-
OneDrive 用户左管理栏 API 权限 ⇢ 添加权限
offine-access、files.read.all、files.read.write.all⇢ 左管理栏证书和密码 ⇢ 创建并获取客户端密码 client-secret -
SharePoint 用户左管理栏 API 权限 ⇢ 添加权限
offine-access、sites.read.all、sites.read.write.all⇢ 左管理栏证书和密码 ⇢ 创建并获取客户端密码 (client-secret)⇢ 创建并获取 client-secret 和以下两项额外参数:- hostName: 你的 SharePoint Host，比如
cos.sharepoint.cn - sitePath: 你的 SharePoint 网站相对位置，比如
/sites/cos
比如我的 SharePoint 访问网址为
https://odbeet.sharepoint.cn/sites/beet，则hostName值为odbeet.sharepoint.cn，sitePath值为/sites/beet，这是最快判断上述两者取值的方法 - hostName: 你的 SharePoint Host，比如
- 得到上述配置参数后，请保存好留作后用
请在以下三种平台中根据你的需求任选其一:
未开通云开发&新注册用户需要先开通云开发，具体过程为：在 此地址 注册登录，完成后再进入 开通地址 开通 ⇢ 不创建环境(请勾选)，其它默认 ⇢ 跳转到授权界面并授权，开通成功 0. 点击此按钮一键部署：
- 使用免费资源(记得勾选)
注意：直接部署计费模式为按量计费 + 免费额度，如果你需要使用包月类型的免费额度，请参考手动部署教程：
点击展开手动部署教程
-
配置机密环境变量：
git clone -b tcb-scf https://github.com/beetcb/sosf.git && cd sosf npm i npm run auth # 在此根据提示开始配置
配置完成后，sosf 会创建一个
.env文件，内容大致如下： -
进入云开发控制台 ⇢ 空模板 ⇢ 确保选择计费方式
包年包月, 套餐版本免费版(这样能够确保免费额度超出后不继续扣费，当然如果你觉得服务不错，请付费表示支持) ⇢ 进入控制台 -
安装 tcb cli 并授权登录：
npm i -g @cloudbase/cli tcb login
-
部署云函数：
tcb fn deploy
-
指定 HTTP 访问路径：
tcb service create -p / -f sosf # 让函数在根目录触发 -
等待几分钟，就可以开始预览了，访问示例：
https://your.app/path/to/file.md
-
本地获取机密环境变量：
git clone -b tcb-scf https://github.com/beetcb/sosf.git && cd sosf npm i npm run auth # 在此根据提示开始配置
配置完成后，sosf 会创建一个
.env文件，内容大致如下： -
进入刚刚创建的环境 ⇢ 左栏云函数 ⇢ 在线代码编辑器 ⇢ 将本地
.env文件里的内容粘贴到在线编辑的.env文件中并保存，然后点击测试，无报错则配置成功 -
到此，应该部署成功了，如需自定义域名，请配置 HTTP 访问服务。访问示例：
https://domain.com/path/to/file.md
leancloud 不支持导入模板应用，所以配置相对麻烦
-
配置机密型环境变量：
git clone -b leancloud https://github.com/beetcb/sosf.git && cd sosf npm i npm run auth # 在此根据提示开始配置
-
注册 Leancloud 开发板并进入控制台
-
创建开发版应用并进入应用管理界面
-
安装 lean cli：安装文档 ⇢ 登录 ⇢ 绑定 ⇢ 部署你的 sosf 项目
lean login # 登录 lean switch # 绑定 lean deploy # 部署
-
部署成功后，我们回到控制台，左设置栏域名绑定 ⇢ 在此绑定你的域名
-
访问地址示例：
https://your.app/path/to/file.md
-
配置机密型环境变量：
git clone -b vercel https://github.com/beetcb/sosf.git && cd sosf npm i npm run auth # 在此根据提示开始配置
-
安装 vercel cli 并登录：
npm i -g vercel vercel login
-
部署：
vercel --prod # 按照提示完成部署到此部署完成，访问地址可以在命令行或 vercel 官网看到。需要使用自定义域名，请参考 custom-domains
-
访问地址示例：
https://your.app/?path=/path/to/file.md
作者：beetcb
邮箱: i@beetcb.com
sosf - Licensed under under MIT