Instalación de Next

Copias de seguridad y mantenimiento

Las copias de seguridad regulares y el mantenimiento oportuno son cruciales para cualquier servicio en producción. Nextcloud no es una excepción.

¿Qué respaldar:

• Datos de Nextcloud: Archivos de usuario almacenados en el volumen nextcloud_data.
• Base de datos de Nextcloud: Toda la base de datos MariaDB, que almacena información sobre usuarios, archivos, configuraciones, etc. (volumen db_data).
• Archivos de configuración de Nextcloud: El archivo config/config.php y otras configuraciones (volumen nextcloud_config).
• Configuración de Docker Compose: Los archivos docker-compose.yml y .env.
• Certificados de Let's Encrypt: El directorio /etc/letsencrypt (volumen certbot_certs).

Script simple de copia de seguridad automática

Crearemos un script simple que realizará copias de seguridad de todos los componentes necesarios. Para almacenar las copias de seguridad, se recomienda utilizar un almacenamiento externo, como un almacenamiento en la nube compatible con S3 u otro VPS.

Cree un directorio para los scripts de copia de seguridad:

mkdir -p ~/scripts
nano ~/scripts/backup_nextcloud.sh

Contenido de ~/scripts/backup_nextcloud.sh:

#!/bin/bash

# --- Configuración ---
BACKUP_DIR="/mnt/backups/nextcloud" # Directorio para el almacenamiento temporal de copias de seguridad en el VPS
NEXTCLOUD_PROJECT_DIR="/home/nextcloudadmin/nextcloud_data" # Ruta a su docker-compose.yml
DATE=$(date +%Y%m%d%H%M%S)
DB_BACKUP_FILE="${BACKUP_DIR}/nextcloud_db_${DATE}.sql"
DATA_BACKUP_FILE="${BACKUP_DIR}/nextcloud_data_${DATE}.tar.gz"
CONFIG_BACKUP_FILE="${BACKUP_DIR}/nextcloud_config_${DATE}.tar.gz"
CERT_BACKUP_FILE="${BACKUP_DIR}/nextcloud_certs_${DATE}.tar.gz"
COMPOSE_BACKUP_FILE="${BACKUP_DIR}/nextcloud_compose_${DATE}.tar.gz"

# Variables de .env
source "${NEXTCLOUD_PROJECT_DIR}/.env"

# --- Creación del directorio de copias de seguridad ---
mkdir -p "${BACKUP_DIR}" || { echo "Error: No se pudo crear el directorio de copias de seguridad."; exit 1; }

echo "--- Iniciando la copia de seguridad de Nextcloud ---"

# 1. Copia de seguridad de la base de datos MariaDB
echo "Realizando copia de seguridad de la base de datos..."
sudo docker compose -f "${NEXTCLOUD_PROJECT_DIR}/docker-compose.yml" exec db sh -c \
    "exec mariadb-dump -u${MYSQL_USER} -p${MYSQL_PASSWORD} ${MYSQL_DATABASE}" > "${DB_BACKUP_FILE}" || \
    { echo "Error: La copia de seguridad de la base de datos falló."; exit 1; }
echo "Copia de seguridad de la base de datos completada: ${DB_BACKUP_FILE}"

# 2. Copia de seguridad de los datos de Nextcloud (archivos de usuario)
echo "Realizando copia de seguridad de los datos de Nextcloud..."
sudo docker compose -f "${NEXTCLOUD_PROJECT_DIR}/docker-compose.yml" exec app tar -czf - -C /var/www/html/data . > "${DATA_BACKUP_FILE}" || \
    { echo "Error: La copia de seguridad de los datos de Nextcloud falló."; exit 1; }
echo "Copia de seguridad de los datos de Nextcloud completada: ${DATA_BACKUP_FILE}"

# 3. Copia de seguridad de la configuración de Nextcloud
echo "Realizando copia de seguridad de la configuración de Nextcloud..."
sudo docker compose -f "${NEXTCLOUD_PROJECT_DIR}/docker-compose.yml" exec app tar -czf - -C /var/www/html config > "${CONFIG_BACKUP_FILE}" || \
    { echo "Error: La copia de seguridad de la configuración de Nextcloud falló."; exit 1; }
echo "Copia de seguridad de la configuración de Nextcloud completada: ${CONFIG_BACKUP_FILE}"

# 4. Copia de seguridad de los certificados de Let's Encrypt
echo "Realizando copia de seguridad de los certificados de Let's Encrypt..."
sudo tar -czf "${CERT_BACKUP_FILE}" -C /var/lib/docker/volumes/nextcloud_data_certbot_certs/_data . || \
    { echo "Error: La copia de seguridad de los certificados falló."; exit 1; }
