Перейти до змісту

Швидкий старт StudioFS

Зміст посібника · English

Ця сторінка — найкоротший шлях від порожнього сервера до спільних дисків для вашої команди. Пояснень тут мінімум: якщо крок незрозумілий або щось пішло не так, відкривайте відповідну главу повного посібника.

Дані окремо, метадані окремо

StudioFS розділяє ваш диск на дві частини й зберігає їх у різних місцях:

  • Дані — вміст файлів: відео, звук, зображення, проєкти. Вони лежать у S3-сховищі зашифрованими частинами під технічними іменами. Відкривши bucket, ви не побачите там звичних папок і файлу interview.mov.
  • Метадані — усе, що робить набір частин диском: назви файлів, структура папок, розміри, дати, відомості про те, з яких частин складається кожен файл, а також ключ шифрування тому. Спільна копія метаданих зберігається в PostgreSQL.

Кожен робочий комп’ютер тримає власну локальну копію метаданих і кеш потрібних даних, тому перегляд папок і повторне відкриття файлів не чекають на сервер. Зміни спочатку приймаються локально, а потім у фоні передаються: вміст — у S3, метадані — у PostgreSQL. Звідти їх отримують інші комп’ютери.

Звідси головне правило: S3 і PostgreSQL існують лише в парі. Без метаданих набір об’єктів у S3 не перетвориться назад на файли, а без S3 метадані — лише перелік назв. Резервні копії потрібні для обох.

Що отримаємо наприкінці

Два диски StudioFS з однією спільною базою метаданих:

  • homesilo — дані у власному сховищі RustFS за Caddy на вашому сервері.
  • cloudsilo — дані в Backblaze B2.
                       ┌── Tailscale ── PostgreSQL :5432        (метадані обох дисків)
Робочі комп’ютери ─────┼── HTTPS ────── RustFS + Caddy          (дані homesilo)
                       └── HTTPS ────── Backblaze B2            (дані cloudsilo)

Якщо потрібен лише один із дисків, пропустіть кроки для іншого.

Що потрібно, щоб почати

  • Сервер для PostgreSQL — Linux-сервер або VPS із Docker і доступом через SSH.
  • Сервер для RustFS — Linux-сервер із Docker, достатнім дисковим простором, доменом і відкритими портами 80/443. Може бути тим самим сервером, що й PostgreSQL.
  • Обліковий запис Backblaze — для диска cloudsilo.
  • Комп’ютери клієнтів — один або кілька комп’ютерів із Windows, macOS або Linux, на яких працюватимуть із файлами. Бажано з вільним місцем на SSD під кеш.
  • Обліковий запис Tailscale — для приватного доступу всіх комп’ютерів до PostgreSQL.

1. Tailscale на сервері

Зареєструйтеся в Tailscale, а на сервері виконайте:

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
tailscale ip -4

Запишіть адресу на кшталт 100.101.102.103 — далі вона позначається як PG_TAILSCALE_IP. Детальніше: глава 08.

2. PostgreSQL

mkdir -p ~/studiofs-postgres/pgdata && cd ~/studiofs-postgres

Створіть compose.yaml (замініть пароль на власний):

services:
  postgres:
    image: postgres:18-alpine
    restart: unless-stopped
    environment:
      POSTGRES_DB: studiofs
      POSTGRES_USER: studiofs
      POSTGRES_PASSWORD: CHANGE_ME_STRONG_PASSWORD
      PGDATA: /var/lib/postgresql/data
    ports:
      - "5432:5432"
    volumes:
      - ./pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U studiofs -d studiofs"]
      interval: 10s
      timeout: 5s
      retries: 5

docker compose up -d
docker compose ps        # чекаємо статус healthy

Закрийте порт 5432 для інтернету у firewall провайдера VPS.

Налаштування продуктивності та резервні копії: глава 07. Не видаляйте pgdata — це метадані всіх дисків.

3. Сховище для homesilo: RustFS + Caddy

