如何从客户端直接上传文件至MinIO？（Node.js+Express场景）

完全可以实现，核心思路是使用MinIO的预签名上传URL：后端通过MinIO SDK生成一个临时、带有效期的上传URL返回给客户端，客户端拿到后直接向MinIO发起PUT请求上传文件，全程不需要后端接收文件再转发，彻底避免multer这类工具的代理托管环节。

实现步骤 #

1. 后端（Express）生成预签名URL #

首先安装MinIO Node.js SDK：

npm install minio

编写Express接口负责生成预签名上传URL：

const express = require('express');
const Minio = require('minio');
const app = express();

// 初始化MinIO客户端
const minioClient = new Minio.Client({
    endPoint: '你的MinIO服务地址', // 示例：localhost:9000
    port: 9000,
    useSSL: false, // 生产环境根据实际配置开启SSL
    accessKey: '你的MinIO AccessKey',
    secretKey: '你的MinIO SecretKey'
});

// 检查并自动创建目标bucket（可选，确保上传目标存在）
async function ensureBucketExists(bucketName) {
    const exists = await minioClient.bucketExists(bucketName);
    if (!exists) {
        await minioClient.makeBucket(bucketName);
    }
}

// 生成预签名上传URL的接口
app.get('/api/get-presigned-upload-url', async (req, res) => {
    const { fileName, bucketName = 'musics' } = req.query;
    if (!fileName) {
        return res.status(400).json({ error: 'fileName 参数为必填项' });
    }

    try {
        await ensureBucketExists(bucketName);
        // 生成有效期1小时的PUT请求预签名URL
        const presignedUrl = await minioClient.presignedPutObject(bucketName, fileName, 3600);
        res.json({ presignedUrl });
    } catch (err) {
        console.error('生成预签名URL失败:', err);
        res.status(500).json({ error: '生成上传链接失败' });
    }
});

app.listen(3000, () => {
    console.log('Express服务运行在 http://localhost:3000');
});

2. 客户端直接上传到MinIO #

客户端通过向后端获取预签名URL后，直接发起PUT请求上传文件，以下是浏览器端示例代码：

<input type="file" id="fileUploader">
<button onclick="handleUpload()">开始上传</button>

<script>
async function handleUpload() {
    const file = document.getElementById('fileUploader').files[0];
    if (!file) return alert('请选择文件');

    // 1. 向后端请求预签名URL
    const urlResp = await fetch(`/api/get-presigned-upload-url?fileName=${encodeURIComponent(file.name)}`);
    const { presignedUrl } = await urlResp.json();

    // 2. 直接向MinIO上传文件
    const uploadResp = await fetch(presignedUrl, {
        method: 'PUT',
        body: file,
        headers: {
            'Content-Type': file.type // 可选，指定文件MIME类型，MinIO也可自动识别
        }
    });

    if (uploadResp.ok) {
        alert('文件上传成功');
    } else {
        alert('文件上传失败');
    }
}
</script>

关键注意事项 #

• 安全原则：绝对不要在客户端暴露MinIO的AccessKey和SecretKey，所有签名操作必须在后端完成，客户端仅使用临时的预签名URL。
• URL有效期：可根据业务需求调整预签名URL的有效期（示例中为3600秒），有效期越短安全性越高。
• Bucket权限：确保MinIO的目标Bucket配置了正确的上传权限，同时预签名URL对应的PUT操作权限有效。
• 文件元数据：如果需要自定义文件元数据（如存储类型、缓存策略），可以在生成预签名URL时通过presignedPutObject的额外参数指定。

内容的提问来源于stack exchange，提问作者mahdi