Scaleway 是欧洲领先的云服务提供商,总部位于法国巴黎,旗下产品涵盖对象存储、虚拟主机、Kubernetes、Serverless 容器和数据库等。对于使用 Vue 3 的前端团队而言,Scaleway 最吸引人的地方在于其对象存储服务价格低廉、兼容 S3 API,而且提供了欧洲多个区域的数据中心。不过在实际集成过程中,很多开发者会遇到跨域、权限签名、环境变量管理等问题。下面我们围绕 Vue 3 + Scaleway 的工程化实践展开详细讨论。

Scaleway 核心服务与 Vue 3 集成场景
Scaleway 的产品线大致分为计算、存储、网络和 AI 四类。在 Vue 3 单页应用中最常用的通常是对象存储(Object Storage)和 Serverless Functions。对象存储可以用来托管前端构建产物,实现静态网站托管;也可以作为用户上传图片、文件的存储后端。Serverless Functions 则适合编写轻量级的 API 接口,例如生成预签名 URL、处理表单提交或调用第三方服务。
在 Vue 3 项目中集成这些服务,并不要求使用官方 SDK。Scaleway 对象存储兼容 AWS S3 协议,因此可以直接使用 AWS 的 JavaScript SDK,或者更轻量的 @aws-sdk/client-s3。如果你不想在前端直接暴露访问密钥,还可以通过后端或 Serverless 函数来中转请求。下面是一个最简单的调用示例,展示如何在 Vite 创建的 Vue 3 项目中初始化 S3 客户端:
// src/utils/scaleway.ts
import { S3Client, PutObjectCommand } from "@aws-sdk/client-s3";
const s3Client = new S3Client({
region: "fr-par",
endpoint: "https://s3.fr-par.scw.cloud",
credentials: {
accessKeyId: import.meta.env.VITE_SCW_ACCESS_KEY,
secretAccessKey: import.meta.env.VITE_SCW_SECRET_KEY,
},
forcePathStyle: true,
});
export async function uploadFile(file: File) {
const command = new PutObjectCommand({
Bucket: "my-vue-bucket",
Key: `uploads/${Date.now()}-${file.name}`,
Body: file,
ContentType: file.type,
});
return s3Client.send(command);
}
这段代码把访问密钥放在 Vite 的环境变量中,通过 import.meta.env 读取。需要注意的是,前端代码中硬编码 Secret Key 存在安全风险,生产环境应改用预签名 URL 或后端代理。我们会在后面的章节中详细说明更安全的做法。
除了对象存储,Serverless Functions 也非常适合与 Vue 3 配合使用。例如,你可以在 Scaleway 上创建一个 Python 或 Node.js 函数,用来接收前端表单数据并写入数据库。Vue 3 端只需要用 fetch 或 axios 调用该函数的 HTTPS 端点即可。这种架构把密钥和业务逻辑都留在服务端,前端只负责展示和交互。
工程化配置与环境变量管理
Vue 3 项目通常使用 Vite 作为构建工具。Vite 提供了 .env 文件机制,可以区分开发环境和生产环境。集成 Scaleway 时,我们需要把区域、Bucket 名称、API 端点等配置集中管理,避免散落在代码各处。推荐在项目根目录创建 .env.development 和 .env.production 两个文件,分别写入不同的值。
例如开发环境可能使用本地的 MinIO 模拟 S3 服务,而生产环境则指向 Scaleway 的巴黎区域。下面是一个 .env.development 的示例:
VITE_SCW_ENDPOINT=http://localhost:9000 VITE_SCW_REGION=fr-par VITE_SCW_BUCKET=dev-assets VITE_SCW_ACCESS_KEY=minioadmin VITE_SCW_SECRET_KEY=minioadmin
对于生产环境,密钥不应该被直接打包进前端代码。一种常见的做法是在构建阶段通过 CI 环境变量注入,而这些变量在仓库中是加密存储的。Vite 在构建时会把 import.meta.env.VITE_* 替换为对应的字符串,因此任何拥有前端 JS 文件的人都能看到这些值。如果你必须在前端使用密钥,请确保该密钥只具有最小权限,例如仅允许向特定 Bucket 写入,且不能删除或列出对象。
跨域问题也是集成过程中容易踩坑的地方。如果 Vue 3 应用部署在 Scaleway 对象存储静态托管域名下,而 API 函数或对象存储的访问域名不同,浏览器会阻止跨域请求。解决办法有两个:一是在 Scaleway 对象存储的 CORS 配置中允许前端域名;二是在 Vite 开发服务器中配置代理。开发模式下,可以在 vite.config.ts 中这样设置:
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
export default defineConfig({
plugins: [vue()],
server: {
proxy: {
'/scw-api': {
target: 'https://your-function.functions.fnc.fr-par.scw.cloud',
changeOrigin: true,
rewrite: (path) => path.replace(/^\/scw-api/, ''),
},
},
},
})
这样在开发时,前端请求 /scw-api/xxx 会被代理到 Scaleway 的 Serverless 函数,避免了浏览器直接跨域。生产环境则需要在函数端配置 CORS 头部,允许前端域名访问。
实战:上传文件到 Scaleway 对象存储
上传文件是很多 Vue 3 应用的基础功能,比如用户头像、图片素材、附件等。直接在浏览器中上传到对象存储需要解决两个问题:权限控制和进度反馈。权限控制推荐使用预签名 URL,即后端或 Serverless 函数生成一个带过期时间和权限限制的临时 URL,前端拿到这个 URL 后直接上传文件,无需持有密钥。
假设你已经在 Scaleway 上创建了一个 Serverless Function,该函数负责生成预签名 PUT URL。函数内部使用 AWS SDK 的 getSignedUrl 方法,返回给前端一个可以直接上传的地址。Vue 3 端的上传组件可以这样实现:
<template>
<div>
<input type="file" @change="onFileChange" />
<button @click="upload" :disabled="!file || uploading">上传</button>
<progress :value="progress" max="100"></progress>
</div>
</template>
<script setup lang="ts">
import { ref } from 'vue'
const file = ref<File | null>(null)
const uploading = ref(false)
const progress = ref(0)
function onFileChange(event: Event) {
const target = event.target as HTMLInputElement
file.value = target.files?.[0] || null
}
async function upload() {
if (!file.value) return
uploading.value = true
progress.value = 0
// 第一步:从 Serverless 函数获取预签名 URL
const presignResp = await fetch('/scw-api/presign', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
fileName: file.value.name,
contentType: file.value.type,
}),
})
const { uploadUrl } = await presignResp.json()
// 第二步:使用 XMLHttpRequest 上传以获取进度
await new Promise((resolve, reject) => {
const xhr = new XMLHttpRequest()
xhr.open('PUT', uploadUrl)
xhr.setRequestHeader('Content-Type', file.value!.type)
xhr.upload.onprogress = (e) => {
if (e.lengthComputable) {
progress.value = Math.round((e.loaded / e.total) * 100)
}
}
xhr.onload = () => xhr.status === 200 ? resolve(null) : reject(new Error('上传失败'))
xhr.onerror = () => reject(new Error('网络错误'))
xhr.send(file.value)
})
uploading.value = false
}
</script>
上面的代码展示了完整的流程:先请求预签名 URL,然后使用原生 XMLHttpRequest 上传文件以便监听进度事件。如果你更喜欢 axios,需要配置 onUploadProgress 来实现类似效果。预签名 URL 的有效期通常设置为几分钟到几小时,Scaleway 默认支持最长 7 天,但为了安全不建议设置过长。
另一种做法是在前端直接使用 S3 SDK 的 PutObjectCommand,并配合 Cognito 身份池或临时凭证。但 Scaleway 目前对 IAM 策略的支持不如 AWS 灵活,因此预签名 URL 是更稳妥的方案。上传完成后,你可以在前端直接拼接对象的公开访问地址,或者再调用一次后端函数来获取带 CDN 的链接。
部署 Vue 3 应用与 Scaleway 集成最佳实践
当 Vue 3 项目开发完成,需要部署到生产环境时,Scaleway 提供了多种选择。最简单的是把 dist 目录上传到对象存储,并开启静态网站托管功能。你可以在 Scaleway 控制台创建一个公开读的 Bucket,将构建产物全部上传,然后绑定一个自定义域名。Vite 构建默认使用绝对路径,如果应用部署在子路径下,需要修改 base 配置。
下面是一个部署脚本示例,它使用 AWS CLI 的 S3 同步命令把本地构建产物推送到 Scaleway:
# 安装 AWS CLI 并配置 Scaleway 凭证 aws configure set aws_access_key_id $SCW_ACCESS_KEY aws configure set aws_secret_access_key $SCW_SECRET_KEY # 同步 dist 目录到 Scaleway 对象存储 aws s3 sync ./dist s3://my-vue-app \ --endpoint-url https://s3.fr-par.scw.cloud \ --region fr-par \ --delete
需要注意的是,Scaleway 对象存储的静态网站托管功能要求所有文件为公开读,且需要设置索引文档和错误文档。你可以在 Bucket 的属性中配置 index.html 作为索引文档。对于 Vue Router 的 history 模式,还需要配置错误文档也为 index.html,否则刷新子路由会返回 404。
如果应用需要后端 API,可以考虑使用 Scaleway 的 Serverless Containers 或 Kubernetes。Serverless Containers 允许你把整个 Node.js 服务打包成容器,按请求计费,适合轻量级 API。Vue 3 前端仍然部署在对象存储,API 请求通过环境变量指向容器域名。这种前后端分离的架构在 Scaleway 上成本很低,而且可以独立扩展。
最后要强调的是监控和日志。Scaleway 提供了 Metrics 和 Logs 服务,建议在 Vue 3 应用中加入错误上报,例如使用 Sentry 或自定义的 window.onerror 处理函数,把错误信息发送到 Serverless 函数并记录到 Scaleway 日志中。这样当线上出现问题时,你能快速定位是前端代码还是云服务配置导致的。