Nextcloud Automated Installer
[!CAUTION]
This project is for educational and ethical cybersecurity purposes only. The author is not responsible for any misuse or damage caused by this software.
🧠 Overview
Este proyecto es un instalador automatizado de Nextcloud para entornos Ubuntu, construido íntegramente en Bash. A partir del análisis de la estructura del repositorio y sus archivos clave, el script principal (src/setup.sh) orquesta el despliegue completo de un stack LAMP (Linux + Apache + MySQL/MariaDB + PHP) y la configuración de Nextcloud sobre él, a través de un asistente interactivo por menú que guía al administrador en cada etapa del proceso.
El proyecto sigue una estrategia DevSecOps centrada en la automatización del despliegue y la seguridad de la infraestructura, garantizando que cada componente esté configurado siguiendo las mejores prácticas de la industria.
⚙️ Features
- Asistente interactivo por menú —
setup.sh presenta un menú modular que permite ejecutar cada fase del despliegue de forma independiente o secuencial.
- Instalación del stack LAMP — Automatiza la instalación y configuración de Apache2 como servidor web, MySQL/MariaDB como base de datos y PHP con las extensiones requeridas por Nextcloud.
- Despliegue de Nextcloud — Descarga, descomprime y enlaza Nextcloud al directorio web de Apache, configurando la base de datos y los parámetros de red del servidor.
- Hardening de seguridad — Aplica endurecimiento de permisos en directorios críticos de Nextcloud (
/var/www/html/nextcloud/) para cumplir con las recomendaciones de seguridad oficiales.
- Diagnóstico del sistema — Opción de verificación de estado que reporta el estado de los servicios activos (Apache2, MySQL, PHP) y recursos del sistema.
- Documentación técnica detallada — Guías completas en la carpeta
docs/ que cubren desde la arquitectura hasta el mantenimiento del sistema.
- Documentación técnica separada — Carpeta
docs/ con documentación detallada del proceso de despliegue, independiente del código fuente.
🛠️ Tech Stack
| Componente |
Tecnología |
| Sistema Operativo |
Ubuntu 20.04 LTS o superior |
| Lenguaje de scripting |
Bash / Shell |
| Servidor web |
Apache2 |
| Base de datos |
MySQL / MariaDB |
| Lenguaje backend |
PHP (con extensiones Nextcloud) |
| Aplicación desplegada |
Nextcloud (plataforma self-hosted) |
| Control de versiones |
Git (GitHub) |
📦 Installation
Requisitos previos
- Ubuntu Server 20.04 LTS o superior
- Acceso de superusuario (
sudo)
- Conexión a Internet activa
- Al menos 2 GB de RAM y 10 GB de espacio en disco (recomendado para Nextcloud)
Instalación
# 1. Clonar el repositorio
git clone https://github.com/devsebastian44/Nextcloud.git
cd Nextcloud
# 2. Otorgar permisos de ejecución al script principal
chmod +x src/setup.sh
# 3. Ejecutar el instalador con privilegios de root
sudo ./src/setup.sh
⚠️ Se recomienda ejecutar el instalador sobre un servidor limpio o una máquina virtual dedicada. No ejecutar sobre sistemas con servicios web ya configurados sin revisar previamente los archivos de configuración en configs/.
▶️ Usage
Al ejecutar sudo ./src/setup.sh, se presenta un menú interactivo con las siguientes opciones:
╔══════════════════════════════════════╗
║ Nextcloud Professional Installer ║
╠══════════════════════════════════════╣
║ [1] Instalar Requisitos ║
║ [2] Configurar Nextcloud ║
║ [3] Configurar Seguridad ║
║ [4] Verificar Estado ║
║ [0] Salir ║
╚══════════════════════════════════════╝
Flujo recomendado de ejecución:
# Paso 1 — Instalar el stack LAMP (Apache, MySQL, PHP)
Seleccionar opción [1]
# Paso 2 — Desplegar y vincular Nextcloud con la base de datos
Seleccionar opción [2]
# Paso 3 — Aplicar hardening de permisos y configuración de seguridad
Seleccionar opción [3]
# Paso 4 — Verificar que todos los servicios estén activos
Seleccionar opción [4]
Verificación manual post-instalación:
# Estado de Apache2
sudo systemctl status apache2
# Estado de MySQL/MariaDB
sudo systemctl status mysql
# Acceder a Nextcloud desde el navegador
http://<IP_DEL_SERVIDOR>/
📁 Project Structure
Nextcloud/
│
├── src/
│ └── setup.sh # Script principal del instalador:
│ # menú interactivo, instalación LEMP,
│ # despliegue y configuración de Nextcloud
│
├── docs/ # Documentación técnica detallada:
│ # guías de configuración, diagramas
│ # de arquitectura y flujos de despliegue
│
├── .gitignore # Exclusiones de Git: archivos de entorno,
│ # configs reales y artefactos privados
│
├── LICENSE # Licencia GPL-3.0
└── README.md # Documentación pública del repositorio
📌 El repositorio incluye adicionalmente: configs/ (plantillas de configuración) y tests/ (validaciones y pruebas unitarias).
🔐 Security
Este proyecto despliega una plataforma de colaboración privada. Se consideran las siguientes implicaciones de seguridad:
- Hardening de permisos — El script aplica restricciones de propiedad y permisos sobre los directorios de Nextcloud (
www-data, 750/640) para limitar la exposición de archivos sensibles.
- Separación de credenciales — Las configuraciones reales de base de datos y parámetros de red son filtradas por el pipeline de sanitización antes de la publicación pública; nunca deben commitearse credenciales reales.
- Apache como servidor seguro — Se recomienda configurar HTTPS con certificado SSL/TLS (Let's Encrypt o autofirmado) sobre Apache antes de exponer Nextcloud a redes públicas.
- PHP hardening — Verificar que
php.ini tenga deshabilitadas directivas como expose_php, display_errors y configurados límites de subida adecuados (upload_max_filesize, post_max_size).
- MySQL/MariaDB — Ejecutar
mysql_secure_installation tras la instalación para eliminar usuarios anónimos, deshabilitar el acceso root remoto y eliminar bases de datos de prueba.
- Firewall — Se recomienda configurar
ufw para permitir únicamente los puertos necesarios (80, 443) y bloquear accesos directos al puerto de base de datos (3306).
- Uso responsable — Este proyecto está diseñado para entornos educativos, laboratorios y despliegues controlados. Revisar y adaptar todos los archivos de configuración antes de cualquier uso en producción.
⚠️ Este repositorio contiene la versión completa y funcional del instalador. Se recomienda revisar los archivos de configuración en configs/ antes del despliegue.
🧪 Testing
El proyecto incluye scripts de validación para asegurar la calidad del código:
# Ejecutar verificación de sintaxis
./tests/test_syntax.sh
# Ejecutar linting (requiere shellcheck)
./tests/test_lint.sh
Los tests se ejecutan automáticamente en cada Pull Request mediante GitHub Actions.
🤝 Contributing
¡Las contribuciones son bienvenidas! Si deseas mejorar el instalador:
- Fork el proyecto.
- Crea una rama para tu mejora (
git checkout -b feature/amazing-feature).
- Realiza tus cambios y asegúrate de que los tests pasen.
- Commit tus cambios siguiendo el estándar Conventional Commits.
- Push a la rama (
git push origin feature/amazing-feature).
- Abre un Pull Request.
🚀 Roadmap
Posibles mejoras identificadas a partir del análisis del código y la arquitectura actual:
- Soporte HTTPS automático — Integrar Certbot con Let's Encrypt directamente desde el menú del instalador.
- Selección de versión de Nextcloud — Permitir al usuario especificar la versión a instalar en lugar de usar siempre la más reciente.
- Soporte para MariaDB y PostgreSQL — Ampliar la opción de base de datos más allá de MySQL.
- Modo headless / no interactivo — Añadir soporte para flags de línea de comandos que permitan ejecución automatizada sin menú (útil para CI/CD).
- Integración con Redis — Configurar Redis como caché de sesiones y archivos para mejorar el rendimiento de Nextcloud.
- Script de backup automatizado — Añadir un módulo de respaldo para datos de Nextcloud y la base de datos.
- Soporte multi-distro — Extender compatibilidad a Debian y CentOS/Rocky Linux además de Ubuntu.
📄 License
Este proyecto está bajo la licencia GNU General Public License v3.0 (GPL-3.0).
GPL-3.0 License — Copyright (c) devsebastian44
Se permite el uso, modificación y distribución bajo los términos de la GPL v3.
Las versiones derivadas deben mantener la misma licencia y publicar el código fuente.
👨💻 Author
Sebastian
GitHub: @devsebastian44
Proyecto desarrollado con fines educativos y de automatización de infraestructura,
siguiendo principios DevSecOps para el despliegue seguro de plataformas self-hosted.