NexusGrab
NexusGrab - File Manager
## 🎯 Caratteristiche
- ✅ Interfaccia moderna e responsive (Bootstrap 5)
- ✅ Gestione file e cartelle con navigazione gerarchica
- ✅ Sistema di categorie per organizzare i file
- ✅ Pannello di amministrazione protetto
- ✅ Statistiche download in tempo reale
- ✅ Sistema di ricerca integrato
- ✅ **Nessun database richiesto** (usa JSON)
- ✅ Pagine legali complete (Privacy, Termini, Cookie Policy)
NexusGrab è un moderno file manager web sviluppato in PHP
che permette di gestire e condividere file in modo semplice ed efficiente.
## 📋 Requisiti
- **PHP 7.4 o superiore** (consigliato PHP 8.0+)
- **Server web** (Apache o Nginx)
- **Estensioni PHP:** fileinfo, json, session (solitamente già incluse)
- **Spazio su disco** per i file caricati
**⚠️ NOTA:** NexusGrab **NON richiede MySQL**. Usa un file JSON per i dati.
## 🚀 Installazione Rapida
1. **Carica i file** sul tuo server web
**Imposta i permessi:**
```bash
chmod 755 uploads
chmod 755 data
**Accedi al pannello admin:**
- URL: `http://tuodominio/download/admin/login.php`
- Username: `admin`
- Password: (quella configurata)
📁 Struttura del Progetto
```
download/
├── index.php # Homepage principale
├── browse.php # Esplorazione file
├── download.php # Sistema download
├── logout.php # Logout admin
├── admin/ # Pannello amministrazione
│ ├── index.php
│ └── login.php
├── config/ # Configurazione
│ └── config.php
├── includes/ # Componenti riutilizzabili
│ ├── header.php
│ ├── footer.php
│ ├── categories.php
│ └── recent_downloads.php
├── assets/ # Risorse statiche
│ └── css/
│ └── style.css
├── data/ # Dati sistema
│ └── files.json
└── uploads/ # File caricati
```
## 🔒 Sicurezza
- ✅ Cambia immediatamente la password admin dopo l'installazione
- ✅ Elimina i file di test/debug prima di mettere online
- ✅ Imposta permessi corretti (755 per cartelle, 644 per file)
- ✅ Usa HTTPS per proteggere le credenziali
- ✅ Fai backup regolari di `uploads/` e `data/files.json`
**Configura la password admin:**
- Esegui `fix_password.php` nel browser
- Oppure modifica `config/config.php` manualmente
## 📝 Note
- Il sistema usa **JSON invece di MySQL** per semplicità
- Adatto per fino a ~1000 file per buone performance
- Dimensione massima file: dipende da `php.ini` (default 2MB)
## 📄 Licenza
Questo progetto è rilasciato sotto licenza MIT.
🎯 Cos'è NexusGrab?
**NexusGrab** è un sistema di gestione file web che ti permette di:
- ✅ Caricare e organizzare file sul tuo server
- ✅ Condividere file con link pubblici
- ✅ Gestire file e cartelle tramite un'interfaccia web
- ✅ Monitorare statistiche di download
- ✅ Organizzare file in categorie/cartelle
**Non richiede database MySQL!** Tutti i dati sono salvati in un file JSON, rendendo l'installazione molto semplice.
---
## 📋 Requisiti di Sistema
Prima di installare, assicurati di avere:
### **Requisiti Minimi:**
- ✅ **PHP 7.4 o superiore** (consigliato PHP 8.0+)
- ✅ **Server web** (Apache o Nginx)
- ✅ **Spazio su disco** per i file che vuoi caricare
- ✅ **Permessi di scrittura** per alcune cartelle
### **Estensioni PHP Necessarie:**
- ✅ `fileinfo` - Per gestire i file
- ✅ `json` - Per salvare i dati (solitamente già inclusa)
- ✅ `session` - Per il login admin (solitamente già inclusa)
### **Come Verificare i Requisiti:**
Crea un file `test.php` nella root del progetto con questo contenuto:
```php
<?php
phpinfo();
?>
```
Apri `http://tuosito.com/test.php` e verifica che PHP sia installato.
---
## 🚀 Installazione Passo-Passo
### **STEP 1: Carica i File sul Server**
1. **Scarica o clona** tutti i file del progetto
2. **Carica** tutti i file nella cartella del tuo server web
- Esempio: `/public_html/download/` o `/var/www/html/download/`
- Puoi usare FTP, SFTP o il file manager del tuo hosting
### **STEP 2: Crea le Cartelle Necessarie**
Crea queste cartelle se non esistono già:
```
download/
├── uploads/ ← Cartella per i file caricati
├── data/ ← Cartella per i dati JSON
```
**Come crearle:**
- **Via FTP/File Manager:** Crea le cartelle manualmente
- **Via Terminale SSH:**
```bash
mkdir uploads
mkdir data
```
### **STEP 3: Imposta i Permessi**
Le cartelle devono essere **scrivibili** dal server:
**Via Terminale SSH:**
```bash
chmod 755 uploads
chmod 755 data
chmod 666 data/files.json # Se il file esiste già
```
**Via FTP/File Manager:**
- Clicca destro sulla cartella → Proprietà/Permessi
- Imposta: `755` per cartelle, `644` per file
### **STEP 4: Crea il File JSON dei Dati**
Crea il file `data/files.json` con questo contenuto iniziale:
```json
{
"files": [],
"categories": []
}
```
**Come crearlo:**
- Crea un file vuoto chiamato `files.json` nella cartella `data/`
- Incolla il contenuto JSON sopra
- Salva il file
### **STEP 5: Configura la Password Admin**
1. **Apri** il file `config/config.php`
2. **Trova** la riga con `ADMIN_PASSWORD`
3. **Genera un hash** per la tua password:
**Opzione A - Usa lo script automatico:**
- Apri nel browser: `http://tuosito.com/download/fix_password.php`
- Lo script genererà l'hash e aggiornerà automaticamente `config.php`
- **Elimina** `fix_password.php` dopo l'uso
**Opzione B - Genera manualmente:**
- Apri nel browser: `http://tuosito.com/download/generate_admin_password.php`
- Modifica la password nello script
- Copia l'hash generato
- Incollalo in `config/config.php` al posto di `ADMIN_PASSWORD`
### **STEP 6: Verifica l'Installazione**
1. **Apri** nel browser: `http://tuosito.com/download/`
2. Dovresti vedere la homepage con le cartelle
3. **Prova il login admin:**
- Vai a: `http://tuosito.com/download/admin/login.php`
- Username: `admin`
- Password: (quella che hai configurato)
---
## 🎓 Come Funziona NexusGrab
### **Architettura del Sistema**
```
┌─────────────────────────────────────────┐
│ INTERFACCIA UTENTE │
│ (index.php, browse.php, download.php) │
└──────────────┬──────────────────────────┘
│
┌──────────────▼──────────────────────────┐
│ CONFIGURAZIONE │
│ (config/config.php) │
│ - Percorsi cartelle │
│ - Credenziali admin │
│ - Funzioni utility │
└──────────────┬──────────────────────────┘
│
┌──────────────▼──────────────────────────┐
│ STORAGE DATI │
│ - uploads/ (file fisici) │
│ - data/files.json (metadati) │
└─────────────────────────────────────────┘
```
### **Flusso di Funzionamento**
#### **1. Visualizzazione File (index.php)**
```
Utente apre homepage
↓
PHP legge cartella uploads/
↓
Scansiona tutte le sottocartelle
↓
Legge metadati da data/files.json
↓
Mostra file e cartelle all'utente
```
#### **2. Download File (download.php)**
```
Utente clicca "Scarica"
↓
PHP verifica che il file esista
↓
Aggiorna contatore download in JSON
↓
Invia file al browser
```
#### **3. Upload File (admin/index.php)**
```
Admin seleziona file
↓
Sceglie cartella destinazione
↓
PHP salva file in uploads/cartella/
↓
Aggiunge metadati a data/files.json
↓
File disponibile per download
```
---
## 📖 Guida all'Uso
### **Per gli Utenti Finali**
#### **Navigare i File**
1. **Homepage (`index.php`):**
- Mostra tutte le cartelle principali
- Tabella con tutti i file
- Barra di ricerca per trovare file
2. **Esplora File (`browse.php`):**
- Naviga nelle cartelle
- Breadcrumb per orientarti
- Clicca su una cartella per aprirla
- Clicca su un file per scaricarlo
3. **Download:**
- Clicca il pulsante "Scarica" accanto al file
- Il file si scaricherà automaticamente
- Il contatore download viene aggiornato
### **Per gli Amministratori**
#### **Accesso al Pannello Admin**
1. Vai a: `http://tuosito.com/download/admin/login.php`
2. Inserisci:
- **Username:** `admin`
- **Password:** (quella configurata)
3. Clicca "Accedi"
#### **Caricare un File**
1. Nel pannello admin, vai alla sezione "Carica File"
2. Clicca "Scegli File" e seleziona il file dal tuo computer
3. Scegli la **cartella di destinazione** dal menu a tendina
4. Clicca "Carica"
5. Il file sarà disponibile nella cartella selezionata
#### **Creare una Cartella**
1. Nel pannello admin, vai alla sezione "Crea Cartella"
2. Inserisci il nome della cartella
3. (Opzionale) Scegli una cartella padre
4. Clicca "Crea"
5. La cartella sarà disponibile per organizzare i file
#### **Gestire File e Cartelle**
Nel pannello admin puoi:
- **Rinomina:** Clicca "Rinomina" e inserisci il nuovo nome
- **Elimina:** Clicca "Elimina" e conferma
- **Naviga:** Clicca su una cartella per aprirla
---
## ⚙️ Configurazione Avanzata
### **Modificare i Percorsi**
Apri `config/config.php`:
```php
// Cartella dove vengono salvati i file
define('UPLOAD_DIR', __DIR__ . '/../uploads/');
// File JSON con i metadati
define('DATA_FILE', __DIR__ . '/../data/files.json');
```
**Esempio:** Se vuoi salvare i file in un'altra posizione:
```php
define('UPLOAD_DIR', '/var/www/files/');
```
### **Cambiare Username Admin**
In `config/config.php`:
```php
define('ADMIN_USERNAME', 'tuo_username');
```
### **Cambiare Password Admin**
1. Usa `generate_admin_password.php` o `fix_password.php`
2. Oppure genera manualmente l'hash e sostituisci `ADMIN_PASSWORD`
### **Personalizzare lo Stile**
Modifica `assets/css/style.css` per cambiare:
- Colori del sito
- Font e dimensioni
- Layout e spaziature
---
## 🔒 Sicurezza
### **Raccomandazioni Importanti:**
1. **Cambia la password admin** subito dopo l'installazione
2. **Elimina i file di test/debug** prima di mettere online:
- `test_*.php`
- `debug_*.php`
- `fix_password.php`
- `generate_admin_password.php`
- `setup_password.php`
- `temp_hash_generator.php`
- `test_password.php`
3. **Imposta permessi corretti:**
- Cartelle: `755`
- File PHP: `644`
- File JSON: `644` o `666` (se necessario)
4. **Usa HTTPS** per proteggere le credenziali di login
5. **Backup regolari:**
- Cartella `uploads/` (i tuoi file)
- File `data/files.json` (metadati)
---
## 🐛 Risoluzione Problemi
### **Problema: "File non trovato"**
**Soluzione:**
- Verifica che la cartella `uploads/` esista
- Controlla i permessi della cartella (deve essere `755` o `777`)
### **Problema: "Non posso caricare file"**
**Soluzione:**
- Verifica i permessi della cartella `uploads/` (deve essere scrivibile)
- Controlla `php.ini` per `upload_max_filesize` e `post_max_size`
### **Problema: "Errore login admin"**
**Soluzione:**
- Verifica che l'hash in `config/config.php` sia corretto
- Usa `test_password.php` per verificare la password
- Assicurati che `password_verify()` funzioni (PHP 5.5+)
### **Problema: "Pagina bianca"**
**Soluzione:**
- Attiva gli errori PHP temporaneamente:
```php
error_reporting(E_ALL);
ini_set('display_errors', 1);
```
- Controlla i log del server
- Verifica che tutti i file siano caricati correttamente
### **Problema: "CSS non si carica"**
**Soluzione:**
- Verifica che `assets/css/style.css` esista
- Controlla i permessi del file (deve essere leggibile)
- Verifica il percorso nel browser (Console → Network)
---
## 📁 Struttura File Essenziali
```
download/
├── index.php ← Homepage principale
├── browse.php ← Esplorazione file
├── download.php ← Sistema download
├── logout.php ← Logout admin
├── info.php ← Pagina informazioni
├── privacy-policy.php ← Privacy Policy
├── termini-servizio.php ← Termini di Servizio
├── cookie-policy.php ← Cookie Policy
│
├── admin/
│ ├── index.php ← Pannello admin
│ └── login.php ← Login admin
│
├── config/
│ └── config.php ← Configurazione sistema
│
├── includes/
│ ├── header.php ← Header comune
│ ├── footer.php ← Footer comune
│ ├── categories.php ← Gestione categorie
│ └── recent_downloads.php ← Download recenti
│
├── assets/
│ └── css/
│ └── style.css ← Stili CSS
│
├── data/
│ └── files.json ← Database JSON
│
└── uploads/ ← File caricati
├── Cartella1/
├── Cartella2/
└── ...
```
---
## 🎯 Funzionalità Principali
### **1. Gestione File**
- ✅ Upload file tramite pannello admin
- ✅ Download file pubblici
- ✅ Organizzazione in cartelle
- ✅ Rinomina ed elimina file
### **2. Statistiche**
- ✅ Contatore download per ogni file
- ✅ Visualizzazione file totali
- ✅ Visualizzazione cartelle totali
### **3. Ricerca**
- ✅ Ricerca file per nome
- ✅ Filtro in tempo reale
- ✅ Ricerca in tutte le cartelle
### **4. Navigazione**
- ✅ Breadcrumb per orientamento
- ✅ Navigazione gerarchica
- ✅ Icone per tipo di file
### **5. Sicurezza**
- ✅ Login admin protetto
- ✅ Session management
- ✅ Validazione percorsi file
---
## 📝 Note Importanti
### **Sistema Basato su JSON**
NexusGrab **NON usa MySQL**. Tutti i dati sono salvati in `data/files.json`:
- Lista file caricati
- Categorie
- Contatori download
- Date di upload
**Vantaggi:**
- ✅ Installazione semplice (no database)
- ✅ Backup facile (copia un file)
- ✅ Portabile
**Svantaggi:**
- ⚠️ Non adatto per milioni di file
- ⚠️ Performance con migliaia di file
### **Limitazioni**
- Massimo dimensione file: dipende da `php.ini` (default 2MB)
- Numero file consigliato: fino a ~1000 file per buone performance
- Non supporta upload multipli simultanei
---
## 🆘 Supporto
### **File di Aiuto nel Progetto:**
- `README.md` - Documentazione base
- `REPORT_ERRORI_E_FILE_NECESSARI.md` - Lista file essenziali
- `analisi_completa_nexusgrab.md` - Analisi tecnica dettagliata
### **Controlli Pre-Installazione:**
Prima di mettere online, verifica:
- [ ] Password admin cambiata
- [ ] File di test/debug eliminati
- [ ] Permessi cartelle corretti
- [ ] File JSON creato e scrivibile
- [ ] HTTPS configurato (raccomandato)
- [ ] Backup configurato
---
## 🎉 Congratulazioni!
Ora hai installato e configurato NexusGrab!
**Prossimi Passi:**
1. Carica i tuoi primi file tramite il pannello admin
2. Organizza i file in cartelle
3. Condividi i link con gli utenti
4. Monitora le statistiche di download
**Buon utilizzo! 🚀**