Actualizar TubePress
Actualizaciones con un clic, actualizaciones manuales, versiones firmadas y la protección de versión de PHP.
TubePress se actualiza igual que WordPress: un clic en el panel de administración descarga una versión firmada, la verifica, hace una copia de seguridad, reemplaza el núcleo y ejecuta las migraciones de base de datos. Tus temas, plugins, medios y configuraciones permanecen intactos.
Esta página explica exactamente qué cambia una actualización, cómo aplicarla y cómo mantenerse seguro.
Cómo funcionan las actualizaciones
Las versiones se distribuyen como paquetes firmados desde tubepress.io. Antes de que TubePress toque un solo archivo, cada paquete se verifica dos veces:
- una suma de verificación SHA-256 — una discrepancia cancela la actualización; y
- una firma Ed25519 — el núcleo rechaza la instalación sin una firma válida, por lo que un paquete de núcleo manipulado o sin firma es rechazado directamente.
Una actualización solo reemplaza el núcleo fijo. Concretamente:
src/, sql/, templates/admin/, templates/install/ y config/app.php.themes/, plugins/, los medios subidos en public/uploads/, el contenido de tu base de datos y tu configuración (incluido config/database.php).Justo antes de intercambiar los archivos, TubePress copia el núcleo actual a storage/backups/ y realiza una copia de seguridad de la base de datos. Si no puede crear esa copia de seguridad, la actualización del núcleo se cancela en lugar de arriesgar tus datos. Los archivos se intercambian de forma atómica, las nuevas migraciones numeradas en sql/ se ejecutan automáticamente y el resultado se registra en un log de actualización que puedes revisar o desde el que puedes revertir.
Actualización con un clic
Ve a Admin → Actualizaciones en /admin/updates (se requiere acceso de administrador). La pantalla muestra tu versión actual y cualquier actualización disponible para el núcleo, plugins y temas. Buscar actualizaciones vuelve a consultar tubepress.io bajo demanda.
Haz clic para aplicar un elemento y TubePress descarga, verifica, hace copia de seguridad, intercambia y migra — luego registra el resultado. Si algo parece incorrecto después, puedes revertir a la copia de seguridad que acaba de crear.
Actualizaciones automáticas
¿Prefieres no intervenir? Activa el ajuste auto_update_enabled (está desactivado por defecto). Cuando está activo, una tarea pseudo-cron en segundo plano comprueba periódicamente y aplica las actualizaciones pendientes como máximo una vez al día. Por seguridad, es deliberadamente conservador:
- el núcleo y los plugins gratuitos se actualizan automáticamente;
- los temas siempre se dejan para que los actualices manualmente, de modo que tus personalizaciones nunca se sobrescriban sin supervisión; y
- los elementos de pago se omiten — requieren una compra en el marketplace.
El planificador es el mismo pseudo-cron integrado que se usa en otros lugares — consulta Mantenimiento.
Actualización manual
El actualizador con un clic es el método recomendado porque es el único que también verifica firmas, crea copias de seguridad y ejecuta las migraciones de base de datos. Si tu panel realmente no puede conectarse a tubepress.io (un host con firewall o aislado de la red), puedes actualizar manualmente:
- Haz una copia de seguridad primero. Realiza una copia de seguridad completa de archivos y base de datos — consulta Copias de seguridad.
- Obtén la versión oficial. Descarga el ZIP firmado desde la página de descarga o tu cuenta.
- Reemplaza solo el núcleo. Sobrescribe
src/,sql/,templates/admin/,templates/install/yconfig/app.phpde la nueva versión. Dejathemes/,plugins/,public/uploads/yconfig/database.phpen su lugar. - Aplica las nuevas migraciones. Aplica cualquier archivo numerado nuevo en
sql/a tu base de datos — este es el paso que el actualizador integrado normalmente hace por ti.
El guardián de versión PHP
TubePress incluye una pequeña puerta de análisis seguro (config/php-guard.php) que se ejecuta en cada punto de entrada antes de que arranque la aplicación. Está escrita deliberadamente en estilo PHP antiguo para que se analice en cualquier versión — lo que significa que si un sitio se mueve a, o se degrada a, un PHP más antiguo que el requerido 8.2, los visitantes ven una página limpia de “actualización de PHP requerida” en lugar de un error fatal sin formato.
Esto es importante en las actualizaciones: las versiones más nuevas pueden usar sintaxis PHP más moderna, así que confirma que tu host ejecuta PHP 8.2 o superior (se recomienda 8.4) antes y después de actualizar. Más detalles en Mantenimiento.
Antes de actualizar
Las actualizaciones están diseñadas para ser seguras y reversibles, pero una copia de seguridad sigue siendo tu cinturón de seguridad:
- Haz copia de seguridad de archivos y base de datos — el actualizador crea la suya, pero guarda también tu propia copia. Consulta Copias de seguridad.
- Verifica PHP — confirma que estás en 8.2+ (idealmente 8.4).
- Anota tus personalizaciones — los cambios de tema y plugin se conservan, pero un inventario rápido nunca está de más.
- Actualiza en un momento tranquilo — el intercambio es casi instantáneo, pero elige un momento de poco tráfico por si acaso.
Próximos pasos
¿Todavía con dudas?
Abre un ticket desde tu panel y nuestro equipo te ayudará.