Потрібні домен, наприклад s3.example.com, з A-записом на публічну IP-адресу сервера та відкриті порти 80 і 443. Без домену RustFS можна використовувати й за адресою IP:порт, наприклад http://203.0.113.10:9000, але це менш зручно: з’єднання йде без HTTPS, а якщо IP-адреса сервера зміниться, endpoint доведеться оновлювати на всіх комп’ютерах. RustFS і Caddy запускаються одним compose.yaml: Caddy приймає HTTPS-з’єднання й сам отримує та продовжує сертифікат Let’s Encrypt, а RustFS назовні не публікується взагалі. Усі дані лежать у папках поруч із compose.yaml.

mkdir -p ~/rustfs && cd ~/rustfs
mkdir -p rustfs-data caddy-data caddy-config
sudo chown -R 10001:10001 rustfs-data   # RustFS у контейнері працює від UID/GID 10001

compose.yaml:

services:
  rustfs:
    image: rustfs/rustfs:1.0.3
    restart: unless-stopped
    environment:
      RUSTFS_VOLUMES: /data
      RUSTFS_ADDRESS: 0.0.0.0:9000
      RUSTFS_CONSOLE_ENABLE: "true"
      RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001
      RUSTFS_ACCESS_KEY: CHANGE_ME_ADMIN_KEY
      RUSTFS_SECRET_KEY: CHANGE_ME_ADMIN_SECRET
    ports:
      - "127.0.0.1:9001:9001"   # вебконсоль, лише для SSH-тунелю
    volumes:
      - ./rustfs-data:/data

  caddy:
    image: caddy:2.11
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - ./caddy-data:/data
      - ./caddy-config:/config
    depends_on:
      - rustfs

Поруч створіть Caddyfile, замінивши домен на свій:

s3.example.com {
    reverse_proxy rustfs:9000
}

docker compose up -d
docker compose logs -f caddy   # чекаємо повідомлення про отриманий сертифікат, вихід — Ctrl+C

Додатково нічого налаштовувати не потрібно: Caddy за замовчуванням не обмежує розмір запиту, передає дані потоком і не змінює заголовок Host, від якого залежить підпис S3-запитів. Перевірка: curl -I https://s3.example.com/ має повернути відповідь від RustFS (зазвичай 403 без підпису — це нормально), а не помилку з’єднання чи сертифіката.

Що де лежить:

Папка Вміст
rustfs-data/ дані homesilo. Щоб зберігати їх на дисковому масиві, зробіть цю папку точкою монтування масиву або символьним посиланням на нього
caddy-data/ сертифікати Let’s Encrypt. Не видаляйте, інакше Caddy запитуватиме їх заново
caddy-config/ службова конфігурація Caddy

rustfs/rustfs:1.0.3 — актуальний стабільний випуск RustFS на момент написання; перевірте сторінку випусків і за потреби вкажіть новіший.

Bucket, політика й ключ

Вебконсоль RustFS відкрийте через SSH-тунель, не публікуючи її в інтернет:

ssh -L 9001:127.0.0.1:9001 user@your-server

Потім у браузері — http://127.0.0.1:9001, вхід з адміністративними ключами з compose.yaml. Адміністративні ключі в StudioFS не використовуємо: створимо окремого користувача лише з правами на bucket та об’єкти.

  1. Створіть приватний bucket homesilo. Цей крок можна пропустити: завдяки політиці нижче studiofs init створить bucket сам.
  2. У розділі Identity створіть політику studiofs з таким JSON:
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:ListAllMyBuckets",
        "s3:CreateBucket",
        "s3:GetBucketLocation",
        "s3:ListBucket",
        "s3:ListBucketMultipartUploads"
      ],
      "Resource": ["arn:aws:s3:::*"]
    },
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:PutObject",
        "s3:DeleteObject",
        "s3:AbortMultipartUpload",
        "s3:ListMultipartUploadParts"
      ],
      "Resource": ["arn:aws:s3:::*/*"]
    }
  ]
}

