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

Конфігурація

Після успішного встановлення Seafile через Docker Compose, наступним кроком є налаштування веб-сервера для обробки HTTPS-трафіку та маршрутизації запитів до Seafile. Ми будемо використовувати Caddy – сучасний веб-сервер, який автоматично керує сертифікатами TLS від Let's Encrypt, що значно спрощує налаштування HTTPS.

1. Підготовка доменного імені

Переконайтеся, що у вас є зареєстроване доменне ім'я (наприклад, cloud.yourdomain.com) та DNS-запис типу A або AAAA, що вказує на IP-адресу вашого VPS. Без цього Caddy не зможе отримати SSL-сертифікат.

2. Додавання Caddy до docker-compose.yml

Відредагуємо існуючий файл docker-compose.yml, додавши сервіс Caddy.

sudo nano /opt/seafile/docker-compose.yml

Додайте новий сервіс caddy в кінець файлу, а також змініть порт seafile, щоб він не конфліктував з Caddy, якщо ви запускали Seafile без Caddy спочатку. Переконайтеся, що порти 80 і 443 доступні на вашому VPS (ми відкрили їх в UFW раніше).

version: '3.8'
services:
  db:
    image: postgres:15
    container_name: seafile-db
    environment:
      - POSTGRES_USER=seafile
      - POSTGRES_PASSWORD=your_db_password
      - POSTGRES_DB=seafile
      - PGDATA=/var/lib/postgresql/data/pgdata
    volumes:
      - /opt/seafile/db_data:/var/lib/postgresql/data/pgdata
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U seafile -d seafile"]
      interval: 10s
      timeout: 5s
      retries: 5

  memcached:
    image: memcached:1.6
    container_name: seafile-memcached
    restart: unless-stopped

  seafile:
    image: seafileltd/seafile-pro:13.0.0
    container_name: seafile
    # Удалите или закомментируйте порты 8000 и 8082, если вы их указывали для прямого доступа.
    # Caddy будет проксировать запросы к внутренним портам контейнера Seafile.
    # ports:
    #   - "8000:8000"
    #   - "8082:8082"
    volumes:
      - /opt/seafile/data:/shared
      - /opt/seafile/logs:/var/log/seafile
      - /opt/seafile/conf:/opt/seafile/conf
    environment:
      - DB_HOST=db
      - DB_ROOT_PASSWD=your_db_password
      - [email protected]
      - SEAFILE_ADMIN_PASSWORD=your_admin_password
      - SEAFILE_SERVER_HOSTNAME=your.domain.com # Убедитесь, что это ваш домен
      - SEAFILE_SERVER_URL=https://your.domain.com # Убедитесь, что это ваш домен с HTTPS
      - TIME_ZONE=Europe/Moscow
      - SEAFILE_IMAGE_VERSION=13.0.0
    depends_on:
      db:
        condition: service_healthy
      memcached:
        condition: service_started
    restart: unless-stopped

  caddy:
    image: caddy:2.7.5-alpine # Актуальная версия Caddy на 2026 год
    container_name: caddy
    ports:
      - "80:80" # HTTP
      - "443:443" # HTTPS
    volumes:
      - /opt/seafile/Caddyfile:/etc/caddy/Caddyfile # Конфиг Caddy
      - /opt/seafile/caddy_data:/data # Место для сертификатов и данных Caddy
    environment:
      - DOMAIN=your.domain.com # Ваш домен
    restart: unless-stopped
    depends_on:
      - seafile # Caddy зависит от Seafile

ВАЖЛИВО: Замініть your.domain.com на ваш реальний домен. Переконайтеся, що SEAFILE_SERVER_URL у сервісі seafile також використовує https://your.domain.com.

3. Створення файлу Caddyfile

Створіть файл конфігурації для Caddy в директорії /opt/seafile/Caddyfile.

sudo nano /opt/seafile/Caddyfile

Вставте наступний вміст, замінивши your.domain.com на ваш домен:

your.domain.com {
    reverse_proxy /seafhttp/ seafile:8082 # Проксирование для Seafile Fileserver
    reverse_proxy / seafile:8000 # Проксирование для основного веб-интерфейса Seafile

    # Дополнительные настройки для безопасности (опционально, но рекомендуются)
    header {
        Strict-Transport-Security "max-age=31536000; includeSubDomains" always
        X-Frame-Options "DENY"
        X-Content-Type-Options "nosniff"
        X-XSS-Protection "1; mode=block"
        Referrer-Policy "strict-origin-when-cross-origin"
    }

    log {
        output file /var/log/caddy/access.log {
            roll_size 10MB
            roll_keep 5
        }
    }
}

