🧼 Porządki w nazwach plików na Linuksie z detox – małe narzędzie, które uratowało moje backupy

🌐 Także w: English · Deutsch · Français · Español · Italiano · Português · Nederlands
😤 Kiedy backup pada... przez nazwę pliku
Niedawno jeden z moich zautomatyzowanych backupów na Linuksie niespodziewanie wywalił się w połowie. Żadnego eleganckiego komunikatu o błędzie, żadnego zgrabnego fallbacku — po prostu ciche przerwanie.
Po porządnej dawce hardcore’owego grep i grzebania w logach znalazłem winowajcę: jeden jedyny plik z niezgodną nazwą, której narzędzie do backupu nie potrafiło przetworzyć. Co gorsza — plik pochodził z systemu macOS (MacBook Air). No jasne. 😅
Okazuje się, że macOS uwielbia dosypywać uroczych dziwactw Unicode, niewidocznych znaków i kreatywnie używać symboli specjalnych. Super dla ludzi, nie tak super dla linuksowych systemów plików czy narzędzi do backupu.
💾 Na scenę wchodzi rdiff-backup: moja ulubiona broń do wersjonowanych backupów
Do codziennych backupów używam rdiff-backup, bo obsługuje wersjonowane, przyrostowe kopie zapasowe — jak Time Machine, tylko bardziej nerdowsko i przyjaźnie dla CLI:
rdiff-backup /data /mnt/backup/data
Ale tu jest haczyk: rdiff-backup zakrztusił się tą zniekształconą nazwą pliku i się poddał. Żadnej przyrostowej magii, żadnego wersjonowania — tylko porażka.
Wniosek: czyść pliki zanim zrobisz ich backup. Dodałem więc krok przed backupem: detox.
🧼 Czym jest detox i dlaczego powinno cię to obchodzić?
detox to małe linuksowe narzędzie wiersza poleceń, które rekurencyjnie porządkuje bałaganiarskie nazwy plików, usuwając problematyczne znaki, takie jak:
- Spacje
- Umlauty (ä, ö, ü → ae, oe, ue)
- Szaleństwa Unicode
- Dziwne symbole i znaki sterujące
Idealne dla plików, które przyszły z... no cóż... skądkolwiek, co nie jest Linuksem.
🛠️ Instalacja
W większości dystrybucji to po prostu:
sudo apt install detox
🚀 Podstawowe użycie
Aby rekurencyjnie wyczyścić katalog:
detox -r /your/directory
🔧 Przykładowa magia przed/po
| Oryginalna nazwa pliku | Po czyszczeniu |
|---|---|
| Urlaubsfotos 2024 (Köln).jpg | Urlaubsfotos_2024_Koeln.jpg |
| Résumé_finalé.pdf | Resume_finale.pdf |
| Projekt 1#Beta!.zip | Projekt_1Beta.zip |
🧪 Polecane schematy
detox obsługuje różne „schematy” (schemes) określające, jak nazwy plików są czyszczone. U mnie najlepiej sprawdziło się to:
detox -r -s utf_8 -s iso8859_1 -v /data
utf_8: usuwa dziwaczne wielobajtowe rzeczy z Unicodeiso8859_1: transliteruje niemieckie/francuskie akcenty-v: pokazuje dokładnie, co jest zmieniane (gorąco polecam)
🔁 Teraz mój pipeline backupu wygląda tak
# Step 1: Clean up file names
detox -r -s utf_8 -s iso8859_1 -v /data
# Step 2: Run versioned backup
rdiff-backup /data /mnt/backup/data
Odkąd dorzuciłem detox do całości, moje przebiegi rdiff-backup idą gładko jak po maśle — nawet przy synchronizacji bałaganiarskich plików z macOS, pendrive’ów czy synchronizowanych folderów w chmurze.
🧙 Zautomatyzuj to jak nerd
Jeśli lubisz skrypty, oto przykład bez zbędnych ceregieli:
#!/bin/bash
SOURCE="/data"
TARGET="/mnt/backup/data"
# Clean first
detox -r -s utf_8 -s iso8859_1 -v "$SOURCE"
# Then backup with version history
rdiff-backup "$SOURCE" "$TARGET"
Wrzuć to do crona, systemd albo czegokolwiek, czym automatyzujesz. Przyszły ty ci podziękuje.
📚 Na koniec
Jeśli robisz backupy, synchronizujesz między systemami albo po prostu chcesz nazw plików, przez które twoje skrypty shellowe nie będą płakać, detox to obowiązkowa pozycja.
Jest mały, szybki, rekurencyjny i uratował mi tyłek. Szczególnie w połączeniu z rdiff-backup sprawia, że twój pipeline backupu jest dużo odporniejszy i bardziej deterministyczny.
I pamiętaj: garbage in, garbage out. Najpierw czyść, potem rób backup.
