精选优惠 · 官方会场

轻量应用服务器

新用户专享

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 等组合活动,按业务规模和实际预算搭配。

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

云小站更多特惠

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

前往官方会场

Vue 阿里云上传如何配置 STS 并显示进度

在 Vue 项目中上传图片或附件,可以让文件先经过业务服务器,再由服务器转存到阿里云 OSS。不过文件较多或体积较大时,服务器也要承担相应的带宽和处理压力。常见的替代方案是由 Vue 前端直传 OSS,后端负责签发短时有效、权限受限的 STS 临时凭证。

下面以图片上传为例,说明 Vue 阿里云上传需要准备什么、怎样显示上传进度,以及上线前容易漏掉的权限和安全检查。

一、前端直传,密钥不能写进 Vue

前端直传不代表把阿里云账号密钥交给浏览器。页面代码和网络请求都可能被查看,AccessKey ID 和 AccessKey Secret 一旦写进 Vue 项目,即使放在环境变量里,也可能随构建产物暴露。

更稳妥的流程是:用户选择文件后,Vue 向业务后端申请临时凭证;后端完成身份校验并签发受限凭证;前端拿到凭证后上传文件到 OSS;上传成功,再把对象名或文件地址提交给业务接口保存。文件本身不经过业务服务器,后端也不必接收每次上传的文件流。

二、准备 OSS 和 STS 临时凭证

开发前先确认 OSS Bucket、地域和存储类型。若网页域名与 OSS 域名不同,还要在 Bucket 跨域规则中配置允许的来源域名、请求方法和必要请求头。正式环境应填写实际使用的域名,不要为了省事将来源设为任意域名。

后端需要通过 RAM 角色或其他安全方式获取签发临时凭证的能力。授权策略应限制到具体 Bucket 和业务目录,例如只允许写入指定目录,不要附带删除文件、列举整个 Bucket 等无关权限。接口通常会向前端返回临时 AccessKey、Secret、SecurityToken,以及地域、Bucket 和过期时间等信息。

申请凭证的接口也要检查登录状态和用户身份,并根据业务需要增加频率限制。前端传来的目录或文件名不能直接决定授权范围;写入范围应由后端校验。

三、Vue 3 上传示例:用回调更新进度

示例使用阿里云 OSS JavaScript SDK。安装依赖后,页面先请求 /api/oss/sts 获取临时凭证,再调用 SDK 上传。这里假设接口返回的字段与代码一致,实际项目要按后端接口约定调整。

安装依赖:npm install ali-oss

以下代码省略了样式和请求封装。接入项目时,建议使用统一的请求工具,并检查接口返回的数据是否完整。

import OSS from ‘ali-oss’

import { ref } from ‘vue’

const progress = ref(0)

const imageUrl = ref(”)

const uploading = ref(false)

async function uploadImage(file) {

  if (!file || !file.type.startsWith(‘image/’)) {

    throw new Error(‘请选择图片文件’)

  }

  const result = await fetch(‘/api/oss/sts’, { credentials: ‘include’ })

  if (!result.ok) throw new Error(‘获取上传凭证失败’)

  const auth = await result.json()

  const client = new OSS({

    region: auth.region,

    bucket: auth.bucket,

    accessKeyId: auth.accessKeyId,

    accessKeySecret: auth.accessKeySecret,

    stsToken: auth.securityToken

  })

  const safeName = file.name.replace(/[^\w.-]/g, ‘_’)

  const objectName = `uploads/${Date.now()}-${safeName}`

  uploading.value = true

  try {

    const res = await client.put(objectName, file, {

      progress: (value) => { progress.value = Math.round(value * 100) }

    })

    imageUrl.value = res.url

    return { objectName, url: res.url }

  } finally {

    uploading.value = false

  }

}

progress 是 0 到 100 的百分比,可以绑定到进度条或文字提示;上传过程中用 uploading 禁用重复提交。生产环境还要捕获异常并显示清楚的提示。临时凭证和完整错误堆栈不应输出到面向用户的页面。

四、商品后台上传主图的处理方式

例如,运营人员在商品后台上传主图。前端可以先限制 JPEG、PNG、WebP 等格式,并设置单张大小上限,例如 5MB;后端再根据当前用户身份签发短时凭证,只允许写入 products/ 目录。上传成功后,前端把对象名提交给商品保存接口。

业务数据库通常保存对象名会更灵活。以后更换 CDN 域名或调整访问策略时,不必逐条改写完整访问地址。图片需要公开展示时,可以通过合适的 Bucket 访问策略或 CDN 域名提供访问;合同、用户资料等私密文件则应保持私有,由后端按需生成短时签名地址。上传权限和读取权限要分别设计。