Створіть директорію для логів Caddy:

sudo mkdir -p /opt/seafile/caddy_data /opt/seafile/logs/caddy
sudo chown -R 1000:1000 /opt/seafile/caddy_data # Убедитесь, что у Caddy есть права на запись

4. Перезапуск Docker Compose

Тепер, коли всі конфігурації готові, перезапустимо Docker Compose, щоб застосувати зміни.

cd /opt/seafile
sudo docker compose down # Останавливаем и удаляем старые контейнеры
sudo docker compose up -d # Запускаем новые с Caddy

Caddy автоматично запитає та встановить SSL-сертифікат для вашого домену. Це може зайняти кілька хвилин.

5. Перевірка працездатності

Через кілька хвилин після запуску спробуйте отримати доступ до вашого Seafile через веб-браузер, використовуючи ваше доменне ім'я (наприклад, https://your.domain.com). Ви повинні побачити сторінку входу Seafile з дійсним SSL-сертифікатом.

Ви також можете перевірити доступність через curl:

curl -I https://your.domain.com

У відповіді ви повинні побачити статус HTTP/2 200 та заголовки, що вказують на успішне з'єднання. Якщо є проблеми, перевірте логи Caddy та Seafile.

sudo docker compose logs caddy
sudo docker compose logs seafile

Увійдіть, використовуючи email адміністратора ([email protected]) та пароль (your_admin_password), які ви вказали в docker-compose.yml. Після входу ви зможете створити бібліотеки, завантажити файли та налаштувати користувачів.

Резервне копіювання та обслуговування

Резервні копії – це наріжний камінь будь-якої надійної системи. Для Seafile необхідно регулярно створювати резервні копії, щоб у разі збою сервера, пошкодження даних або випадкового видалення ви могли відновити свою роботу. Обслуговування включає регулярні оновлення та моніторинг.

1. Що резервувати

Для повного відновлення Seafile вам знадобляться три ключові компоненти:

1. База даних Seafile: Містить метадані про файли, користувачів, бібліотеки, дозволи. Без неї Seafile не зможе функціонувати.
2. Директорія даних Seafile: Містить самі файли в зашифрованому та дедуплікованому вигляді. Зазвичай це /opt/seafile/data.
3. Конфігураційні файли: Файли docker-compose.yml та Caddyfile, а також будь-які інші налаштування, які ви могли змінити вручну (наприклад, у /opt/seafile/conf).

2. Простий скрипт авторезервування

Створимо простий скрипт для автоматичного резервного копіювання. Ми будемо використовувати pg_dump для бази даних та rsync для файлів. Як місце зберігання можна використовувати зовнішнє S3-сумісне об'єктне сховище або інший VPS.

sudo nano /opt/seafile/backup_seafile.sh

Вставте наступний код, замінивши плейсхолдери:

#!/bin/bash

# --- Конфігурація ---
BACKUP_DIR="/var/backups/seafile"
DB_USER="seafile"
DB_NAME="seafile"
DB_CONTAINER_NAME="seafile-db"
SEAFILE_DATA_DIR="/opt/seafile/data"
SEAFILE_CONF_DIR="/opt/seafile/conf"
CADDY_CONFIG_FILE="/opt/seafile/Caddyfile"
DOCKER_COMPOSE_FILE="/opt/seafile/docker-compose.yml"
TIMESTAMP=$(date +"%Y%m%d%H%M%S")

# --- Створення директорії для резервних копій ---
mkdir -p "$BACKUP_DIR/$TIMESTAMP"
echo "Створено директорію для резервної копії: $BACKUP_DIR/$TIMESTAMP"

# --- 1. Резервне копіювання бази даних PostgreSQL ---
echo "Створення резервної копії бази даних..."
# Отримуємо пароль з docker-compose.yml (небезпечно для продакшену без шифрування, краще використовувати .env)
# Для продакшену рекомендується використовувати .env файл або секрети Docker
DB_PASS=$(grep POSTGRES_PASSWORD /opt/seafile/docker-compose.yml | awk -F'=' '{print $2}' | xargs)
export PGPASSWORD=$DB_PASS
sudo docker exec $DB_CONTAINER_NAME pg_dump -U $DB_USER -d $DB_NAME > "$BACKUP_DIR/$TIMESTAMP/seafile_db.sql"
if [ $? -eq 0 ]; then
    echo "Резервну копію бази даних успішно створено."
