Så upptäcker du skiftlägeskänsliga filnamnskrockar innan du kopierar mellan plattformar

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

Identifiera skiftlägeskänsliga filnamnskollisioner genom att inventera varje relativ sökväg, normalisera varje sökväg enligt målets jämförelseregler och gruppera sökvägar som ger samma normaliserade nyckel. Lös alla grupper innan du kopierar data.

Den här förhandskontrollen är viktig när du flyttar från en skiftlägeskänslig Linux-resurs till Windows, standardvolymer i macOS eller skiftlägesokänsliga SMB-namnrymder. En vanlig filräkning avslöjar inte att två giltiga källnamn konkurrerar om ett och samma målnamn.

Vad räknas som en filnamnskollision?

En kollision uppstår när skilda källsökvägar behandlas som samma sökväg av målet. En praktisk påminnelse om skillnader i skiftlägeskänslighet mellan plattformar visar varför Report.pdf och report.pdf kan bete sig olika, men jämförelsen måste omfatta varje katalogkomponent.

Plattformsöverskridande konflikter kan också omfatta Unicode-normalisering, avslutande blanksteg eller punkter, reserverade enhetsnamn och tecken som vissa mål inte tillåter. Orsakerna till filnamnsändringar mellan macOS och Linux hör hemma i samma kompatibilitetsgranskning av sökvägar.

Definiera målet innan du skannar. En kopiering till en ext4-, NTFS- eller SMB-baserad datamängd kan ge olika namnbehandling. Detta hänger ihop med varför SMB-beteendet skiljer sig mellan klienter.

Vilka kollisionstyper bör förhandskontrollen rapportera?

Dela upp kollisionerna i separata kategorier så att åtgärderna blir förutsägbara. Ett par som bara skiljer sig åt i skiftläge kan vanligtvis döpas om, medan ett reserverat Windows-namn kan kräva både namnbyte och en uppdatering av programreferensen.

Kollisionstyp Exempel Varför kopiering är osäker
Enbart skiftläge Photo.jpg och photo.jpg Skiftlägesokänsligt mål ser ett namn
Skiftläge i katalognamn Client/A och client/A Hela underträd kan slås samman
Unicode-normalisering Visuellt identiska sammansatta och dekomponerade namn macOS och nätverkslager kan normalisera på olika sätt
Borttagna tecken notes och notes. Vissa Windows-sökvägar ignorerar avslutande punkter eller blanksteg
Reserverat namn CON.txt Mål-API:t kan vägra att skapa

Rapporten bör bevara sökvägen på byte-nivå och visa en läsbar version. Annars kan Unicode-namn som ser identiska ut uppfattas som en enda duplicerad rad i stället för två separata källposter.

Hur skapar du en tillförlitlig källinventering?

Kör inventeringen på källfilsystemet eller via samma protokoll som används för migreringen. Exportera relativa sökvägar i ett format som hanterar blanksteg, tabbar, radbrytningar och tecken som inte är ASCII på ett säkert sätt.

Ta med kataloger, eftersom två katalognamn som kolliderar kan dölja tusentals berörda filer. Registrera objekttyp, storlek, ändringstid och en stabil identifierare om sådan finns, så att omdöpta objekt går att spåra.

Frys skrivningar eller ta en ögonblicksbild före den slutliga genomsökningen. Om namn ändras mellan inventeringen och kopieringen kan en felfri förhandskontroll vara inaktuell när migreringen börjar.

Hur bör sökvägar normaliseras för jämförelse?

Börja med målets regler för skiftlägeshantering. Jämför en nyckel med gemener eller skiftlägesnormaliserad nyckel, men behåll den ursprungliga sökvägen i rapporten. Byt inte automatiskt namn på källan i det här steget.

Lägg sedan till målspecifika regler: Unicode-normalisering, hantering av avgränsare, otillåtna tecken, borttagna avslutande tecken, sökvägslängdsgränser och reserverade namn. En mer aggressiv normalisering än vad målet använder kan ge falska positiva träffar, medan en mindre aggressiv normalisering kan missa destruktiva kollisioner.

