Для веб-сайтов на основе видео для достижения наилучших результатов у вас должен быть основной сервер (для ComusThumbz), сервер хранения и 1 или более серверов преобразования видео. Для серверов хранения и хранения вы можете использовать доступные услуги, просто следуйте ссылкам в нашем админ.

Что охватывает эта страница

В этом руководстве объясняется, что ваш веб-сервер должен быть установлен, прежде чем вы сможете запустить ComusThumbz. Если вы уже успешно установили ComusThumbz, ваш сервер, вероятно, соответствует всем этим требованиям. Используйте это руководство при настройке нового сервера или устранении проблем.

Соответствую ли я требованиям?

Быстрая проверка

Большинство хостинг-провайдеров, которые поддерживают современные веб-сайты PHP, могут запускать ComusThumbz. Тебе нужно:

• Сервер Linux (Ubuntu, Debian, CentOS или аналогичные)
• PHP версии 8.3 или новее
• База данных MySQL или MariaDB
• Не менее 2 ГБ оперативной памяти (4 ГБ + рекомендуется для видео-сайтов)
• установленный FFmpeg (требуется для обработки видео)
• Ионкуб

Что может сделать Comus Thumbz

Когда ваш сервер отвечает всем требованиям, у вас будет доступ к этим функциям:

• Загружать и управлять видео с автоматической генерацией миниатюр и несколькими вариантами качества
• Создание фотогалереи с обработкой изображений и объемными загрузками
• Хостинг потоков веб-камеры Live Использование технологии видео в реальном времени
• Монетизация создателя включая советы, подписки и контент с оплатой за просмотр
• Несколько языков 25 языков от арабского до вьетнамского
• Обработка платежей с поддержкой Stripe, PayPal, CCBill и 7 других провайдеров
• Хранилище CDN разгрузка видеофайлов в BunnyCDN, Wasabi, Backblaze и другие сервисы
• Передовая аналитика отслеживание просмотров, кликов, доходов и поведения пользователей
• ИИ-инструменты Помогает быстрее просматривать и организовывать контент

Тип сервера: что работает лучше

Рекомендуемый хостинг

Минимальные спецификации сервера:

• 2 CPU ядра (4+ рекомендуется)
• 2 ГБ ОЗУ (4 ГБ + рекомендуется)
• 10 ГБ свободного дискового пространства (больше при локальном хранении видео)
• Ubuntu 22.04 или Debian 12

Не рекомендуется

Программные требования

Веб-сервер

Ваш сервер также нуждается в Апач или Nginx для обслуживания веб-страниц.

Апач (наиболее распространенные):

• Необходимо поддерживать .htaccess Файлы для чистых URL
• Версия 2.4 или новее

Nginx:

• Версия 1.18 или новее
• Требуется ручная настройка для чистых URL

PHP версия

Требуется: PHP 8.3 или новее

ComusThumbz использует современные функции PHP, которые работают только в версии 8.3 и выше. Старые версии (PHP 7.x или PHP 8.0-8.2) не будут работать.

Проверьте свою версию PHP:

Если у вас есть доступ к серверу, запустите:

php -v

Вы должны увидеть что-то вроде: PHP 8.3.x

Если вы видите более низкую версию (например, 7.4 или 8.0), вам нужно обновить PHP перед установкой ComusThumbz.

База данных

Требуется: MySQL 5.7+ или MariaDB 10.3+

Рекомендуется: MySQL 8.0+ или MariaDB 11.4+

Ваша база данных хранит весь ваш контент, пользователей и настройки. Новые версии обеспечивают лучшую производительность для крупных сайтов.

Инструмент обработки видео (FFmpeg)

Что такое FFmpeg?
FFmpeg - это инструмент командной строки, который преобразует видео в различные форматы и создает миниатюры. Он работает в фоновом режиме автоматически, когда пользователи загружают видео.

Проверьте, установлен ли FFmpeg:

ffmpeg -version

Если вы видите информацию о версии, устанавливается FFmpeg. Если вы видите, что «команда не найдена», вам нужно установить ее или попросить своего хостинг-провайдера установить ее.

