精选优惠 · 官方会场

轻量应用服务器

新用户专享

2核2G · 200M峰值带宽 · 40G系统盘

限阿里云新用户
68元/年限阿里云新用户
立即选购

云服务器 ECS

新老同享

经济型e · 2核2G · 3M固定带宽 · 40G盘

同主体限1台 · 不可叠券
99元/年同主体限1台 · 不可叠券
立即选购

云数据库 RDS

数据库精选

托管数据库 · 弹性扩容 · 自动备份

按地域与配置选择
查看活动价按地域与配置选择
查看优惠
更多阿里云活动收起阿里云活动
11月1日—30日企业至高减 1728 元

双11满减礼包

个人至高减360元;需对应实名认证,满减门槛及适用产品以官方规则为准。

前往官方会场
AI 专场让 AI 应用轻松上云

AI 产品特惠

浏览 Token Plan、Qoder 与 AI 应用等官方活动,按实际使用需求选择。

前往官方会场
搭配更省心服务器 + 数据库

云产品组合购

查看 ECS、RDS 等组合活动,按业务规模和实际预算搭配。

前往官方会场
官方活动合集热门云产品,一站选

云小站更多特惠

继续查看服务器、数据库与存储等优惠,选择适合自己的配置。

前往官方会场

阿里云 OSS javascript 文件上传,安全配置要注意什么

网页上传头像、图片或业务附件时,常见做法是先把文件传到应用服务器,再由服务器转存到对象存储。文件量增加后,这条链路会占用服务器带宽,也增加维护环节。使用阿里云 OSS JavaScript SDK,浏览器可以直接把文件上传到 OSS,减轻应用服务器的传输负担。

直传并不意味着把存储权限交给浏览器。前端代码会被访问者查看,密钥、上传范围和文件访问方式都要提前设计好。接入时,除了调用上传接口,还要检查临时凭证、RAM 权限、跨域规则,以及失败后的处理方式。

浏览器为什么要使用 OSS JavaScript 客户端

阿里云 OSS 提供 JavaScript SDK,网页应用可以通过它上传、下载、删除文件,也可以进行分片上传。常见的浏览器直传流程是:前端向业务后端申请临时凭证,后端确认用户身份并签发权限受限的凭证;前端再用凭证初始化 OSS 客户端,将文件上传到指定 Bucket。

不要把 AccessKey ID 和 AccessKey Secret 写进前端代码。网页脚本可以被任何访问者查看,长期密钥一旦泄露,攻击者就可能在密钥权限范围内读取、删除或上传文件。应由后端通过 STS 签发短时有效的临时凭证,并限制它能访问的 Bucket、目录和操作。

接入前要准备哪些配置

  • 创建 OSS Bucket,并确认实际地域、存储类型和读写权限。通常可将 Bucket 保持为私有,再按业务需要生成签名 URL。
  • 在 RAM 中配置最小权限策略,只允许访问指定 Bucket 或目录,并限制可执行的操作。不要为了省事直接授予整个 Bucket 的读写权限。
  • 由后端提供临时凭证接口,返回 STS 凭证、过期时间、Bucket 和地域等信息。接口需要先确认用户已登录,并按用户或业务场景限制上传范围。
  • 在 OSS 控制台配置跨域规则,填写实际使用的网页来源、请求方法和必要请求头,不要用宽泛配置代替权限控制。

地域必须与 Bucket 所在地域一致,Bucket 名称也要准确。跨域规则只决定浏览器是否允许网页发起跨域请求,并不会授予对象读写权限,也不会让私有文件自动公开。遇到浏览器跨域报错时,应核对来源、方法和请求头;遇到权限错误,则要检查 STS 策略和对象路径。

JavaScript 上传示例

以下代码假设项目已经安装并引入阿里云 OSS JavaScript SDK。使用浏览器构建工具时,应按项目的依赖管理方式安装和打包 SDK。示例中的 sts 数据由业务后端安全返回,不能替换成写在前端的长期密钥。

const client = new OSS({
  region: ‘oss-cn-hangzhou’,
  bucket: ‘example-bucket’,
  accessKeyId: sts.accessKeyId,
  accessKeySecret: sts.accessKeySecret,
  stsToken: sts.securityToken
});
const file = input.files[0];
const key = ‘uploads/’ + crypto.randomUUID() + ‘-‘ + file.name;
const result = await client.put(key, file);
console.log(result.name);

对象名加入随机标识,可以减少不同用户上传同名文件时互相覆盖的情况。示例中的 crypto.randomUUID() 需要目标浏览器支持;不支持时,可在项目中使用可靠的 UUID 库。用户提供的文件名也不宜未经处理就拼进对象路径,应考虑特殊字符、路径分隔符和可能暴露的个人信息。

前端可以先检查文件大小和类型,及时给用户提示,但这不能代替服务端限制。后端签发凭证时仍应限制可写入的目录,并设置合理的有效期;如果业务要求只允许特定格式或大小,还要在服务端流程中落实相应校验。

头像上传时,上传成功还不等于业务完成

以个人资料页更换头像为例:用户选中文件后,前端检查图片类型和大小,再向后端申请上传凭证。后端确认登录状态后,签发只能写入该用户头像目录的短期 STS 凭证。前端完成上传后,再把对象 Key 提交给业务接口,由后端更新头像记录。

