Para sites baseados em vídeo para melhores resultados você deve ter um servidor principal (para ComusThumbz), um servidor de armazenamento e 1 ou mais servidores de conversão de vídeo. Para os servidores de armazenamento e covnersion você pode usar serviços que estão disponíveis, basta seguir os links em nosso administrador.

O que esta página cobre

Este guia explica o que seu servidor web precisa ter instalado antes de poder executar o ComusThumbz. Se você já instalou o ComusThumbz com sucesso, seu servidor provavelmente atende a todos esses requisitos. Use este guia ao configurar um novo servidor ou problemas de solução de problemas.

Cumpri os requisitos?

Verificação Rápida

A maioria dos provedores de hospedagem que suportam sites PHP modernos pode executar ComusThumbz. Precisas de:

• Um servidor Linux (Ubuntu, Debian, CentOS ou similar)
• Versão do PHP 8.3 ou mais recente
• Banco de dados MySQL ou MariaDB
• Pelo menos 2GB de RAM (4GB+ recomendado para sites de vídeo)
• FFmpeg instalado (necessário para processamento de vídeo)
• IonCube

O Que o ComusThumbz Pode Fazer

Quando seu servidor atender a todos os requisitos, você terá acesso a esses recursos:

• Envie e gerencie vídeos com geração automática de miniaturas e múltiplas opções de qualidade
• Criar galerias de fotos com processamento de imagens e uploads em massa
• Host ao vivo streamings de webcam utilização de tecnologia de vídeo em tempo real
• Monetização do Criador incluindo dicas, assinaturas e conteúdo pay-per-view
• Línguas múltiplas suportando 25 idiomas de árabe para vietnamita
• Tratamento dos pagamentos com suporte para Stripe, PayPal, CCBill e outros 7 provedores
• Armazenamento de CDN para descarregar arquivos de vídeo para BunnyCDN, Wasabi, Backblaze e outros serviços
• Análise avançada rastreamento de visualizações, cliques, ganhos e comportamento do usuário
• Ferramentas alimentadas por IA para ajudar a rever e organizar o conteúdo mais rápido

Tipo de servidor: O que funciona melhor

Hospedagem Recomendada

Especificações mínimas do servidor:

• 2 núcleos de CPU (4+ recomendados)
• 2GB de RAM (4GB+ recomendado)
• 10GB de espaço livre em disco (mais se armazenar vídeos localmente)
• Ubuntu 22.04 ou Debian 12

Não Recomendado

Requisitos de software

Servidor Web

O seu servidor precisa de alguma coisa Apache ou Nginx para servir páginas web.

Apache (mais frequentes):

• Deve apoiar .htaccess arquivos para URLs limpos
• Versão 2.4 ou mais recente

Nginx:

• Versão 1.18 ou mais recente
• Requer configuração manual para URLs limpos

Versão do PHP

Necessário: PHP 8.3 ou mais recente

ComusThumbz usa recursos PHP modernos que só funcionam na versão 8.3 e acima. Versões mais antigas (PHP 7.x ou PHP 8.0-8.2) não funcionarão.

Verificando sua versão do PHP:

Se você tiver acesso ao servidor, execute:

php -v

Devias ver algo como: PHP 8.3.x

Se você ver uma versão inferior (como 7.4 ou 8.0), você precisará atualizar o PHP antes de instalar o ComusThumbz.

Base de dados

Necessário: MySQL 5.7+ ou MariaDB 10.3+

Recomendado: MySQL 8.0+ ou MariaDB 11.4+

Seu banco de dados armazena todo o seu conteúdo, usuários e configurações. As versões mais novas proporcionam melhor desempenho para grandes sites.

Ferramenta de processamento de vídeo (FFmpeg)

O que é o FFmpeg?
FFmpeg é uma ferramenta de linha de comando que converte vídeos para diferentes formatos e cria miniaturas. Ele é executado em segundo plano automaticamente quando os usuários enviam vídeos.

Verificando se o FFmpeg está instalado:

ffmpeg -version