Normalisera varje sökvägskomponent. Två filer med olika basnamn kan ändå kollidera om deras överordnade kataloger normaliseras till samma sökväg.

Vad kan du köra på Linux, macOS eller Windows?

I Linux eller macOS kan ett skript läsa nullavgränsade sökvägar, beräkna en målnyckel, sortera efter den nyckeln och rapportera grupper med fler än en ursprunglig sökväg. Publicerade metoder för att hitta filnamn som är duplicerade oavsett skiftläge visar grupperingslogiken, men arkiv med flera språk kräver explicit Unicode-hantering.

find /source -print0 | python3 collision_scan.py --target windows

I Windows kan PowerShell räkna upp relativa sökvägar och gruppera dem med en skiftlägesokänslig ordinaljämförare. Kör det mot källresursen med ett konto som har åtkomst till alla avsedda kataloger.

Get-ChildItem -LiteralPath '\\NAS\Source' -Recurse -Force |
  ForEach-Object { $_.FullName.Substring($root.Length).ToLowerInvariant() } |
  Group-Object | Where-Object Count -gt 1

De här exemplen illustrerar grupperingsmodellen, inte en universell skanner. Produktionskontroller måste bevara originalen, hantera otillgängliga sökvägar och tillämpa målets fullständiga namnregler.

Hur bör du lösa kollisionsgrupper?

Välj ett kanoniskt namn tillsammans med dataägaren och byt sedan namn på de andra sökvägarna med ett deterministiskt suffix, till exempel en projektkod, ett datum eller en tagg för källsystemet. Konsekventa namnregler för hemmaservrar hjälper till att undvika godtyckliga suffix.

  1. Exportera kollisionsgruppen och ansvarig avdelning eller applikation.
  2. Välj sökvägen som behåller den kanoniska stavningen.
  3. Byt namn på de motstridiga sökvägarna i källan eller i en mellanlagrad kopia.
  4. Uppdatera spellistor, databaser, genvägar, skript och manifest som hänvisar till dem.
  5. Kör hela genomsökningen igen tills inga blockerande grupper återstår.

Låt inte kopieringsverktyget tyst avgöra saken utifrån överskrivningsordningen. Även om båda filerna har identiskt innehåll förstör en tyst sammanslagning av namn bevis för den ursprungliga namnrymden.

Hur verifierar du att kopieringen inte slog ihop sökvägar?

Skapa ett manifest före kopieringen efter korrigeringarna och generera ett destinationsmanifest med samma regler för relativa sökvägar. Jämför normaliserade sökvägsuppsättningar, objektantal, storlekar och innehållshashar för viktiga filer.

Granska kopieringsloggarna efter händelser som ”finns redan”, namnändring, överhoppning, ogiltigt namn och överskrivning. Verktyget kan fortfarande hoppa över sökvägar trots att det avslutas med felkod 0.

Håll källan skrivskyddad tills användarna har validerat programmets beteende. Namnrymdskompatibilitet omfattar länkar och referenser, inte bara förekomsten av fildata.

Vanliga frågor

Kan två filnamn som bara skiljer sig åt i skiftläge finnas i Linux?

Vanligtvis ja på vanliga skiftlägeskänsliga Linux-filsystem. De kan kollidera när de kopieras till en skiftlägesokänslig destination eller visas via en tjänst med annan konfiguration.

Är det en säker lösning att konvertera alla filnamn till gemener?

Nej. Masskonvertering till gemener kan skapa nya kollisioner och bryta referenser. Upptäck grupperna först och gör sedan granskade, deterministiska namnändringar.

Upptäcker kontrollsummor filnamnskollisioner?

Kontrollsummor jämför innehåll, inte namnrymdsidentitet. Två olika sökvägar kan ha samma eller olika innehåll och ändå konkurrera om samma destinationsnamn.

En säker kopiering mellan plattformar bevisar att varje källsökväg motsvarar en enda giltig målsökväg. Gör den kontrollen före överföringen i stället för att upptäcka kollisioner genom överskrivna filer.

Support och tips

Mer att läsa

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.