五、常见问题与排查方法

  • 浏览器提示跨域错误:检查 OSS 跨域规则是否包含当前页面域名、实际使用的请求方法(如 PUT)和 SDK 所需请求头,也要确认预检请求没有被网关或代理拦截。
  • 上传返回 403:核对 STS 是否过期、SecurityToken 是否传入、地域和 Bucket 是否对应,并检查 RAM 策略是否允许写入目标目录。不要只因报错就直接扩大授权范围。
  • 大文件上传慢或中断:普通 put 适合常见小文件。较大的文件可以评估 SDK 的分片上传,并提前设计失败重试、取消上传和未完成分片清理。
  • 对象名或路径不安全:不要直接把用户输入拼成对象路径。可以由后端生成随机文件名或目录,并校验扩展名、文件大小和内容类型。浏览器提供的 MIME 类型不能单独作为安全依据。
  • 需要写入不同目录:由后端根据用户身份和业务类型决定可写范围。前端提交的目录参数必须经过校验,不能让客户端借此扩大授权。

六、上线前检查这些环节

部署前,分别测试凭证过期后能否重新申请、未登录用户能否被拒绝、上传失败后界面能否恢复,以及对象是否进入预期目录。还要确认敏感文件没有被意外公开。图片业务可根据需要增加服务端内容检测、压缩或审核流程。

这套方案的职责分工比较清楚:Vue 负责文件选择、上传交互和进度反馈;后端校验身份并控制 STS 授权范围;OSS 保存文件。把这几处权限和异常处理落实好,前端直传才能既方便使用,也不把密钥和文件访问权限留在浏览器里。

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

相关推荐

  • 阿里云盘个人版怎么用?空间怎么清理和分享

    手机里的照片越存越多,电脑硬盘又时常告急,很多人会先想到云盘。阿里云盘个人版客户端界面简单,上手快,是不少人日常备份文件时的常用工具。这篇文章说明注册后该先做什么,文件怎么上传、分享,空间怎么清理,以及哪些地方需要留意。 个人版适合什么场景 个人版主要面向普通用户,常见用途是备份照片、保存文档,以及在手机和电脑之间传文件。如果需要多人协作、统一管理团队文件,…

    2026年11月1日
  • 阿里云美西服务器怎么选?先看业务场景和部署要点

    面向北美用户部署网站、应用或游戏服务,服务器区域会影响访问体验、运维方式和后续扩展。阿里云美西服务器靠近美国西部及太平洋沿岸网络节点,跨境电商、出海应用,以及需要连接北美和亚洲团队的业务,通常会把它列入候选。不过,美西位置不代表所有地区的用户访问都快,买好实例也不等于部署完成。选之前,先弄清用户在哪里、应用需要处理什么流量,以及团队如何运维,往往比单看配置和…

    阿里云 2026年11月15日
  • 阿里云网站迁移的7个步骤与常见风险检查方法

    把网站文件复制到新服务器,只完成了迁移的一部分。数据库、运行环境、域名解析、证书和缓存都需要逐项处理;漏掉其中一项,轻则页面或功能异常,重则丢失新提交的数据。下面按实际操作顺序整理阿里云网站迁移的准备工作、上线步骤和检查重点。 迁移前:盘点网站和业务依赖 先确认网站目前运行在哪种环境,计划迁往阿里云的哪种产品,以及是否需要调整架构。常见选择包括云服务器ECS…

    阿里云 2026年11月15日
  • 阿里云怎么查看服务器?控制台和命令行分别怎么操作?

    想确认阿里云服务器是否运行、配置了多少资源,或查找连接地址,可以从阿里云控制台的 ECS 实例列表开始。日常查看单台服务器,用控制台更直观;需要盘点多台实例或定期巡检时,再考虑使用阿里云 CLI。还要分清一件事:控制台显示的是云平台上的实例信息,登录服务器后看到的则是操作系统和应用的实际状态。 在控制台查看 ECS 实例 登录阿里云控制台,在“产品与服务”中…

    阿里云 2026年11月15日
  • 阿里云企业邮箱控制台怎么管理账号和配置安全?

    员工入职、部门调整、离职交接,都会牵涉邮箱账号。域名解析或登录出现问题时,管理员也需要回到管理后台核对设置。熟悉阿里云企业邮箱控制台,能让这些日常操作有章可循,也方便查清谁在什么时候改了什么。 阿里云企业邮箱控制台能处理哪些事 控制台是管理员管理企业邮箱服务的入口。根据购买的产品版本、账号权限和页面调整,功能名称可能不完全相同;日常管理通常涉及邮箱账号、组织…

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