Fil Backup Scanner - Dokumentation

📑 Innehållsförteckning

Översikt
Funktioner
Systemkrav
Installation
Använda Webb UI
Använda Kommandoraden
Konfiguration
Felsökning
Säkerhet
FAQ

🎯 Översikt

Fil Backup Scanner är ett kraftfullt verktyg för att automatiskt hitta och säkerhetskopiera nyligen modifierade filer på ditt system. Verktyget scannar alla tillgängliga lagringsenheter och skapar en organiserad ZIP-fil med alla matchade filer.

✨ Perfekt för:

Automatiska säkerhetskopior av utvecklingsprojekt
Snabb backup innan systemuppdateringar
Katastrofåterställning och versionshantering
Dokumentation av ändringar över tid

⭐ Funktioner

🔍 Smart Scanning

Scannar automatiskt alla tillgängliga enheter och partitioner på systemet.

📅 Tidsfiltrering

Hitta filer modifierade de senaste X dagarna (konfigurerbart).

📂 Filtypsfilter

Välj exakt vilka filändelser du vill inkludera i scanningen.

📦 ZIP-komprimering

Automatisk komprimering med bevarad katalogstruktur.

📋 Detaljerad Rapport

Genererar en komplett fillista med storlekar och modifieringsdatum.

🌐 Webb Interface

Användarvänligt PHP-baserat webb-UI för enkel åtkomst.

💻 Systemkrav

Backend (Python)

Python 3.6+ (rekommenderat: Python 3.8 eller senare)
Operativsystem: Windows, Linux, eller macOS
Diskutrymme: Tillräckligt för ZIP-filen (beroende på antal filer)
Behörigheter: Läsrättigheter för kataloger som ska scannas

Webb UI (PHP)

PHP 7.4+ (rekommenderat: PHP 8.0 eller senare)
Webbserver: Apache, Nginx, eller PHP:s inbyggda server
PHP-tilläggg: Standard (exec-funktionen måste vara aktiverad)

⚠️ Viktigt: PHP:s exec()-funktion måste vara aktiverad i php.ini. Kontrollera att den inte är listad under disable_functions.

🚀 Installation

Steg 1: Ladda ner filerna

Ladda ner alla nödvändiga filer till en katalog på din webbserver:

                
/var/www/backup-scanner/
├── backup_scanner.py
├── index.php
└── readme.html

Steg 2: Konfigurera behörigheter

På Linux/macOS, ge Python-skriptet exekveringsrättigheter:

chmod +x backup_scanner.py

Skapa och konfigurera backup-katalogen:

                
mkdir backups
chmod 755 backups

Steg 3: Testa Python-skriptet

Verifiera att Python-skriptet fungerar:

python3 backup_scanner.py -days 7 -output ./backups

Steg 4: Starta webbservern

Alternativ A - PHP inbyggd server (utveckling):

                
cd /var/www/backup-scanner
php -S localhost:8000

Alternativ B - Apache:

                
# Placera filerna i /var/www/html/backup-scanner/
# Öppna http://localhost/backup-scanner/

Alternativ C - Nginx:

Konfigurera en server block i Nginx och peka på katalogen.

