Перенос файлов в Supabase Storage
Скрипт на Node.js копирует файлы из Supabase Cloud в базу Татнет через Storage API. Он переносит объекты из списка, сохраняя имена бакетов, пути и типы файлов. Для небольшого набора, например 11 изображений, достаточно одного запуска.
Подготовьте бакеты и ключи
- В Studio базы Татнет откройте Storage и создайте бакеты с теми же именами и видимостью, что в исходном проекте. Для приватного бакета оставьте Public bucket выключенным.
- В исходном проекте Supabase Cloud откройте Project Settings → API Keys и скопируйте серверный
sb_secret_…или, если проект использует старые ключи,service_role. Ключ исходного проекта нужен для чтения файлов из обоих бакетов, включая приватный. - В панели Татнет откройте Supabase → ваша база и скопируйте API URL из карточки. В Открыть Studio → Project Settings → API Keys → Secret keys нажмите Reveal и скопируйте ключ назначения. Для старой базы см. инструкцию по ключам в Studio.
Составьте список файлов
Создайте отдельную папку для переноса и установите клиент Supabase. Для примера нужен Node.js 22 или новее.
npm init -y
npm install @supabase/supabase-js@2
Создайте в этой папке файл .env. Подставьте API URL обоих проектов и их серверные ключи. Храните .env локально и исключите его из Git.
SOURCE_URL=<API URL исходного проекта>
SOURCE_SERVICE_KEY=<серверный ключ исходного проекта>
TARGET_URL=<API URL базы Татнет>
TARGET_SERVICE_KEY=<серверный ключ базы Татнет>
В objects.json перечислите все файлы, которые нужно скопировать. Укажите имя исходного бакета и полный путь внутри него, включая вложенные папки. В примере ниже один файл из публичного бакета и один из приватного. Для переноса 11 изображений добавьте 11 записей.
[
{ "bucket": "public-images", "path": "catalog/cover.png" },
{ "bucket": "private-images", "path": "originals/cover.png" }
]
Запустите копирование
Сохраните пример как copy-storage.mjs рядом с objects.json и .env.
import { readFile } from 'node:fs/promises'
import { createClient } from '@supabase/supabase-js'
const auth = { persistSession: false, autoRefreshToken: false }
const source = createClient(process.env.SOURCE_URL, process.env.SOURCE_SERVICE_KEY, { auth })
const target = createClient(process.env.TARGET_URL, process.env.TARGET_SERVICE_KEY, { auth })
const objects = JSON.parse(await readFile(new URL('./objects.json', import.meta.url), 'utf8'))
if (!Array.isArray(objects) || objects.length === 0) {
throw new Error('Добавьте файлы в objects.json')
}
const paths = new Set()
const buckets = new Set()
for (const object of objects) {
if (!object || typeof object.bucket !== 'string' || !object.bucket.trim() ||
typeof object.path !== 'string' || !object.path.trim() || object.path.startsWith('/')) {
throw new Error('Укажите имя бакета и путь внутри него без начального /')
}
const fullPath = `${object.bucket}/${object.path}`
if (paths.has(fullPath)) throw new Error(`Путь указан дважды — ${fullPath}`)
paths.add(fullPath)
buckets.add(object.bucket)
}
// Проверяем доступ и видимость всех бакетов до загрузки первого файла.
for (const bucket of buckets) {
const original = await source.storage.getBucket(bucket)
const destination = await target.storage.getBucket(bucket)
if (original.error) throw new Error(`Исходный бакет ${bucket} — ${original.error.message}`)
if (destination.error) throw new Error(`Бакет в Татнет ${bucket} — ${destination.error.message}`)
if (original.data.public !== destination.data.public) {
throw new Error(`Видимость бакета ${bucket} отличается от исходной`)
}
}
let copied = 0
for (const { bucket, path } of objects) {
const fullPath = `${bucket}/${path}`
const { data: file, error: downloadError } = await source.storage.from(bucket).download(path)
if (downloadError) throw new Error(`Скачивание ${fullPath} — ${downloadError.message}`)
const { error: uploadError } = await target.storage.from(bucket).upload(path, await file.arrayBuffer(), {
contentType: file.type || 'application/octet-stream',
upsert: false,
})
if (uploadError) throw new Error(`Загрузка ${fullPath} — ${uploadError.message}`)
copied += 1
console.log(`[${copied}/${objects.length}] ${fullPath}`)
}
console.log(`Скопировано ${copied} из ${objects.length}`)
node --env-file=.env copy-storage.mjs
При ошибке скрипт останавливается. Исходные файлы и уже загруженные файлы остаются на месте. Проверьте список успешных загрузок, устраните ошибку и оставьте в objects.json только пути, которые ещё нужно перенести. При совпадении путей скрипт оставляет существующий файл и сообщает об ошибке загрузки.
Проверьте результат
- Сверьте количество и пути файлов с исходным списком в Studio → Storage. Для 11 изображений итог первого успешного запуска —
Скопировано 11 из 11. - Если приложение хранит полные URL публичных файлов, обновите их на адреса файлов в Татнет.
- Настройте политики RLS приватных файлов в целевой базе отдельно. Проверьте доступ под пользователем приложения и создавайте новые подписанные ссылки из базы Татнет.