Настройки PHP, требующие настройки

Несколько настроек PHP контролируют, сколько файлов вы можете загрузить и как долго может работать обработка. Обычно они должны быть увеличены из значений по умолчанию.

Важные настройки

Как проверить текущие настройки

Создайте файл под названием phpinfo.php с этим содержанием:

Загрузите его на свой сайт и посетите в браузере (пример:) https://yoursite.com/phpinfo.php). Вы увидите все настройки PHP. Ищите имена настроек выше, чтобы увидеть текущие значения.

Функции PHP, которые должны быть включены

Некоторые хостинг-провайдеры отключают определенные функции PHP для обеспечения безопасности. ComusThumbz нуждается в таких функциях:

Если они являются инвалидами: Видео не обрабатывается, загрузка не будет работать, а настройки не могут быть сохранены.

Как дать им возможность: Свяжитесь с хостинг-провайдером или отредактируйте php.ini Если у вас есть доступ к серверу. Ищите линию, начинающуюся с disablefunctions = Удалить любую из функций, перечисленных выше.

Автоматические задачи (Cron Jobs)

Что такое Cron Job?

Работа cron — это автоматическая задача, которая выполняется каждую минуту в фоновом режиме. Он обрабатывает обработку видео, обновляет статистику и выполняет другие задачи обслуживания.

Создание Cron Job

Вы должны установить один крон работы, которая работает каждую минуту:

Командование:

     php /path/to/your/site/ct/admin/cron/sitecron.php

Заменить /path/to/your/site/ Ваш реальный путь установки.

Пользователи cPanel:

Пойти Обсуждение Cron Jobs

1. Установить сроки (каждую минуту)
2. Вставьте команду выше с правильным путем
3. щелкнуть Добавить новый Cron Job

Пользователи HestiaCP:

1. Войти через SSH
2. Беги! crontab -e
3. Добавить строку cron и сохранить

Проверьте, работает ли он:

• Видео должно перейти от «в ожидании» к «активному» в течение нескольких минут после загрузки.
• Пойти Панель администратора Крон-менеджер Чтобы увидеть последнее время

HTTPS / SSL сертификат

Большинство современных хостинг-провайдеров предлагают бесплатные SSL-сертификаты Давайте шифровать.

cPanel: Пойти SSL/TLS статус кликнуть AutoSSL Чтобы получить бесплатный сертификат

HestiaCP: Пойти Web > [ваш домен] Редактировать > SSL Скачать Let's Encrypt

Manual setup: If you manage your own server, use Certbot:

sudo certbot --apache -d yourdomain.com

Storage Space Planning

How Much Space Do I Need?

Where Files Are Stored

After installation, these folders will hold your content:

• ct/uploads/videos/ - Uploaded video files
• ct/uploads/images/ - Images and thumbnails
• ct/cache/ - Temporary files (can be cleared)
• ct/logs/ - System logs

These folders need to be writable by the web server.

Live Streaming Requirements (Optional)

Live streaming requires Docker and LiveKit to be installed on your server.

What is Docker?
Docker is a tool that runs LiveKit (the streaming software) in an isolated container.

What is LiveKit?
LiveKit handles real-time video streaming between broadcasters and viewers.

System Requirements:

• Docker Engine 20.10 or newer
• Open ports: 7880, 7881 (TCP) and 50000-50020 (UDP)
• Separate server recommended for high-traffic streaming

Common Problems and Solutions

Videos Stay "Pending" Forever

What you see: You upload a video but it never appears on your site. In the admin panel, it shows status "pending."

Common causes:

1. Cron job not running
2. FFmpeg not installed
3. PHP functions disabled

How to fix:

1. Check if the cron job is running (see Admin Panel > Cron Manager)
2. Test FFmpeg: Run ffmpeg -version via SSH or ask your host
3. Check PHP functions: Create a test file to verify exec() works
4. Contact support if the issue persists

Can't Upload Large Files

What you see: Upload fails for videos larger than 100MB.

How to fix:

1. Increase PHP settings (uploadmaxfilesize and postmaxsize) to at least 500M
2. Restart PHP-FPM after changing settings
3. If on cPanel, use MultiPHP INI Editor

