Inicio
» ADMINISTRADOR DE RED
»
Cómo borrar el historial de versiones de archivos de ownCloud desde la línea de comandos
Cómo borrar el historial de versiones de archivos de ownCloud desde la línea de comandos
La línea de comandos de ownCloud permite liberar espacio de almacenamiento eliminando versiones de archivos, pero el comando correcto depende de lo que se entienda por "purgar". Se puede configurar ownCloud para que solo caduque las versiones que infrinjan la política de retención configurada, eliminar todas las versiones guardadas de una o más cuentas, o eliminar todas las versiones del sistema. Estas opciones difieren notablemente en cuanto a reversibilidad y alcance. Primero, confirme si su servidor es ownCloud Server o ownCloud Infinite Scale ; utilizan herramientas de línea de comandos diferentes.
Los comandos que se muestran a continuación se basan en la documentación de administración actual de ownCloud Server 10.16 y 11.0 y en la guía de Infinite Scale 8.2, revisada el 6 de octubre de 2026. Las rutas, los nombres de los servicios y los ID de cuenta varían según la instalación, por lo que conviene adaptar los ejemplos antes de ejecutarlos en un servidor de producción.
Elige el método de limpieza que mejor se adapte a tu objetivo.
Método
Lo que elimina
Mejor ajuste
Principal compensación
versions:expireen el servidor ownCloud
Versiones consideradas caducadas por la regla de retención configurada
Mantenimiento rutinario y control de cuotas
Conserva las versiones que aún están cubiertas por la política, por lo que es posible que no recupere tanto espacio de inmediato como una eliminación completa.
versions:cleanup USER_IDen el servidor ownCloud
Todas las versiones guardadas para la cuenta o cuentas especificadas.
Eliminar el historial de una cuenta específica
Ese usuario pierde la capacidad de restaurar versiones anteriores, incluidas las versiones publicadas.
versions:cleanupsin ID de usuario
Todas las versiones guardadas para todos los usuarios de ownCloud Server.
Un reinicio planificado para toda la organización.
Se trata de una operación destructiva de gran alcance, y el comando documentado no incluye opción de vista previa.
ocis revisions purgea escala infinita
Revisiones en todos los espacios por defecto, o un ámbito de recursos más restringido cuando se especifique
Implementaciones de escala infinita que requieren limpieza de revisiones
Su comportamiento en modo de prueba y las opciones de ruta de almacenamiento son diferentes de los comandos de ownCloud Server occ.
Para la administración recurrente del almacenamiento, comience con la política de retención y versions:expire. Úselo versions:cleanupsolo cuando desee borrar deliberadamente el historial seleccionado ahora.
1. Confirme su producto ownCloud y la ubicación del comando.
Para ownCloud Server, conéctese al host o contenedor que ejecuta la aplicación PHP y cambie al directorio de instalación de ownCloud, donde occse encuentra el script. Un patrón común en Linux es ejecutar comandos como la cuenta del servidor web, a menudo www-datao wwwrun:
cd /var/www/owncloud sudo -u www-data php occ status
Utilice la ruta de instalación y la cuenta de servidor web correspondientes a su sistema. Ejecutar occcomo root puede dejar archivos con la propiedad de la cuenta incorrecta, por lo que debe usar la cuenta de servicio documentada. Confirme que la aplicación Versiones files_versionsesté habilitada; los comandos de versión no están disponibles cuando esta aplicación está deshabilitada y tampoco están disponibles en el modo de mantenimiento de un solo usuario.
El occ statuscomando comprueba la instalación del servidor ownCloud antes de la limpieza de versiones.
Si ownCloud Server se ejecuta en Docker, ejecute el comando dentro del contenedor de la aplicación. Por ejemplo, desde el directorio que contiene su configuración de Compose, un despliegue puede usar docker compose exec owncloud occ status; reemplace owncloudcon el nombre real del servicio en su archivo Compose. No utilice los occejemplos para Infinite Scale.
2. Decida si desea aplicar la retención o borrar el historial.
Utilice la caducidad cuando desee una limpieza basada en políticas.
versions:expireEvalúa las versiones según la versions_retention_obligationconfiguración en config.php. Sin un ID de usuario, se aplica a todos los usuarios; también puede enumerar uno o más ID de usuario. Para una sola cuenta, el comando es:
sudo -u www-data php occ versions:expire alice
Sustituya el ID de cuenta real, no el nombre de usuario ni la dirección de correo electrónico, a menos que así se identifique la cuenta en su instalación. Para ejecutar el proceso de caducidad en todas las cuentas, omita alice. Esta opción respeta la regla de retención configurada: no necesariamente eliminará las versiones recientes o retenidas.
El versions:expirecomando aplica la política de retención configurada a una cuenta específica.
La documentación de ownCloud Server describe autoel patrón de retención predeterminado y también documenta alternativas basadas en el tiempo. Revise su política antes de ejecutar la expiración, especialmente si su organización tiene requisitos legales u operativos de retención. Para la expiración recurrente normal, ownCloud la ejecuta como una tarea en segundo plano. El manual de administración recomienda usar cron del sistema para las tareas en segundo plano; invocar manualmente la expiración es útil para una ejecución de mantenimiento programada, pero no debe convertirse en un sustituto improvisado de un programador correctamente configurado.
Utilice la limpieza cuando tenga la intención de eliminar todas las versiones en el ámbito.
Para una cuenta, ejecute:
sudo -u www-data php occ versions:cleanup alice
Para varias cuentas, proporcione sus identificadores separados por espacios:
sudo -u www-data php occ versions:cleanup alice bob
Sin identificadores, el comando elimina todos los archivos versionados para todos los usuarios:
sudo -u www-data php occ versions:cleanup
Al proporcionar un ID de cuenta, se limita la limpieza del historial completo a ese usuario.
Primero, realiza una copia de seguridad si las versiones pueden ser necesarias para la recuperación y confirma los ID de cuenta antes de ejecutar el comando. El comando documentado elimina los datos de la versión y la files_versionscarpeta asociada para su ámbito. También elimina las versiones publicadas que, de otro modo, persistirían más allá del período de retención normal. No existe una opción de "solo vista previa" documentada para ownCloud Server versions:cleanup, por lo que un error tipográfico o un ID omitido puede tener un impacto mayor del previsto.
3. Entienda la diferencia entre ownCloud Server e Infinite Scale.
ownCloud Infinite Scale (oCIS) no utiliza el occ versions:cleanupcomando PHP. Su documentación de administración describe la limpieza de revisiones con ocis revisions purge. El comando realiza por defecto una prueba en seco, que informa de lo que eliminaría sin borrar las revisiones. Se requiere la ruta de almacenamiento de usuarios configurada; este ejemplo utiliza una ruta de marcador de posición:
ocis revisions purge -p /base/path/storage/users
Inspeccione los resultados de la prueba y verifique que la ruta de almacenamiento sea correcta. Para eliminar realmente las revisiones que aparecen en esa ejecución, desactive explícitamente la prueba:
Por defecto, el comando Escala infinita se dirige a las revisiones en todos los espacios. Su --resource-idopción permite limitar la operación a un espacio o a un archivo individual si se dispone del ID correcto. Si la ruta o el alcance son inciertos, deténgase en la prueba y confirme ambos con la configuración de su implementación. La documentación indica que los modos de comodín alternativos pueden aumentar el uso de CPU y memoria en espacios grandes; mantenga la configuración predeterminada a menos que haya determinado la necesidad de cambiarla.
Sin un ID de usuario, versions:cleanupse dirige a todos los usuarios de ownCloud Server.
4. Verifica el resultado sin eliminar más datos.
Tras una limpieza del servidor, inspeccione algunas cuentas representativas en la interfaz web y confirme que las entradas antiguas ya no aparecen en el historial de versiones de cada archivo. Compruebe la salida del comando para los usuarios procesados. Para Infinite Scale, compare los resultados de la purga con la salida de la prueba y revise el estado de finalización del comando. A continuación, compruebe el uso del almacenamiento en la capa relevante para su implementación: informes de cuotas de ownCloud, el sistema de archivos local o el almacén de objetos configurado.
No elimine archivos manualmente para files_versionsfinalizar una purga. Los comandos compatibles de ownCloud coordinan la limpieza de versiones con los metadatos de la aplicación; eliminar objetos de almacenamiento fuera de la aplicación puede generar registros inconsistentes. Además, la recuperación de espacio en disco del servidor puede diferir del número de versiones eliminadas si su sistema de almacenamiento utiliza instantáneas, replicación o su propio comportamiento de eliminación diferida. Esto depende del sistema de almacenamiento y debe consultarse con su administrador o proveedor.
¿Qué opción debería utilizar?
Elija esta opciónversions:expire cuando su objetivo sea la gestión continua de cuotas con las reglas de retención existentes.
Seleccione la opción "con alcance"versions:cleanup USER_ID cuando necesite eliminar todo el historial de las cuentas conocidas y haya aceptado la pérdida de los puntos de restauración.
Seleccione "Global"versions:cleanup únicamente para un restablecimiento intencional de todo el sistema después de la copia de seguridad y la revisión del alcance.
Seleccione el flujo de trabajo de purga de escala infinita solo en oCIS y revise su ejecución en seco predeterminada antes de configurarlo --dry-run=false.
Nota de versión: El comportamiento de los comandos y los ejemplos se compararon con la documentación de ownCloud Server 10.16/11.0 e Infinite Scale 8.2 el 6 de octubre de 2026. Verifique el manual correspondiente a su versión instalada antes de ejecutar una operación destructiva.