130 lines
2.8 KiB
Markdown
130 lines
2.8 KiB
Markdown
# CameraSave Docker Container
|
|
|
|
Ein Python-Skript, das automatisch Video-Anhänge aus E-Mails herunterlädt und in einer strukturierten Ordnerhierarchie speichert.
|
|
|
|
## 🚀 Schnellstart mit Docker
|
|
|
|
### 1. Repository klonen/vorbereiten
|
|
```bash
|
|
cd /Users/rxf/Projekte/CameraSave
|
|
```
|
|
|
|
### 2. Umgebungsvariablen konfigurieren
|
|
```bash
|
|
# Die .env Datei ist bereits erstellt - passe sie an deine Zugangsdaten an
|
|
nano .env
|
|
# oder
|
|
code .env
|
|
```
|
|
|
|
**Wichtig**: Bearbeite die `.env` Datei und trage deine echten E-Mail-Zugangsdaten ein!
|
|
|
|
### 3. Container mit Docker Compose starten
|
|
```bash
|
|
docker-compose up -d
|
|
```
|
|
|
|
### 4. Logs überprüfen
|
|
```bash
|
|
docker-compose logs -f camerasave
|
|
```
|
|
|
|
## 🐋 Manuelle Docker-Befehle
|
|
|
|
### Image erstellen
|
|
```bash
|
|
docker build -t camerasave .
|
|
```
|
|
|
|
### Container ausführen
|
|
```bash
|
|
docker run -d \
|
|
--name camerasave \
|
|
-v $(pwd)/videospeicher:/app/videospeicher \
|
|
-e EMAIL_USER="deine-email@domain.de" \
|
|
-e EMAIL_PASS="dein-passwort" \
|
|
camerasave
|
|
```
|
|
|
|
### Einmalige Ausführung
|
|
```bash
|
|
docker run --rm \
|
|
-v $(pwd)/videospeicher:/app/videospeicher \
|
|
-e EMAIL_USER="deine-email@domain.de" \
|
|
-e EMAIL_PASS="dein-passwort" \
|
|
camerasave
|
|
```
|
|
|
|
## 📁 Ordnerstruktur
|
|
|
|
Das Skript erstellt automatisch folgende Struktur:
|
|
```
|
|
videospeicher/
|
|
├── 2025/
|
|
│ ├── 01/
|
|
│ │ ├── 15/
|
|
│ │ │ ├── 01_20250115123456000.mp4
|
|
│ │ │ └── ...
|
|
│ │ └── ...
|
|
│ └── ...
|
|
└── ...
|
|
```
|
|
|
|
## ⚙️ Konfiguration
|
|
|
|
### Umgebungsvariablen
|
|
- `IMAP_SERVER`: IMAP-Server (Standard: secureimap.t-online.de)
|
|
- `IMAP_PORT`: IMAP-Port (Standard: 993)
|
|
- `EMAIL_USER`: E-Mail-Adresse
|
|
- `EMAIL_PASS`: E-Mail-Passwort (empfohlen: App-spezifisches Passwort)
|
|
- `SAVE_DIR`: Speicherverzeichnis (Standard: /app/videospeicher)
|
|
|
|
### Automatische Bereinigung
|
|
- Dateien älter als 365 Tage werden automatisch gelöscht
|
|
- Leere Ordner werden entfernt
|
|
|
|
## 🔒 Sicherheitshinweise
|
|
|
|
1. **App-spezifische Passwörter verwenden**: Erstelle ein App-spezifisches Passwort für dein E-Mail-Konto
|
|
2. **Umgebungsvariablen nutzen**: Speichere Zugangsdaten nicht im Code
|
|
3. **Volume-Backups**: Sichere regelmäßig das `videospeicher` Volume
|
|
|
|
## 🛠 Wartung
|
|
|
|
### Container neustarten
|
|
```bash
|
|
docker-compose restart
|
|
```
|
|
|
|
### Container stoppen
|
|
```bash
|
|
docker-compose down
|
|
```
|
|
|
|
### Logs anzeigen
|
|
```bash
|
|
docker-compose logs camerasave
|
|
```
|
|
|
|
### Container-Status prüfen
|
|
```bash
|
|
docker-compose ps
|
|
```
|
|
|
|
## 🐛 Troubleshooting
|
|
|
|
### E-Mail-Verbindungsfehler
|
|
- Überprüfe IMAP-Server und Port
|
|
- Stelle sicher, dass IMAP aktiviert ist
|
|
- Verwende App-spezifische Passwörter
|
|
|
|
### Berechtigung-Fehler
|
|
```bash
|
|
# Berechtigungen für videospeicher-Ordner setzen
|
|
sudo chown -R $(id -u):$(id -g) videospeicher/
|
|
```
|
|
|
|
### Container-Logs überprüfen
|
|
```bash
|
|
docker logs camerasave
|
|
``` |