精选优惠 · 官方会场

轻量应用服务器

新用户专享

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 JS 配置好后,怎么上传文件?

网站或小程序里的图片、视频和附件如果都经过业务服务器,文件流量也会占用服务器带宽。常见做法是把文件存到阿里云 OSS,再由服务端或浏览器按权限上传、读取。配置好阿里云oss js后,能不能顺利上传,除了调用 SDK,还要看 Bucket 配置、凭证和浏览器跨域规则是否匹配。

阿里云 OSS 和 JavaScript SDK

阿里云对象存储 OSS(Object Storage Service)可以保存图片、文档、音视频等文件。JavaScript 项目通常使用官方 ali-oss SDK 操作 OSS,可用于 Node.js,也可用于浏览器端。常见操作包括上传、下载、删除对象,以及生成带有效期的访问地址。

SDK 负责发起请求,不会替项目自动处理访问权限、CORS 或密钥安全。比如网页上传时,Bucket 没有允许当前网站的跨域请求,浏览器就可能拦截;把长期 AccessKey 写进前端代码,则会让访问者有机会拿到密钥。接入前应把这些配置一并考虑。

开始前准备 Bucket 和凭证

  • 创建 Bucket:选择存储地域,并确认文件的访问方式。个人资料、业务附件等私密文件通常不应设为公共读。
  • 记下地域和 Bucket 名称:初始化客户端时要使用控制台中的准确值,地域或名称填错都可能导致请求失败。
  • 安排凭证发放:长期 AccessKey 不要放进浏览器代码、网页配置或公开仓库。浏览器上传应由业务后端校验用户后,签发短期凭证。
  • 配置 CORS:浏览器直接请求 OSS 时,需要在 Bucket 中允许业务网站的来源、请求方法和所需请求头。

Node.js 项目安装并初始化 SDK

在 Node.js 项目中安装 ali-oss:

npm install ali-oss

服务端可以从环境变量读取密钥,避免把凭证写死在源代码里:

const OSS = require('ali-oss');
const client = new OSS({
  region: process.env.OSS_REGION,
  bucket: process.env.OSS_BUCKET,
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET
});

这段初始化代码应放在受控的服务端环境中。部署时要妥善管理环境变量,并限制密钥的权限和使用范围。网页端不能直接照搬这段配置:浏览器开发者工具可以查看前端代码,长期密钥一旦泄露,就可能被用于未授权操作。

如果由 Node.js 服务端接收文件并上传 OSS,可以在服务端校验用户和文件,再调用 SDK。若要让浏览器直传,则应采用临时凭证流程,避免文件先经过业务服务器,也避免把长期密钥交给用户。

浏览器上传:使用后端签发的临时凭证

浏览器直传通常分成三步:页面向业务后端申请上传凭证;后端检查用户身份和上传权限,再向阿里云 STS 获取有时效、有限权的临时凭证;页面拿到凭证后,使用 SDK 上传文件。凭证过期后不能继续使用,页面需要重新向后端申请。

浏览器端的 SDK 初始化方式会受版本和项目构建环境影响,实际接入时应对照所用版本的官方文档。常见配置包括地域、Bucket 和后端返回的临时身份凭证。不要把临时凭证长期缓存,也不要让用户自行指定不受限制的上传目录。

用户选择文件后,可以由系统生成对象名称,再调用上传方法:

const file = input.files[0];
const objectName = `uploads/${Date.now()}-${file.name}`;
const result = await client.put(objectName, file);
console.log(result.url);

这段代码展示的是基本调用。实际页面还应检查文件是否为空、限制允许的格式和大小,并显示上传进度、失败原因和重试入口。前端校验方便用户及时发现问题,但不能代替服务端授权和必要的文件检查。

活动后台上传海报的处理方式

例如,运营人员要在活动管理后台上传海报。页面先把登录状态交给后端验证,后端确认账号有活动管理权限后,返回短期上传凭证和允许使用的目录。页面拿凭证将图片直接传到 OSS,上传成功后,再把对象名称提交给业务接口。

业务后端可以保存对象名称、活动编号和上传人等信息。展示图片时,再根据 Bucket 的访问策略返回公开地址或签名地址。这样图片文件不必经过业务服务器,业务系统仍然能记录谁上传了什么,也能按自己的权限规则控制展示。

对象名称和目录最好由系统生成,不要直接使用用户提交的完整路径。否则可能出现文件覆盖、目录混乱,或文件被传入不应访问的位置。可以在文件名中加入随机值或唯一标识,同时把用户原始文件名单独保存为业务数据。

