Der vom Kunden hochgeladene Dateiname kann nicht direkt als Speicherpfad verwendet werden: um Pfaddurchquerung und doppelte Namensabdeckung zu verhindern

Die hochgeladene Datei heißt `../../report.pdf`, was nicht bedeutet, dass der Server sie unter diesem Namen speichern soll. Der Dateiname stammt vom Benutzer und gehört zu den Eingabedaten; Der Festplattenpfad gehört zur Systemberechtigungsgrenze. Eine Verwechslung der beiden kann leicht zu Problemen wie Pfaddurchquerung, doppelter Namensabdeckung und unterschiedlichem Verhalten zwischen Windows und Linux führen.

Nur weil die hochgeladene Datei den Namen ../../report.pdf trägt, heißt das nicht, dass der Server sie unter diesem Namen speichern sollte. Entwickler, die serverseitige Upload-Funktionen schreiben, sowie Teams, die sich mit Benutzerdateien befassen und sich um Pfaddurchquerung und doppelte Namensabdeckung kümmern müssen, werden auf dieses Problem stoßen. Nachdem Sie diesen Artikel gelesen haben, können Sie zwischen Anzeigenamen und Speichernamen unterscheiden, wissen, welche Prüfungen auf jeder Ebene durchgeführt werden sollten, und Ihre eigene Implementierung anhand der Akzeptanzpunkte überprüfen.

Der Dateiname stammt vom Benutzer und gehört zu den Eingabedaten; Der Festplattenpfad gehört zur Systemberechtigungsgrenze. Eine Verwechslung der beiden kann leicht zu Problemen wie Pfaddurchquerung, doppelter Namensabdeckung und unterschiedlichem Verhalten zwischen Windows und Linux führen.

In diesem Artikel werden synthetische Proben verwendet, um die Verarbeitungsmethode zu demonstrieren. Der Code wurde in einer isolierten Umgebung stichprobenartig überprüft und stellt keine Garantie für alle echten Dateien oder die Produktleistung dar. Bevor Sie wichtige Dokumente bearbeiten, bewahren Sie bitte die Originale auf und überprüfen Sie sie anhand der Grenzen und Akzeptanzpunkte im Text.

Kann der hochgeladene Dateiname direkt als Speicherpfad verwendet werden? Fazit in einem Satz

Es kann nicht direkt verwendet werden. Der Anzeigename wird für die Schnittstellenanzeige verwendet und der Speicherpfad wird vom Server basierend auf der internen ID generiert.

Ihre SituationEmpfohlene PraktikenGrund
Der ursprüngliche Dateiname des Benutzers muss auf der Benutzeroberfläche angezeigt werdenAnzeigename nur zur Anzeige reserviertAnzeigename vom Festplattenpfad getrennt, um Pfadkreuzungen zu vermeiden
Hochgeladene Dateien müssen gespeichert werdenDer Server generiert eine interne ID und verbindet den SpeicherpfadVermeiden Sie das Überschreiben mit doppelten Namen und lassen Sie sich nicht durch Benutzereingaben beeinträchtigen
Die Dateierweiterung muss an der Speicherung teilnehmenÜbernehmen Sie das Suffix aus der Liste der zulässigen ServerKopieren Sie keine von Benutzern bereitgestellten Erweiterungen
Der wahre Typ der Datei muss ermittelt werdenFühren Sie eine Inhaltserkennung und -analyse durchErweiterungen können gefälscht sein

Anzeigename und Speichername sind getrennt

Der ursprüngliche Name bleibt für die Schnittstellenanzeige erhalten, die interne Identifikation wird jedoch vom Server generiert. Das Speichersuffix sollte ebenfalls aus der serverseitigen Zulassungsliste stammen und nicht die vom Benutzer angegebene Erweiterung kopieren.

Das folgende Beispiel erstellt nur einen Pfad und erstellt kein Verzeichnis oder keine Datei.

Minimaler Pfadkonstruktor

from pathlib import Path
import re

def storage_path(root, internal_id, extension):
    if not re.fullmatch(r"[a-f0-9]{32}", internal_id):
        raise ValueError("invalid internal id")
    if extension not in {".pdf", ".docx", ".udoc"}:
        raise ValueError("unsupported extension")
    base = Path(root).resolve()
    candidate = (base / (internal_id + extension)).resolve()
    if candidate.parent != base:
        raise ValueError("outside storage root")
    return candidate

root = Path.cwd() / "synthetic-uploads"
identifier = "a" * 32
p = storage_path(root, identifier, ".pdf")
assert p.parent == root.resolve()
assert p.name == identifier + ".pdf"
for bad in ["../../report", "A" * 32, "a" * 31, "a" * 32 + "/x"]:
    try:
        storage_path(root, bad, ".pdf")
    except ValueError:
        pass
    else:
        raise AssertionError(bad)

In diesem Beispiel wird davon ausgegangen, dass die interne ID vom Server generiert wurde. Es handelt sich nicht um eine sichere Schreibdateiimplementierung für Umgebungen mit beliebigen Festplattenangriffen:

  • Es kann immer noch zu einem Wettlauf zwischen Kontrolle und tatsächlicher Öffnung kommen.
  • Berechtigungen für übergeordnete Verzeichnisse und Richtlinien für symbolische Links müssen separat gesteuert werden.