Перший блок дозволяє бачити й створювати bucket і перелічувати об’єкти в них. Другий — читати, записувати й видаляти об’єкти, зокрема великими частинами (multipart). Політика діє на будь-який bucket цього RustFS, тож для наступних дисків нічого перенастроювати не доведеться. Видаляти самі bucket вона не дозволяє. Тому тримайте в цьому RustFS лише дані StudioFS або використовуйте окремий інстанс для інших задач. 3. Там само створіть користувача studiofs із надійним секретним ключем і призначте йому політику studiofs. Ім’я користувача — це його Access Key, секретний ключ — Secret Key.

Значення для init:

Параметр Значення
--endpoint https://s3.example.com
--bucket homesilo
--region us-east-1
--access-key studiofs
--secret-key секретний ключ цього користувача

4. Сховище для cloudsilo: Backblaze B2

  1. У панелі Backblaze створіть bucket: Private. Назви bucket у B2 глобально унікальні, тож додайте щось своє, наприклад cloudsilo-yourstudio. Lifecycle-правила на автоматичне видалення не вмикайте.
  2. У параметрах bucket знайдіть Endpoint, наприклад s3.us-west-004.backblazeb2.com. Частина між s3. і .backblazeb2.com — це region.
  3. У розділі Application Keys створіть ключ, обмежений цим bucket, з доступом Read and Write. Збережіть keyID і applicationKey одразу: секрет показують лише один раз.
Параметр Значення
--endpoint https://s3.us-west-004.backblazeb2.com
--bucket cloudsilo-yourstudio
--region us-west-004
--access-key keyID
--secret-key applicationKey

5. Перший комп’ютер

Tailscale і доступ до бази

Встановіть Tailscale (Windows, macOS, Linux) і увійдіть у той самий tailnet. Перевірте порт:

# Windows
Test-NetConnection 100.101.102.103 -Port 5432

# macOS / Linux
nc -vz 100.101.102.103 5432

Встановлення StudioFS

Система Драйвер Детально
Windows x64 WinFSP 2026+ глава 10
macOS macFUSE 5.4.0+ (потрібен дозвіл системного розширення й перезапуск) глава 11
Linux fuse3 з репозиторію дистрибутива глава 12

Завантажте збірку для своєї системи зі сторінки випусків, покладіть studiofs у PATH і перевірте:

studiofs --version

На macOS і Linux підготуйте батьківську папку для монтування:

# macOS
sudo mkdir -p /Volumes/Studiofs && sudo chown "$(id -un):$(id -gn)" /Volumes/Studiofs
# Linux
sudo mkdir -p /mnt/StudioFS && sudo chown "$(id -un):$(id -gn)" /mnt/StudioFS

Створення дисків

Запускайте від свого звичайного користувача, без sudo. Підставте свої значення з кроків 3 і 4 і виберіть блок для своєї оболонки. Обидва диски використовують той самий PostgreSQL.

homesilo, macOS / Linux:

studiofs init homesilo \
  --endpoint 'https://s3.example.com' \
  --bucket 'homesilo' \
  --region 'us-east-1' \
  --access-key 'studiofs' \
  --secret-key 'YOUR_RUSTFS_SECRET_KEY' \
  --meta 'postgresql://studiofs:YOUR_PASSWORD@100.101.102.103:5432/studiofs'

homesilo, Windows PowerShell:

studiofs init homesilo `
  --endpoint 'https://s3.example.com' `
  --bucket 'homesilo' `
  --region 'us-east-1' `
  --access-key 'studiofs' `
  --secret-key 'YOUR_RUSTFS_SECRET_KEY' `
  --meta 'postgresql://studiofs:YOUR_PASSWORD@100.101.102.103:5432/studiofs'

cloudsilo, macOS / Linux:

studiofs init cloudsilo \
  --endpoint 'https://s3.us-west-004.backblazeb2.com' \
  --bucket 'cloudsilo-yourstudio' \
  --region 'us-west-004' \
  --access-key 'YOUR_B2_KEY_ID' \
  --secret-key 'YOUR_B2_APPLICATION_KEY' \
  --meta 'postgresql://studiofs:YOUR_PASSWORD@100.101.102.103:5432/studiofs'

cloudsilo, Windows PowerShell:

