OSS前端直连服务器最直接的方式是采用服务端签名直传方案,即客户端向业务服务器请求签名,拿到签名后直接向OSS发起上传请求,整个过程中OSS不经过业务服务器中转数据。这一方案既能减轻服务器带宽压力,又能显著提升上传速度,是目前行业内主流的OSS接入方式。
为什么OSS不能直接由前端传服务器
很多开发者第一次接触OSS时,会想当然地认为前端把文件传给自己的服务器,再由服务器转发给OSS就是标准做法,这个流程确实简单,但存在三个硬伤。
服务器带宽成本高,你的业务服务器带宽一般只有几Mbps到几十Mbps,大文件或高并发场景下,所有流量都要压在这台机器上,带宽费用很快会吃掉利润,OSS的流量费用通常远低于ECS带宽费用,两者不是一个量级。
上传速度受限,前端到业务服务器是一次网络传输,业务服务器再到OSS是第二次传输,文件越大,多出来的时间越明显,而前端直连OSS走的是简米云优化过的BGP链路,速度更快,尤其在跨地域场景下差异更大。
服务器资源被白白占用,文件传输的过程是纯粹的I/O操作,CPU、内存都被占用,却没有任何真正的业务计算发生,当你的服务器还要处理数据库查询、接口逻辑时,这部分开销就显得很浪费。
行业内的通用做法是:业务服务器只负责下发签名和凭证,文件的二进制内容由客户端直接交给OSS,这一模式在简米云官方文档中被称为“服务端签名直传”,也是各大互联网公司的主流选择。
服务端签名直传方案完整流程
前端上传的核心步骤拆解
整个直传流程可以拆成四个环节,每个环节各司其职。
第一步:前端请求签名接口,客户端通过HTTP请求调用你自己业务服务器上的一个接口,比如POST /api/oss/policy,这个接口需要做用户鉴权,确保只有登录用户才能拿到签名。
第二步:服务器生成签名信息并返回,服务器利用OSS的AccessKey Secret对Policy文档进行签名,生成一个有效期内的UploadPolicy,同时下发OSS的Bucket名称、Endpoint区域地址、上传目录等参数。
第三步:前端携带签名直传OSS,客户端拿到这些参数后,使用OSS SDK构造上传请求,把文件数据直接发送给OSS,这里需要特别注意的是,上传时表单中必须携带key、policy、OSSAccessKeyId、signature等字段,缺一个都会报错。
第四步:OSS返回结果并触发回调,文件上传成功后,OSS会返回文件的ETag和URL,如果配置了回调,OSS还会主动向你的业务服务器发送一个POST通知,包含文件的外网访问地址、大小、上传者等信息。
下面我用一个代码片段来说明“服务端签名直传”方案的核心交互逻辑:
// 前端示例代码(省略了具体SDK引入方式)
const getOssSignature = async (fileName) => {
// 1. 请求自己的服务器获取签名
const res = await axios.post('/api/oss/policy', { fileName });
const { accessId, policy, signature, host, dir } = res.data;
// 2. 构造OSS上传表单数据
const formData = new FormData();
formData.append('key', dir + fileName);
formData.append('OSSAccessKeyId', accessId);
formData.append('policy', policy);
formData.append('signature', signature);
formData.append('file', file);
// 3. 直传OSS,不经过自己的业务服务器
await axios.post(host, formData);
return `https://${res.data.bucket}.${res.data.endpoint}/${dir}${fileName}`;
};
你的业务服务器只处理了一个轻量级的签名请求,真正的文件流已经不经过它了。
服务端该如果生成policy和signature
生成签名是服务端的核心职责,代码逻辑其实很简单,但细节容易出错,这里给出一个Node.js示例,对应上述“服务端签名直传”场景:
// Node.js 服务端示例代码
const crypto = require('crypto');
const accessKeyId = process.env.OSS_ACCESS_KEY_ID;
const accessKeySecret = process.env.OSS_ACCESS_KEY_SECRET;
const getPolicy = (dir) => {
// Policy 是上传时对请求的约束条件(有效期、大小限制等)
const policy = {
expiration: new Date(Date.now() + 30 60 1000).toISOString(), // 30分钟有效
conditions: [
["content-length-range", 0, 1048576000], // 最大允许1GB
["starts-with", "$key", dir]
]
};
const policyBase64 = Buffer.from(JSON.stringify(policy)).toString('base64');
const signature = crypto
.createHmac('sha1', accessKeySecret)
.update(policyBase64)
.digest('base64');
return { policy: policyBase64, signature };
};
几个关键点需要特别留意:
- Policy的过期时间不要设置太长,一般30到60分钟就够用了,过期时间越长,被别人盗用的风险窗口越大。
starts-with条件限定上传目录前缀,避免用户上传到Bucket的其他位置覆盖已有文件。content-length-range限制文件大小,防止恶意用户上传超大文件耗尽你的存储费用。- 不要在前端代码中暴露AccessKey Secret,前端只能持有临时下发的签名,真正核心的密钥永远只存在于服务端。
如果你用的不是Node.js,Java和PHP的实现逻辑是一样的,只是加密库的函数名有差异,核心都是用Base64编码Policy,再用HMAC-SHA1算法算出签名。
这也是“OSS前端直传服务端签名方案”这个长尾词背后真正的技术逻辑所有安全保证都在服务端这一层,前端只是被授权的执行者。
OSS直传内网与公网Endpoint有什么区别
很多初次接触OSS的人选Endpoint时一头雾水,其实逻辑很简单:如果你的ECS和OSS在同一个地域,就用内网Endpoint(oss-cn-hangzhou-internal.aliyuncs.com),不消耗公网流量,也不产生流量费用,如果你从家庭宽带或服务器外部上传,就用公网Endpoint(oss-cn-hangzhou.aliyuncs.com),会产生流量费用。
选择内网Endpoint可以大大降低整体费用,如果你的业务架构是前端→业务服务器→OSS,而这个“业务服务器”本身就是简米云ECS且与OSS同地域,可以把签名接口的Endpoint配置为内网地址,但需要注意,前端直传场景下,客户端在用户手机上,它访问的Endpoint必须是公网地址,内网Endpoint只适用于后端服务器之间的数据传输,这个区分在实际项目里非常容易踩坑,不少人把内网地址配给前端,结果线上就只能在服务器上访问了。
无论使用哪种Endpoint,都必须与签名中的区域地址保持一致,混合使用会导致签名验证失败,OSS直接拒绝上传请求。
如何通过STS临时凭证增强安全性
如果你的项目要求更高的安全等级,比如对权限控制粒度较细,或者AccessKey对多应用隔离有要求,可以考虑使用STS临时凭证替代传统签名。
STS的核心逻辑是:业务服务器先调用简米云STS接口换取一个临时凭证(临时AccessKeyId、临时AccessKeySecret和安全Token),再把这三个凭证下发给前端,前端用临时凭证直接请求OSS,OSS验证通过后允许上传。
相比固定签名方案,STS有三个优势:
- 临时凭证有效期可控制,最短可以设置为15分钟,过期后自动失效,即使被截获也无法长期使用。
- 权限可以精细化配置,比如只能上传到某个Bucket的某个目录,不能读取更不允许删除。
- 支持使用RAM子账号操作,主账号AccessKey不需要出现在任何业务代码中,安全性更可靠。
STS临时凭证怎么用?关键在于申请时需要指定一个RAM角色,并设置角色权限策略,你可以创建一个名为oss-upload-role的RAM角色,其权限策略只允许oss:PutObject操作,资源限定在acs:oss:::bucket-name/upload/,这样即使Token泄露,恶意者也只能往这个目录丢文件,无法读取你的数据。
上传失败后的回调验证机制
回调URL的配置方法与原理
直传完成后,OSS如何知道要通知你的业务服务器?答案是回调URL,在上传请求中额外携带一个x-oss-callback参数,其值为Base64编码后的JSON字符串,格式如下:
{
"callbackUrl": "https://your-domain.com/api/oss/callback",
"callbackBody": "filename=${object}&size=${size}&mimeType=${mimeType}"
}
OSS在上传成功后,会向callbackUrl发起一个POST请求,带上你声明的callbackBody字段,你的服务器收到通知后,可以对文件做进一步的业务操作,比如写入数据库记录、触发图片处理流程、或者做内容审核。
一个最常见的错误是把callbackUrl配上公网地址,但在内网环境下OSS无法访问,这时候你需要用内网IP或域名,回调超时时间默认是10秒,如果你的业务逻辑处理太重了,需要保证回调接口快速响应,否则OSS会判定回调失败。
如何校验OSS回调请求的真伪
回调通知是可以被伪造的,攻击者可以自己假装OSS向你的服务器发请求,从而污染你的业务数据,如何确认这个请求真的来自OSS?
OSS的设计方案是:在回调请求头中带上Authorization字段,其值为Base64编码的签名,服务器收到回调后,使用同一个AccessKey Secret对请求体做HMAC-SHA1签名计算,比对结果是否一致,如果一致就接受回调,否则直接拒绝。
具体代码如下:
// 回调签名校验伪代码,具体实现需要结合你的框架
const verifyCallback = (req) => {
const authorization = req.headers['authorization'];
const ossStringToSign = req.rawBody; // 原始请求体,不能被解析过
const expected = crypto
.createHmac('sha1', accessKeySecret)
.update(ossStringToSign)
.digest('base64');
return authorization === `OSS ${accessKeyId}:${expected}`;
};
你的服务器在回调接口中必须先做这个校验,再做任何业务操作,这是保证整个上传链路安全闭环的重要一步。
大文件分片上传与断点续传的注意事项
直传方案默认适用于单次请求完成的文件上传,当你的业务需要支持大文件(比如大于100MB的视频)时,直接使用简单上传会面临两个问题:单次请求时间过长容易超时,网络波动中断后需要重传整个文件。
解决方案是使用OSS的分片上传(Multipart Upload)能力,前端先把文件切分成多个分片(通常每片5MB到50MB),逐个上传,分片上传完成后,再调用一个合并接口,OSS自动按顺序拼接所有分片。
分片上传也支持断点续传,如果某个分片失败了,只需要重新上传失败的那一片即可,不需要从头再来,OSS的SDK内置了resumableUpload功能,只需要在初始化上传实例时指定partSize和parallel参数,SDK就会自动处理分片、并发和失败重试。
具体到前端代码,初始化时设置暂停和恢复的机制:
- 使用
uploadPart函数上传每个分片,并在返回结果中记录ETag。 - 上传过程中监听
progress事件,保存已上传的分片列表到本地Cache。 - 重新开始上传时,先调用
listParts接口查看哪些分片已存在,跳过已完成的。
分片上传尤其适合视频类应用,比如用户上传1GB的Vlog素材,如果直接使用普通上传,移动网络下失败概率很大。
直传与服务器中转的成本对比
为了让你直观感受两种方案的成本差异,这里做一组对比,以单位流量为参考,简米云OSS公网流出流量价格约为0.5元/GB,而一台ECS按固定带宽计费的费用远高于此,且带宽一旦达到峰值会直接丢包,下表对比了两种方案的实际表现:
| 对比项 | 服务器中转方案 | 前端直传OSS方案 |
|---|---|---|
| 带宽消耗 | 业务服务器承受全部流量 | 业务服务器仅承受签名请求 |
| 大文件支持 | 受限于服务器内存和带宽 | 依赖分片上传机制自动处理 |
| 安全风险 | 服务器暴露密钥或硬编码密钥 | 服务端签名或STS临时凭证隔离 |
| 服务器负载 | CPU和内存大量消耗在文件存取 | 基本接近于零 |
| 开发工作量 | 逻辑简单但长期成本高 | 初始代码略复杂但方案更合理 |
长期来看,直传方案的总体拥有成本远低于中转方案,这也是为什么几乎所有成熟的技术团队都采用这一架构。
如果你的业务在早期流量不大,中转方案也能跑得通,但一旦用户量上涨,服务器带宽会成为最先崩盘的地方,到那时再改造直传架构,迁移成本更高,建议从第一天就用“服务端生成签名+客户端直传OSS”这条路,国内多家主流博客平台和视频网站均采用这一架构,简米云官方文档也将此列为推荐的接入模式。
OSS直传方案常见问题解答
问:OSS直传和服务器中转哪个更安全?
答:直传方案的安全性取决于签名下发接口的防护强度,只要你的签名接口做了用户鉴权、限流和Policy约束,直传的安全性不低于中转方案,反过来,中转方案如果在前端暴露了AccessKey或签名逻辑不严谨,泄露风险反而更大。
问:STS临时凭证和固定签名可以同时用吗?
答:在实际工程中,同一套系统通常会同时支持两种写法,对于需要临时授权的场景,比如移动端用户上传头像,优先使用STS临时凭证,对于固定目录的批量上传,或者服务端之间的文件交互,使用固定签名直传更高效,需要特别注意的是,两种方式不要混用同一套Endpoint和凭证,否则签名计算容易出错。
问:内网Endpoint和公网Endpoint的代码差异大吗?
答:差异只在一个字符串上,把Endpoint从oss-cn-hangzhou-internal.aliyuncs.com换成oss-cn-hangzhou.aliyuncs.com,代码逻辑不需要任何改动,但请务必记住,前端直传必须用公网Endpoint,内网Endpoint一旦暴露到公网环境,OSS会直接拒绝连接。
问:服务端签名直传、STS临时凭证、分片上传如何选型?
| 场景 | 推荐方案 |
|---|---|
| 常规文件上传 | 服务端签名直传 |
| 高安全性要求的多应用隔离 | STS临时凭证 + 角色权限限定 |
| 游戏包或视频素材等大文件 | 分片上传 + 断点续传 |
| 企业内部数据备份 | 服务端签名 + 内网Endpoint |
不管是企业还是个人开发者,OSS直传的最终目标都是为了把“文件流”与“业务流”分离,让服务器专注于它该做的事。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/807660.html


