0Pricing
Supabase Backend as a Service · Урок

Хранение файлов в хранилищах Supabase

Узнайте, как создавать хранилища и управлять ими, а также программно загружать файлы различных типов в проект Supabase.

«Хранение файлов в хранилищах Supabase» — бесплатный урок Supabase Backend as a Service на CoddyKit. Это урок 1 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Supabase Backend as a Service, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Supabase Backend as a Service содержит 4 уроков всего.

Части этого урока еще не переведены и отображаются на английском.

Welcome to Supabase Storage

Managing files like images, videos, and documents is crucial for many apps. Supabase offers a robust, S3-compatible object storage solution right out of the box!

It's designed for scalability and security, letting you store and serve user-generated content or application assets with ease.

Understanding Storage Buckets

Think of a bucket as a top-level folder or container for your files. Each Supabase project can have multiple buckets.

  • Organize files by type (e.g., avatars, product-images).
  • Set different security rules for each bucket.
  • Buckets are isolated, meaning files in one bucket don't mix with another.

Create a Bucket in the Dashboard

You can create buckets directly from the Supabase Dashboard. Navigate to the Storage section and click "New bucket".

Give it a unique name and decide if it should be public or private. We'll explore these options next!

Public or Private Access?

This is a key decision when creating a bucket:

  • Public Buckets: Anyone with the URL can access files. Great for static assets like profile pictures or public documents.
  • Private Buckets: Files require authentication and specific policies to be accessed. Ideal for sensitive user data or premium content.

You can change this setting later, but it's good to plan ahead!

Setting Up for Uploads (JS)

To upload files from your app, you'll use the Supabase client library. First, ensure you have your Supabase URL and anon key initialized.

We'll use a simple JavaScript example. Imagine supabase is your initialized client.

import { createClient } from '@supabase/supabase-js';

const SUPABASE_URL = 'YOUR_SUPABASE_URL';
const SUPABASE_ANON_KEY = 'YOUR_ANON_KEY';

const supabase = createClient(SUPABASE_URL, SUPABASE_ANON_KEY);

console.log('Supabase client initialized.');

Programmatically Upload a File

The storage.from().upload() method is your go-to for uploading. It needs the bucket name, the path within the bucket, and the file itself.

Let's simulate uploading a simple text file. In a real app, you'd get the file from an HTML <input type="file">.

import { createClient } from '@supabase/supabase-js';

const SUPABASE_URL = 'YOUR_SUPABASE_URL';
const SUPABASE_ANON_KEY = 'YOUR_ANON_KEY';

const supabase = createClient(SUPABASE_URL, SUPABASE_ANON_KEY);

async function uploadFile() {
  // In a real app, 'file' would come from an input element
  const mockFile = new File(['Hello CoddyKit!'], 'hello.txt', {
    type: 'text/plain',
  });

  const { data, error } = await supabase.storage
    .from('my-first-bucket') // Replace with your bucket name
    .upload('public/hello_world.txt', mockFile);

  if (error) {
    console.error('Upload error:', error.message);
  } else {
    console.log('Upload successful:', data);
  }
}

uploadFile();

File Paths & Overwrite Behavior

The 'path' in .upload('path/to/file.txt', file) determines where your file lands within the bucket.

  • 'my-image.jpg': Uploads to the bucket's root.
  • 'avatars/user123.png': Creates an avatars folder if it doesn't exist.

By default, uploading to an existing path will overwrite the old file. You can control this with the upsert option.

Controlling Overwrites with Upsert

The upsert option in the upload method lets you decide what happens if a file with the same path already exists.

  • upsert: true (default): Overwrites the existing file.
  • upsert: false: Returns an error if a file with the same path exists, preventing accidental overwrites.

Use upsert: false when you want to ensure unique file names.

import { createClient } from '@supabase/supabase-js';

const SUPABASE_URL = 'YOUR_SUPABASE_URL';
const SUPABASE_ANON_KEY = 'YOUR_ANON_KEY';

const supabase = createClient(SUPABASE_URL, SUPABASE_ANON_KEY);

async function uploadUniqueFile() {
  const mockFile = new File(['Unique content!'], 'unique.txt', {
    type: 'text/plain',
  });

  // This will fail if 'public/unique.txt' already exists
  const { data, error } = await supabase.storage
    .from('my-first-bucket') // Replace with your bucket name
    .upload('public/unique.txt', mockFile, { upsert: false });

  if (error) {
    console.error('Upload failed (file exists or other error):', error.message);
  } else {
    console.log('Unique upload successful:', data);
  }
}

uploadUniqueFile();

Handles All Your File Needs

Supabase Storage isn't limited to just images or text files. It can handle any file type you throw at it!

  • Images: PNG, JPG, GIF, SVG
  • Videos: MP4, MOV, WebM
  • Documents: PDF, DOCX, XLSX
  • Audio: MP3, WAV

Just ensure your client-side code provides the correct file object.

Quick Check on Buckets

You've learned about Supabase Storage buckets and how to upload files. Let's test your understanding!

Recap: Storing Files

Great job! You've learned the fundamentals of Supabase Storage:

  • What buckets are and how to create them.
  • The difference between public and private buckets.
  • How to programmatically upload files using the Supabase client.
  • Controlling file overwrites with the upsert option.

Next, you'll dive into securing your files with Storage Policies!

Часто задаваемые вопросы

Урок «Хранение файлов в хранилищах Supabase» бесплатный?

Да — полный текст урока «Хранение файлов в хранилищах Supabase» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Supabase Backend as a Service, подпишись на CoddyKit PRO. Курс Supabase Backend as a Service содержит 4 уроков всего.

Чему я научусь в уроке «Хранение файлов в хранилищах Supabase»?

Узнайте, как создавать хранилища и управлять ими, а также программно загружать файлы различных типов в проект Supabase. Ты практикуешь Supabase Backend as a Service с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Supabase Backend as a Service?

Предыдущий опыт не требуется. Supabase Backend as a Service на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 1 из 4.

Сколько времени занимает урок «Хранение файлов в хранилищах Supabase»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Supabase Backend as a Service?

Да. Каждый урок Supabase Backend as a Service включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Хранение файлов в хранилищах Supabase
  2. Управление доступом с помощью политик
  3. Загрузка и получение медиаданных
  4. Преобразование изображений и подписанные URL-адреса
← Назад к Supabase Backend as a Service