Nextcloud

KO | EN

gitlite — search

#python #react #rust #deep-learning #linux #docker #nodejs #windows #awesome #cli #vue #pytorch #ios #open-source

(★ 23)

Script para instalar y configurar Nextcloud automáticamente

Nextcloud 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Nextcloud Automated Installer

![Ubuntu](https://img.shields.io/badge/Ubuntu-20.04%2B-E95420?style=flat&logo=ubuntu&logoColor=white)
![Shell](https://img.shields.io/badge/Shell-Bash_5.0%2B-4EAA25?style=flat&logo=gnubash&logoColor=white)
![Nextcloud](https://img.shields.io/badge/Nextcloud-Self--Hosted-0082C9?style=flat&logo=nextcloud&logoColor=white)
![MySQL](https://img.shields.io/badge/Database-MySQL%2FMariaDB-4479A1?style=flat&logo=mysql&logoColor=white)
![GitHub Actions](https://img.shields.io/badge/GitHub_Actions-CI%2FCD-2088FF?style=flat&logo=github-actions&logoColor=white)
![License](https://img.shields.io/badge/License-GPL--3.0-red?style=flat)

> [!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

```bash
# 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:**

```bash
# 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:**

```bash
# 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:

```bash
# 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:

1. **Fork** el proyecto.
2. Crea una rama para tu mejora (`git checkout -b feature/amazing-feature`).
3. Realiza tus cambios y asegúrate de que los tests pasen.
4. **Commit** tus cambios siguiendo el estándar [Conventional Commits](https://www.conventionalcommits.org/).
5. **Push** a la rama (`git push origin feature/amazing-feature`).
6. 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](https://github.com/devsebastian44)

> Proyecto desarrollado con fines educativos y de automatización de infraestructura,
> siguiendo principios DevSecOps para el despliegue seguro de plataformas self-hosted.

Nextcloud

Nextcloud 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Nextcloud

Nextcloud 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README