Se você ver informações da versão, FFmpeg está instalado. Se você vir "comando não encontrado", você precisará instalá-lo ou pedir ao seu provedor de hospedagem para instalá-lo.

Configurações do PHP que precisam de ajuste

Várias configurações do PHP controlam o tamanho dos arquivos que você pode carregar e quanto tempo o processamento pode executar. Estes geralmente precisam ser aumentados de valores padrão.

Configurações Importantes

Como verificar as configurações atuais

Criar um ficheiro chamado phpinfo.php com este conteúdo:

Envie-o para o seu site e visite-o em um navegador (exemplo: https://yoursite.com/phpinfo.php). Você verá todas as configurações PHP. Procure pelos nomes de configuração acima para ver os valores atuais.

Funções PHP que devem ser habilitadas

Alguns provedores de hospedagem desabilitam certas funções PHP para segurança. ComusThumbz precisa dessas funções para funcionar:

Se estes estiverem desativados: Vídeos não processarão, uploads falharão e as configurações não podem ser salvas.

Como habilitá-los: Contacte o seu provedor de hospedagem ou edite php.ini se tiver acesso ao servidor. Procurar por uma linha começando com disablefunctions = e remover qualquer uma das funções listadas acima.

Tarefas Automáticas de Fundo (Trabalhos de Comando)

O que é um Cron Job?

Um trabalho cron é uma tarefa automática que executa cada minuto no fundo. Ele lida com processamento de vídeo, atualiza estatísticas e executa outras tarefas de manutenção.

Configurando a Tarefa do Cron

Você precisa definir um trabalho cron que funciona a cada minuto:

O comando:

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

Substituir /path/to/your/site/ com o seu verdadeiro caminho de instalação.

Usuários do cPanel:

Ir para Avançado > Trabalhos de Cron

1. Definir o momento para (a cada minuto)
2. Colar o comando acima com o seu caminho correto
3. Clique Adicionar nova tarefa do Cron

Utilizadores da HestiaCP:

1. Entrar via SSH
2. Executar: crontab -e
3. Adicionar a linha cron e salvar

A verificar se está a funcionar.

• Os vídeos devem passar de "pendente" para "ativo" dentro de alguns minutos após o upload
• Ir para Painel de administração > Gestor de Crons para ver a última execução

HTTPS / Certificado SSL

A maioria dos modernos provedores de hospedagem oferecem certificados SSL grátis através Vamos criptografar.

cPanel: Ir para Estado do SSL/TLS e clique AutoSSL para obter um certificado gratuito

HestiaCP: Ir para Web > [seu domínio] > Editar > SSL e habilitar Vamos Encriptar

Configuração manual: Se gerir o seu próprio servidor, utilize o Certbot:

sudo certbot --apache -d yourdomain.com

Planejamento de Espaço de Armazenamento

De quanto espaço preciso?

Onde os arquivos são armazenados

Após a instalação, essas pastas manterão seu conteúdo:

• ct/uploads/videos/ - Arquivos de vídeo enviados
• ct/uploads/images/ - Imagens e miniaturas
• ct/cache/ - Arquivos temporários (podem ser limpos)
• ct/logs/ - Registos de sistemas

Essas pastas precisam ser escritas pelo servidor web.

Requisitos de transmissão ao vivo (Opcional)

A transmissão ao vivo requer Acoplamento e LiveKit para ser instalado no seu servidor.

O que é o Docker?
Docker é uma ferramenta que executa LiveKit (o software de streaming) em um recipiente isolado.

O que é o LiveKit?
O LiveKit lida com streaming de vídeo em tempo real entre emissoras e telespectadores.

Requisitos do sistema:

• Motor de Docker 20.10 ou mais recente
• Portos abertos: 7880, 7881 (TCP) e 50000-50020 (UDP)
• Servidor separado recomendado para streaming de alto tráfego

Problemas e soluções comuns

Vídeos Ficar "Pendente" Para Sempre

O que você vê: Você carrega um vídeo, mas ele nunca aparece em seu site. No painel de administração, mostra o estado "pendente".

Causas comuns:

1. O trabalho do Cron não está em execução
2. FFmpeg não instalado
3. Funções PHP desactivadas

Como corrigir:

1. Verifique se a tarefa do cron está em execução (ver Painel de administração > Gestor de Crons)
2. Teste FFmpeg: Executar ffmpeg -version via SSH ou perguntar à sua máquina
3. Verificar funções PHP: Criar um arquivo de teste para verificar exec() funciona
4. Contacte o suporte se o problema persistir

Não é possível enviar arquivos grandes

O que você vê: O envio falha para vídeos maiores que 100MB.

Como corrigir:

1. Aumentar as configurações do PHP (uploadmaxfilesize e postmaxsize) até pelo menos 500M
2. Reiniciar o PHP-FPM após alterar as configurações
3. Se em cPanel, utilizar Editor MultiPHP INI

Permissão Negada Erros

O que você vê: Erros sobre arquivos ou pastas não serem graváveis.

Como corrigir:

1. Certifique-se de que as pastas têm permissões corretas:

• ct/logs/ deve ser escrito
• ct/uploads/ deve ser escrito
• ct/cache/ deve ser escrito

1. Se você tem acesso SSH, execute: chmod -R 775 ct/logs ct/uploads ct/cache
2. Contacte o seu fornecedor de alojamento se não tiver acesso SSH

A Ligação à Base de Dados Falhou

O que você vê: Mensagem de erro sobre a conexão do banco de dados em cada página.

Como corrigir:

1. Verificar se o MySQL está em execução
2. Verificar as credenciais do banco de dados ct/dat/config.inc.php
3. Certifique-se que o usuário da base de dados tenha permissões completas
4. Contacte o seu provedor de hospedagem para problemas de banco de dados

Verificando seu servidor automaticamente

Requisitos Verificar o Programa

Gravar isto como checkrequirements.php em seu site root e visite-o em seu navegador:

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";
?>

Este script verifica:

• Versão do PHP
• Extensões necessárias
• Funções habilitadas
• Configuração do PHP
• Instalação do FFmpeg

Obter Ajuda

Onde procurar primeiro

1. Verificar a tarefa do cron - A maioria dos "vídeos que não processam" é relacionada com o Cron
2. Verificar o FFmpeg está instalado - Corre. ffmpeg -version para verificar
3. Rever as configurações do PHP - Certifique-se de que os limites de memória e upload são elevados o suficiente
4. Verificar permissões de pastas - A pasta de envios deve ser escrita

Quando contactar o suporte

Contacte o seu fornecedor de alojamento se:

• Você não pode acessar as configurações PHP ou cPanel
• FFmpeg não está instalado e você não pode instalá-lo
• O banco de dados não se conecta apesar das credenciais corretas
• Firewall problemas estão bloqueando conexões

Contacte o suporte do ComusThumbz se:

• Os requisitos são cumpridos, mas os recursos ainda não funcionam
• Você vê mensagens de erro específicas no painel de administração
• As opções de configuração não são claras

Guias relacionados

Lista de Verificação do Resumo

Antes de instalar o ComusThumbz, verifique se você tem:

• [ ] Servidor Linux (VPS ou dedicado, não compartilhado)
• [ ] PHP 8.3 ou mais recente
• [ ] MySQL 5.7+ ou MariaDB 10.3+
• [ ] Pelo menos 2GB de RAM (4GB+ recomendado)
• [ ] FFmpeg instalado e funcionando
• [ ] exec() e funções PHP relacionadas habilitadas
• [ ] Limite de memória PHP definido para 512M ou superior
• [ ] Upload max filesize set to 500M ou superior
• [ ] Pastas de escrita para uploads, logs e cache
• [ ] Capacidade de trabalho Cron (corre a cada minuto)
• [ ] Certificado SSL (livre Vamos criptografar funciona muito bem)
• [ ] 10GB + espaço livre em disco

Precisa de mais ajuda? Verifique o Guia de Instalação em seguida, ou entre em contato com seu provedor de hospedagem para verificar os requisitos do servidor.