studiofs init cloudsilo `
  --endpoint 'https://s3.us-west-004.backblazeb2.com' `
  --bucket 'cloudsilo-yourstudio' `
  --region 'us-west-004' `
  --access-key 'YOUR_B2_KEY_ID' `
  --secret-key 'YOUR_B2_APPLICATION_KEY' `
  --meta 'postgresql://studiofs:YOUR_PASSWORD@100.101.102.103:5432/studiofs'

Успіх — це рядки:

✓ Volume 'homesilo' initialized
✓ Volume 'cloudsilo' initialized

Якщо init впав, не запускайте його повторно навмання й не погоджуйтеся на CLEAR: спершу прочитайте помилку (глава 13).

Підключення

Кожен диск підключається окремою командою. Для щоденної роботи додайте -d (фоновий режим); без нього кожна команда займає своє вікно термінала, зате помилки видно одразу.

# Windows: вільні літери дисків
studiofs mount homesilo H: -d
studiofs mount cloudsilo K: -d

# macOS → /Volumes/Studiofs/homesilo і /Volumes/Studiofs/cloudsilo
studiofs mount homesilo /Volumes/Studiofs -d
studiofs mount cloudsilo /Volumes/Studiofs -d
# Linux → /mnt/StudioFS/homesilo і /mnt/StudioFS/cloudsilo
studiofs mount homesilo /mnt/StudioFS -d
studiofs mount cloudsilo /mnt/StudioFS -d

Створіть на кожному диску тестову папку, переконайтеся, що вона з’явилася, і видаліть її.

Відключення: studiofs umount H: / studiofs umount /Volumes/Studiofs/homesilo / studiofs umount /mnt/StudioFS/homesilo, і так само для cloudsilo. Детальніше: глави 14 і 17.

6. Решта комп’ютерів

На кожному новому комп’ютері: Tailscale + перевірка порту 5432, драйвер і studiofs, як у кроці 5. init не потрібен — диски вже існують.

Додавати комп’ютер колеги у свій tailnet не обов’язково. Достатньо поділитися з ним лише сервером PostgreSQL:

  1. У панелі Tailscale на сторінці Machines відкрийте меню сервера PostgreSQL і виберіть Share.
  2. Надішліть колезі посилання-запрошення або запросіть його за email.
  3. Колега встановлює Tailscale, входить у власний обліковий запис і приймає запрошення.

Після цього сервер з’явиться в його мережі з тією самою адресою 100.101.102.103. Колега бачить лише цей сервер, а не решту ваших пристроїв, і ви можете в будь-який момент відкликати доступ. Перевірка порту 5432 — така сама, як у кроці 5.

studiofs discover homesilo --meta 'postgresql://studiofs:YOUR_PASSWORD@100.101.102.103:5432/studiofs'
studiofs discover cloudsilo --meta 'postgresql://studiofs:YOUR_PASSWORD@100.101.102.103:5432/studiofs'

discover завантажує лише метадані; S3-ключі надходять з конфігурації диска, вводити їх не потрібно. Далі той самий mount, що й на першому комп’ютері:

studiofs mount homesilo H: -d
studiofs mount cloudsilo K: -d

studiofs mount homesilo /Volumes/Studiofs -d    # macOS
studiofs mount cloudsilo /Volumes/Studiofs -d
studiofs mount homesilo /mnt/StudioFS -d        # Linux
studiofs mount cloudsilo /mnt/StudioFS -d

Перше підключення на новому комп’ютері може зайняти трохи часу: StudioFS завантажує до себе всі метадані диска. Самі файли при цьому не завантажуються — їхній вміст надходить із S3, коли ви їх відкриваєте.

Перевірка в обидва боки: створіть hello-from-a.txt на першому комп’ютері й відкрийте його вміст на другому, потім навпаки. Маленький файл має з’явитися майже одразу.

Виконуйте discover і mount від одного й того самого користувача: локальний стан лежить у ~/.studiofs. Повторний discover після перезапуску не потрібен — достатньо mount. Детальніше: глава 16.

Що далі

Зміст · English