else
    echo "Помилка при створенні резервної копії бази даних!"
fi
unset PGPASSWORD

# --- 2. Резервне копіювання директорії даних Seafile ---
echo "Копіювання директорії даних Seafile..."
# Використовуємо sudo для доступу до /opt/seafile/data, оскільки вона може бути створена root
sudo rsync -av --delete "$SEAFILE_DATA_DIR" "$BACKUP_DIR/$TIMESTAMP/"
if [ $? -eq 0 ]; then
    echo "Резервну копію даних Seafile успішно створено."
else
    echo "Помилка при копіюванні даних Seafile!"
fi

# --- 3. Резервне копіювання конфігураційних файлів ---
echo "Копіювання конфігураційних файлів..."
cp "$SEAFILE_CONF_DIR"/ "$BACKUP_DIR/$TIMESTAMP/" 2>/dev/null
cp "$CADDY_CONFIG_FILE" "$BACKUP_DIR/$TIMESTAMP/"
cp "$DOCKER_COMPOSE_FILE" "$BACKUP_DIR/$TIMESTAMP/"
echo "Резервну копію конфігурацій успішно створено."

# --- Очищення старих резервних копій (наприклад, зберігаємо 7 останніх днів) ---
echo "Очищення старих резервних копій..."
find "$BACKUP_DIR" -maxdepth 1 -type d -mtime +7 -exec rm -rf {} \;
echo "Старі резервні копії видалено."

echo "Процес резервного копіювання завершено."

sudo chmod +x /opt/seafile/backup_seafile.sh

sudo crontab -e

0 3    /opt/seafile/backup_seafile.sh >> /var/log/seafile_backup.log 2>&1

Цей рядок означає: "О 03:00 щодня тижня, щодня місяця, щомісяця року, виконати скрипт backup_seafile.sh та перенаправити його вивід у лог-файл."

4. Куди зберігати резервні копії

Важливо: Не зберігайте резервні копії на тому ж сервері, що й робочі дані. Це зводить нанівець сенс резервного копіювання у разі відмови диска на VPS. Рекомендовані варіанти:

• Зовнішнє S3-сумісне об'єктне сховище: Дешево, надійно, масштабовано. Використовуйте утиліти на кшталт s3cmd або rclone для автоматичного завантаження резервних копій.
• Окремий VPS: Ви можете орендувати невеликий VPS з достатнім дисковим простором і налаштувати rsync по SSH для копіювання резервних копій.
• Локальне сховище із синхронізацією: Якщо у вас є NAS або інший сервер у вашій локальній мережі, можна налаштувати синхронізацію резервних копій з VPS на нього.

5. Оновлення: Rolling vs Maintenance Window

Регулярні оновлення важливі для безпеки та отримання нових функцій. Оскільки ми використовуємо Docker Compose, процес оновлення відносно простий.

• Оновлення ОС: Регулярно запускайте sudo apt update && sudo apt upgrade -y на вашому VPS.
• Оновлення Docker-образів Seafile:
  1. Перед оновленням завжди робіть повну резервну копію.
  2. Змініть тег образу Seafile (наприклад, seafileltd/seafile-pro:13.0.0 на seafileltd/seafile-pro:13.0.1 або latest, якщо це стабільний реліз) у вашому docker-compose.yml.
  3. Зупиніть контейнери: sudo docker compose down.
  4. Завантажте нові образи: sudo docker compose pull.
  5. Запустіть контейнери: sudo docker compose up -d.

  Maintenance Window (вікно обслуговування): Рекомендується виконувати оновлення Docker-образів у заздалегідь визначене вікно обслуговування, коли активність користувачів мінімальна. Це дозволить уникнути можливих проблем та швидко їх усунути, якщо вони виникнуть. Seafile зазвичай не вимагає тривалого простою для мінорних оновлень, але завжди краще бути готовим.

• Оновлення Caddy/PostgreSQL/Memcached: Аналогічно Seafile, оновіть теги образів у docker-compose.yml та перезапустіть контейнери.

Завжди перевіряйте офіційну документацію Seafile перед великими оновленнями версії, оскільки можуть знадобитися додаткові кроки міграції бази даних.

Вирішення проблем + FAQ

