对于基于视频的网站,您应当拥有一个主服务器(用于ComusThumbz),一个存储服务器和一个或更多的视频转换服务器. 对于存储和综合服务器,你可以使用 可用的服务,只是跟随我们的管理员的链接。

此页面封面

本指南解释您的网络服务器在运行 ComusThumbz 之前需要安装什么 。 如果您已经成功安装了 ComusThumbz, 您的服务器可能满足所有这些要求 。 设置新服务器或排除出问题时使用此指南 。

我符合要求吗?

快速检查

大多数支持现代PHP网站的托管供应商可以运行ComusThumbz. 你需要的就是: 爱丽丝.

• Linux 服务器 (Ubuntu、Debian、CentOS,或类似)
• PHP 第8.3版或更新版本
• MySQL 或 MariaDB 数据库
• 至少2GB的内存 (4GB+建议视频网站).
• 安装了 FFmpeg (视频处理所需).
• 电子立方体

ComusThumbz 能够做什么

当您的服务器满足所有要求时,您就可以访问这些功能:

• 上传和管理视频 有自动缩略图生成和多个质量选项
• 创建相片画廊 有图像处理和批量上传
• 主机直播网络相机流 使用实时视频技术
• 创建者货币化 包括小费、订阅和付费浏览内容
• 多语言 支持从阿拉伯语到越南语的25种语言
• 付款处理 支持Frede、PayPal、CCBill和7个其他供应商
• CDN 存储 将视频文件卸载到 BunnyCDN、Wasabi、Backflaze 和其他服务
• 高级分析 跟踪视图、点击、收益和用户行为
• 人工智能工具 帮助更快地审查和组织内容

服务器类型: 最佳效果

建议的主机

最小服务器光谱 :

• 2个CPU核(4个+建议)
• 2GB 内存(建议4GB+)
• 10GB 自由磁盘空间( 更多如果在本地存储视频)
• Ubuntu 22.04 或 Debian 12号

未建议

软件需求

Web 服务器

您的服务器也需要 阿帕奇语Name 或者说 阳性 服务网页。

阿帕奇语Name (最常见的):

• 必须支持 .htaccess 干净的 URL 文件
• 2.4版本或更新版本

阳性数字 :

• 1.18版本或较新版本
• 需要手动配置干净的 URL

前一頁 版本

要求 : 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),在安装ComusThumbz之前需要升级PHP.

数据库

要求 : MySQL 5.7+或马里亚DB 10.3+

建议: MySQL 8.0+或马里亚DB 11.4+

您的数据库存储您的全部内容、 用户和设置 。 较新的版本为大型站点提供了更好的性能.

视频处理工具( FFmpeg)

什么是"FFmpeg"吗?
FFmpeg是一个命令行工具,可以将视频转换为不同的格式并创建缩略图. 当用户上传视频时,它在背景中自动运行.

检查FFmpeg是否安装 :

ffmpeg -version

如果看到版本信息,则安装了FFmpeg. 如果看到"没有找到命令",则需要安装,或者要求主机提供者安装.

PHP 设置需要调整

若干 PHP 设置控制您可以上传多大的文件, 处理可以运行多久 。 这些通常需要从默认值中增加 。

重要设置

如何检查当前设置

创建名为的文件 phpinfo.php 含有此内容:

上传到您的站点并访问浏览器(例如: https://yoursite.com/phpinfo.php) (中文(简体) ). 您将看到所有 PHP 设置 。 查找上面的设置名称以查看当前值 。

前一頁必须启用的函数

一些托管服务商为安全目的禁用某些PHP功能. ComusThumbz需要这些功能才能工作:

如果这些残疾: 视频不会处理,上传失败,设置无法被保存.

如何使他们能够: 联系您的主机提供者或编辑 php.ini 如果您有服务器访问权限。 寻找一条从 disablefunctions = 并删除上述任何功能。

自动背景任务( Cron 任务)

What is a Cron Job?

A cron job is an automatic task that runs every minute in the background. It handles video processing, updates statistics, and performs other maintenance tasks.

Setting Up the Cron Job

You need to set ONE cron job that runs every minute:

The command:

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

Replace /path/to/your/site/ with your actual installation path.

cPanel users:

Go to Advanced > Cron Jobs

1. Set timing to (every minute)
2. Paste the command above with your correct path
3. Click Add New Cron Job

HestiaCP users:

1. Log in via SSH
2. Run: crontab -e
3. Add the cron line and save

Checking if it's working:

• Videos should move from "pending" to "active" within a few minutes of upload
• Go to Admin Panel > Cron Manager to see the last run time

HTTPS / SSL Certificate

Most modern hosting providers offer free SSL certificates through Let's Encrypt.

cPanel: Go to SSL/TLS Status and click AutoSSL to get a free certificate

HestiaCP: Go to Web > [your domain] > Edit > SSL and enable 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.

什么是多克吗?
Docker是一个在孤立的容器中运行LiveKit(流出软件)的工具.

什么是活猫?
LiveKit处理广播和观众之间的实时视频流.

系统要求:

• 20.10或更新型的多克引擎
• 开放港口:7880、7881(TCP)和50000-50020(UDP)
• 推荐用于高流量流的单独服务器

共同问题和解决办法

视频永远停留在"等待"中

你看到的东西: 你上传一段视频,但从未出现在你的网站上. 在管理面板中,它显示状态"待决".

常见原因:

1. 未运行的 Cron 任务
2. 未安装 FFmpeg
3. PHP 函数已禁用

如何修复:

1. 检查 cron 工作是否在运行( 见 行政小组 > Cron 管理器(中文(简体) ).
2. 测试 FFmpeg: 运行 ffmpeg -version 通过 SSH 或询问您的主机
3. 检查 PHP 函数: 创建测试文件进行校验 exec() 工作内容
4. 如果问题依然存在,则提供联系支助

无法上传大文件

你看到的东西: 上传大于100MB的视频失败 。

如何修复:

1. 增加 PHP 设置( E)uploadmaxfilesize 和 postmaxsize至至少500米
2. 更改设置后重新启动 PHP- FPM
3. 如果在分板上,则使用 MultiPHP INI 编辑器

权限拒绝出错

你看到的东西: 文件或文件夹无法写入的错误 。

如何修复:

1. 确保文件夹有正确的权限 :

• ct/logs/ 应可写
• ct/uploads/ 应可写
• ct/cache/ 应可写

1. 如果您有 SSH 访问权限, 请运行 : chmod -R 775 ct/logs ct/uploads ct/cache
2. 如果您没有 SSH 访问权限, 请联系您的主机提供者

数据库连接失败

你看到的东西: 每页关于数据库连接的错误消息 。

如何修复:

1. 检查 MySQL 是否运行
2. 校验数据库证书 ct/dat/config.inc.php
3. 确保数据库用户拥有全部权限
4. 就数据库问题联系您的托管提供者

自动检查您的服务器

检查脚本

另存为 checkrequirements.php 在您的网站根中访问浏览器:

ComusThumbz Requirements Check\n";
echo "
\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 "
\n";
?>

此脚本检查 :

• 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.