echo "Copia de seguridad de los certificados completada: ${CERT_BACKUP_FILE}"

# 5. Copia de seguridad de los archivos de Docker Compose
echo "Realizando copia de seguridad de los archivos de Docker Compose..."
tar -czf "${COMPOSE_BACKUP_FILE}" -C "${NEXTCLOUD_PROJECT_DIR}" docker-compose.yml .env || \
    { echo "Error: La copia de seguridad de los archivos de Docker Compose falló."; exit 1; }
echo "Copia de seguridad de los archivos de Docker Compose completada: ${COMPOSE_BACKUP_FILE}"

echo "--- Copia de seguridad completada ---"

# --- Limpieza de copias de seguridad antiguas (conservar los últimos 7 días) ---
echo "Limpiando copias de seguridad antiguas..."
find "${BACKUP_DIR}" -type f -name "nextcloud_*.sql" -mtime +7 -delete
find "${BACKUP_DIR}" -type f -name "nextcloud_*.tar.gz" -mtime +7 -delete
echo "Limpieza completada."

# --- Subida de copias de seguridad a almacenamiento externo (ejemplo con rclone a S3) ---
# Instale rclone y configúrelo para su almacenamiento S3
# Por ejemplo, rclone config
# rclone sync "${BACKUP_DIR}" "s3_remote:nextcloud-backups"
# Copias de seguridad sincronizadas con S3.

exit 0

Haga el script ejecutable:

chmod +x ~/scripts/backup_nextcloud.sh

Para ejecutar este script, es posible que necesite montar un disco externo o configurar /mnt/backups. Además, asegúrese de que el usuario nextcloudadmin tenga permisos de lectura/escritura en /var/lib/docker/volumes/nextcloud_data_certbot_certs/_data o use sudo para el comando tar para los certificados.

Dónde almacenar las copias de seguridad:

• Servicio externo compatible con S3: AWS S3, Backblaze B2, DigitalOcean Spaces. Esta es una opción fiable y relativamente económica. Utilice utilidades como rclone para la sincronización automática.
• VPS separado: Alquile un VPS pequeño exclusivamente para almacenar copias de seguridad. Sincronice mediante SSH/rsync.
• NAS/servidor local: Si tiene su propio hardware.

¡Nunca almacene las copias de seguridad en el mismo VPS que el servicio principal! En caso de fallo del servidor, perderá tanto el servicio como las copias de seguridad.

Automatización de copias de seguridad con Cron

Agregue el script al programador Cron para su ejecución diaria (por ejemplo, a las 3 de la mañana).

sudo crontab -e

Agregue la siguiente línea al final del archivo:

0 3 * * * /home/nextcloudadmin/scripts/backup_nextcloud.sh >> /var/log/nextcloud_backup.log 2>&1

Esto ejecutará el script todos los días a las 03:00 y registrará la salida en el archivo de registro /var/log/nextcloud_backup.log.

Actualizaciones: rolling vs maintenance window

• Actualización del SO: Ejecute regularmente sudo apt update && sudo apt upgrade -y. Se recomienda hacerlo una vez al mes o cuando se publiquen actualizaciones críticas.
• Actualización de imágenes Docker:
  • Rolling (continuo): Para Nextcloud y la base de datos, esta no siempre es la mejor opción, ya que las actualizaciones pueden requerir migraciones de la base de datos o cambios en la API.
  • Maintenance window (ventana de mantenimiento): Se recomienda planificar las actualizaciones de las imágenes Docker de Nextcloud, MariaDB y Redis fuera del horario laboral.

    
    cd ~/nextcloud_data
    sudo docker compose pull                  # Загрузить новые версии образов
    sudo docker compose down                  # Остановить все сервисы
    sudo docker compose up -d                 # Запустить сервисы с новыми образами
    sudo docker exec -it app occ upgrade      # Выполнить обновление Nextcloud через его CLI
    sudo docker exec -it app occ maintenance:mode --off # Выключить режим обслуживания
                        

• Actualización de Certbot: Los certificados de Let's Encrypt se actualizan automáticamente mediante el contenedor certbot, que se ejecuta en docker-compose.yml.

Solución de problemas + Preguntas frecuentes

Aquí se recopilan los problemas típicos y las preguntas frecuentes durante la instalación y operación de Nextcloud en un VPS.

Nginx devuelve 502 Bad Gateway

Qué verificar: Esto significa que Nginx no puede comunicarse con la aplicación backend (en nuestro caso, el contenedor Nextcloud FPM).