У процесі встановлення та експлуатації Seafile можуть виникнути різні проблеми. Нижче представлені відповіді на часто задавані питання та типові сценарії усунення несправностей.

Що робити, якщо Seafile не запускається або недоступний?

Проблема: Після запуску docker compose up -d контейнери не запускаються або веб-інтерфейс Seafile недоступний за вашим доменом.

Що перевірити:

1. Статус контейнерів: Виконайте sudo docker compose ps. Переконайтеся, що всі контейнери (seafile-db, seafile-memcached, seafile, caddy) перебувають у стані running. Якщо будь-який контейнер у стані exited або restarting, перейдіть до наступного кроку.
2. Логи контейнерів: Перевірте логи проблемного контейнера, наприклад: sudo docker compose logs seafile або sudo docker compose logs caddy. Шукайте помилки, пов'язані з підключенням до БД, дозволами, конфігурацією або нестачею ресурсів.
3. Файрвол (UFW): Переконайтеся, що порти 80 і 443 відкриті: sudo ufw status.
4. DNS: Перевірте, що ваше доменне ім'я коректно вказує на IP-адресу вашого VPS за допомогою dig your.domain.com або nslookup your.domain.com.
5. Конфігурація Caddyfile: Перевірте синтаксис /opt/seafile/Caddyfile. Будь-яка помилка може призвести до збою Caddy.
6. Паролі в docker-compose.yml: Переконайтеся, що паролі для бази даних (POSTGRES_PASSWORD та DB_ROOT_PASSWD) збігаються.
7. Доменні імена в docker-compose.yml: Переконайтеся, що SEAFILE_SERVER_HOSTNAME та SEAFILE_SERVER_URL містять ваш коректний домен.

Як виправити: Виправте помилки в конфігураційних файлах, перезапустіть контейнери: sudo docker compose down && sudo docker compose up -d. Якщо проблема з сертифікатами Caddy, переконайтеся, що ваш домен доступний з інтернету і не блокується файрволом.

Не вдається отримати SSL-сертифікат від Let's Encrypt через Caddy. Що робити?

Проблема: Caddy повідомляє про помилку при спробі отримати SSL-сертифікат, наприклад, "certificate acquisition failed".

Що перевірити:

1. DNS-запис: Найчастіша причина. Переконайтеся, що A-запис для вашого домену (наприклад, your.domain.com) вказує на публічну IP-адресу вашого VPS. Перевірте це за допомогою сервісів на кшталт whatsmydns.net або локально dig your.domain.com +short. Зміни DNS можуть займати до кількох годин.
2. Доступність портів 80 і 443: Переконайтеся, що ваш файрвол (UFW) дозволяє вхідні з'єднання на портах 80 і 443. Caddy використовує порт 80 для HTTP-01 челенджу Let's Encrypt.
3. Caddyfile: Перевірте, що в /opt/seafile/Caddyfile вказано правильний домен.
4. Логи Caddy: sudo docker compose logs caddy. Шукайте повідомлення про помилки від Let's Encrypt.

Як виправити: Виправте DNS-записи, відкрийте порти у файрволі, перевірте конфіг Caddy. Після виправлення перезапустіть Caddy: sudo docker compose restart caddy.

Який VPS-конфіг мінімально підійде для Seafile?

Відповідь: Для невеликої команди (до 10 користувачів) або особистого використання, мінімально достатнім буде VPS з 2 vCPU, 4 ГБ оперативної пам'яті та 100-200 ГБ SSD-диска. Важливо, щоб диск був SSD для хорошої продуктивності введення/виведення, особливо для бази даних. Мережевий канал повинен бути не менше 100 Мбіт/с симетричним, щоб забезпечити комфортну швидкість синхронізації та завантаження/вивантаження файлів. Пам'ятайте, що чим більше користувачів і даних, тим вищими мають бути вимоги до ресурсів.

Що обрати — VPS чи dedicated для цього завдання?

Відповідь: Для більшості сценаріїв встановлення Seafile для малих та середніх команд (до 50 користувачів) VPS є оптимальним вибором. Він пропонує достатню продуктивність, гнучкість у масштабуванні та значно нижчу вартість порівняно з виділеним сервером. Виділений сервер (dedicated) варто розглядати, якщо у вас дуже велика кількість користувачів (більше 50-100), критично важливі дані з високими вимогами до IOPS, величезні обсяги зберігання (кілька терабайт), або якщо вам потрібен повний контроль над апаратним забезпеченням та максимальна фізична ізоляція з міркувань безпеки або відповідності регуляторним вимогам. Для початку завжди краще почати з VPS, а потім масштабуватися до dedicated, якщо виникне реальна необхідність.