上传失败时先检查这些位置

  • 浏览器提示跨域错误:检查 Bucket 的 CORS 配置,确认来源、请求方法和请求头都符合当前请求,并留意规则是否已经生效。
  • 返回 AccessDenied:检查临时凭证是否过期、授权策略是否覆盖目标 Bucket 和目录,以及当前操作是否在授权范围内。
  • 找不到 Bucket 或无法连接:核对 Bucket 名称和地域,也检查当前网络环境。地域标识填错时,请求可能无法正常到达目标存储空间。
  • 文件较大或上传时间较长:根据 SDK 支持情况考虑分片上传,并为页面增加进度反馈、失败重试和取消操作。
  • 上传成功却打不开:确认对象权限和读取方式。私有文件一般需要通过后端生成有时效的签名 URL,不能把普通对象地址当成公开链接使用。

上线前检查权限和业务记录

临时凭证应按最小权限发放,只开放当前上传需要的 Bucket、目录和操作。私密文件不要设为公共读;签名 URL 要设置合理的有效期,它不是永久访问地址。文件类型和大小限制、上传日志及生命周期规则也要结合业务配置,方便排查问题和清理无用对象。

上传成功只说明文件已存入 OSS,不代表业务流程已经完成。页面可能被关闭,网络可能中断,用户也可能重复提交。业务接口应记录对象名称和上传状态,并处理失败、重复提交等情况。对图片内容有安全要求的项目,还可以在上传后增加服务端审核或扫描流程。

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

相关推荐

  • 阿里云香港主机怎么选?小站和跨境用起来差在哪

    网站放在哪里,通常是上线前最先要定的事。放在大陆服务器,需要先完成备案,审核周期可能要几周。放在海外,访问速度和管理方式又会有另一套问题。阿里云香港主机介于两者之间,不用备案,国内访问也比较稳定,所以很多小团队会先选它。 香港主机值得选在哪里 香港机房离大陆近,国内用户访问时的网络延迟一般比美西、东南亚节点低。如果你的官网、活动页或小程序后端主要面向大陆用户…

    2026年10月31日
  • 万网备案和阿里云备案有什么区别?选哪个更合适

    搭建网站或迁移服务器时,常见的疑问是:以前通过万网办过备案,换到阿里云后还要不要重新申请?域名要不要一起转过去?判断时别只看备案记录上写着“万网”还是“阿里云”,还要核对备案信息、网站接入服务和当前使用的服务器。 备案看接入服务,不只看域名 网站备案通常是指在中国大陆提供互联网信息服务时,按要求提交网站主办者和网站信息。备案信息由主管部门管理,云服务商等接入…

    阿里云 2026年11月15日
  • 阿里云印尼服务器怎么选?部署前先确认这5项

    业务开始面向印度尼西亚用户后,服务器部署在哪里,会影响访问体验、运维安排和合规评估。阿里云印尼服务器通常指部署在印度尼西亚地域的云计算资源,可用于网站、应用接口、游戏服务和本地业务系统。 它是否适合项目,不能只看机房离用户近不近。用户主要分布在哪些地区、系统如何拆分、数据需要怎样处理,以及长期费用能否接受,都需要一起评估。部署前把下面五项核实清楚,能减少迁移…

    阿里云 2026年11月15日
  • 阿里云搭梯子前,先确认部署是否符合合规要求

    搜索“阿里云搭梯子教程”的人,常见需求是出差时访问自己的服务器、办公系统或云上资源。不过,“搭梯子”也常被用来指绕过网络管理或访问限制,这类用途可能违反所在地法律法规、网络服务条款或单位制度。本文不提供规避限制的代理搭建方法,重点说明如何使用阿里云的正规网络产品,为自有业务建立范围明确、可管理的远程接入通道。 先明确需求:访问自有资源,还是转发全部流量 如果…

    阿里云 2026年11月15日
  • 阿里云代金券如何使用教程视频:从领券到下单抵扣的操作演示

    手里有阿里云代金券,常见的问题是找不到券、下单时没有抵扣选项,或者结算金额和预期不一样。操作时可以按“查看代金券—核对规则—选择商品—提交订单—确认抵扣”的顺序走一遍。阿里云控制台和活动页面可能会调整,菜单名称、入口位置以及页面展示以实际页面为准。 先看清代金券的使用条件 阿里云代金券通常用于抵扣符合条件的云产品订单费用,但不能当作现金使用,也不一定适用于所…

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