Como Migrar do KVS para o TubePress

Mover um site de tube já estabelecido para um novo CMS parece arriscado — mas as duas coisas com que os operadores mais se preocupam, perder sua biblioteca e perder seu ranqueamento no Google, são ambas perfeitamente gerenciáveis. Este guia mostra o passo a passo da migração do KVS (Kernel Video Sharing) para o CMS TubePress gratuito e auto-hospedado, sem perder nenhuma das duas.

A versão curta: exporte seu catálogo do KVS, importe-o em massa para o TubePress com mapeamento de colunas, preserve a estrutura das suas URLs (ou configure redirecionamentos 301 limpos), deixe o TubePress regenerar seus sitemaps e dados estruturados e, então, redirecione o DNS assim que tiver verificado tudo em uma URL de staging. Para ver primeiro um comparativo lado a lado das duas plataformas, confira a comparação TubePress vs KVS.

Por que migrar do KVS, afinal?

O KVS é um produto capaz e maduro, então migrar só faz sentido se seus pontos negativos estiverem custando caro a você. Os motivos habituais pelos quais os operadores trocam:

• Custo. O KVS é uma licença comercial paga (cerca de $99–$499 pagamento único por domínio, ou cerca de $49/mês de aluguel). O TubePress é gratuito, em sites ilimitados que você possui, com atualizações gratuitas para sempre.
• Código codificado. O KVS vem codificado com ionCube por padrão, então você não consegue ler nem modificar livremente o núcleo. O TubePress é PHP simples e editável, sem ionCube — você possui e pode auditar cada linha.
• Aprisionamento por domínio. Rodar uma rede de sites multiplica os custos de licença do KVS; com o TubePress, a mesma build roda em todos os lugares por $0.

Se nenhum desses pontos incomoda você, talvez não haja motivo para mudar. Se incomodam, o restante deste guia é o caminho prático para sair.

Antes de começar: o que você vai precisar

• Acesso ao admin e ao banco de dados do seu KVS atual (para exportar os metadados dos seus vídeos).
• Um servidor que atenda aos requisitos do TubePress (PHP 8.2+, MySQL/MariaDB, Nginx ou Apache).
• Uma instalação nova do TubePress em uma URL ou subdomínio de staging — nunca migre diretamente para o seu domínio ao vivo. Baixe-o na página de download e execute o instalador de 5 minutos.
• Um backup do banco de dados e dos arquivos do seu KVS. Sempre migre a partir de uma cópia, nunca da única cópia.

Passo 1 — Exporte sua biblioteca do KVS

O TubePress importa de CSV ou JSON, então o objetivo deste passo é um arquivo de exportação limpo, com uma linha por vídeo. Exporte seu catálogo a partir do admin do KVS (ou diretamente do seu banco de dados) e inclua os campos que você quer manter: título, descrição, tags, categorias, atores/modelos, duração, URL da miniatura, URL do arquivo de vídeo ou caminho de armazenamento, data de envio e número de visualizações.

Você não precisa migrar tudo de uma vez. Muitos operadores exportam em blocos (por categoria ou intervalo de datas) e os importam como lotes separados, o que mantém cada etapa pequena e fácil de verificar.

Passo 2 — Mapeie os campos do KVS para o TubePress

O importador do TubePress permite que você mapeie suas colunas para os campos dele, então sua exportação do KVS não precisa corresponder a um modelo fixo. Alinhe cada coluna de origem (por exemplo, video_title → Título, cat → Categoria, models → Performer) uma vez, e o mapeamento se aplica ao arquivo inteiro.

Este também é o momento de organizar a taxonomia: una categorias duplicadas, padronize o uso de maiúsculas e minúsculas nas tags e separe os campos de performers separados por vírgula, para que seu novo site comece limpo em vez de herdar anos de bagunça acumulada.

Passo 3 — Importe em massa para o TubePress

Execute a importação no seu site de staging. O importador do TubePress processa arquivos CSV/JSON de qualquer tamanho em lotes retomáveis, com detecção de duplicatas e atribuição de categorias/tags em lote, e não há limite fixo de linhas. Se um lote for interrompido, ele é retomado em vez de recomeçar do zero ou criar duplicatas.

Para bibliotecas grandes, importe primeiro alguns milhares de linhas e confirme o resultado — títulos, miniaturas, categorias e players renderizando corretamente — antes de rodar o catálogo completo. O guia de importação em massa passo a passo cobre o importador em detalhes.

Passo 4 — Preserve suas URLs e proteja seu SEO

Este é o passo que decide se você mantém seu tráfego. Os mecanismos de busca indexaram suas URLs do KVS por anos; se essas URLs mudarem e nada disser ao Google para onde elas foram, você perde o ranqueamento vinculado a elas.

Você tem duas opções seguras:

• Mantenha a mesma estrutura de URLs. Se você conseguir reproduzir os padrões de URL de vídeos, categorias e performers que já existem no TubePress, a maioria dos links continua funcionando como está.
• Redirecione com 301 as URLs antigas para as novas. Onde os padrões diferirem, mapeie antiga → nova com redirecionamentos permanentes para que o valor seja transferido. Um exemplo simples de Nginx:

location ~ ^/video/(\d+)/ {
    return 301 /watch/$1;
}

Em seguida, o TubePress faz o trabalho contínuo de SEO por você: ele emite uma canonical limpa por página, regenera sitemaps XML e gera hreflang, Open Graph e JSON-LD (VideoObject, BreadcrumbList) automaticamente. Envie o novo sitemap no Google Search Console logo após o lançamento, para que as novas URLs sejam rastreadas novamente com rapidez. O guia de SEO para sites de tube adulto aprofunda esse tema.

Passo 5 — Cuide das miniaturas, da mídia e do seu CDN

Seus arquivos de vídeo e miniaturas geralmente são a maior parte de uma migração e, muitas vezes, você não precisa movê-los de jeito nenhum. O TubePress suporta múltiplos backends de armazenamento (local, S3, FTP/SFTP, WebDAV), então você pode apontá-lo para o seu armazenamento ou CDN existente e continuar servindo os mesmos arquivos. Se você também estiver trocando de servidor, mova a mídia separadamente da importação dos metadados e verifique se uma amostra das URLs resolve corretamente antes de entrar no ar.

Passo 6 — Verifique no staging e, então, redirecione o DNS

Antes de qualquer mudança de DNS, percorra o site de staging: faça uma verificação por amostragem da reprodução de vídeos, das páginas de categorias e performers, da busca, da área de membros e de algumas URLs antigas redirecionadas. Confirme que o sitemap é gerado e que as páginas retornam canonicals limpas. Somente quando o staging estiver sólido você redireciona seu domínio — a virada passa a ser apenas uma mudança de DNS, e seus visitantes nunca veem um site migrado pela metade.

Armadilhas comuns de migração a evitar

• Mudar URLs sem redirecionamentos. A forma mais rápida de perder ranqueamento. Mapeie cada padrão antigo para um novo.
• Importar duplicatas. Use a detecção de duplicatas do importador e importe em lotes limpos, em vez de reexecutar arquivos sobrepostos.
• Migrar diretamente para o domínio ao vivo. Sempre use staging primeiro; nunca experimente na URL que está gerando tráfego.
• Esquecer o sitemap. Reenvie-o no Search Console no dia do lançamento, para que a mudança seja descoberta em dias, não semanas.

Feita nesta ordem, uma migração do KVS é metódica em vez de arriscada — e, ao final, você está rodando um CMS gratuito e totalmente editável, sem licença por domínio. Quando estiver pronto, baixe o TubePress e configure seu site de staging.