这两个步骤应分别处理。对象已经上传、数据库记录却没有更新时,页面可能仍显示旧头像,还会留下没有业务记录关联的文件。可以在业务提交失败时提示用户重试,并安排清理未关联对象的任务。展示头像时,如果 Bucket 为私有,后端可根据对象 Key 生成有时效的签名 URL;若采用公开读取,也只开放确有需要的资源。

大文件、进度和失败处理

普通的 put 适合常见的小文件。文件较大或网络不稳定时,可以考虑 SDK 提供的分片上传能力,并通过进度回调更新页面状态。上传界面应明确显示进度、失败提示和重试入口,避免用户看不到反馈后反复点击,生成多个对象。

重试前要想好对象 Key 的规则。沿用同一个 Key,便于把重试与原操作关联起来;若每次重试都生成新 Key,则需要能够追踪并清理重复对象。网络错误、凭证过期、权限不足和跨域配置错误也要区别处理:凭证过期时重新向后端申请,权限不足时检查 RAM 策略和目标路径,跨域问题则核对 OSS 的 CORS 配置。

日志中不要记录完整临时凭证、敏感请求信息或不应公开的文件地址。排查问题时,记录错误类型和必要的业务关联信息即可,避免调试日志本身成为新的泄露入口。

上线前的检查项

  • 浏览器报跨域错误:检查 CORS 规则是否包含当前网站域名、实际使用的方法和必要请求头。
  • 上传返回权限错误:核对 STS 策略、Bucket 名称、地域、对象 Key 范围和凭证有效期。
  • 上传成功但图片无法访问:确认 Bucket 是否为私有;私有对象需要签名 URL 或经过授权的下载接口,不能直接把对象地址当作公开链接。
  • 文件被覆盖或出现重复对象:检查对象 Key 是否包含随机标识、用户标识或业务记录 ID,并确认重试时采用的命名规则。

上线前还应测试大文件、网络中断、凭证过期和重复提交等情况,并确认前端拿到的权限没有超出业务需要。阿里云 OSS JavaScript 接入本身并不复杂,凭证生命周期、可写入范围和异常处理,决定了浏览器直传是否安全、稳定,也决定后续排查问题时是否有清晰的处理路径。

赞 (0)
上一篇 2026年11月15日 上午3:37
下一篇 2026年11月15日 上午3:37

相关推荐

  • 银行用的是阿里云,核心系统上云靠谱吗?

    一提银行的IT系统,很多人想到的还是机房里那些大型机和小型机。这几年情况有了变化,不少银行把部分业务,甚至一部分核心系统迁到了云上。阿里云是其中常被提到的选项,网商银行也经常被拿来讨论。所以“银行用的是阿里云”这句话,背后问的其实是另一件事:金融系统上云到底靠不靠谱。 银行为什么想上云 传统银行的IT架构多半建在集中式设备上。买一台设备要等采购周期,业务量涨…

    2026年11月1日
  • 阿里云第三代服务器是什么?性能和选型要点解析

    搜索“阿里云第三代服务器是”什么时,容易把它理解成一款固定型号。实际情况是,它通常指阿里云弹性计算服务(ECS)中采用第三代架构的一组实例规格,覆盖通用计算、计算密集和内存密集等不同用途。用户可按业务需要选择 vCPU、内存、系统盘和网络配置。 选购时,不能只凭“第三代”判断性能或是否划算。不同规格族的 CPU 平台、网络能力、可选配置和价格可能不同;同一实…

    阿里云 2026年11月15日
  • 阿里云盘古系统怎么选?对比这3项关键区别

    阿里云盘古系统怎么选?先看清3项关键区别 搜索“阿里云盘古系统”,常见情况是想找一套能在阿里云上使用的人工智能平台,或想确认盘古模型是不是阿里云提供的。这里要先分清品牌:盘古大模型通常指华为推出的盘古系列模型,并非阿里云自有的大模型品牌。阿里云面向企业提供的相关产品和服务,主要包括通义系列模型、百炼平台、PAI等。 因此,选型时不宜只按“盘古系统”这个名称找…

    阿里云 2026年11月15日
  • 阿里云博彩服务器能不能用?合规要求和风险先了解

    搜索“阿里云博彩服务器”,有人是在找云主机,也有人已经准备搭建博彩或竞猜类网站。两种情况都不能只看服务器配置:这类业务还涉及经营许可、用户资金、个人信息和云服务商的使用规则。服务器买得到、程序跑得起来,不等于业务可以合法经营,也不等于服务商允许这么用。 部署之前,先确认两件事:业务面向的地区是否要求取得相关许可,阿里云现行服务规则是否允许这类用途。只要其中一…

    阿里云 2026年11月15日
  • 阿里云搭建支付服务器,架构部署和上线运维要注意什么

    支付系统出问题,影响的不只是用户体验。订单可能卡在“待支付”,用户已经付款却没开通服务,财务对账也会变得困难。因此,阿里云搭建支付服务器不能只看买哪种云主机、怎么部署程序,还得先理清支付链路,并考虑安全隔离、异常处理和对账。 多数电商、会员服务和小型平台,无需自行处理银行卡信息或建设清算系统。常见做法是由业务系统创建订单、记录状态,再调用合规支付服务商的接口…

    阿里云 2026年11月15日
返回顶部