• Asegúrese de que el contenedor app esté en ejecución: sudo docker compose ps.
• Revise los logs del contenedor app: sudo docker compose logs app. Busque errores de PHP-FPM.
• Asegúrese de que Nginx esté configurado correctamente para hacer proxy a app:9000.
• Verifique que los contenedores estén en la misma red Docker.

Cómo solucionarlo: Si app no está en ejecución, revise los logs en busca de errores de inicio. Si está en ejecución pero no responde, es posible que PHP-FPM se haya colgado o que Nextcloud no esté inicializado. Intente reiniciar el contenedor app: sudo docker compose restart app.

No se puede obtener el certificado SSL de Let's Encrypt

Qué verificar:

• Asegúrese de que su dominio apunte correctamente a la dirección IP de su VPS (registros A/AAAA). Use dig your.domain.com.
• Asegúrese de que los puertos 80 y 443 estén abiertos en el firewall (sudo ufw status).
• Revise los logs del contenedor certbot: sudo docker compose logs certbot.
• Asegúrese de que Nginx esté configurado para .well-known/acme-challenge/.

Cómo solucionarlo: Corrija los registros DNS, abra los puertos en UFW, verifique la configuración de Nginx. Si hay un problema con Certbot, es posible que se hayan alcanzado los límites de solicitudes (raro para dominios nuevos) o que haya un problema con el sistema de archivos.

Nextcloud funciona lento

Qué verificar:

• Recursos del VPS: CPU o RAM insuficientes. Verifique el uso de recursos: htop o docker stats.
• Caché: Asegúrese de que Redis esté configurado y funcionando (consulte la sección "Configuración" y config/config.php).
• Base de datos: Rendimiento lento de la BD. Revise los logs de MariaDB en busca de errores o consultas lentas.
• Disco: E/S de disco lenta. Un SSD es obligatorio para Nextcloud.
• Configuración interna de Nextcloud: Vaya a "Configuración" -> "Visión general" en Nextcloud para obtener recomendaciones de rendimiento.

Cómo solucionarlo: Aumente los recursos del VPS (RAM, CPU), asegúrese de que la caché de Redis esté configurada correctamente, considere la optimización de la base de datos o la migración a un SSD más rápido.

No puedo iniciar sesión en Nextcloud después de la instalación

Qué verificar:

• La exactitud del nombre de usuario y la contraseña del administrador que especificó durante la configuración inicial.
• Revise los logs del contenedor app en busca de errores de autenticación.
• Asegúrese de que la base de datos esté en ejecución y accesible para Nextcloud (contenedor db).

Cómo solucionarlo: Si olvidó la contraseña del administrador, puede restablecerla a través de la CLI de Nextcloud: sudo docker exec -it app occ user:resetpassword admin_username. Asegúrese de que el contenedor db esté en ejecución y que no haya errores en sus logs.

¿Qué configuración mínima de VPS es adecuada?

Para un solo usuario o una familia muy pequeña (hasta 3-5 personas) con uso básico (almacenamiento de archivos, sincronización), un VPS con 1 vCPU, 2 GB de RAM y 100 GB de SSD será mínimamente adecuado. Sin embargo, para un funcionamiento más cómodo y la posibilidad de ampliar funciones (por ejemplo, videollamadas, edición de documentos), se recomienda 2 vCPU, 4 GB de RAM y 200 GB de SSD. Esto garantizará un mejor rendimiento y estabilidad del sistema.

¿Qué elegir: VPS o dedicado para esta tarea?

Para la mayoría de los escenarios de uso de Nextcloud (nube personal, equipo pequeño o mediano de hasta 50-100 usuarios), un VPS es la opción óptima. Ofrece suficiente rendimiento, flexibilidad y es significativamente más económico que un servidor dedicado. Un servidor dedicado solo debe elegirse para cargas muy grandes, un número significativo de usuarios (más de 100), requisitos específicos de hardware o en caso de que se requiera un aislamiento completo a nivel físico.

Error "Trusted domain" en Nextcloud

Qué verificar: Este error significa que Nextcloud no confía en el dominio desde el que intenta acceder a él.

• Asegúrese de que NEXTCLOUD_TRUSTED_DOMAINS en su archivo .env contenga el dominio correcto.
• Verifique que en config/config.php dentro del contenedor de Nextcloud su dominio también esté listado como de confianza.

Cómo solucionarlo: Edite el archivo .env y/o config/config.php, agregando su dominio a la lista de confianza. Después de modificar .env, debe recrear el contenedor: sudo docker compose down && sudo docker compose up -d. Después de modificar config.php dentro del contenedor, es suficiente con reiniciar el contenedor app: sudo docker compose restart app.