Permission Denied Errors

What you see: Errors about files or folders not being writable.

How to fix:

1. Make sure folders have correct permissions:

• ct/logs/ should be writable
• ct/uploads/ should be writable
• ct/cache/ should be writable

1. If you have SSH access, run: chmod -R 775 ct/logs ct/uploads ct/cache
2. Contact your hosting provider if you don't have SSH access

Database Connection Failed

What you see: Error message about database connection on every page.

How to fix:

1. Check that MySQL is running
2. Verify database credentials in ct/dat/config.inc.php
3. Make sure the database user has full permissions
4. Contact your hosting provider for database issues

Checking Your Server Automatically

Requirements Check Script

Save this as checkrequirements.php in your site root and visit it in your browser:

<?php
echo "<h2>ComusThumbz Requirements Check</h2>\n";
echo "<pre>\n";

// PHP Version
$phpOk = versioncompare(PHPVERSION, '8.3.0', '>=');
echo "PHP Version: " . PHPVERSION . " " . ($phpOk ? '✅ OK' : '❌ Need 8.3+') . "\n\n";

// Extensions
$extensions = ['pdo', 'pdomysql', 'gd', 'curl', 'mbstring', 'json'];
echo "Required Extensions:\n";
foreach ($extensions as $ext) {
$loaded = extensionloaded($ext);
echo " $ext: " . ($loaded ? '✅ OK' : '❌ MISSING') . "\n";
}

// Functions
$disabled = explode(',', iniget('disablefunctions'));
$required = ['exec', 'shellexec', 'mkdir', 'chmod', 'fileputcontents'];
echo "\nRequired Functions:\n";
foreach ($required as $func) {
$ok = !inarray(trim($func), arraymap('trim', $disabled));
echo " $func: " . ($ok ? '✅ OK' : '❌ DISABLED') . "\n";
}

// Settings
echo "\nPHP Settings:\n";
echo " memorylimit: " . iniget('memorylimit') . "\n";
echo " maxexecutiontime: " . iniget('maxexecutiontime') . " seconds\n";
echo " uploadmaxfilesize: " . iniget('uploadmaxfilesize') . "\n";
echo " postmaxsize: " . iniget('postmaxsize') . "\n";

// FFmpeg
echo "\nExternal Tools:\n";
$ffmpeg = @shellexec('which ffmpeg 2>/dev/null');
echo " FFmpeg: " . ($ffmpeg ? '✅ Found' : '❌ NOT FOUND') . "\n";
echo "</pre>\n";
?>

This script checks:

• PHP version
• Required extensions
• Enabled functions
• PHP settings
• FFmpeg installation

Getting Help

Where to Look First

1. Check the cron job - Most "videos not processing" issues are cron-related
2. Verify FFmpeg is installed - Run ffmpeg -version to check
3. Review PHP settings - Make sure memory and upload limits are high enough
4. Check folder permissions - Uploads folder must be writable

When to Contact Support

Contact your hosting provider if:

• You can't access PHP settings or cPanel
• FFmpeg isn't installed and you can't install it
• Database won't connect despite correct credentials
• Firewall issues are blocking connections

Contact ComusThumbz support if:

• Requirements are met but features still don't work
• You see specific error messages in the admin panel
• Configuration options aren't clear

Related Guides

Summary Checklist

Before installing ComusThumbz, verify you have:

• [ ] Linux server (VPS or dedicated, not shared hosting)
• [ ] PHP 8.3 or newer
• [ ] MySQL 5.7+ or MariaDB 10.3+
• [ ] At least 2GB RAM (4GB+ recommended)
• [ ] FFmpeg installed and working
• [ ] exec() and related PHP functions enabled
• [ ] PHP memory limit set to 512M or higher
• [ ] Upload max filesize set to 500M or higher
• [ ] Writable folders for uploads, logs, and cache
• [ ] Cron job capability (runs every minute)
• [ ] SSL certificate (free Let's Encrypt works great)
• [ ] 10GB+ free disk space

Need More Help? Check the Installation Guide next, or contact your hosting provider to verify server requirements.