✅ Klart! Öppna nu webbläsaren och gå till din installation (t.ex. http://localhost:8000 eller http://localhost/backup-scanner/)

🌐 Använda Webb UI

Steg-för-steg guide

Öppna webb-interfacet i din webbläsare
Välj antal dagar: Ange hur många dagar bakåt du vill scanna (1-365)
Välj filändelser: Markera de filtyper du vill inkludera i scanningen
Ange output-katalog: Där backup ZIP-filen ska sparas (standard: ./backups)
Klicka "Starta Scanning": Vänta medan systemet scannar
Ladda ner backup: När scanningen är klar, klicka på nedladdningslänken

💡 Tips: Scanning av hela systemet kan ta flera minuter beroende på antal filer och lagringsenheter. Var tålmodig!

Exempel på användning

Scenario	Dagar	Filändelser	Beskrivning
Daglig utveckling	1	.php, .js, .py	Backup av dagens kodändringar
Veckobackup	7	Alla	Fullständig veckobackup
Projektdokumentation	30	.md, .txt, .pdf	Backup av dokumentation
Konfigurationsfiler	14	.conf, .json, .xml	Systemkonfigurationer

⌨️ Använda Kommandoraden

Python-skriptet kan också köras direkt från kommandoraden:

Grundläggande syntax

python3 backup_scanner.py [OPTIONS]

Tillgängliga parametrar

Parameter	Beskrivning	Standard
`-days ANTAL`	Antal dagar bakåt att scanna	7
`-ext .EXT1 .EXT2`	Filändelser att inkludera	.php .py .txt .js .html .css .json .xml .md
`-output KATALOG`	Output-katalog för backup	Aktuell katalog

Exempel

Exempel 1: Scanna de senaste 7 dagarna (standard):

python3 backup_scanner.py

Exempel 2: Scanna de senaste 14 dagarna med specifika filändelser:

python3 backup_scanner.py -days 14 -ext .php .py .txt

Exempel 3: Spara backup i specifik katalog:

python3 backup_scanner.py -days 3 -output /backup/monthly

Exempel 4: Endast PHP-filer de senaste 24 timmarna:

python3 backup_scanner.py -days 1 -ext .php

⚙️ Konfiguration

Anpassa standardfiländelser

I backup_scanner.py, ändra rad ~16:

                
self.extensions = extensions or ['.php', '.py', '.txt', '.js', 
                                  '.html', '.css', '.json', '.xml', '.md']

Exkludera kataloger

I backup_scanner.py, ändra rad ~61:

                
dirs[:] = [d for d in dirs if not d.startswith('.') and 
          d not in ['node_modules', '__pycache__', 'venv', 'env',
                   'System Volume Information', '$RECYCLE.BIN',
                   'din_katalog_att_exkludera']]

Ändra standard output-katalog i Webb UI

I index.php, ändra rad ~235:

value="./backups"

🔧 Felsökning

Problem: "backup_scanner.py hittades inte"

Lösning: Kontrollera att backup_scanner.py och index.php ligger i samma katalog. Använd absolut sökväg om nödvändigt.

Problem: "exec() är inaktiverad"

Lösning:

Öppna php.ini
Hitta raden: disable_functions
Ta bort "exec" från listan
Starta om webbservern

Problem: "Permission denied"

Lösning:

Linux/macOS: chmod +x backup_scanner.py
Kontrollera att webbservern har läsrättigheter för katalogerna
Ge skrivrättigheter till output-katalogen: chmod 755 backups

Problem: "Python3 not found"

Lösning:

Installera Python 3: sudo apt install python3 (Linux)
På vissa system: använd python istället för python3
Ändra i index.php rad ~95: $cmd = "python " . escapeshellarg($scriptPath);

Problem: Scanning tar för lång tid

Tips för snabbare scanning:

Minska antal dagar (t.ex. 1-3 dagar istället för 30)
Välj färre filändelser
Lägg till fler kataloger i exkluderingslistan
Överväg att scanna specifika kataloger istället för hela systemet

🔒 Säkerhet

⚠️ Viktiga säkerhetsaspekter:

Webbåtkomst: Skydda Webb UI med .htaccess eller liknande autentisering
Filbehörigheter: Backup-filer kan innehålla känslig information
HTTPS: Använd alltid HTTPS i produktionsmiljö
Backup-lagring: Lagra backups på en säker plats
Automatisk rensning: Radera gamla backups regelbundet

Exempel på .htaccess-skydd

                
AuthType Basic
AuthName "Backup Scanner"
AuthUserFile /path/to/.htpasswd
Require valid-user

Skapa .htpasswd

htpasswd -c .htpasswd username

❓ Vanliga Frågor (FAQ)

Kan jag scanna specifika kataloger istället för hela systemet?

Just nu scannar verktyget alla tillgängliga enheter. För att scanna specifika kataloger, modifiera scan_all_drives()-funktionen i backup_scanner.py och anropa scan_directory() direkt med den önskade sökvägen.

Hur stora kan backup-filerna bli?

Storleken beror helt på antal och storlek på matchade filer. ZIP-komprimering reducerar vanligtvis storleken med 50-70% för textbaserade filer. Kontrollera diskutrymmet innan du skapar stora backups.

Kan jag schemalägga automatiska backups?

Ja! Använd cron (Linux/macOS) eller Task Scheduler (Windows):

                
# Cron exempel - daglig backup kl 02:00
0 2 * * * cd /path/to/backup-scanner && python3 backup_scanner.py -days 1 -output /backups/daily

Finns det någon storleksbegränsning för filer?

Nej, men mycket stora filer kan göra backup-processen långsam och ZIP-filen stor. Överväg att exkludera större binära filer om det behövs.

Påverkar verktyget systemets prestanda?

Under scanning används disk I/O, vilket kan påverka systemet. För stora system, kör backups under lågtrafiktimmar eller nätter.

Kan jag återställa filer från en backup?

Ja, packa upp ZIP-filen så återställs den ursprungliga katalogstrukturen under backup_files/-mappen.

📞 Support:

För ytterligare hjälp eller buggrapporter, kontakta din systemadministratör eller konsultera projektets dokumentation.

← Tillbaka till Backup Scanner

📚 Fil Backup Scanner

📑 Innehållsförteckning

🎯 Översikt

⭐ Funktioner

🔍 Smart Scanning

📅 Tidsfiltrering

📂 Filtypsfilter

📦 ZIP-komprimering

📋 Detaljerad Rapport

🌐 Webb Interface

💻 Systemkrav

Backend (Python)

Webb UI (PHP)

🚀 Installation

Steg 1: Ladda ner filerna

Steg 2: Konfigurera behörigheter

Steg 3: Testa Python-skriptet

Steg 4: Starta webbservern

🌐 Använda Webb UI

Steg-för-steg guide

Exempel på användning

⌨️ Använda Kommandoraden

Grundläggande syntax

Tillgängliga parametrar

Exempel

⚙️ Konfiguration

Anpassa standardfiländelser

Exkludera kataloger

Ändra standard output-katalog i Webb UI

🔧 Felsökning

Problem: "backup_scanner.py hittades inte"

Problem: "exec() är inaktiverad"

Problem: "Permission denied"

Problem: "Python3 not found"

Problem: Scanning tar för lång tid

🔒 Säkerhet

Exempel på .htaccess-skydd

Skapa .htpasswd

❓ Vanliga Frågor (FAQ)

Kan jag scanna specifika kataloger istället för hela systemet?

Hur stora kan backup-filerna bli?

Kan jag schemalägga automatiska backups?

Finns det någon storleksbegränsning för filer?

Påverkar verktyget systemets prestanda?

Kan jag återställa filer från en backup?

📦 Fil Backup Scanner v1.0