Як оновити Seafile до нової версії?

Відповідь: Процес оновлення Seafile, встановленого через Docker Compose, складається з кількох кроків. По-перше, завжди робіть повний бекап бази даних та директорії даних Seafile перед початком оновлення. Потім, відкрийте файл docker-compose.yml та змініть тег образу Seafile (наприклад, з seafileltd/seafile-pro:13.0.0 на seafileltd/seafile-pro:13.0.1 або на latest, якщо це стабільний реліз). Після цього виконайте sudo docker compose down для зупинки поточних контейнерів, sudo docker compose pull для завантаження нового образу та sudo docker compose up -d для запуску Seafile з новою версією. Іноді, при великих оновленнях, можуть знадобитися додаткові кроки міграції, описані в офіційній документації Seafile – завжди перевіряйте її перед оновленням.

Seafile займає занадто багато місця. Як зменшити споживання диска?

Проблема: Диск VPS швидко заповнюється, особливо при активній роботі з файлами та їх версіями.

Що перевірити та як виправити:

1. Версіонування файлів: Seafile за замовчуванням зберігає історію версій файлів. Ви можете налаштувати політику зберігання версій для кожної бібліотеки або глобально, щоб видаляти старі версії через певний час. Це робиться через веб-інтерфейс адміністратора.
2. Кошик: Файли, видалені з бібліотек, спочатку потрапляють до кошика. Регулярно очищайте кошик через веб-інтерфейс адміністратора.
3. Видалення сміття (Garbage Collection): Seafile має вбудовану функцію "garbage collection" для видалення невикористовуваних блоків даних. Її можна запустити з веб-інтерфейсу адміністратора або вручну в контейнері Seafile. Наприклад: sudo docker exec seafile /opt/seafile/seafile-server-latest/seaf-gc.sh. Це може зайняти багато часу для великих обсягів даних.
4. Розмір диска: Якщо перелічені методи не допомагають, можливо, вам просто потрібно збільшити дисковий простір вашого VPS. Більшість провайдерів дозволяють це зробити без перевстановлення системи.

Як змінити доменне ім'я Seafile після встановлення?

Відповідь: Якщо вам потрібно змінити доменне ім'я для вашого Seafile, вам потрібно буде внести зміни в кілька місць. Спочатку оновіть DNS-запис для нового домену, щоб вона вказувала на IP-адресу вашого VPS. Потім відредагуйте файл /opt/seafile/docker-compose.yml, змінивши значення SEAFILE_SERVER_HOSTNAME та SEAFILE_SERVER_URL на новий домен. Також відредагуйте /opt/seafile/Caddyfile, вказавши новий домен у першому рядку. Після збереження змін виконайте sudo docker compose down && sudo docker compose up -d, щоб Caddy міг запросити новий SSL-сертифікат для нового домену, і Seafile оновив свої внутрішні посилання.

Висновки та наступні кроки

Вітаємо! Ви успішно встановили та налаштували власне приватне хмарне сховище Seafile на вашому VPS. Тепер у вас є повний контроль над вашими даними, висока продуктивність та безпека, що забезпечується HTTPS та регулярними бекапами. Ви створили надійну платформу для синхронізації файлів та спільної роботи, яка повністю відповідає вашим потребам у приватності та контролі.

Наступні кроки для розвитку вашого хмарного сховища:

• Інтеграція з OnlyOffice/Collabora Online: Для повноцінної спільної роботи над документами в реальному часі розгляньте інтеграцію Seafile з OnlyOffice або Collabora Online. Це дозволить редагувати документи прямо в браузері.
• Розширене керування користувачами: Якщо у вас велика команда, налаштуйте інтеграцію Seafile з LDAP/Active Directory для централізованого керування користувачами.
• Моніторинг продуктивності: Встановіть інструменти моніторингу (наприклад, Prometheus + Grafana) для відстеження завантаження CPU, RAM, диска та мережі, щоб передбачати проблеми та планувати масштабування.
• Оптимізація сховища: Вивчіть можливості Seafile щодо налаштування сховища, такі як використання зовнішніх S3-сумісних сховищ для файлових блоків, що може бути економічно вигідніше для дуже великих обсягів даних.