|
| 1 | +--- |
| 2 | +sidebar_position: 11 |
| 3 | +id: file-names |
| 4 | +title: Dateinamensbeschränkungen im OpenCloud Desktop-Client |
| 5 | +description: Dateinamensbeschränkungen im OpenCloud Desktop-Client |
| 6 | +draft: false |
| 7 | +--- |
| 8 | + |
| 9 | +# Dateinamensbeschränkungen im OpenCloud Desktop-Client |
| 10 | + |
| 11 | +Bei der Verwendung des OpenCloud Desktop-Clients müssen Datei- und Ordnernamen bestimmte Anforderungen des Betriebssystems (OS) erfüllen, um eine reibungslose Synchronisierung zwischen verschiedenen Plattformen zu gewährleisten. |
| 12 | +Diese Einschränkungen werden nicht von OpenCloud erzwungen, sondern stammen aus systembedingten Beschränkungen. |
| 13 | + |
| 14 | +## Wichtige Richtlinien |
| 15 | + |
| 16 | +- Verwenden Sie keine verbotenen Zeichen oder reservierten Namen in Dateinamen – unabhängig vom Betriebssystem. |
| 17 | +- Wenn Sie von Linux/macOS zu einer Windows-basierten Freigabe synchronisieren, stellen Sie sicher, dass die Dateinamen mit den Windows-Benennungsregeln kompatibel sind. |
| 18 | +- Um unter Linux/macOS beim Synchronisieren mit Windows nur die Groß-/Kleinschreibung zu ändern (z. B. `File.txt` → `file.txt`), benennen Sie die Datei zunächst in einen komplett neuen Namen um, lassen Sie sie synchronisieren und benennen Sie sie danach in den gewünschten Namen um. |
| 19 | + |
| 20 | +## Häufige Einschränkungen |
| 21 | + |
| 22 | +### a. Maximale Pfadlänge |
| 23 | + |
| 24 | +Windows begrenzt Dateipfade standardmäßig auf 260 Zeichen. |
| 25 | +Wenn Ihr Synchronisierungs-Stammverzeichnis diesen Wert überschreitet, zeigt der Desktop-Client folgende Warnung an: |
| 26 | +„The path 'YOUR.LONG.PATH' is too long. Please enable long paths in the Windows settings or choose a different folder.“ |
| 27 | + |
| 28 | +Unter Windows 10 und neuer kann diese Beschränkung aufgehoben werden, indem "Long Paths" aktiviert werden. Siehe [Microsoft-Dokumentation](https://learn.microsoft.com/de-de/windows/win32/fileio/maximum-file-path-limitation?tabs=registry#enable-long-paths-in-windows-10-version-1607-and-later). |
| 29 | + |
| 30 | +### b. Verbotene Zeichen |
| 31 | + |
| 32 | +| Betriebssystem | Verbotene Zeichen | |
| 33 | +| -------------- | ------------------------------- | ------------ | |
| 34 | +| Windows | `<`, `>`, `:`, `"`, `/`, `\`, ` | `, `?`, `\*` | |
| 35 | + |
| 36 | +### c. Nicht druckbare ASCII-Zeichen |
| 37 | + |
| 38 | +- Linux/macOS: NUL (Zeichencode 0) |
| 39 | +- Windows: ASCII 0 – 31 |
| 40 | + |
| 41 | +Auch wenn diese Zeichen auf manchen Systemen gültig sind, führen sie häufig zu Problemen bei der Synchronisierung. |
| 42 | + |
| 43 | +### d. Reservierte Dateinamen (Windows) |
| 44 | + |
| 45 | +Vermeiden Sie die Verwendung folgender Dateinamen: |
| 46 | +`CON`, `PRN`, `AUX`, `NUL`, `COM1` – `COM9`, `LPT1` – `LPT9` |
| 47 | + |
| 48 | +### e. Besondere Regeln |
| 49 | + |
| 50 | +- Unter Linux/macOS beim Synchronisieren zu SMB können Dateinamen, die sich nur in der Groß-/Kleinschreibung unterscheiden, zu Konflikten führen – benennen Sie Dateien eindeutig, um Fehler zu vermeiden. |
| 51 | +- Unter Windows dürfen Dateinamen nicht mit einem Leerzeichen oder Punkt (`.`) enden. |
| 52 | + |
| 53 | +## Beispiel |
| 54 | + |
| 55 | +Das Erstellen einer Datei mit dem Namen `example.` oder `example.LPT1` unter macOS kann zwar erfolgreich mit OpenCloud synchronisiert werden. |
| 56 | +Beim Zugriff über einen Windows-Client werden diese Dateien jedoch möglicherweise abgelehnt, da sie gegen reservierte Namens- oder Formatregeln verstoßen, was zu inkonsistentem Synchronisierungsverhalten zwischen Geräten führt. |
| 57 | + |
| 58 | +## Zusammenfassung |
| 59 | + |
| 60 | +| Einschränkungstyp | Maßnahme | |
| 61 | +| ------------------------- | ------------------------------------------------------ | |
| 62 | +| Pfadlänge | Pfade unter ~260 Zeichen halten (außer bei Long Paths) | |
| 63 | +| Verbotene Zeichen | Nicht erlaubte Zeichen aus Namen entfernen | |
| 64 | +| Steuerzeichen | Nicht druckbare ASCII-Zeichen vermeiden | |
| 65 | +| Reservierte Dateinamen | Keine Windows-reservierten Namen verwenden | |
| 66 | +| Nur Groß-/Kleinschreibung | Vorher temporär umbenennen, dann synchronisieren | |
| 67 | +| Endzeichen | Keine Dateinamen mit Leerzeichen oder Punkt beenden | |
0 commit comments