📑 Содержание

• Автоматическое развертывание через Actions
  • Автоматическое развертывание бэкенда
  • Автоматическое развертывание фронтенда
• Ручное развертывание
  • Ручное развертывание бэкенда
  • Ручное развертывание фронтенда
• Учебник по развертыванию ClawCloud CloudPaste

Автоматическое развертывание через Actions

Использование GitHub Actions позволяет автоматически развернуть приложение после отправки кода.

Настройка репозитория GitHub

1. Форкните или клонируйте репозиторий https://github.com/ling-drag0n/CloudPaste
2. Перейдите в настройки вашего репозитория GitHub
3. Навигация: Settings → Secrets and variables → Actions → New Repository secrets
4. Добавьте следующие Secrets:

Получение API-токена Cloudflare

1. Посетите Cloudflare Dashboard

2. Создайте новый API-токен

3. Выберите шаблон "Edit Cloudflare Workers" и добавьте права на редактирование D1 базы данных

   

Автоматическое развертывание бэкенда

Форкните репозиторий, заполните secrets, затем запустите workflow!!! Развертывание автоматически запускается при изменении файлов в директории backend и отправке в ветку main или master. Процесс:

1. Автоматическое создание D1 базы данных (если не существует)
2. Инициализация базы schema.sql (создание таблиц и начальных данных)
3. Установка переменной ENCRYPTION_SECRET (из GitHub Secrets или автоматическая генерация)
4. Автоматическое развертывание Worker в Cloudflare
5. Рекомендуется настроить кастомный домен вместо стандартного Cloudflare (иначе возможны проблемы с доступом в некоторых регионах)

⚠️ Запомните ваш домен бэкенда

Автоматическое развертывание фронтенда

Cloudflare Pages (Рекомендуется)

Форкните репозиторий, заполните secrets, затем запустите workflow. Развертывание автоматически запускается при изменении файлов в директории frontend и отправке в ветку main или master. После развертывания нужно установить переменные окружения в панели Cloudflare Pages:

1. Войдите в Cloudflare Dashboard

2. Навигация: Pages → Ваш проект (например, "cloudpaste-frontend")

3. Нажмите "Settings" → "Environment variables"