– Eine eindeutige ID bedeutet auch nicht, dass die „No Override"-Richtlinie ignoriert werden kann.

Dateinamensreinigung ist keine Dateiauthentifizierung

Die Dateinamen-Bereinigung kann nur einen Teil des Problems lösen; verschiedene Phänomene müssen auf verschiedenen Ebenen behandelt werden:

EingabephänomenAuf welcher Ebene sollte es behandelt werden?Schwächen
Enthält WegtrennerNicht als Speicherpfad verwendetNur das Entfernen der diagonalen Linie reicht nicht aus
Die Dateiendung ist PDFInhaltserkennung und -analyseErweiterungen können gefälscht werden
Anzeigename, der HTML enthältInterface-Ausgang entweichtDu kannst es nicht lösen, indem du den Namen der Festplatte änderst
Gleicher AnzeigenameInterne ID-IsolierungEs sollte den vorherigen Upload nicht überschreiben

📊 Kernvergleich

MethodeWas kann gelöst werden?Schwächen
Verwenden Sie direkt den Dateinamen des BenutzersDie Implementierung ist am einfachstenPfaddurchquerung und Überschreiben von doppelten Namen können auftreten
Entfernen Sie nur den WegtrennerEinen Teil der Eingabe verarbeitetNur das Entfernen der diagonalen Linie reicht nicht aus
Bestimmen Sie den Typ anhand der VerlängerungVorläufige Unterscheidung der DokumenteErweiterungen können gefälscht werden und müssen mit der Inhaltserkennung koordiniert werden
Der Server generiert interne IDsIsoliere doppelte Dateien, deren Pfade vom System gesteuert werdenEs erfordert weiterhin die Zusammenarbeit mit der "No Override"-Richtlinie und der Verzeichnisberechtigungskontrolle

Objektspeicherung hat dieselben Grenzen

R2 oder andere Objekte speichern alle Semantiken ohne traditionelle Verzeichnisdurchlauf, aber Objektschlüssel beeinflussen weiterhin die Isolation, das Überschreiben und die Offenlegung von URLs.

  • Buchstabieren Sie den vom tenant bereitgestellten String nicht direkt in ein gemeinsames Präfix.
  • Der Downloader kann die Autorisierung nicht ausschließlich anhand von Schlüsselnamen ableiten.

Dokumente sollten eine Identität haben, bevor sie in die Übersetzung aufgenommen werden

Beim Zugriff auf den OmniDoc (Produkteinführung)-Workflow können Benutzer weiterhin vertraute Dateinamen sehen, intern mit unabhängigen Task-IDs und Datei-IDs.

Eindeutige Dokumentidentitäten bringen folgende Vorteile mit sich:

  • Beim Scheitern und erneuten Versuchen kann es der ursprünglichen Aufgabe genau entsprechen.
  • Übersetzung, Download und anschließendes Korrekturlesen stellen sicher, dass die korrekte Datei abgestimmt wird.
  • Verringert das Risiko, dass die Datei eines anderen mit demselben Namen wie das aktuelle Ergebnis verwechselt wird.

🎯 Welche Methode passt zu dir?

Wenn du den Dateinamen anzeigen musst

Der ursprüngliche Anzeigename des Benutzers wird beibehalten, jedoch nur für die Schnittstelle, nicht für den Festplattenpfad.

Wenn du Dateien speichern und hochladen musst

Der Server erzeugt die interne ID, nimmt die Erweiterung aus der Zulassungsliste und steuert die Abdeckung sowie Verzeichnisberechtigungen gemäß den tatsächlichen Richtlinien.

Wenn du Objektspeicher verwendest

Buchstabieren Sie Tenant-Strings nicht direkt mit dem Präfix 'share' und treffen Sie beim Herunterladen separate Autorisierungsentscheidungen.

❓ Häufig gestellte Fragen (FAQ)

1. Wenn du die diagonalen Linien entfernst, wird der Dateiname dann sicher?

Nicht genug. Das Entfernen nur der Schrägstrichstriche verarbeitet nur einen Teil der Eingabe; Pfadbau, Übersteuerung und Dateitypbestimmung müssen weiterhin getrennt behandelt werden.

2. Wenn die Dateiendung PDF ist, kann man sie dann als PDF bestätigen?

Nein. Erweiterungen können gefälscht werden, die Inhaltserkennung und -parsing erfordern.

3. Was soll ich tun, wenn der Anzeigename HTML enthält?

Escape während der Schnittstellenausgabe kann nicht durch Änderung des Dateinamens auf der Festplatte gelöst werden.

4. Muss ich nach der Verwendung einer eindeutigen ID das Überschreiben trotzdem deaktivieren?

Ja. Eine eindeutige ID bedeutet nicht, dass Sie die "Keine Überschreibung"-Regelung ignorieren können.

📝 Zusammenfassung

Der Dateiname des Uploads sollte getrennt vom Speicherpfad behandelt werden: Der Anzeigename wird für die Anzeige verwendet, und der Speicherpfad wird vom Server basierend auf der internen ID generiert. Wege, Abdeckungen, Arten und Genehmigungen müssen separat überprüft werden.

Erleben Sie jetzt: Laden Sie Ihr Dokument hoch, um mit der Übersetzung zu beginnen, wobei Sie die ursprüngliche Formatierung bewahren

Quellen: Python pathlib

Aktualisiert am 2026-11-15