4. Добавьте переменную окружения:

   • Имя: VITE_BACKEND_URL

   • Значение: URL вашего Worker бэкенда (например, https://cloudpaste-backend.your-username.workers.dev) без "/" в конце. Рекомендуется использовать кастомный домен Worker бэкенда.

   • Убедитесь, что ввели полный домен бэкенда в формате "https://xxxx.com"

5. Важный шаг: Затем снова запустите workflow фронтенда для завершения загрузки домена бэкенда!!!

   

Строго следуйте шагам, иначе загрузка домена бэкенда завершится неудачей

Vercel

Для Vercel рекомендуется развертывать следующим образом:

1. Импортируйте ваш GitHub проект после форка
2. Настройте параметры развертывания:

Framework Preset: Vite
Build Command: npm run build
Output Directory: dist
Install Command: npm install

3. Настройте переменные окружения: Введите: VITE_BACKEND_URL и ваш домен бэкенда
4. Нажмите кнопку "Deploy" для развертывания

☝️ Выберите один из вышеуказанных методов

Ручное развертывание

Ручное развертывание бэкенда

1. Клонируйте репозиторий

git clone https://github.com/ling-drag0n/CloudPaste.git
cd CloudPaste/backend

2. Установите зависимости

   npm install
   

3. Войдите в Cloudflare

   npx wrangler login
   

4. Создайте D1 базу данных

   npx wrangler d1 create cloudpaste-db
   

   Запомните ID базы данных из вывода.

5. Измените конфигурацию wrangler.toml

   [[d1_databases]]
   binding = "DB"
   database_name = "cloudpaste-db"
   database_id = "YOUR_DATABASE_ID"
   

6. Разверните Worker

   npx wrangler deploy
   

   Запомните URL из вывода; это адрес вашего API бэкенда.

7. Инициализация базы данных (автоматически) Посетите URL вашего Worker для запуска инициализации:

   https://cloudpaste-backend.your-username.workers.dev
   

⚠️ Напоминание о безопасности: Пожалуйста, немедленно измените пароль администратора по умолчанию после инициализации системы (Логин: admin, Пароль: admin123).

Ручное развертывание фронтенда

Cloudflare Pages

1. Подготовьте код фронтенда

   cd CloudPaste/frontend
   npm install
   

2. Настройте переменные окружения Создайте или измените файл .env.production:

   VITE_BACKEND_URL=https://cloudpaste-backend.your-username.workers.dev
   VITE_APP_ENV=production
   VITE_ENABLE_DEVTOOLS=false
   

3. Соберите проект фронтенда

   npm run build
   

   Будьте осторожны при сборке! !

4. Разверните на Cloudflare Pages

   Метод 1: Через Wrangler CLI

   npx wrangler pages deploy dist --project-name=cloudpaste-frontend
   

   Метод 2: Через Cloudflare Dashboard

   1. Войдите в Cloudflare Dashboard
   2. Выберите "Pages"
   3. Нажмите "Create a project" → "Direct Upload"
   4. Загрузите файлы из директории dist
   5. Установите имя проекта (например, "cloudpaste-frontend")
   6. Нажмите "Save and Deploy"

Vercel

1. Подготовьте код фронтенда

   cd CloudPaste/frontend
   npm install
   

2. Установите и войдите в Vercel CLI

   npm install -g vercel
   vercel login
   

3. Настройте переменные окружения, аналогично Cloudflare Pages

4. Соберите и разверните

   vercel --prod
   

   Следуйте подсказкам для настройки проекта.

Учебник по развертыванию ClawCloud CloudPaste

10GB бесплатного трафика в месяц, подходит только для легкого использования

Шаг 1:

Ссылка для регистрации: Claw Cloud (без #AFF) Не требуется кредитная карта, если дата регистрации на GitHub более 180 дней, вы получаете $5 кредита каждый месяц.

Шаг 2:

После регистрации нажмите APP Launchpad на главной странице, затем нажмите create app в правом верхнем углу

Шаг 3:

Сначала разверните бэкенд, как показано на рисунке (только для справки):

Хранилище данных бэкенда здесь:

Шаг 4:

Затем фронтенд, как показано на рисунке (только для справки):

Развертывание завершено и готово к использованию, кастомные домены можно настроить по необходимости

📑 Содержание

• Развертывание через командную строку Docker
  • Развертывание бэкенда Docker
  • Развертывание фронтенда Docker
• Развертывание в один клик через Docker Compose

Развертывание через командную строку Docker

Развертывание бэкенда Docker

Бэкенд CloudPaste можно быстро развернуть с помощью официального Docker-образа.

1. Создайте директорию для хранения данных

   mkdir -p sql_data
   

2. Запустите контейнер бэкенда

   docker run -d --name cloudpaste-backend \
     -p 8787:8787 \
     -v $(pwd)/sql_data:/data \
     -e ENCRYPTION_SECRET=your-encryption-key \
     -e NODE_ENV=production \
     -e RUNTIME_ENV=docker \
     dragon730/cloudpaste-backend:latest
   

   Запомните URL развертывания (например, http://your-server-ip:8787), он понадобится для развертывания фронтенда.

⚠️ Совет по безопасности: Обязательно настройте ENCRYPTION_SECRET и храните его в безопасности, так как этот ключ используется для шифрования чувствительных данных.

Развертывание фронтенда Docker

Фронтенд использует Nginx для обслуживания и настраивает адрес API бэкенда при запуске.

docker run -d --name cloudpaste-frontend \
  -p 80:80 \
  -e BACKEND_URL=http://your-server-ip:8787 \
  dragon730/cloudpaste-frontend:latest

⚠️ Примечание: BACKEND_URL должен включать полный URL (включая протокол http:// или https://) ⚠️ Напоминание о безопасности: Пожалуйста, немедленно измените пароль администратора по умолчанию после инициализации системы (Логин: admin, Пароль: admin123).

Обновление Docker-образа

При выходе новой версии проекта вы можете обновить ваше развертывание Docker следующим образом:

1. Получите последние образы

   docker pull dragon730/cloudpaste-backend:latest
   docker pull dragon730/cloudpaste-frontend:latest
   

2. Остановите и удалите старые контейнеры

   docker stop cloudpaste-backend cloudpaste-frontend
   docker rm cloudpaste-backend cloudpaste-frontend
   

3. Запустите новые контейнеры с теми же командами (сохраняя директорию данных и конфигурацию)

Развертывание в один клик через Docker Compose

Использование Docker Compose позволяет развернуть и фронтенд, и бэкенд одним кликом, это самый простой рекомендуемый метод.

1. Создайте файл docker-compose.yml

version: "3.8"

services:
  frontend:
    image: dragon730/cloudpaste-frontend:latest
    environment:
      - BACKEND_URL=https://xxx.com # Fill in the backend service address
    ports:
      - "8080:80" #"127.0.0.1:8080:80"
    depends_on:
      - backend # Depends on backend service
    networks:
      - cloudpaste-network
    restart: unless-stopped

  backend:
    image: dragon730/cloudpaste-backend:latest
    environment:
      - NODE_ENV=production
      - RUNTIME_ENV=docker
      - PORT=8787
      - ENCRYPTION_SECRET=custom-key # Please modify this to your own security key
    volumes:
      - ./sql_data:/data # Data persistence
    ports:
      - "8787:8787" #"127.0.0.1:8787:8787"
    networks:
      - cloudpaste-network
    restart: unless-stopped

networks:
  cloudpaste-network:
    driver: bridge

2. Запустите сервисы

docker-compose up -d

⚠️ Напоминание о безопасности: Пожалуйста, немедленно измените пароль администратора по умолчанию после инициализации системы (Логин: admin, Пароль: admin123).

3. Доступ к сервисам

Фронтенд: http://your-server-ip:80 Бэкенд: http://your-server-ip:8787

Обновление Docker Compose

Когда нужно обновиться до новой версии:

1. Получите последние образы

   docker-compose pull
   

2. Пересоздайте контейнеры с новыми образами (сохраняя тома данных)

   docker-compose up -d --force-recreate
   

💡 Совет: Если есть изменения конфигурации, может потребоваться резервное копирование данных и изменение файла docker-compose.yml

Пример обратного прокси Nginx

server {
    listen 443 ssl;
    server_name paste.yourdomain.com;  # Replace with your domain name

    # SSL certificate configuration
    ssl_certificate     /path/to/cert.pem;  # Replace with certificate path
    ssl_certificate_key /path/to/key.pem;   # Replace with key path

    # Frontend proxy configuration
    location / {
        proxy_pass http://localhost:80;  # Docker frontend service address
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }

    # Backend API proxy configuration
    location /api {
        proxy_pass http://localhost:8787;  # Docker backend service address
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        client_max_body_size 0;

        # WebSocket support (if needed)
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }

    # WebDAV Configuration
    location /dav {
        proxy_pass http://localhost:8787/dav;  # Points to your backend service

        # WebDAV necessary headers
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

        # WebDAV method support
        proxy_pass_request_headers on;

        # Support all WebDAV methods
        proxy_method $request_method;

        # Necessary header processing
        proxy_set_header Destination $http_destination;
        proxy_set_header Overwrite $http_overwrite;

        # Handle large files
        client_max_body_size 0;

        # Timeout settings
        proxy_connect_timeout 3600s;
        proxy_send_timeout 3600s;
        proxy_read_timeout 3600s;
    }
}

⚠️ Совет по безопасности: Рекомендуется настроить HTTPS и обратный прокси (например, Nginx) для повышения безопасности.

Получение API R2 и настройка кросс-доменных запросов

1. Войдите в Cloudflare Dashboard

2. Перейдите в раздел R2 Storage и создайте bucket.

3. Создайте API токен

4. Сохраните все данные после создания — они понадобятся позже

5. Настройте правила кросс-доменных запросов: выберите соответствующий bucket, перейдите в Settings, отредактируйте политику CORS, как показано ниже:

[
  {
    "AllowedOrigins": ["http://localhost:3000", "https://replace-with-your-frontend-domain"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedHeaders": ["*"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]

Получение API B2 и настройка кросс-доменных запросов

1. Если у вас нет аккаунта B2, сначала зарегистрируйтесь, затем создайте bucket.

2. В боковом меню выберите Application Key, нажмите Create Key и следуйте инструкциям.

3. Настройте кросс-доменные запросы для B2; конфигурация CORS в B2 сложнее, обратите внимание

4. Сначала попробуйте варианты 1 или 2, перейдите на страницу загрузки и проверьте, работает ли она. Если в консоли F12 появляются ошибки CORS, используйте вариант 3. Для постоянного решения сразу применяйте вариант 3.

   

Для настройки варианта 3, так как панель управления не поддерживает эту функцию, необходимо выполнить конфигурацию вручную, скачав CLI инструмент B2. Подробнее см.: "https://docs.cloudreve.org/zh/usage/storage/b2".

После загрузки в соответствующей директории CMD выполните следующие команды:

b2-windows.exe account authorize   //Log in to your account, following prompts to enter your keyID and applicationKey
b2-windows.exe bucket get <bucketName> //You can execute to get bucket information, replace <bucketName> with your bucket name

Конфигурация для Windows: используйте ".\b2-windows.exe xxx", Для Python CLI команды будут аналогичны:

b2-windows.exe bucket update <bucketName> allPrivate --cors-rules "[{\"corsRuleName\":\"CloudPaste\",\"allowedOrigins\":[\"*\"],\"allowedHeaders\":[\"*\"],\"allowedOperations\":[\"b2_upload_file\",\"b2_download_file_by_name\",\"b2_download_file_by_id\",\"s3_head\",\"s3_get\",\"s3_put\",\"s3_post\",\"s3_delete\"],\"exposeHeaders\":[\"Etag\",\"content-length\",\"content-type\",\"x-bz-content-sha1\"],\"maxAgeSeconds\":3600}]"

Замените на имя вашего bucket. Для allowedOrigins в настройках CORS можно указать нужные домены; здесь разрешены все.

5. Настройка кросс-доменных запросов завершена

Доступ к API MinIO и настройка кросс-доменных запросов

1. Развертывание MinIO Server

   Используйте следующую конфигурацию Docker Compose (пример) для быстрого развертывания MinIO:

   version: "3"
   
   services:
     minio:
       image: minio/minio:RELEASE.2025-02-18T16-25-55Z
       container_name: minio-server
       command: server /data --console-address :9001 --address :9000
       environment:
         - MINIO_ROOT_USER=minioadmin # Имя администратора
         - MINIO_ROOT_PASSWORD=minioadmin # Пароль администратора
         - MINIO_BROWSER=on
         - MINIO_SERVER_URL=https://minio.example.com # URL доступа к S3 API
         - MINIO_BROWSER_REDIRECT_URL=https://console.example.com # URL консоли
       ports:
         - "9000:9000" # Порт S3 API
         - "9001:9001" # Порт консоли
       volumes:
         - ./data:/data
         - ./certs:/root/.minio/certs # SSL сертификаты (при необходимости)
       restart: always
   

   Выполните docker-compose up -d для запуска сервиса.

2. Настройка обратного прокси (пример)

   Для корректной работы MinIO, особенно предпросмотра файлов, правильно настройте обратный прокси. Рекомендуемые настройки для OpenResty/Nginx:

   Обратный прокси для MinIO S3 API (minio.example.com):

   location / {
       proxy_pass http://127.0.0.1:9000;
       proxy_set_header Host $host;
       proxy_set_header X-Real-IP $remote_addr;
       proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
       proxy_set_header X-Forwarded-Proto $scheme;
   
       # Оптимизация HTTP
       proxy_http_version 1.1;
       proxy_set_header Connection "";  # Включение keepalive для HTTP/1.1
   
       # Важно: Решение проблем с ошибками 403 и предпросмотром
       proxy_cache off;
       proxy_buffering off;
       proxy_request_buffering off;
   
       # Без ограничения размера файла
       client_max_body_size 0;
   }
   

   Обратный прокси для MinIO Console (console.example.com):

   location / {
       proxy_pass http://127.0.0.1:9001;
       proxy_set_header Host $host;
       proxy_set_header X-Real-IP $remote_addr;
       proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
       proxy_set_header X-Forwarded-Proto $scheme;
   
       # Поддержка WebSocket
       proxy_http_version 1.1;
       proxy_set_header Upgrade $http_upgrade;
       proxy_set_header Connection "upgrade";
   
       # Критические настройки
       proxy_cache off;
       proxy_buffering off;
   
       # Без ограничения размера файла
       client_max_body_size 0;
   }
   

3. Доступ к консоли для создания bucket и ключей доступа

   Подробная конфигурация описана в официальной документации:
   https://min.io/docs/minio/container/index.html
   CN: https://min-io.cn/docs/minio/container/index.html

   

4. Дополнительная настройка (опционально)

   Разрешенные источники должны включать домен вашего фронтенда.
   

5. Настройка MinIO в CloudPaste

   • Войдите в панель администратора CloudPaste
   • Перейдите в "Настройки S3 хранилища" → "Добавить конфигурацию хранилища"
   • Выберите "Другие S3-совместимые сервисы" в качестве провайдера
   • Введите данные:
     • Имя: Произвольное имя
     • URL конечной точки: URL сервиса MinIO (например, https://minio.example.com)
     • Имя bucket: Созданный ранее bucket
     • Access Key ID: Ваш ключ доступа
     • Secret Key: Ваш секретный ключ
     • Регион: Оставьте пустым
     • Доступ в стиле path: ОБЯЗАТЕЛЬНО ВКЛЮЧИТЕ!
   • Нажмите "Проверить соединение" для проверки
   • Сохраните настройки

6. Устранение неполадок

   • Важно: При использовании CDN Cloudflare может потребоваться добавить proxy_set_header Accept-Encoding "identity", а также учитывать проблемы с кешированием. Рекомендуется использовать только DNS-разрешение.
   • Ошибка 403: Убедитесь, что обратный прокси включает proxy_cache off и proxy_buffering off
   • Проблемы с предпросмотром: Проверьте правильность настроек MINIO_SERVER_URL и MINIO_BROWSER_REDIRECT_URL
   • Ошибки загрузки: Проверьте настройки CORS; разрешенные источники должны включать домен фронтенда
   • Консоль недоступна: Проверьте конфигурацию WebSocket, особенно Connection "upgrade"

Другие настройки, связанные с S3, будут добавлены позже......

Руководство по настройке и использованию WebDAV

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

Основная информация о сервисе WebDAV

• Базовый URL WebDAV: https://your-backend-domain/dav
• Поддерживаемые методы аутентификации:
  • Базовая аутентификация (логин+пароль)
• Поддерживаемые типы прав:
  • Учетные записи администраторов — Полные права
  • API ключи — Требуется включенное право на монтирование (mount_permission)

Настройка прав доступа

1. Доступ через учетную запись администратора

Используйте логин и пароль администратора для прямого доступа к сервису WebDAV:

• Логин: Имя администратора
• Пароль: Пароль администратора

2. Доступ через API ключ (рекомендуется)

Для более безопасного доступа рекомендуется создать специальный API ключ:

1. Войдите в интерфейс управления
2. Перейдите в "Управление API ключами"
3. Создайте новый API ключ, убедитесь, что включено "Право на монтирование"
4. Способ использования:
   • Логин: Значение API ключа
   • Пароль: То же значение API ключа, что и логин

Настройка обратного прокси NGINX

При использовании NGINX в качестве обратного прокси необходимо добавить специальную конфигурацию WebDAV для корректной работы всех методов:

# WebDAV Configuration
location /dav {
    proxy_pass http://localhost:8787;  # Points to your backend service

    # WebDAV necessary headers
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

    # WebDAV method support
    proxy_pass_request_headers on;

    # Support all WebDAV methods
    proxy_method $request_method;

    # Necessary header processing
    proxy_set_header Destination $http_destination;
    proxy_set_header Overwrite $http_overwrite;

    # Handle large files
    client_max_body_size 0;

    # Timeout settings
    proxy_connect_timeout 3600s;
    proxy_send_timeout 3600s;
    proxy_read_timeout 3600s;
}

Распространенные проблемы и решения

1. Проблемы с подключением:

   • Убедитесь, что URL WebDAV указан правильно
   • Проверьте корректность учетных данных
   • Убедитесь, что API ключ имеет право на монтирование

2. Ошибки прав доступа:

   • Убедитесь, что учетная запись имеет необходимые права
   • Учетные записи администраторов должны иметь полные права
   • API ключи требуют отдельного включения права на монтирование

3. ⚠️⚠️ Проблемы с загрузкой через WebDAV:

   • В режиме предварительно подписанной загрузки обратите внимание на настройки CORS соответствующего S3 хранилища
   • В автоматическом режиме WebDAV файлы до 10MB загружаются напрямую, от 10 до 50MB — частями, а свыше 50MB — с предварительной подписью
   • Учитывайте ограничения Cloudflare Worker при загрузке: рекомендуется использовать режим с предварительной подписью или прямой загрузки, избегая загрузки частями
   • Для развертывания через Docker достаточно обратить внимание на конфигурацию nginx прокси, подойдет любой режим загрузки
   • Клиенты Windows, Raidrive и другие пока не поддерживают перетаскивание для загрузки, все остальное работает