2026-03-30 10:01:17 +02:00
<!DOCTYPE html>
2025-12-12 11:57:38 +01:00
< html lang = "en" >
< head >
2026-03-30 10:01:17 +02:00
< meta charset = "UTF-8" >
< meta name = "viewport" content = "width=device-width, initial-scale=1.0" >
< meta name = "description" content = "A backup program for disk arrays. It stores parity information of your data and it recovers from up to six disk failures" >
< meta name = "keywords" content = "snapraid snapshot raid backup disk array redundancy parity" >
< title > SnapRAID CLI Manual< / title >
< link rel = "stylesheet" href = "style.css" >
2026-04-14 09:53:56 +02:00
< link rel = "apple-touch-icon" sizes = "180x180" href = "/apple-touch-icon.png" >
< link rel = "icon" type = "image/png" sizes = "32x32" href = "/favicon-32x32.png" >
< link rel = "icon" type = "image/png" sizes = "16x16" href = "/favicon-16x16.png" >
< link rel = "manifest" href = "/site.webmanifest" >
2026-03-30 10:01:17 +02:00
< script src = "script.js" > < / script >
2025-12-12 11:57:38 +01:00
<!-- Google Analytics 4 -->
<!-- Google tag (gtag.js) -->
< script async src = "https://www.googletagmanager.com/gtag/js?id=G-W1Z5FKHYQ4" > < / script >
< script >
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'G-W1Z5FKHYQ4');
< / script >
<!-- Google Universal Analytics -->
< script type = "text/javascript" >
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-21967501-1']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
< / script >
2026-03-30 10:01:17 +02:00
2025-12-12 11:57:38 +01:00
< / head >
< body >
2026-03-30 10:01:17 +02:00
< header >
< div class = "container nav-container" >
< a href = "index" class = "logo" >
< img src = "android-chrome-192x192.png" width = "32" height = "32" / >
SnapRAID
< / a >
< nav >
< input type = "checkbox" id = "menu-toggle" >
< label for = "menu-toggle" class = "menu-icon" > < svg viewBox = "0 0 24 24" width = "24" height = "24" fill = "currentColor" > < path d = "M3 18h18v-2H3v2zm0-5h18v-2H3v2zm0-7v2h18V6H3z" / > < / svg > < / label >
< ul >
< li > < a href = "index" > Home< / a > < / li >
< li > < a href = "ui" > UI & Daemon< / a > < / li >
< li > < a href = "howitworks" > How it Works< / a > < / li >
< li > < a href = "design" > Design< / a > < / li >
< li > < a href = "compare" > Compare< / a > < / li >
< li > < a href = "manual" class = "active" > Manual< / a > < / li >
< li > < a href = "faq" > FAQ< / a > < / li >
< li > < a href = "support" > Support< / a > < / li >
< li > < a href = "download" class = "nav-cta" > Download< / a > < / li >
< li >
< button class = "theme-toggle" aria-label = "Toggle theme" >
< svg class = "sun-icon" viewBox = "0 0 24 24" fill = "none" stroke = "currentColor" stroke-width = "2" stroke-linecap = "round" stroke-linejoin = "round" > < circle cx = "12" cy = "12" r = "5" > < / circle > < line x1 = "12" y1 = "1" x2 = "12" y2 = "3" > < / line > < line x1 = "12" y1 = "21" x2 = "12" y2 = "23" > < / line > < line x1 = "4.22" y1 = "4.22" x2 = "5.64" y2 = "5.64" > < / line > < line x1 = "18.36" y1 = "18.36" x2 = "19.78" y2 = "19.78" > < / line > < line x1 = "1" y1 = "12" x2 = "3" y2 = "12" > < / line > < line x1 = "21" y1 = "12" x2 = "23" y2 = "12" > < / line > < line x1 = "4.22" y1 = "19.78" x2 = "5.64" y2 = "18.36" > < / line > < line x1 = "18.36" y1 = "5.64" x2 = "19.78" y2 = "4.22" > < / line > < / svg >
< svg class = "moon-icon" viewBox = "0 0 24 24" fill = "none" stroke = "currentColor" stroke-width = "2" stroke-linecap = "round" stroke-linejoin = "round" > < path d = "M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z" > < / path > < / svg >
< / button >
< / li >
< / ul >
< / nav >
< / div >
< / header >
< div class = "container manual-layout" >
< aside class = "manual-sidebar" >
< h4 > Components< / h4 >
< select id = "manual-selector" style = "width: 100%; padding: 5px; background: var(--bg-surface); color: var(--text-primary); border: 1px solid var(--border-color); border-radius: 4px; margin-bottom: 2rem;" >
< option value = "manual" > Command Line< / option >
< option value = "manual-daemon" > Daemon< / option >
< option value = "manual-log" > Log< / option >
< / select >
2025-12-12 11:57:38 +01:00
2026-03-30 10:01:17 +02:00
< h4 > Languages< / h4 >
< select id = "language-selector" style = "width: 100%; padding: 5px; background: var(--bg-surface); color: var(--text-primary); border: 1px solid var(--border-color); border-radius: 4px; margin-bottom: 2rem;" >
< option value = "manual" > English< / option >
< option value = "manual-de" > German< / option >
< option value = "manual-es" > Spanish< / option >
< option value = "manual-fr" > French< / option >
< option value = "manual-it" > Italian< / option >
< option value = "manual-ja" > Japanse< / option >
< option value = "manual-ko" > Korean< / option >
< option value = "manual-pl" > Polish< / option >
< option value = "manual-pt" > Portuguese< / option >
< option value = "manual-ro" > Romanian< / option >
< option value = "manual-ru" > Russian< / option >
< option value = "manual-sv" > Swedish< / option >
< option value = "manual-uk" > Ukranian< / option >
< option value = "manual-zh" > Simplified Chinese< / option > .
2025-12-12 11:57:38 +01:00
2026-03-30 10:01:17 +02:00
< / select >
2025-12-12 11:57:38 +01:00
2026-03-30 10:01:17 +02:00
< h4 > Contents< / h4 >
< ul id = "manual-toc-list" >
<!-- Populated by JavaScript -->
< / ul >
< / aside >
2025-12-12 11:57:38 +01:00
2026-03-30 10:01:17 +02:00
< main id = "manual-container" >
< div class = "manual-doc" >
< div class = "manual-section-level-1" >
< h1 id = "sec1" class = "manual-title-level-1" >
2025-12-12 11:57:38 +01:00
Synopsis
2026-03-30 10:01:17 +02:00
< / h1 >
2025-12-12 11:57:38 +01:00
< pre >
snapraid [-c, --conf CONFIG]
[-f, --filter PATTERN] [-d, --filter-disk NAME]
[-m, --filter-missing] [-e, --filter-error]
[-a, --audit-only] [-h, --pre-hash] [-i, --import DIR]
[-p, --plan PERC|bad|new|full]
[-o, --older-than DAYS] [-l, --log FILE]
[-s, --spin-down-on-error] [-w, --bw-limit RATE]
2026-03-30 10:01:17 +02:00
[-t, --tail]
2025-12-12 11:57:38 +01:00
[-Z, --force-zero] [-E, --force-empty]
[-U, --force-uuid] [-D, --force-device]
[-N, --force-nocopy] [-F, --force-full]
2026-03-30 10:01:17 +02:00
[-R, --force-realloc] [-W, --force-realloc-tail]
2025-12-12 11:57:38 +01:00
[-S, --start BLKSTART] [-B, --count BLKCOUNT]
[-L, --error-limit NUMBER]
[-A, --stats]
[-v, --verbose] [-q, --quiet]
status|smart|probe|up|down|diff|sync|scrub|fix|check
2026-03-30 10:01:17 +02:00
|list|dup|pool|devices|touch|rehash|locate
2025-12-12 11:57:38 +01:00
< / pre >
< pre >
snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT]
< / pre >
2026-03-30 10:01:17 +02:00
< / div >
< div class = "manual-section-level-1" >
< h1 id = "sec2" class = "manual-title-level-1" >
2025-12-12 11:57:38 +01:00
Description
2026-03-30 10:01:17 +02:00
< / h1 >
2025-12-14 22:21:44 +01:00
< p > SnapRAID to program do tworzenia kopii zapasowych przeznaczony
2025-12-12 11:57:38 +01:00
dla macierzy dyskowych, przechowujący informacje parzystości
do odzyskiwania danych w przypadku awarii do sześciu dysków.
2025-12-14 22:21:44 +01:00
< / p > < p > Przeznaczony głównie dla domowych centrów multimedialnych z dużymi,
2025-12-12 11:57:38 +01:00
rzadko zmieniającymi się plikami, SnapRAID oferuje kilka funkcji:
2025-12-14 22:21:44 +01:00
< / p > < ul >
2025-12-12 11:57:38 +01:00
< li >
Możesz używać dysków już wypełnionych plikami bez
konieczności ich ponownego formatowania, uzyskując do nich dostęp jak zwykle.
< / li >
< li >
Wszystkie Twoje dane są haszowane, aby zapewnić integralność danych i zapobiec
cichej korupcji.
< / li >
< li >
Gdy liczba uszkodzonych dysków przekracza liczbę parzystości,
utrata danych ogranicza się do dotkniętych dysków; dane na
innych dyskach pozostają dostępne.
< / li >
< li >
Jeśli przypadkowo usuniesz pliki na dysku, możliwe jest ich odzyskanie.
< / li >
< li >
Dyski mogą mieć różne rozmiary.
< / li >
< li >
Możesz dodawać dyski w dowolnym momencie.
< / li >
< li >
SnapRAID nie blokuje Twoich danych; możesz przestać go używać
w dowolnym momencie bez ponownego formatowania ani przenoszenia danych.
< / li >
< li >
Aby uzyskać dostęp do pliku, wystarczy, że zakręci się tylko jeden dysk,
co oszczędza energię i zmniejsza hałas.
< / li >
< / ul >
2025-12-14 22:21:44 +01:00
< p > Więcej informacji można znaleźć na oficjalnej stronie SnapRAID:
2026-03-30 10:01:17 +02:00
< / p > < pre >
< a href = "https://www.snapraid.it/" > https://www.snapraid.it/< / a >
2025-12-12 11:57:38 +01:00
< / pre >
2026-03-30 10:01:17 +02:00
< / div >
< div class = "manual-section-level-1" >
< h1 id = "sec3" class = "manual-title-level-1" >
2025-12-12 11:57:38 +01:00
Limitations
2026-03-30 10:01:17 +02:00
< / h1 >
2025-12-14 22:21:44 +01:00
< p > SnapRAID to hybryda programu RAID i programu do tworzenia kopii zapasowych,
2025-12-12 11:57:38 +01:00
której celem jest połączenie najlepszych zalet obu. Ma jednak pewne
ograniczenia, które należy wziąć pod uwagę przed jego użyciem.
2025-12-14 22:21:44 +01:00
< / p > < p > Głównym ograniczeniem jest to, że jeśli dysk ulegnie awarii, a Ty nie wykonałeś
2025-12-12 11:57:38 +01:00
niedawno synchronizacji, możesz nie być w stanie w pełni odzyskać danych.
Dokładniej, możesz nie być w stanie odzyskać danych o wielkości
zmienionych lub usuniętych plików od czasu ostatniej operacji synchronizacji.
Dzieje się tak, nawet jeśli zmienione lub usunięte pliki nie znajdują się na
uszkodzonym dysku. Dlatego SnapRAID jest lepiej dostosowany do
danych, które rzadko się zmieniają.
2025-12-14 22:21:44 +01:00
< / p > < p > Z drugiej strony, nowo dodane pliki nie uniemożliwiają odzyskania już
2025-12-12 11:57:38 +01:00
istniejących plików. Stracisz tylko ostatnio dodane pliki, jeśli
znajdują się one na uszkodzonym dysku.
2025-12-14 22:21:44 +01:00
< / p > < p > Inne ograniczenia SnapRAID to:
< / p > < ul >
2025-12-12 11:57:38 +01:00
< li >
W SnapRAID nadal masz oddzielne systemy plików dla każdego dysku.
W RAID otrzymujesz jeden duży system plików.
< / li >
< li >
SnapRAID nie rozdziela danych.
W RAID uzyskujesz wzrost prędkości dzięki rozdzielaniu.
< / li >
< li >
SnapRAID nie obsługuje odzyskiwania w czasie rzeczywistym.
W RAID nie musisz przerywać pracy, gdy dysk ulegnie awarii.
< / li >
< li >
SnapRAID może odzyskać dane tylko z ograniczonej liczby awarii dysków.
W przypadku kopii zapasowej możesz odzyskać dane po całkowitej
awarii całej macierzy dysków.
< / li >
< li >
Zapisywane są tylko nazwy plików, znaczniki czasu, dowiązania symboliczne
i dowiązania twarde.
Uprawnienia, właścicielstwo i rozszerzone atrybuty nie są zapisywane.
< / li >
< / ul >
2026-03-30 10:01:17 +02:00
< / div >
< div class = "manual-section-level-1" >
< h1 id = "sec4" class = "manual-title-level-1" >
2025-12-12 11:57:38 +01:00
Getting Started
2026-03-30 10:01:17 +02:00
< / h1 >
2025-12-14 22:21:44 +01:00
< p > Aby użyć SnapRAID, musisz najpierw wybrać jeden dysk w swojej macierzy
2026-03-30 10:01:17 +02:00
dysków, który zostanie przeznaczony na informacje o < b > parzystości< / b > . Z jednym dyskiem
2025-12-12 11:57:38 +01:00
na parzystość będziesz w stanie odzyskać dane po awarii pojedynczego dysku,
podobnie jak w RAID5.
2025-12-14 22:21:44 +01:00
< / p > < p > Jeśli chcesz odzyskać dane po większej liczbie awarii dysków, podobnie jak
2025-12-12 11:57:38 +01:00
w RAID6, musisz zarezerwować dodatkowe dyski na parzystość. Każdy dodatkowy
dysk parzystości umożliwia odzyskanie danych po jeszcze jednej awarii dysku.
2025-12-14 22:21:44 +01:00
< / p > < p > Jako dyski parzystości musisz wybrać największe dyski w macierzy,
2025-12-12 11:57:38 +01:00
ponieważ informacje o parzystości mogą urosnąć do rozmiaru największego
dysku danych w macierzy.
2026-03-30 10:01:17 +02:00
< / p > < p > Dyski te będą przeznaczone do przechowywania plików < b > parzystości< / b > .
2025-12-12 11:57:38 +01:00
Nie powinieneś na nich przechowywać swoich danych.
2026-03-30 10:01:17 +02:00
< / p > < p > Następnie musisz zdefiniować dyski < b > danych< / b > , które chcesz chronić
2025-12-12 11:57:38 +01:00
za pomocą SnapRAID. Ochrona jest bardziej skuteczna, jeśli te dyski
zawierają dane, które rzadko się zmieniają. Z tego powodu lepiej jest
NIE włączać dysku C:\ w systemie Windows ani katalogów /home, /var i /tmp
w systemie Unix.
2026-03-30 10:01:17 +02:00
< / p > < p > Lista plików jest zapisywana w plikach < b > zawartości< / b > , zwykle
2025-12-12 11:57:38 +01:00
przechowywanych na dyskach danych, parzystości lub rozruchowych.
Plik ten zawiera szczegóły Twojej kopii zapasowej, w tym wszystkie
sumy kontrolne w celu weryfikacji jej integralności.
2026-03-30 10:01:17 +02:00
Plik < b > zawartości< / b > jest przechowywany w wielu kopiach, a każda kopia musi
2025-12-12 11:57:38 +01:00
znajdować się na innym dysku, aby zapewnić, że nawet w przypadku wielu
awarii dysków, przynajmniej jedna kopia jest dostępna.
2025-12-14 22:21:44 +01:00
< / p > < p > Na przykład, załóżmy, że interesuje Cię tylko jeden poziom parzystości
2025-12-12 11:57:38 +01:00
i Twoje dyski znajdują się w:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
/mnt/diskp < - wybrany dysk dla parzystości
/mnt/disk1 < - pierwszy dysk do ochrony
/mnt/disk2 < - drugi dysk do ochrony
/mnt/disk3 < - trzeci dysk do ochrony
< / pre >
2025-12-14 22:21:44 +01:00
< p > Musisz utworzyć plik konfiguracyjny /etc/snapraid.conf z
2025-12-12 11:57:38 +01:00
następującymi opcjami:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
parity /mnt/diskp/snapraid.parity
content /var/snapraid/snapraid.content
content /mnt/disk1/snapraid.content
content /mnt/disk2/snapraid.content
data d1 /mnt/disk1/
data d2 /mnt/disk2/
data d3 /mnt/disk3/
< / pre >
2025-12-14 22:21:44 +01:00
< p > Jeśli używasz systemu Windows, powinieneś użyć formatu ścieżek Windows,
2025-12-12 11:57:38 +01:00
z literami dysków i ukośnikami odwrotnymi zamiast ukośników:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
parity E:\snapraid.parity
content C:\snapraid\snapraid.content
content F:\array\snapraid.content
content G:\array\snapraid.content
data d1 F:\array\
data d2 G:\array\
data d3 H:\array\
< / pre >
2025-12-14 22:21:44 +01:00
< p > Jeśli masz wiele dysków i zabrakło Ci liter dysków, możesz zamontować
2025-12-12 11:57:38 +01:00
dyski bezpośrednio w podfolderach. Zobacz:
2026-03-30 10:01:17 +02:00
< / p > < pre >
< a href = "https://www.google.com/search?q=Windows+mount+point" > https://www.google.com/search?q=Windows+mount+point< / a >
2025-12-12 11:57:38 +01:00
< / pre >
2026-03-30 10:01:17 +02:00
< p > W tym momencie jesteś gotowy do uruchomienia polecenia < b > sync< / b > , aby zbudować
2025-12-12 11:57:38 +01:00
informacje o parzystości.
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
snapraid sync
< / pre >
2025-12-14 22:21:44 +01:00
< p > Ten proces może zająć kilka godzin za pierwszym razem, w zależności od rozmiaru
2025-12-12 11:57:38 +01:00
danych już obecnych na dyskach. Jeśli dyski są puste,
proces jest natychmiastowy.
2025-12-14 22:21:44 +01:00
< / p > < p > Możesz go zatrzymać w dowolnym momencie, naciskając Ctrl+C, a przy następnym
2025-12-12 11:57:38 +01:00
uruchomieniu wznowi się w miejscu, w którym został przerwany.
2025-12-14 22:21:44 +01:00
< / p > < p > Kiedy to polecenie się zakończy, Twoje dane są BEZPIECZNE.
< / p > < p > Teraz możesz zacząć używać swojej macierzy, jak chcesz, i okresowo
2026-03-30 10:01:17 +02:00
aktualizować informacje o parzystości, uruchamiając polecenie < b > sync< / b > .
< / p > < div class = "manual-section-level-2" >
< h2 id = "sec4-1" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
Scrubbing
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Aby okresowo sprawdzać dane i parzystość pod kątem błędów, możesz
2026-03-30 10:01:17 +02:00
uruchomić polecenie < b > scrub< / b > .
< / p > < pre >
2025-12-12 11:57:38 +01:00
snapraid scrub
< / pre >
2025-12-14 22:21:44 +01:00
< p > To polecenie porównuje dane w Twojej macierzy z haszem obliczonym
2026-03-30 10:01:17 +02:00
podczas polecenia < b > sync< / b > , aby zweryfikować integralność.
2025-12-14 22:21:44 +01:00
< / p > < p > Każde uruchomienie polecenia sprawdza około 8% macierzy, z wyłączeniem danych
2025-12-12 11:57:38 +01:00
już sprawdzonych w ciągu poprzednich 10 dni.
Możesz użyć opcji -p, --plan, aby określić inną ilość,
oraz opcji -o, --older-than, aby określić inny wiek w dniach.
Na przykład, aby sprawdzić 5% macierzy dla bloków starszych niż 20 dni, użyj:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
snapraid -p 5 -o 20 scrub
< / pre >
2025-12-14 22:21:44 +01:00
< p > Jeśli podczas procesu zostaną znalezione ciche błędy lub błędy wejścia/wyjścia,
2026-03-30 10:01:17 +02:00
odpowiednie bloki zostaną oznaczone jako złe w pliku < b > content< / b >
i wymienione w poleceniu < b > status< / b > .
< / p > < pre >
2025-12-12 11:57:38 +01:00
snapraid status
< / pre >
2026-03-30 10:01:17 +02:00
< p > Aby je naprawić, możesz użyć polecenia < b > fix< / b > , filtrując złe bloki
2025-12-12 11:57:38 +01:00
za pomocą opcji -e, --filter-error:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
snapraid -e fix
< / pre >
2026-03-30 10:01:17 +02:00
< p > Przy następnym < b > scrub< / b > , błędy znikną z raportu < b > status< / b > ,
2025-12-12 11:57:38 +01:00
jeśli zostały faktycznie naprawione. Aby przyspieszyć, możesz użyć -p bad, aby
sprawdzić tylko bloki oznaczone jako złe.
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
snapraid -p bad scrub
< / pre >
2026-03-30 10:01:17 +02:00
< p > Uruchomienie < b > scrub< / b > na niezsynchronizowanej macierzy może zgłosić błędy
2025-12-12 11:57:38 +01:00
spowodowane usuniętymi lub zmodyfikowanymi plikami. Błędy te są zgłaszane
2026-03-30 10:01:17 +02:00
w wyniku < b > scrub< / b > , ale powiązane bloki nie są oznaczane jako złe.
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec4-2" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
Pooling
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Uwaga: Funkcja łączenia w pulę opisana poniżej została zastąpiona przez
2026-03-30 10:01:17 +02:00
narzędzie mergerfs, które jest obecnie zalecaną opcją dla użytkowników Linuksa
2025-12-12 11:57:38 +01:00
w społeczności SnapRAID. Mergefs zapewnia bardziej elastyczny i wydajny
sposób łączenia wielu dysków w jeden ujednolicony punkt montowania,
umożliwiając bezproblemowy dostęp do plików w całej macierzy bez polegania
na dowiązaniach symbolicznych. Dobrze integruje się z SnapRAID w celu ochrony
parzystości i jest powszechnie używane w konfiguracjach takich jak
OpenMediaVault (OMV) lub niestandardowe konfiguracje NAS.
2025-12-14 22:21:44 +01:00
< / p > < p > Aby wszystkie pliki w Twojej macierzy były widoczne w tym samym drzewie katalogów,
2026-03-30 10:01:17 +02:00
możesz włączyć funkcję < b > pooling< / b > . Tworzy ona wirtualny, tylko do odczytu,
2025-12-12 11:57:38 +01:00
widok wszystkich plików w Twojej macierzy za pomocą dowiązań symbolicznych.
2026-03-30 10:01:17 +02:00
< / p > < p > Katalog < b > pooling< / b > możesz skonfigurować w pliku konfiguracyjnym za pomocą:
< / p > < pre >
2025-12-12 11:57:38 +01:00
pool /pool
< / pre >
2025-12-14 22:21:44 +01:00
< p > lub, jeśli używasz systemu Windows, za pomocą:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
pool C:\pool
< / pre >
2026-03-30 10:01:17 +02:00
< p > a następnie uruchom polecenie < b > pool< / b > , aby utworzyć lub zaktualizować wirtualny widok.
< / p > < pre >
2025-12-12 11:57:38 +01:00
snapraid pool
< / pre >
2025-12-14 22:21:44 +01:00
< p > Jeśli używasz platformy Unix i chcesz udostępnić ten katalog
2025-12-12 11:57:38 +01:00
przez sieć maszynom Windows lub Unix, powinieneś dodać
następujące opcje do swojego /etc/samba/smb.conf:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
# W sekcji globalnej smb.conf
unix extensions = no
< / pre >
< pre >
# W sekcji udziału smb.conf
[pool]
comment = Pula
path = /pool
read only = yes
guest ok = yes
wide links = yes
follow symlinks = yes
< / pre >
2025-12-14 22:21:44 +01:00
< p > W systemie Windows udostępnianie dowiązań symbolicznych przez sieć wymaga od klientów
2025-12-12 11:57:38 +01:00
zdalnego ich rozwiązywania. Aby to umożliwić, oprócz udostępnienia katalogu puli,
musisz również udostępnić wszystkie dyski niezależnie, używając nazw dysków
zdefiniowanych w pliku konfiguracyjnym jako punkty udostępniania. Musisz również
2026-03-30 10:01:17 +02:00
określić w opcji < b > share< / b > w pliku konfiguracyjnym ścieżkę UNC Windows,
2025-12-12 11:57:38 +01:00
której klienci zdalni muszą użyć, aby uzyskać dostęp do tych udostępnionych dysków.
2026-03-30 10:01:17 +02:00
< / p > < p > Na przykład, działając z serwera o nazwie < b > darkstar< / b > , możesz użyć
2025-12-12 11:57:38 +01:00
opcji:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
data d1 F:\array\
data d2 G:\array\
data d3 H:\array\
pool C:\pool
share \\darkstar
< / pre >
2025-12-14 22:21:44 +01:00
< p > i udostępnić w sieci następujące katalogi:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
\\darkstar\pool -> C:\pool
\\darkstar\d1 -> F:\array
\\darkstar\d2 -> G:\array
\\darkstar\d3 -> H:\array
< / pre >
2025-12-14 22:21:44 +01:00
< p > aby umożliwić zdalnym klientom dostęp do wszystkich plików pod adresem \\darkstar\pool.
< / p > < p > Możesz również potrzebować skonfigurować klientów zdalnych, aby umożliwić dostęp
2025-12-12 11:57:38 +01:00
do zdalnych dowiązań symbolicznych za pomocą polecenia:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1
< / pre >
2026-03-30 10:01:17 +02:00
< / div >
< div class = "manual-section-level-2" >
< h2 id = "sec4-3" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
Undeleting
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > SnapRAID działa bardziej jak program do tworzenia kopii zapasowych niż system RAID
2025-12-12 11:57:38 +01:00
i może być użyty do przywrócenia lub odzyskania usuniętych plików do ich poprzedniego
stanu za pomocą opcji -f, --filter:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
snapraid fix -f FILE
< / pre >
2025-12-14 22:21:44 +01:00
< p > lub dla katalogu:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
snapraid fix -f DIR/
< / pre >
2025-12-14 22:21:44 +01:00
< p > Możesz go również użyć do odzyskania tylko przypadkowo usuniętych plików wewnątrz
2025-12-12 11:57:38 +01:00
katalogu za pomocą opcji -m, --filter-missing, która przywraca
tylko brakujące pliki, pozostawiając wszystkie inne nienaruszone.
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
snapraid fix -m -f DIR/
< / pre >
2025-12-14 22:21:44 +01:00
< p > Lub aby odzyskać wszystkie usunięte pliki na wszystkich dyskach za pomocą:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
snapraid fix -m
< / pre >
2026-03-30 10:01:17 +02:00
< / div >
< div class = "manual-section-level-2" >
< h2 id = "sec4-4" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
Recovering
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Najgorsze się wydarzyło i straciłeś jeden lub więcej dysków!
< / p > < p > NIE PANIKUJ! Będziesz w stanie je odzyskać!
< / p > < p > Pierwszą rzeczą, którą musisz zrobić, to unikać dalszych zmian w Twojej macierzy dysków.
2025-12-12 11:57:38 +01:00
Wyłącz wszelkie zdalne połączenia z nią i wszelkie zaplanowane procesy, w tym
jakąkolwiek zaplanowaną nocną synchronizację lub scrub SnapRAID.
2025-12-14 22:21:44 +01:00
< / p > < p > Następnie postępuj zgodnie z poniższymi krokami.
2026-03-30 10:01:17 +02:00
< / p > < div class = "manual-section-level-3" >
< h3 id = "sec4-4-1" class = "manual-title-level-3" >
2025-12-12 11:57:38 +01:00
KROK 1 -> Ponowna konfiguracja
2026-03-30 10:01:17 +02:00
< / h3 >
2025-12-14 22:21:44 +01:00
< p > Potrzebujesz trochę miejsca do odzyskania, najlepiej na dodatkowych
2025-12-12 11:57:38 +01:00
zapasowych dyskach, ale wystarczy zewnętrzny dysk USB lub dysk zdalny.
2026-03-30 10:01:17 +02:00
< / p > < p > Zmodyfikuj plik konfiguracyjny SnapRAID, aby opcja < b > data< / b > lub < b > parity< / b >
2025-12-12 11:57:38 +01:00
uszkodzonego dysku wskazywała na lokalizację z wystarczającą ilością pustego
miejsca do odzyskania plików.
2026-03-30 10:01:17 +02:00
< / p > < p > Na przykład, jeśli dysk < b > d1< / b > uległ awarii, zmień z:
< / p > < pre >
2025-12-12 11:57:38 +01:00
data d1 /mnt/disk1/
< / pre >
2025-12-14 22:21:44 +01:00
< p > na:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
data d1 /mnt/new_spare_disk/
< / pre >
2025-12-14 22:21:44 +01:00
< p > Jeśli dysk do odzyskania jest dyskiem parzystości, zaktualizuj odpowiednią
2026-03-30 10:01:17 +02:00
opcję < b > parity< / b > .
2025-12-12 11:57:38 +01:00
Jeśli masz wiele uszkodzonych dysków, zaktualizuj wszystkie ich opcje konfiguracyjne.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-3" >
< h3 id = "sec4-4-2" class = "manual-title-level-3" >
2025-12-12 11:57:38 +01:00
KROK 2 -> Naprawa
2026-03-30 10:01:17 +02:00
< / h3 >
2025-12-14 22:21:44 +01:00
< p > Uruchom polecenie fix, zapisując log w pliku zewnętrznym za pomocą:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
snapraid -d NAME -l fix.log fix
< / pre >
2026-03-30 10:01:17 +02:00
< p > Gdzie NAME to nazwa dysku, taka jak < b > d1< / b > w naszym poprzednim przykładzie.
Jeśli dysk do odzyskania jest dyskiem parzystości, użyj nazw < b > parity< / b > , < b > 2-parity< / b > ,
2025-12-12 11:57:38 +01:00
itp.
Jeśli masz wiele uszkodzonych dysków, użyj wielu opcji -d, aby określić
wszystkie z nich.
2025-12-14 22:21:44 +01:00
< / p > < p > To polecenie zajmie dużo czasu.
< / p > < p > Upewnij się, że masz kilka gigabajtów wolnego miejsca na zapisanie pliku fix.log.
2025-12-12 11:57:38 +01:00
Uruchom je z dysku z wystarczającą ilością wolnego miejsca.
2025-12-14 22:21:44 +01:00
< / p > < p > Teraz odzyskałeś wszystko, co jest możliwe do odzyskania. Jeśli niektóre pliki
2025-12-12 11:57:38 +01:00
są częściowo lub całkowicie nie do odzyskania, zostaną one przemianowane
2026-03-30 10:01:17 +02:00
poprzez dodanie rozszerzenia < b > .unrecoverable< / b > .
2025-12-14 22:21:44 +01:00
< / p > < p > Szczegółową listę wszystkich nie do odzyskania bloków znajdziesz w pliku fix.log,
2026-03-30 10:01:17 +02:00
sprawdzając wszystkie linie zaczynające się od < b > unrecoverable:< / b > .
2025-12-14 22:21:44 +01:00
< / p > < p > Jeśli nie jesteś zadowolony z odzyskiwania, możesz spróbować ponownie
2025-12-12 11:57:38 +01:00
tyle razy, ile chcesz.
2025-12-14 22:21:44 +01:00
< / p > < p > Na przykład, jeśli usunąłeś pliki z macierzy po ostatniej
2026-03-30 10:01:17 +02:00
< b > sync< / b > , może to spowodować, że niektóre pliki nie zostaną odzyskane.
W tym przypadku możesz ponowić próbę < b > fix< / b > za pomocą opcji -i, --import,
2025-12-12 11:57:38 +01:00
określając, gdzie te pliki znajdują się teraz, aby włączyć je ponownie
do procesu odzyskiwania.
2025-12-14 22:21:44 +01:00
< / p > < p > Jeśli jesteś zadowolony z odzyskiwania, możesz kontynuować,
2026-03-30 10:01:17 +02:00
ale pamiętaj, że po synchronizacji nie możesz już ponowić próby polecenia < b > fix< / b > !
< / p > < / div >
< div class = "manual-section-level-3" >
< h3 id = "sec4-4-3" class = "manual-title-level-3" >
2025-12-12 11:57:38 +01:00
KROK 3 -> Sprawdzenie
2026-03-30 10:01:17 +02:00
< / h3 >
< p > Jako ostrożne sprawdzenie, możesz teraz uruchomić polecenie < b > check< / b > , aby upewnić się, że
2025-12-12 11:57:38 +01:00
wszystko jest poprawne na odzyskanym dysku.
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
snapraid -d NAME -a check
< / pre >
2026-03-30 10:01:17 +02:00
< p > Gdzie NAME to nazwa dysku, taka jak < b > d1< / b > w naszym poprzednim przykładzie.
2025-12-14 22:21:44 +01:00
< / p > < p > Opcje -d i -a mówią SnapRAID, aby sprawdził tylko określony dysk
2025-12-12 11:57:38 +01:00
i zignorował wszystkie dane parzystości.
2025-12-14 22:21:44 +01:00
< / p > < p > To polecenie zajmie dużo czasu, ale jeśli nie jesteś zbyt ostrożny,
2025-12-12 11:57:38 +01:00
możesz je pominąć.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-3" >
< h3 id = "sec4-4-4" class = "manual-title-level-3" >
2025-12-12 11:57:38 +01:00
KROK 4 -> Synchronizacja
2026-03-30 10:01:17 +02:00
< / h3 >
< p > Uruchom polecenie < b > sync< / b > , aby ponownie zsynchronizować macierz z nowym dyskiem.
< / p > < pre >
2025-12-12 11:57:38 +01:00
snapraid sync
< / pre >
2025-12-14 22:21:44 +01:00
< p > Jeśli wszystko zostanie odzyskane, to polecenie jest natychmiastowe.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< / div >
< / div >
< div class = "manual-section-level-1" >
< h1 id = "sec5" class = "manual-title-level-1" >
2025-12-12 11:57:38 +01:00
Commands
2026-03-30 10:01:17 +02:00
< / h1 >
2025-12-14 22:21:44 +01:00
< p > SnapRAID udostępnia kilka prostych poleceń, które pozwalają na:
< / p > < ul >
2025-12-12 11:57:38 +01:00
< li >
2026-03-30 10:01:17 +02:00
Wyświetlenie statusu macierzy -> < b > status< / b >
2025-12-12 11:57:38 +01:00
< / li >
< li >
2026-03-30 10:01:17 +02:00
Kontrolę dysków -> < b > smart< / b > , < b > probe< / b > , < b > up< / b > , < b > down< / b >
2025-12-12 11:57:38 +01:00
< / li >
< li >
2026-03-30 10:01:17 +02:00
Wykonanie kopii zapasowej/migawki -> < b > sync< / b >
2025-12-12 11:57:38 +01:00
< / li >
< li >
2026-03-30 10:01:17 +02:00
Okresowe sprawdzanie danych -> < b > scrub< / b >
2025-12-12 11:57:38 +01:00
< / li >
< li >
2026-03-30 10:01:17 +02:00
Przywrócenie ostatniej kopii zapasowej/migawki -> < b > fix< / b > .
2025-12-12 11:57:38 +01:00
< / li >
< / ul >
2025-12-14 22:21:44 +01:00
< p > Polecenia muszą być zapisane małymi literami.
2026-03-30 10:01:17 +02:00
< / p > < div class = "manual-section-level-2" >
< h2 id = "sec5-1" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
status
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Wyświetla podsumowanie stanu macierzy dysków.
< / p > < p > Zawiera informacje o fragmentacji parzystości, jak stare
2025-12-12 11:57:38 +01:00
są bloki bez sprawdzenia i wszystkie zarejestrowane ciche
błędy napotkane podczas scrubbingu.
2025-12-14 22:21:44 +01:00
< / p > < p > Prezentowane informacje odnoszą się do ostatniego momentu, w którym
2026-03-30 10:01:17 +02:00
uruchomiłeś < b > sync< / b > . Późniejsze modyfikacje nie są brane pod uwagę.
2025-12-14 22:21:44 +01:00
< / p > < p > Jeśli wykryto złe bloki, ich numery bloków są wymienione.
2026-03-30 10:01:17 +02:00
Aby je naprawić, możesz użyć polecenia < b > fix -e< / b > .
2025-12-14 22:21:44 +01:00
< / p > < p > Pokazuje również wykres reprezentujący ostatni raz, kiedy każdy blok
2025-12-12 11:57:38 +01:00
został sprawdzony lub zsynchronizowany. Sprawdzone bloki są pokazane
2026-03-30 10:01:17 +02:00
za pomocą < b > *< / b > , bloki zsynchronizowane, ale jeszcze niesprawdzone, za pomocą < b > o< / b > .
2025-12-14 22:21:44 +01:00
< / p > < p > Nic nie jest modyfikowane.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec5-2" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
smart
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Wyświetla raport SMART wszystkich dysków w systemie.
< / p > < p > Zawiera oszacowanie prawdopodobieństwa awarii w następnym
2025-12-12 11:57:38 +01:00
roku, co pozwala zaplanować wymianę konserwacyjną dysków, które wykazują
podejrzane atrybuty.
2025-12-14 22:21:44 +01:00
< / p > < p > To oszacowanie prawdopodobieństwa uzyskuje się poprzez skorelowanie atrybutów SMART
2025-12-12 11:57:38 +01:00
dysków z danymi Backblaze dostępnymi pod adresem:
2026-03-30 10:01:17 +02:00
< / p > < pre >
< a href = "https://www.backblaze.com/hard-drive-test-data.html" > https://www.backblaze.com/hard-drive-test-data.html< / a >
2025-12-12 11:57:38 +01:00
< / pre >
2025-12-14 22:21:44 +01:00
< p > Jeśli SMART zgłosi, że dysk ulega awarii, dla tego dysku
2026-03-30 10:01:17 +02:00
wyświetlane jest < b > FAIL< / b > lub < b > PREFAIL< / b > , a SnapRAID zwraca błąd.
2025-12-12 11:57:38 +01:00
W takim przypadku natychmiastowa wymiana dysku jest wysoce zalecana.
2025-12-14 22:21:44 +01:00
< / p > < p > Inne możliwe ciągi statusu to:
2026-03-30 10:01:17 +02:00
< / p > < div class = "manual-tag-list" >
< div class = "manual-tag-entry" >
< div class = "manual-tag-name" >
2025-12-12 11:57:38 +01:00
logfail
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-tag-description" >
2025-12-12 11:57:38 +01:00
W przeszłości niektóre atrybuty były niższe niż
próg.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< div class = "manual-tag-entry" >
< div class = "manual-tag-name" >
2025-12-12 11:57:38 +01:00
logerr
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-tag-description" >
2025-12-12 11:57:38 +01:00
Dziennik błędów urządzenia zawiera błędy.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< div class = "manual-tag-entry" >
< div class = "manual-tag-name" >
2025-12-12 11:57:38 +01:00
selferr
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-tag-description" >
2025-12-12 11:57:38 +01:00
Dziennik autotestu urządzenia zawiera błędy.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< / div >
2025-12-14 22:21:44 +01:00
< p > Jeśli określono opcję -v, --verbose, dostarczana jest głębsza analiza
2025-12-12 11:57:38 +01:00
statystyczna. Ta analiza może pomóc Ci zdecydować, czy potrzebujesz
więcej czy mniej parzystości.
2026-03-30 10:01:17 +02:00
< / p > < p > To polecenie używa narzędzia < b > smartctl< / b > i jest równoważne
uruchomieniu < b > smartctl -a< / b > na wszystkich urządzeniach.
2025-12-14 22:21:44 +01:00
< / p > < p > Jeśli Twoje urządzenia nie zostaną poprawnie wykryte automatycznie, możesz określić
2026-03-30 10:01:17 +02:00
niestandardowe polecenie za pomocą opcji < b > smartctl< / b > w pliku konfiguracyjnym.
2025-12-14 22:21:44 +01:00
< / p > < p > Nic nie jest modyfikowane.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec5-3" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
probe
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Wyświetla stan ZASILANIA wszystkich dysków w systemie.
2026-03-30 10:01:17 +02:00
< / p > < p > < b > Standby< / b > oznacza, że dysk się nie kręci. < b > Active< / b > oznacza,
2025-12-12 11:57:38 +01:00
że dysk się kręci.
2026-03-30 10:01:17 +02:00
< / p > < p > To polecenie używa narzędzia < b > smartctl< / b > i jest równoważne
uruchomieniu < b > smartctl -n standby -i< / b > na wszystkich urządzeniach.
2025-12-14 22:21:44 +01:00
< / p > < p > Jeśli Twoje urządzenia nie zostaną poprawnie wykryte automatycznie, możesz określić
2026-03-30 10:01:17 +02:00
niestandardowe polecenie za pomocą opcji < b > smartctl< / b > w pliku konfiguracyjnym.
2025-12-14 22:21:44 +01:00
< / p > < p > Nic nie jest modyfikowane.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec5-4" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
up
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Rozpędza wszystkie dyski macierzy.
< / p > < p > Możesz rozpędzić tylko określone dyski za pomocą opcji -d, --filter-disk.
< / p > < p > Rozpędzanie wszystkich dysków w tym samym czasie wymaga dużo energii.
2025-12-12 11:57:38 +01:00
Upewnij się, że Twój zasilacz jest w stanie to wytrzymać.
2025-12-14 22:21:44 +01:00
< / p > < p > Nic nie jest modyfikowane.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec5-5" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
down
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Zatrzymuje wszystkie dyski macierzy.
2026-03-30 10:01:17 +02:00
< / p > < p > To polecenie używa narzędzia < b > smartctl< / b > i jest równoważne
uruchomieniu < b > smartctl -s standby,now< / b > na wszystkich urządzeniach.
2025-12-14 22:21:44 +01:00
< / p > < p > Możesz zatrzymać tylko określone dyski za pomocą opcji -d, --filter-disk.
< / p > < p > Aby automatycznie zatrzymać dyski w przypadku błędu, możesz użyć
2025-12-12 11:57:38 +01:00
opcji -s, --spin-down-on-error z dowolnym innym poleceniem, co jest
2026-03-30 10:01:17 +02:00
równoważne ręcznemu uruchomieniu < b > down< / b > , gdy wystąpi błąd.
2025-12-14 22:21:44 +01:00
< / p > < p > Nic nie jest modyfikowane.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec5-6" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
diff
2026-03-30 10:01:17 +02:00
< / h2 >
< p > Wyświetla listę wszystkich plików zmodyfikowanych od ostatniej < b > sync< / b > , które
2025-12-12 11:57:38 +01:00
wymagają ponownego obliczenia danych parzystości.
2025-12-14 22:21:44 +01:00
< / p > < p > To polecenie nie sprawdza danych pliku, a jedynie znacznik czasu pliku,
2025-12-12 11:57:38 +01:00
rozmiar i inode.
2025-12-14 22:21:44 +01:00
< / p > < p > Po wyświetleniu listy wszystkich zmienionych plików, prezentowane jest
2025-12-12 11:57:38 +01:00
podsumowanie zmian, pogrupowane według:
2026-03-30 10:01:17 +02:00
< / p > < div class = "manual-tag-list" >
< div class = "manual-tag-entry" >
< div class = "manual-tag-name" >
2025-12-12 11:57:38 +01:00
equal
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-tag-description" >
2025-12-12 11:57:38 +01:00
Pliki niezmienione od wcześniej.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< div class = "manual-tag-entry" >
< div class = "manual-tag-name" >
2025-12-12 11:57:38 +01:00
added
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-tag-description" >
2025-12-12 11:57:38 +01:00
Pliki dodane, których wcześniej nie było.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< div class = "manual-tag-entry" >
< div class = "manual-tag-name" >
2025-12-12 11:57:38 +01:00
removed
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-tag-description" >
2025-12-12 11:57:38 +01:00
Pliki usunięte.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< div class = "manual-tag-entry" >
< div class = "manual-tag-name" >
2025-12-12 11:57:38 +01:00
updated
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-tag-description" >
2025-12-12 11:57:38 +01:00
Pliki o innym rozmiarze lub znaczniku czasu, co oznacza, że
zostały zmodyfikowane.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< div class = "manual-tag-entry" >
< div class = "manual-tag-name" >
2025-12-12 11:57:38 +01:00
moved
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-tag-description" >
2025-12-12 11:57:38 +01:00
Pliki przeniesione do innego katalogu na tym samym dysku.
Są one identyfikowane przez tę samą nazwę, rozmiar, znacznik czasu
i inode, ale inny katalog.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< div class = "manual-tag-entry" >
< div class = "manual-tag-name" >
2025-12-12 11:57:38 +01:00
copied
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-tag-description" >
Pliki skopiowane na ten sam lub inny dysk, gdzie
oryginalny plik nadal istnieje.
Są one identyfikowane przez posiadanie tej samej nazwy, rozmiaru
i znacznika czasu.
Jeśli podsekundowy znacznik czasu wynosi zero, pełna ścieżka
musi być zgodna, aby plik został zidentyfikowany, a nie
tylko nazwa.
< / div >
< / div >
< div class = "manual-tag-entry" >
< div class = "manual-tag-name" >
relocated
< / div > < div class = "manual-tag-description" >
Pliki przeniesione na ten sam lub inny dysk, gdzie
oryginał zniknął.
Są one identyfikowane przez posiadanie tej samej nazwy, rozmiaru
i znacznika czasu.
Jeśli podsekundowy znacznik czasu wynosi zero, pełna ścieżka
musi być zgodna, aby plik został zidentyfikowany.
W przeciwieństwie do plików 'moved' na tym samym dysku, pliki
relokowane mają inny i-węzeł.
< / div >
< / div >
< div class = "manual-tag-entry" >
< div class = "manual-tag-name" >
2025-12-12 11:57:38 +01:00
restored
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-tag-description" >
Pliki o innym i-węźle, ale pasującym katalogu,
nazwie, rozmiarze i znaczniku czasu.
Są to zazwyczaj pliki przywrócone po ich usunięciu.
< / div >
< / div >
< / div >
< p > Jeśli wymagana jest < b > sync< / b > , kod powrotu procesu wynosi 2, zamiast
2025-12-12 11:57:38 +01:00
domyślnego 0. Kod powrotu 1 jest używany dla ogólnego stanu błędu.
2025-12-14 22:21:44 +01:00
< / p > < p > Nic nie jest modyfikowane.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec5-7" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
sync
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Aktualizuje informacje o parzystości. Wszystkie zmodyfikowane pliki
2025-12-12 11:57:38 +01:00
w macierzy dysków są odczytywane, a odpowiednie dane parzystości
są aktualizowane.
2025-12-14 22:21:44 +01:00
< / p > < p > Możesz zatrzymać ten proces w dowolnym momencie, naciskając Ctrl+C,
2025-12-12 11:57:38 +01:00
bez utraty już wykonanej pracy.
2026-03-30 10:01:17 +02:00
Przy następnym uruchomieniu proces < b > sync< / b > wznowi się w miejscu, w którym
2025-12-12 11:57:38 +01:00
został przerwany.
2025-12-14 22:21:44 +01:00
< / p > < p > Jeśli podczas procesu zostaną znalezione ciche błędy lub błędy wejścia/wyjścia,
2025-12-12 11:57:38 +01:00
odpowiednie bloki zostaną oznaczone jako złe.
2025-12-14 22:21:44 +01:00
< / p > < p > Pliki są identyfikowane po ścieżce i/lub inode i sprawdzane
2025-12-12 11:57:38 +01:00
po rozmiarze i znaczniku czasu.
Jeśli rozmiar pliku lub znacznik czasu się różni, dane parzystości
są ponownie obliczane dla całego pliku.
Jeśli plik zostanie przeniesiony lub zmieniony na tym samym dysku, zachowując ten sam inode,
parzystość nie jest ponownie obliczana.
Jeśli plik zostanie przeniesiony na inny dysk, parzystość jest ponownie obliczana,
ale wcześniej obliczone informacje o haszu są zachowywane.
2026-03-30 10:01:17 +02:00
< / p > < p > Pliki < b > content< / b > i < b > parity< / b > są modyfikowane w razie potrzeby.
2025-12-12 11:57:38 +01:00
Pliki w macierzy NIE są modyfikowane.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec5-8" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
scrub
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Sprawdza macierz, szukając cichych błędów lub błędów wejścia/wyjścia w danych
2025-12-12 11:57:38 +01:00
i dyskach parzystości.
2025-12-14 22:21:44 +01:00
< / p > < p > Każde wywołanie sprawdza około 8% macierzy, z wyłączeniem
2025-12-12 11:57:38 +01:00
danych już sprawdzonych w ciągu ostatnich 10 dni.
Oznacza to, że sprawdzanie raz w tygodniu zapewnia sprawdzenie każdego bitu danych
przynajmniej raz na trzy miesiące.
2025-12-14 22:21:44 +01:00
< / p > < p > Możesz zdefiniować inny plan sprawdzania lub ilość za pomocą opcji -p, --plan,
2025-12-12 11:57:38 +01:00
która akceptuje:
bad - Sprawdza bloki oznaczone jako złe.
new - Sprawdza bloki właśnie zsynchronizowane, jeszcze niesprawdzone.
full - Sprawdza wszystko.
0-100 - Sprawdza określony procent bloków.
2025-12-14 22:21:44 +01:00
< / p > < p > Jeśli określisz wartość procentową, możesz również użyć opcji -o, --older-than,
2025-12-12 11:57:38 +01:00
aby zdefiniować, jak stary powinien być blok.
Najpierw sprawdzane są najstarsze bloki, co zapewnia optymalne sprawdzenie.
Jeśli chcesz sprawdzić tylko bloki właśnie zsynchronizowane, jeszcze niesprawdzone,
2026-03-30 10:01:17 +02:00
użyj opcji < b > -p new< / b > .
< / p > < p > Aby uzyskać szczegóły statusu sprawdzania, użyj polecenia < b > status< / b > .
2025-12-14 22:21:44 +01:00
< / p > < p > Dla każdego znalezionego cichego błędu lub błędu wejścia/wyjścia, odpowiednie bloki
2026-03-30 10:01:17 +02:00
są oznaczane jako złe w pliku < b > content< / b > .
Te złe bloki są wymienione w < b > status< / b > i mogą zostać naprawione za pomocą < b > fix -e< / b > .
2025-12-12 11:57:38 +01:00
Po naprawie, przy następnym sprawdzeniu, zostaną one ponownie sprawdzone, a jeśli okaże się,
że zostały poprawione, oznaczenie złego zostanie usunięte.
2026-03-30 10:01:17 +02:00
Aby sprawdzić tylko złe bloki, możesz użyć polecenia < b > scrub -p bad< / b > .
< / p > < p > Zaleca się uruchamianie < b > scrub< / b > tylko na zsynchronizowanej macierzy, aby uniknąć
2025-12-12 11:57:38 +01:00
zgłaszania błędów spowodowanych przez niezsynchronizowane dane. Błędy te są rozpoznawane
jako nie będące cichymi błędami, a bloki nie są oznaczane jako złe,
ale takie błędy są zgłaszane w wyniku polecenia.
2026-03-30 10:01:17 +02:00
< / p > < p > Plik < b > content< / b > jest modyfikowany w celu zaktualizowania czasu ostatniego sprawdzenia
2025-12-12 11:57:38 +01:00
dla każdego bloku i oznaczenia złych bloków.
2026-03-30 10:01:17 +02:00
Pliki < b > parity< / b > NIE są modyfikowane.
2025-12-12 11:57:38 +01:00
Pliki w macierzy NIE są modyfikowane.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec5-9" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
fix
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Naprawia wszystkie pliki i dane parzystości.
< / p > < p > Wszystkie pliki i dane parzystości są porównywane ze stanem migawki
2026-03-30 10:01:17 +02:00
zapisanym w ostatniej < b > sync< / b > .
2025-12-12 11:57:38 +01:00
Jeśli zostanie znaleziona różnica, jest ona przywracana do zapisanego stanu migawki.
2026-03-30 10:01:17 +02:00
< / p > < p > OSTRZEŻENIE! Polecenie < b > fix< / b > nie rozróżnia błędów od
2025-12-12 11:57:38 +01:00
celowych modyfikacji. Bezwarunkowo przywraca stan pliku
2026-03-30 10:01:17 +02:00
do ostatniej < b > sync< / b > .
2025-12-14 22:21:44 +01:00
< / p > < p > Jeśli nie określono żadnej innej opcji, przetwarzana jest cała macierz.
2025-12-12 11:57:38 +01:00
Użyj opcji filtra, aby wybrać podzbiór plików lub dysków do operacji.
2026-03-30 10:01:17 +02:00
< / p > < p > Aby naprawić tylko bloki oznaczone jako złe podczas < b > sync< / b > i < b > scrub< / b > ,
2025-12-12 11:57:38 +01:00
użyj opcji -e, --filter-error.
W przeciwieństwie do innych opcji filtra, ta stosuje poprawki tylko do plików, które są
2026-03-30 10:01:17 +02:00
niezmienione od ostatniej < b > sync< / b > .
2025-12-14 22:21:44 +01:00
< / p > < p > SnapRAID zmienia nazwy wszystkich plików, których nie można naprawić, dodając
2026-03-30 10:01:17 +02:00
rozszerzenie < b > .unrecoverable< / b > .
2025-12-14 22:21:44 +01:00
< / p > < p > Przed naprawą, cała macierz jest skanowana w celu znalezienia wszelkich plików przeniesionych
2026-03-30 10:01:17 +02:00
od ostatniej operacji < b > sync< / b > .
2025-12-12 11:57:38 +01:00
Pliki te są identyfikowane na podstawie ich znacznika czasu, ignorując ich nazwę
i katalog, i są używane w procesie odzyskiwania, jeśli to konieczne.
Jeśli przeniosłeś niektóre z nich poza macierz, możesz użyć opcji -i, --import,
aby określić dodatkowe katalogi do skanowania.
2025-12-14 22:21:44 +01:00
< / p > < p > Pliki są identyfikowane tylko po ścieżce, a nie po inode.
2026-03-30 10:01:17 +02:00
< / p > < p > Plik < b > content< / b > NIE jest modyfikowany.
Pliki < b > parity< / b > są modyfikowane w razie potrzeby.
2025-12-12 11:57:38 +01:00
Pliki w macierzy są modyfikowane w razie potrzeby.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec5-10" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
check
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Weryfikuje wszystkie pliki i dane parzystości.
2026-03-30 10:01:17 +02:00
< / p > < p > Działa jak < b > fix< / b > , ale tylko symuluje odzyskiwanie i żadne zmiany
2025-12-12 11:57:38 +01:00
nie są zapisywane w macierzy.
2025-12-14 22:21:44 +01:00
< / p > < p > To polecenie jest przeznaczone głównie do ręcznej weryfikacji,
2025-12-12 11:57:38 +01:00
takiej jak po procesie odzyskiwania lub w innych specjalnych warunkach.
2026-03-30 10:01:17 +02:00
Do okresowych i zaplanowanych sprawdzeń użyj < b > scrub< / b > .
2025-12-14 22:21:44 +01:00
< / p > < p > Jeśli użyjesz opcji -a, --audit-only, sprawdzane są tylko
2025-12-12 11:57:38 +01:00
dane pliku, a dane parzystości są ignorowane, co zapewnia
szybsze działanie.
2025-12-14 22:21:44 +01:00
< / p > < p > Pliki są identyfikowane tylko po ścieżce, a nie po inode.
< / p > < p > Nic nie jest modyfikowane.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec5-11" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
list
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Wyświetla listę wszystkich plików zawartych w macierzy w momencie
2026-03-30 10:01:17 +02:00
ostatniej < b > sync< / b > .
2025-12-14 22:21:44 +01:00
< / p > < p > Z -v lub --verbose, wyświetlany jest również czas z dokładnością do podsekundy.
< / p > < p > Nic nie jest modyfikowane.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec5-12" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
dup
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Wyświetla listę wszystkich zduplikowanych plików. Dwa pliki są uważane za równe, jeśli ich
2025-12-12 11:57:38 +01:00
hasze pasują. Dane pliku nie są odczytywane; używane są tylko
wcześniej obliczone hasze.
2025-12-14 22:21:44 +01:00
< / p > < p > Nic nie jest modyfikowane.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec5-13" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
pool
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Tworzy lub aktualizuje wirtualny widok wszystkich
2026-03-30 10:01:17 +02:00
plików w Twojej macierzy dysków w katalogu < b > pooling< / b > .
2025-12-14 22:21:44 +01:00
< / p > < p > Pliki nie są kopiowane, ale linkowane za pomocą
2025-12-12 11:57:38 +01:00
dowiązań symbolicznych.
2025-12-14 22:21:44 +01:00
< / p > < p > Podczas aktualizacji, wszystkie istniejące dowiązania symboliczne i puste
2025-12-12 11:57:38 +01:00
podkatalogi są usuwane i zastępowane nowym
widokiem macierzy. Wszelkie inne zwykłe pliki pozostają na swoim miejscu.
2025-12-14 22:21:44 +01:00
< / p > < p > Nic nie jest modyfikowane poza katalogiem puli.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec5-14" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
devices
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Wyświetla urządzenia niskiego poziomu używane przez macierz.
< / p > < p > To polecenie wyświetla skojarzenia urządzeń w macierzy
2025-12-12 11:57:38 +01:00
i jest przeznaczone głównie jako interfejs skryptowy.
2025-12-14 22:21:44 +01:00
< / p > < p > Pierwsze dwie kolumny to identyfikator i ścieżka urządzenia niskiego poziomu.
2025-12-12 11:57:38 +01:00
Następne dwie kolumny to identyfikator i ścieżka urządzenia wysokiego poziomu.
Ostatnia kolumna to nazwa dysku w macierzy.
2025-12-14 22:21:44 +01:00
< / p > < p > W większości przypadków masz jedno urządzenie niskiego poziomu dla każdego dysku w
2025-12-12 11:57:38 +01:00
macierzy, ale w niektórych bardziej złożonych konfiguracjach możesz mieć wiele
urządzeń niskiego poziomu używanych przez pojedynczy dysk w macierzy.
2025-12-14 22:21:44 +01:00
< / p > < p > Nic nie jest modyfikowane.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec5-15" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
touch
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Ustawia arbitralny znacznik czasu z dokładnością do podsekundy dla wszystkich plików,
2025-12-12 11:57:38 +01:00
które mają go ustawiony na zero.
2025-12-14 22:21:44 +01:00
< / p > < p > Poprawia to zdolność SnapRAID do rozpoznawania przeniesionych
2025-12-12 11:57:38 +01:00
i skopiowanych plików, ponieważ sprawia, że znacznik czasu jest prawie unikalny,
redukując możliwe duplikaty.
2025-12-14 22:21:44 +01:00
< / p > < p > Dokładniej, jeśli znacznik czasu z dokładnością do podsekundy nie jest zerowy,
2025-12-12 11:57:38 +01:00
przeniesiony lub skopiowany plik jest identyfikowany jako taki, jeśli pasuje do
nazwy, rozmiaru i znacznika czasu. Jeśli znacznik czasu z dokładnością do podsekundy
jest zerowy, jest uważany za kopię tylko wtedy, gdy pasują pełna ścieżka,
rozmiar i znacznik czasu.
2025-12-14 22:21:44 +01:00
< / p > < p > Znacznik czasu z dokładnością do sekundy nie jest modyfikowany,
2025-12-12 11:57:38 +01:00
więc wszystkie daty i czasy Twoich plików zostaną zachowane.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec5-16" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
rehash
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Planuje ponowne haszowanie całej macierzy.
< / p > < p > To polecenie zmienia używany rodzaj hasza, zazwyczaj podczas aktualizacji
2025-12-12 11:57:38 +01:00
z systemu 32-bitowego na 64-bitowy, aby przełączyć się z
MurmurHash3 na szybszy SpookyHash.
2025-12-14 22:21:44 +01:00
< / p > < p > Jeśli używasz już optymalnego hasza, to polecenie
2025-12-12 11:57:38 +01:00
nic nie robi i informuje Cię, że nie jest potrzebne żadne działanie.
2025-12-14 22:21:44 +01:00
< / p > < p > Ponowne haszowanie nie jest wykonywane natychmiast, ale odbywa się
2026-03-30 10:01:17 +02:00
stopniowo podczas < b > sync< / b > i < b > scrub< / b > .
< / p > < p > Możesz sprawdzić stan ponownego haszowania za pomocą < b > status< / b > .
2025-12-14 22:21:44 +01:00
< / p > < p > Podczas ponownego haszowania SnapRAID zachowuje pełną funkcjonalność,
2026-03-30 10:01:17 +02:00
z jedynym wyjątkiem, że < b > dup< / b > nie może wykryć zduplikowanych
2025-12-12 11:57:38 +01:00
plików używających innego hasza.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec5-17" class = "manual-title-level-2" >
locate
2025-12-12 11:57:38 +01:00
< / h2 >
2026-03-30 10:01:17 +02:00
< p > Lokalizuje pliki zapisane na dyskach parzystości. Dla każdego dopasowanego pliku
wypisuje jego lokalizację w pliku parzystości oraz liczbę zajmowanych przez
niego fragmentów.
< / p > < p > Możesz użyć opcji -t, --tail, aby ograniczyć operację do plików zajmujących
określoną końcową część parzystości.
< / p > < p > Jeśli chcesz dokonać realokacji tych plików, możesz użyć opcji
-W, --force-realloc-tail.
Pamiętaj, że takie pliki nie będą chronione przez parzystość podczas procesu
realokacji.
< / p > < / div >
< / div >
< div class = "manual-section-level-1" >
< h1 id = "sec6" class = "manual-title-level-1" >
Options
< / h1 >
2025-12-14 22:21:44 +01:00
< p > SnapRAID udostępnia następujące opcje:
2026-03-30 10:01:17 +02:00
< / p > < div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-c, --conf CONFIG
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
2025-12-12 11:57:38 +01:00
Wybiera plik konfiguracyjny do użycia. Jeśli nie określono, w systemie Unix
2026-03-30 10:01:17 +02:00
używa pliku < b > /usr/local/etc/snapraid.conf< / b > , jeśli istnieje,
w przeciwnym razie < b > /etc/snapraid.conf< / b > .
W systemie Windows używa pliku < b > snapraid.conf< / b > w tym samym
katalogu co < b > snapraid.exe< / b > .
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-f, --filter PATTERN
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
Filtruje pliki do przetworzenia w < b > check< / b > i < b > fix< / b > .
2025-12-12 11:57:38 +01:00
Przetwarzane są tylko pliki pasujące do określonego wzorca.
Ta opcja może być używana wielokrotnie.
Zobacz sekcję PATTERN, aby uzyskać więcej szczegółów na temat
specyfikacji wzorców.
W systemie Unix upewnij się, że znaki globbing są cytowane, jeśli są używane.
2026-03-30 10:01:17 +02:00
Ta opcja może być używana tylko z < b > check< / b > i < b > fix< / b > .
Nie może być używana z < b > sync< / b > i < b > scrub< / b > , ponieważ zawsze
2025-12-12 11:57:38 +01:00
przetwarzają całą macierz.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-d, --filter-disk NAME
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
Filtruje dyski do przetworzenia w < b > check< / b > , < b > fix< / b > , < b > up< / b > i < b > down< / b > .
2025-12-12 11:57:38 +01:00
Musisz określić nazwę dysku zdefiniowaną w pliku konfiguracyjnym.
2026-03-30 10:01:17 +02:00
Możesz również określić dyski parzystości za pomocą nazw: < b > parity< / b > , < b > 2-parity< / b > ,
< b > 3-parity< / b > , itp., aby ograniczyć operacje do określonego dysku parzystości.
2025-12-12 11:57:38 +01:00
Jeśli połączysz wiele opcji --filter, --filter-disk i --filter-missing,
wybrane zostaną tylko pliki pasujące do wszystkich filtrów.
Ta opcja może być używana wielokrotnie.
2026-03-30 10:01:17 +02:00
Ta opcja może być używana tylko z < b > check< / b > , < b > fix< / b > , < b > up< / b > i < b > down< / b > .
Nie może być używana z < b > sync< / b > i < b > scrub< / b > , ponieważ zawsze
2025-12-12 11:57:38 +01:00
przetwarzają całą macierz.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-m, --filter-missing
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
Filtruje pliki do przetworzenia w < b > check< / b > i < b > fix< / b > .
2025-12-12 11:57:38 +01:00
Przetwarzane są tylko pliki brakujące lub usunięte z macierzy.
2026-03-30 10:01:17 +02:00
Użyte z < b > fix< / b > , działa to jako polecenie < b > undelete< / b > .
2025-12-12 11:57:38 +01:00
Jeśli połączysz wiele opcji --filter, --filter-disk i --filter-missing,
wybrane zostaną tylko pliki pasujące do wszystkich filtrów.
2026-03-30 10:01:17 +02:00
Ta opcja może być używana tylko z < b > check< / b > i < b > fix< / b > .
Nie może być używana z < b > sync< / b > i < b > scrub< / b > , ponieważ zawsze
2025-12-12 11:57:38 +01:00
przetwarzają całą macierz.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-e, --filter-error
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
Przetwarza pliki z błędami w < b > check< / b > i < b > fix< / b > .
2025-12-12 11:57:38 +01:00
Przetwarza tylko pliki, które mają bloki oznaczone cichymi
2026-03-30 10:01:17 +02:00
błędami lub błędami wejścia/wyjścia podczas < b > sync< / b > i < b > scrub< / b > , jak wymieniono w < b > status< / b > .
Ta opcja może być używana tylko z < b > check< / b > i < b > fix< / b > .
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-p, --plan PERC|bad|new|full
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
2025-12-12 11:57:38 +01:00
Wybiera plan sprawdzania. Jeśli PERC jest wartością numeryczną od 0 do 100,
jest interpretowany jako procent bloków do sprawdzenia.
Zamiast wartości procentowej możesz określić plan:
2026-03-30 10:01:17 +02:00
< b > bad< / b > sprawdza złe bloki, < b > new< / b > sprawdza bloki jeszcze niesprawdzone,
a < b > full< / b > sprawdza wszystko.
Ta opcja może być używana tylko z < b > scrub< / b > .
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-o, --older-than DAYS
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
Wybiera najstarszą część macierzy do przetworzenia w < b > scrub< / b > .
2025-12-12 11:57:38 +01:00
DAYS to minimalny wiek w dniach dla bloku, który ma być sprawdzony;
domyślnie jest to 10.
Bloki oznaczone jako złe są zawsze sprawdzane niezależnie od tej opcji.
2026-03-30 10:01:17 +02:00
Ta opcja może być używana tylko z < b > scrub< / b > .
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-a, --audit-only
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
W < b > check< / b > , weryfikuje hasz plików bez
2025-12-12 11:57:38 +01:00
sprawdzania danych parzystości.
Jeśli interesuje Cię tylko sprawdzenie danych pliku, ta
opcja może znacznie przyspieszyć proces sprawdzania.
2026-03-30 10:01:17 +02:00
Ta opcja może być używana tylko z < b > check< / b > .
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-h, --pre-hash
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
W < b > sync< / b > , uruchamia wstępną fazę haszowania wszystkich nowych danych
2025-12-12 11:57:38 +01:00
w celu dodatkowej weryfikacji przed obliczeniem parzystości.
2026-03-30 10:01:17 +02:00
Zazwyczaj w < b > sync< / b > nie jest wykonywane wstępne haszowanie, a nowe
2025-12-12 11:57:38 +01:00
dane są haszowane tuż przed obliczeniem parzystości, gdy są odczytywane
po raz pierwszy.
Ten proces zachodzi, gdy system jest pod
dużym obciążeniem, wszystkie dyski się kręcą, a CPU jest zajęte.
Jest to ekstremalny warunek dla maszyny, a jeśli ma
ukryty problem sprzętowy, ciche błędy mogą pozostać niewykryte,
ponieważ dane nie są jeszcze haszowane.
2026-03-30 10:01:17 +02:00
Aby uniknąć tego ryzyka, możesz włączyć tryb < b > pre-hash< / b > , aby
2025-12-12 11:57:38 +01:00
wszystkie dane były odczytywane dwukrotnie w celu zapewnienia ich integralności.
Ta opcja weryfikuje również pliki przeniesione wewnątrz macierzy,
aby upewnić się, że operacja przeniesienia zakończyła się pomyślnie, i, jeśli to konieczne,
umożliwia uruchomienie operacji fix przed kontynuowaniem.
2026-03-30 10:01:17 +02:00
Ta opcja może być używana tylko z < b > sync< / b > .
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-i, --import DIR
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
2025-12-12 11:57:38 +01:00
Importuje z określonego katalogu wszelkie pliki usunięte
2026-03-30 10:01:17 +02:00
z macierzy po ostatniej < b > sync< / b > .
Jeśli nadal masz takie pliki, mogą być użyte przez < b > check< / b >
i < b > fix< / b > , aby poprawić proces odzyskiwania.
2025-12-12 11:57:38 +01:00
Pliki są odczytywane, w tym w podkatalogach, i są
identyfikowane niezależnie od ich nazwy.
2026-03-30 10:01:17 +02:00
Ta opcja może być używana tylko z < b > check< / b > i < b > fix< / b > .
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-s, --spin-down-on-error
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
2025-12-12 11:57:38 +01:00
W przypadku każdego błędu, zatrzymuje wszystkie zarządzane dyski przed wyjściem
z niezerowym kodem statusu. Zapobiega to pozostawaniu dysków
aktywnymi i kręcącymi się po przerwanej operacji,
pomagając uniknąć niepotrzebnego gromadzenia się ciepła i zużycia
energii. Użyj tej opcji, aby upewnić się, że dyski są bezpiecznie
zatrzymane, nawet gdy polecenie zakończy się niepowodzeniem.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-w, --bw-limit RATE
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
2025-12-12 11:57:38 +01:00
Stosuje globalne ograniczenie przepustowości dla wszystkich dysków. RATE to
liczba bajtów na sekundę. Możesz określić mnożnik,
taki jak K, M lub G (np. --bw-limit 1G).
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
-t, --tail ROZMIAR
< / div > < div class = "manual-option-description" >
Ogranicza listę plików do tych, które nie używają więcej niż określony
końcowy rozmiar dysków parzystości.
Możesz użyć mnożników takich jak K, M, G lub T (np. --tail 1G).
Opcja ta jest ważna tylko wtedy, gdy jest używana wraz z poleceniem
< b > locate< / b > .
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-A, --stats
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
2025-12-12 11:57:38 +01:00
Włącza rozszerzony widok statusu, który pokazuje dodatkowe informacje.
Ekran wyświetla dwa wykresy:
Pierwszy wykres pokazuje liczbę buforowanych pasków dla każdego
dysku, wraz ze ścieżką pliku, do którego aktualnie uzyskuje się dostęp
na tym dysku. Zazwyczaj najwolniejszy dysk nie będzie miał dostępnego
bufora, co determinuje maksymalną osiągalną przepustowość.
Drugi wykres pokazuje procent czasu spędzonego na czekaniu
w ciągu ostatnich 100 sekund. Oczekuje się, że najwolniejszy dysk
spowoduje większość czasu oczekiwania, podczas gdy inne dyski powinny mieć
niewielki lub żaden czas oczekiwania, ponieważ mogą używać swoich buforowanych pasków.
Ten wykres pokazuje również czas spędzony na czekaniu na obliczenia
hasza i obliczenia RAID.
Wszystkie obliczenia są wykonywane równolegle z operacjami dyskowymi.
Dlatego, dopóki istnieje mierzalny czas oczekiwania dla
przynajmniej jednego dysku, oznacza to, że CPU jest wystarczająco szybkie, aby
nadążyć za obciążeniem.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-Z, --force-zero
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
2025-12-12 11:57:38 +01:00
Wymusza niebezpieczną operację synchronizacji pliku o zerowym
rozmiarze, który wcześniej był niezerowy.
Jeśli SnapRAID wykryje taki stan, zatrzymuje przetwarzanie,
chyba że określisz tę opcję.
Pozwala to łatwo wykryć, kiedy po awarii systemu
niektóre dostępne pliki zostały obcięte.
Jest to możliwy stan w systemie Linux z systemami plików ext3/ext4.
2026-03-30 10:01:17 +02:00
Ta opcja może być używana tylko z < b > sync< / b > .
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-E, --force-empty
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
2025-12-12 11:57:38 +01:00
Wymusza niebezpieczną operację synchronizacji dysku z brakującymi
wszystkimi oryginalnymi plikami.
Jeśli SnapRAID wykryje, że brakuje wszystkich plików pierwotnie obecnych
na dysku lub zostały przepisane, zatrzymuje przetwarzanie,
chyba że określisz tę opcję.
Pozwala to łatwo wykryć, kiedy system plików danych nie jest
zamontowany.
2026-03-30 10:01:17 +02:00
Ta opcja może być używana tylko z < b > sync< / b > .
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-U, --force-uuid
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
2025-12-12 11:57:38 +01:00
Wymusza niebezpieczną operację synchronizacji, sprawdzania i naprawiania
z dyskami, które zmieniły swój UUID.
Jeśli SnapRAID wykryje, że niektóre dyski zmieniły UUID,
zatrzymuje przetwarzanie, chyba że określisz tę opcję.
Pozwala to wykryć, kiedy Twoje dyski są zamontowane w
niewłaściwych punktach montowania.
Dozwolona jest jednak pojedyncza zmiana UUID z
pojedynczą parzystością i więcej z wielokrotną parzystością, ponieważ jest to
normalny przypadek podczas wymiany dysków po odzyskaniu.
2026-03-30 10:01:17 +02:00
Ta opcja może być używana tylko z < b > sync< / b > , < b > check< / b > lub
< b > fix< / b > .
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-D, --force-device
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
2025-12-12 11:57:38 +01:00
Wymusza niebezpieczną operację naprawiania z niedostępnymi dyskami
lub z dyskami na tym samym urządzeniu fizycznym.
Na przykład, jeśli straciłeś dwa dyski danych i masz zapasowy dysk do odzyskania
tylko pierwszego, możesz zignorować drugi niedostępny dysk.
Lub, jeśli chcesz odzyskać dysk w wolnym miejscu pozostawionym na
już używanym dysku, współdzielącym to samo urządzenie fizyczne.
2026-03-30 10:01:17 +02:00
Ta opcja może być używana tylko z < b > fix< / b > .
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-N, --force-nocopy
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
W < b > sync< / b > , < b > check< / b > i < b > fix< / b > , wyłącza heurystykę wykrywania kopii.
2025-12-12 11:57:38 +01:00
Bez tej opcji SnapRAID zakłada, że pliki o tych samych
atrybutach, takich jak nazwa, rozmiar i znacznik czasu, są kopiami z tymi
samymi danymi.
Pozwala to na identyfikację skopiowanych lub przeniesionych plików z jednego dysku
na inny i ponowne wykorzystanie już obliczonych informacji o haszu
w celu wykrycia cichych błędów lub odzyskania brakujących plików.
W niektórych rzadkich przypadkach to zachowanie może prowadzić do fałszywych alarmów
lub spowolnienia procesu z powodu wielu weryfikacji hasza, a ta
opcja pozwala rozwiązać takie problemy.
2026-03-30 10:01:17 +02:00
Ta opcja może być używana tylko z < b > sync< / b > , < b > check< / b > i < b > fix< / b > .
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-F, --force-full
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
W < b > sync< / b > , wymusza pełne ponowne obliczenie parzystości.
2025-12-12 11:57:38 +01:00
Ta opcja może być używana, gdy dodajesz nowy poziom parzystości lub jeśli
powróciłeś do starego pliku zawartości, używając nowszych danych parzystości.
Zamiast ponownego tworzenia parzystości od podstaw, pozwala to
na ponowne wykorzystanie haszy obecnych w pliku zawartości do walidacji danych
2026-03-30 10:01:17 +02:00
i utrzymania ochrony danych podczas procesu < b > sync< / b > za pomocą
2025-12-12 11:57:38 +01:00
istniejących danych parzystości.
2026-03-30 10:01:17 +02:00
Ta opcja może być używana tylko z < b > sync< / b > .
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-R, --force-realloc
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
W < b > sync< / b > , wymusza pełną realokację plików i przebudowę parzystości.
2025-12-12 11:57:38 +01:00
Ta opcja może być używana do całkowitej realokacji wszystkich plików,
usuwając fragmentację, jednocześnie ponownie wykorzystując hasze obecne w pliku zawartości
do walidacji danych.
2026-03-30 10:01:17 +02:00
Ta opcja może być używana tylko z < b > sync< / b > .
2025-12-12 11:57:38 +01:00
OSTRZEŻENIE! Ta opcja jest tylko dla ekspertów i jest wysoce
zalecane, aby jej nie używać.
2026-03-30 10:01:17 +02:00
NIE MASZ ochrony danych podczas operacji < b > sync< / b > .
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
-W, --force-realloc-tail ROZMIAR
< / div > < div class = "manual-option-description" >
Działa jak -R, --force-realloc, ale ogranicza się do określonej części
końcowej (ostatnie ROZMIAR bajtów) każdego pliku parzystości.
Wymusza realokację (przeniesienie) wszelkich fragmentów/bloków plików
obecnie przechowywanych w tej sekcji końcowej, pozwalając na ich
umieszczenie w dowolnym miejscu w pliku (plikach) parzystości, gdzie
dostępne jest wolne miejsce (w tym w istniejących lukach).
Głównym celem tej opcji jest zmniejszenie rozmiaru pliku parzystości
na dysku.
Jeśli realokacja pomyślnie wyczyści całą sekcję końcową (nie pozostaną
żadne bloki korzystające z niej), plik parzystości zostanie przycięty,
odzyskując nieużywane miejsce na końcu.
Możesz użyć mnożników takich jak K, M, G lub T (np.
--force-realloc-tail 1G).
Możesz użyć locate -t, --tail, aby wcześniej poznać pliki, których
będzie to dotyczyć.
OSTRZEŻENIE!
Ta opcja jest przeznaczona wyłącznie dla ekspertów i zdecydowanie
zaleca się jej nie używać.
Podczas operacji < b > sync< / b > pliki, których to dotyczy, NIE mają ochrony
danych.
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-l, --log FILE
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
2025-12-12 11:57:38 +01:00
Zapisuje szczegółowy log do określonego pliku.
Jeśli ta opcja nie jest określona, nieoczekiwane błędy są drukowane
na ekranie, potencjalnie prowadząc do nadmiernego wyjścia w przypadku
wielu błędów. Gdy -l, --log jest określone, tylko
krytyczne błędy, które powodują zatrzymanie SnapRAID, są drukowane
na ekranie.
2026-03-30 10:01:17 +02:00
Jeśli ścieżka zaczyna się od < b > > > < / b > , plik jest otwierany
w trybie dołączania. Wystąpienia < b > %D< / b > i < b > %T< / b > w nazwie są
2025-12-12 11:57:38 +01:00
zastępowane datą i czasem w formacie RRRRMMDD i
GGMMSS. W plikach wsadowych Windows musisz podwoić
2026-03-30 10:01:17 +02:00
znak < b > %< / b > , np. result-%%D.log. Aby użyć < b > > > < / b > , musisz
ujęć nazwę w cudzysłów, np. < b > "> > result.log"< / b > .
2025-12-12 11:57:38 +01:00
Aby wyprowadzić log do standardowego wyjścia lub standardowego błędu,
2026-03-30 10:01:17 +02:00
możesz użyć odpowiednio < b > "> & 1"< / b > i < b > "> & 2"< / b > .
2025-12-12 11:57:38 +01:00
Opisy tagów logu znajdziesz w pliku snapraid_log.txt lub na stronie podręcznika.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-L, --error-limit NUMBER
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
2025-12-12 11:57:38 +01:00
Ustawia nowy limit błędów przed zatrzymaniem wykonania.
Domyślnie SnapRAID zatrzymuje się, jeśli napotka więcej niż 100
błędów wejścia/wyjścia, co wskazuje, że dysk prawdopodobnie ulega awarii.
2026-03-30 10:01:17 +02:00
Ta opcja dotyczy < b > sync< / b > i < b > scrub< / b > , które mogą
2025-12-12 11:57:38 +01:00
kontynuować po pierwszym zestawie błędów dysku, aby spróbować
ukończyć swoje operacje.
2026-03-30 10:01:17 +02:00
Jednak < b > check< / b > i < b > fix< / b > zawsze zatrzymują się przy pierwszym błędzie.
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-S, --start BLKSTART
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
2025-12-12 11:57:38 +01:00
Zaczyna przetwarzanie od określonego
numeru bloku. Może to być przydatne do ponownej próby sprawdzenia
lub naprawy określonych bloków w przypadku uszkodzonego dysku.
Ta opcja jest przeznaczona głównie do zaawansowanego ręcznego odzyskiwania.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-B, --count BLKCOUNT
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
2025-12-12 11:57:38 +01:00
Przetwarza tylko określoną liczbę bloków.
Ta opcja jest przeznaczona głównie do zaawansowanego ręcznego odzyskiwania.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-C, --gen-conf CONTENT
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
2025-12-12 11:57:38 +01:00
Generuje atrapę pliku konfiguracyjnego z istniejącego
pliku zawartości.
Plik konfiguracyjny jest zapisywany na standardowe wyjście
i nie nadpisuje istniejącego.
Ten plik konfiguracyjny zawiera również informacje
potrzebne do rekonstrukcji punktów montowania dysków na wypadek
utraty całego systemu.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-v, --verbose
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
2025-12-12 11:57:38 +01:00
Wyświetla więcej informacji na ekranie.
Jeśli określono raz, drukuje wykluczone pliki
i dodatkowe statystyki.
Ta opcja nie ma wpływu na pliki logów.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-q, --quiet
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
2025-12-12 11:57:38 +01:00
Wyświetla mniej informacji na ekranie.
Jeśli określono raz, usuwa pasek postępu; dwa razy,
bieżące operacje; trzy razy, komunikaty informacyjne; cztery razy,
komunikaty statusu.
Krytyczne błędy są zawsze drukowane na ekranie.
Ta opcja nie ma wpływu na pliki logów.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-H, --help
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
2025-12-12 11:57:38 +01:00
Wyświetla krótki ekran pomocy.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
-V, --version
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
2025-12-12 11:57:38 +01:00
Wyświetla wersję programu.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< / div >
< / div >
< div class = "manual-section-level-1" >
< h1 id = "sec7" class = "manual-title-level-1" >
2025-12-12 11:57:38 +01:00
Configuration
2026-03-30 10:01:17 +02:00
< / h1 >
2025-12-14 22:21:44 +01:00
< p > SnapRAID wymaga pliku konfiguracyjnego, aby wiedzieć, gdzie znajduje się Twoja macierz
2025-12-12 11:57:38 +01:00
dysków i gdzie przechowywać informacje o parzystości.
2026-03-30 10:01:17 +02:00
< / p > < p > W systemie Unix używa pliku < b > /usr/local/etc/snapraid.conf< / b > , jeśli istnieje,
w przeciwnym razie < b > /etc/snapraid.conf< / b > .
W systemie Windows używa pliku < b > snapraid.conf< / b > w tym samym
katalogu co < b > snapraid.exe< / b > .
2025-12-14 22:21:44 +01:00
< / p > < p > Musi zawierać następujące opcje (uwzględniające wielkość liter):
2026-03-30 10:01:17 +02:00
< / p > < div class = "manual-section-level-2" >
< h2 id = "sec7-1" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
parity FILE [,FILE] ...
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Definiuje pliki do użycia do przechowywania informacji o parzystości.
2025-12-12 11:57:38 +01:00
Parzystość umożliwia ochronę przed awarią pojedynczego dysku,
podobnie jak w RAID5.
2025-12-14 22:21:44 +01:00
< / p > < p > Możesz określić wiele plików, które muszą znajdować się na różnych dyskach.
2025-12-12 11:57:38 +01:00
Gdy plik nie może już rosnąć, używany jest następny.
Całkowita dostępna przestrzeń musi być co najmniej tak duża jak największy dysk danych w
macierzy.
2025-12-14 22:21:44 +01:00
< / p > < p > Możesz dodać dodatkowe pliki parzystości później, ale nie możesz
2025-12-12 11:57:38 +01:00
ich zmieniać kolejności ani usuwać.
2025-12-14 22:21:44 +01:00
< / p > < p > Trzymanie dysków parzystości zarezerwowanych dla parzystości zapewnia, że
2025-12-12 11:57:38 +01:00
nie ulegną fragmentacji, co poprawia wydajność.
2025-12-14 22:21:44 +01:00
< / p > < p > W systemie Windows 256 MB jest pozostawione niewykorzystane na każdym dysku, aby uniknąć
2025-12-12 11:57:38 +01:00
ostrzeżenia o pełnych dyskach.
2025-12-14 22:21:44 +01:00
< / p > < p > Ta opcja jest obowiązkowa i może być używana tylko raz.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec7-2" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
(2,3,4,5,6)-parity FILE [,FILE] ...
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Definiuje pliki do użycia do przechowywania dodatkowych informacji o parzystości.
< / p > < p > Dla każdego określonego poziomu parzystości włączany jest jeden dodatkowy
2025-12-12 11:57:38 +01:00
poziom ochrony:
2025-12-14 22:21:44 +01:00
< / p > < ul >
2025-12-12 11:57:38 +01:00
< li >
2-parity włącza podwójną parzystość RAID6.
< / li >
< li >
3-parity włącza potrójną parzystość.
< / li >
< li >
4-parity włącza poczwórną (cztery) parzystość.
< / li >
< li >
5-parity włącza pięciokrotną (pięć) parzystość.
< / li >
< li >
6-parity włącza sześciokrotną (sześć) parzystość.
< / li >
< / ul >
2025-12-14 22:21:44 +01:00
< p > Każdy poziom parzystości wymaga obecności wszystkich poprzednich poziomów parzystości.
2026-03-30 10:01:17 +02:00
< / p > < p > Obowiązują te same uwagi, co dla opcji < b > parity< / b > .
2025-12-14 22:21:44 +01:00
< / p > < p > Te opcje są opcjonalne i mogą być używane tylko raz.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec7-3" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
z-parity FILE [,FILE] ...
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Definiuje alternatywny plik i format do przechowywania potrójnej parzystości.
2026-03-30 10:01:17 +02:00
< / p > < p > Ta opcja jest alternatywą dla < b > 3-parity< / b > , przeznaczoną głównie dla
2025-12-12 11:57:38 +01:00
procesorów niskiej klasy, takich jak ARM lub AMD Phenom, Athlon i Opteron,
które nie obsługują zestawu instrukcji SSSE3. W takich przypadkach zapewnia
lepszą wydajność.
2025-12-14 22:21:44 +01:00
< / p > < p > Ten format jest podobny, ale szybszy niż ten używany przez ZFS RAIDZ3.
2025-12-12 11:57:38 +01:00
Podobnie jak ZFS, nie działa powyżej potrójnej parzystości.
2026-03-30 10:01:17 +02:00
< / p > < p > Podczas używania < b > 3-parity< / b > zostaniesz ostrzeżony, jeśli zaleca się użycie
formatu < b > z-parity< / b > w celu poprawy wydajności.
2025-12-14 22:21:44 +01:00
< / p > < p > Możliwa jest konwersja z jednego formatu na inny poprzez dostosowanie
2025-12-12 11:57:38 +01:00
pliku konfiguracyjnego z pożądanym plikiem z-parity lub 3-parity
2026-03-30 10:01:17 +02:00
i użycie < b > fix< / b > do jego ponownego utworzenia.
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec7-4" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
content FILE
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Definiuje plik do użycia do przechowywania listy i sum kontrolnych wszystkich
2025-12-12 11:57:38 +01:00
plików obecnych w Twojej macierzy dysków.
2025-12-14 22:21:44 +01:00
< / p > < p > Może być umieszczony na dysku używanym do danych, parzystości lub
2025-12-12 11:57:38 +01:00
każdym innym dostępnym dysku.
Jeśli użyjesz dysku danych, ten plik jest automatycznie wykluczony
2026-03-30 10:01:17 +02:00
z procesu < b > sync< / b > .
2025-12-14 22:21:44 +01:00
< / p > < p > Ta opcja jest obowiązkowa i może być używana wielokrotnie do zapisania
2025-12-12 11:57:38 +01:00
wielu kopii tego samego pliku.
2025-12-14 22:21:44 +01:00
< / p > < p > Musisz przechowywać co najmniej jedną kopię dla każdego używanego dysku parzystości
2025-12-12 11:57:38 +01:00
plus jeden. Używanie dodatkowych kopii nie szkodzi.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec7-5" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
data NAME DIR
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Definiuje nazwę i punkt montowania dysków danych w
2025-12-12 11:57:38 +01:00
macierzy. NAME służy do identyfikacji dysku i musi
być unikalna. DIR to punkt montowania dysku w
systemie plików.
2025-12-14 22:21:44 +01:00
< / p > < p > Możesz zmieniać punkt montowania w razie potrzeby, o ile
2025-12-12 11:57:38 +01:00
zachowasz stałą nazwę NAME.
2025-12-14 22:21:44 +01:00
< / p > < p > Powinieneś użyć jednej opcji dla każdego dysku danych w macierzy.
< / p > < p > Możesz później zmienić nazwę dysku, zmieniając bezpośrednio nazwę NAME
2026-03-30 10:01:17 +02:00
w pliku konfiguracyjnym, a następnie uruchamiając polecenie < b > sync< / b > .
2025-12-12 11:57:38 +01:00
W przypadku zmiany nazwy, skojarzenie odbywa się za pomocą zapisanego
UUID dysków.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec7-6" class = "manual-title-level-2" >
extra NAME DIR
< / h2 >
< p > Definiuje nazwę i punkt montowania dodatkowych dysków do
monitorowania za pomocą poleceń < b > smart< / b > oraz < b > probe< / b > .
< / p > < p > Jest to przydatne do monitorowania dysków, które nie są częścią
macierzy, ale są wymagane do funkcjonowania systemu, takich jak
dysk rozruchowy.
< / p > < p > Należy zauważyć, że polecenia < b > up< / b > i < b > down< / b > nie mają wpływu na takie
dyski, ponieważ oczekuje się, że będą one zawsze w ruchu.
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec7-7" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
nohidden
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Wyklucza wszystkie ukryte pliki i katalogi.
2026-03-30 10:01:17 +02:00
W systemie Unix ukryte pliki to te zaczynające się od < b > .< / b > .
2025-12-12 11:57:38 +01:00
W systemie Windows są to te z atrybutem ukrycia.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec7-8" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
exclude/include PATTERN
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Definiuje wzorce plików lub katalogów do wykluczenia lub włączenia
2025-12-12 11:57:38 +01:00
do procesu synchronizacji.
Wszystkie wzorce są przetwarzane w określonej kolejności.
2026-03-30 10:01:17 +02:00
< / p > < p > Jeśli pierwszy pasujący wzorzec jest < b > exclude< / b > , plik
jest wykluczony. Jeśli jest to < b > include< / b > , plik jest włączony.
2025-12-12 11:57:38 +01:00
Jeśli żaden wzorzec nie pasuje, plik jest wykluczony, jeśli ostatni określony
2026-03-30 10:01:17 +02:00
wzorzec to < b > include< / b > , lub włączony, jeśli ostatni określony wzorzec to < b > exclude< / b > .
2025-12-14 22:21:44 +01:00
< / p > < p > Zobacz sekcję PATTERN, aby uzyskać więcej szczegółów na temat specyfikacji
2025-12-12 11:57:38 +01:00
wzorców.
2025-12-14 22:21:44 +01:00
< / p > < p > Ta opcja może być używana wielokrotnie.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec7-9" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
blocksize SIZE_IN_KIBIBYTES
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Definiuje podstawowy rozmiar bloku w kibibajtach dla parzystości.
2025-12-12 11:57:38 +01:00
Jeden kibibajt to 1024 bajty.
2025-12-14 22:21:44 +01:00
< / p > < p > Domyślny rozmiar bloku to 256, co powinno działać w większości przypadków.
< / p > < p > OSTRZEŻENIE! Ta opcja jest tylko dla ekspertów i jest wysoce
2025-12-12 11:57:38 +01:00
zalecane, aby nie zmieniać tej wartości. Aby zmienić tę wartość w przyszłości,
będziesz musiał ponownie utworzyć całą parzystość!
2025-12-14 22:21:44 +01:00
< / p > < p > Powodem użycia innego rozmiaru bloku jest posiadanie wielu małych
2025-12-12 11:57:38 +01:00
plików, rzędu milionów.
2025-12-14 22:21:44 +01:00
< / p > < p > Dla każdego pliku, nawet jeśli ma tylko kilka bajtów, alokowany jest cały blok parzystości,
2025-12-12 11:57:38 +01:00
a przy wielu plikach może to skutkować znaczną nieużywaną przestrzenią parzystości.
Kiedy całkowicie wypełnisz dysk parzystości, nie możesz
dodawać więcej plików do dysków danych.
Jednak marnowana parzystość nie gromadzi się na dyskach danych. Marnowane miejsce
wynikające z dużej liczby plików na dysku danych ogranicza tylko
ilość danych na tym dysku danych, a nie na innych.
2025-12-14 22:21:44 +01:00
< / p > < p > Jako przybliżenie, możesz założyć, że połowa rozmiaru bloku jest
2025-12-12 11:57:38 +01:00
marnowana dla każdego pliku. Na przykład, z 100 000 plików i rozmiarem bloku 256 KiB,
zmarnujesz 12,8 GB parzystości, co może skutkować
12,8 GB mniejszą dostępną przestrzenią na dysku danych.
2026-03-30 10:01:17 +02:00
< / p > < p > Możesz sprawdzić ilość zmarnowanego miejsca na każdym dysku za pomocą < b > status< / b > .
2025-12-12 11:57:38 +01:00
Jest to ilość miejsca, którą musisz pozostawić wolną na dyskach danych
lub użyć dla plików nie włączonych do macierzy.
Jeśli ta wartość jest ujemna, oznacza to, że jesteś blisko wypełnienia
parzystości i reprezentuje to przestrzeń, którą nadal możesz zmarnować.
2025-12-14 22:21:44 +01:00
< / p > < p > Aby uniknąć tego problemu, możesz użyć większej partycji dla parzystości.
2025-12-12 11:57:38 +01:00
Na przykład, jeśli partycja parzystości jest o 12,8 GB większa niż dyski danych,
masz wystarczająco dużo dodatkowego miejsca, aby obsłużyć do 100 000
plików na każdym dysku danych bez marnowania miejsca.
2025-12-14 22:21:44 +01:00
< / p > < p > Sztuczką, aby uzyskać większą partycję parzystości w systemie Linux, jest sformatowanie jej
2025-12-12 11:57:38 +01:00
za pomocą polecenia:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
mkfs.ext4 -m 0 -T largefile4 DEVICE
< / pre >
2025-12-14 22:21:44 +01:00
< p > Daje to około 1,5% dodatkowego miejsca, około 60 GB dla
2025-12-12 11:57:38 +01:00
dysku 4 TB, co pozwala na około 460 000 plików na każdym dysku danych bez
marnowania miejsca.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec7-10" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
hashsize SIZE_IN_BYTES
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Definiuje rozmiar hasza w bajtach dla zapisanych bloków.
< / p > < p > Domyślny rozmiar hasza to 16 bajtów (128 bitów), co powinno działać
2025-12-12 11:57:38 +01:00
w większości przypadków.
2025-12-14 22:21:44 +01:00
< / p > < p > OSTRZEŻENIE! Ta opcja jest tylko dla ekspertów i jest wysoce
2025-12-12 11:57:38 +01:00
zalecane, aby nie zmieniać tej wartości. Aby zmienić tę wartość w przyszłości,
będziesz musiał ponownie utworzyć całą parzystość!
2025-12-14 22:21:44 +01:00
< / p > < p > Powodem użycia innego rozmiaru hasza jest to, że Twój system ma
2025-12-12 11:57:38 +01:00
ograniczoną pamięć. Z reguły, SnapRAID zwykle wymaga
1 GiB pamięci RAM na każde 16 TB danych w macierzy.
2025-12-14 22:21:44 +01:00
< / p > < p > Konkretnie, aby przechowywać hasze danych, SnapRAID wymaga
2025-12-12 11:57:38 +01:00
około TS*(1+HS)/BS bajtów pamięci RAM,
gdzie TS to całkowity rozmiar w bajtach Twojej macierzy dysków, BS to
rozmiar bloku w bajtach, a HS to rozmiar hasza w bajtach.
2025-12-14 22:21:44 +01:00
< / p > < p > Na przykład, z 8 dyskami po 4 TB, rozmiarem bloku 256 KiB
2025-12-12 11:57:38 +01:00
(1 KiB = 1024 bajty) i rozmiarem hasza 16, otrzymujesz:
2025-12-14 22:21:44 +01:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1,93 GiB
< / pre >
2025-12-14 22:21:44 +01:00
< p > Przełączając się na rozmiar hasza 8, otrzymujesz:
< / p > < pre >
2025-12-12 11:57:38 +01:00
RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1,02 GiB
< / pre >
2025-12-14 22:21:44 +01:00
< p > Przełączając się na rozmiar bloku 512, otrzymujesz:
< / p > < pre >
2025-12-12 11:57:38 +01:00
RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0,96 GiB
< / pre >
2025-12-14 22:21:44 +01:00
< p > Przełączając się zarówno na rozmiar hasza 8, jak i rozmiar bloku 512, otrzymujesz:
< / p > < pre >
2025-12-12 11:57:38 +01:00
RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0,51 GiB
< / pre >
2026-03-30 10:01:17 +02:00
< / div >
< div class = "manual-section-level-2" >
< h2 id = "sec7-11" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
autosave SIZE_IN_GIGABYTES
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Automatycznie zapisuje stan podczas synchronizacji lub sprawdzania po przetworzeniu
2025-12-12 11:57:38 +01:00
określonej ilości GB.
2026-03-30 10:01:17 +02:00
Ta opcja jest przydatna, aby uniknąć ponownego uruchamiania długich poleceń < b > sync< / b >
2025-12-12 11:57:38 +01:00
od zera, jeśli zostaną przerwane przez awarię maszyny lub inne zdarzenie.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec7-12" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
temp_limit TEMPERATURE_CELSIUS
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Ustawia maksymalną dozwoloną temperaturę dysku w stopniach Celsjusza. Po określeniu,
2025-12-12 11:57:38 +01:00
SnapRAID okresowo sprawdza temperaturę wszystkich dysków za pomocą
narzędzia smartctl. Aktualne temperatury dysków są wyświetlane podczas
działania SnapRAID. Jeśli którykolwiek dysk przekroczy ten limit, wszystkie operacje
zostają zatrzymane, a dyski są zatrzymywane (przechodzą w stan gotowości) na czas
2026-03-30 10:01:17 +02:00
zdefiniowany przez opcję < b > temp_sleep< / b > . Po okresie uśpienia, operacje
2025-12-12 11:57:38 +01:00
są wznawiane, potencjalnie ponownie zatrzymując się, jeśli limit temperatury
zostanie ponownie osiągnięty.
2025-12-14 22:21:44 +01:00
< / p > < p > Podczas działania SnapRAID analizuje również krzywą nagrzewania każdego
2025-12-12 11:57:38 +01:00
dysku i szacuje długoterminową stałą temperaturę, którą mają
osiągnąć, jeśli aktywność będzie kontynuowana. Oszacowanie jest wykonywane tylko po
czterokrotnym wzroście temperatury dysku, co zapewnia, że
dostępnych jest wystarczająco dużo punktów danych do ustalenia wiarygodnego trendu.
Ta przewidywana stała temperatura jest pokazywana w nawiasach obok
aktualnej wartości i pomaga ocenić, czy chłodzenie systemu jest
odpowiednie. Ta szacowana temperatura ma charakter wyłącznie informacyjny
i nie ma wpływu na zachowanie SnapRAID. Działania programu
opierają się wyłącznie na faktycznie zmierzonych temperaturach dysków.
2025-12-14 22:21:44 +01:00
< / p > < p > Aby wykonać tę analizę, SnapRAID potrzebuje odniesienia dla temperatury systemu.
2025-12-12 11:57:38 +01:00
Najpierw próbuje odczytać ją z dostępnych czujników sprzętowych.
Jeśli nie można uzyskać dostępu do żadnego czujnika systemu, jako awaryjne odniesienie
wykorzystuje najniższą temperaturę dysku zmierzoną na początku uruchomienia.
2025-12-14 22:21:44 +01:00
< / p > < p > Normalnie SnapRAID pokazuje tylko temperaturę najgorętszego dysku.
2025-12-12 11:57:38 +01:00
Aby wyświetlić temperaturę wszystkich dysków, użyj opcji -A lub --stats.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec7-13" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
temp_sleep TIME_IN_MINUTES
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Ustawia czas gotowości, w minutach, po osiągnięciu limitu temperatury.
2025-12-12 11:57:38 +01:00
W tym okresie dyski pozostają zatrzymane. Domyślnie jest to 5 minut.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec7-14" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
pool DIR
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Definiuje katalog puli, w którym tworzony jest wirtualny widok macierzy
2026-03-30 10:01:17 +02:00
dysków za pomocą polecenia < b > pool< / b > .
2025-12-14 22:21:44 +01:00
< / p > < p > Katalog musi już istnieć.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec7-15" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
share UNC_DIR
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Definiuje ścieżkę UNC Windows wymaganą do zdalnego dostępu do dysków.
< / p > < p > Jeśli ta opcja jest określona, dowiązania symboliczne utworzone w katalogu puli
2025-12-12 11:57:38 +01:00
używają tej ścieżki UNC do dostępu do dysków.
Bez tej opcji generowane dowiązania symboliczne używają tylko ścieżek lokalnych,
co nie pozwala na udostępnianie katalogu puli w sieci.
2025-12-14 22:21:44 +01:00
< / p > < p > Dowiązania symboliczne są tworzone przy użyciu określonej ścieżki UNC,
2026-03-30 10:01:17 +02:00
dodając nazwę dysku określoną w opcji < b > data< / b > , a na końcu dodając
2025-12-12 11:57:38 +01:00
katalog i nazwę pliku.
2025-12-14 22:21:44 +01:00
< / p > < p > Ta opcja jest wymagana tylko dla systemu Windows.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-2" >
< h2 id = "sec7-16" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
smartctl DISK/PARITY OPTIONS...
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Definiuje niestandardowe opcje smartctl do uzyskania atrybutów SMART dla
2025-12-12 11:57:38 +01:00
każdego dysku. Może to być wymagane dla kontrolerów RAID i niektórych dysków USB,
których nie można wykryć automatycznie. Symbol zastępczy %s jest zastępowany
nazwą urządzenia, ale jest opcjonalny dla stałych urządzeń, takich jak kontrolery RAID.
2026-03-30 10:01:17 +02:00
< / p > < p > DISK to ta sama nazwa dysku określona w opcji < b > data< / b > .
PARITY to jedna z nazw parzystości: < b > parity< / b > , < b > 2-parity< / b > , < b > 3-parity< / b > ,
< b > 4-parity< / b > , < b > 5-parity< / b > , < b > 6-parity< / b > lub < b > z-parity< / b > .
< / p > < p > W określonych OPCJACH ciąg < b > %s< / b > jest zastępowany
2025-12-12 11:57:38 +01:00
nazwą urządzenia. W przypadku kontrolerów RAID, urządzenie jest
2026-03-30 10:01:17 +02:00
prawdopodobnie stałe i może nie być konieczne użycie < b > %s< / b > .
2025-12-14 22:21:44 +01:00
< / p > < p > Zapoznaj się z dokumentacją smartmontools, aby uzyskać możliwe opcje:
2026-03-30 10:01:17 +02:00
< / p > < pre >
< a href = "https://www.smartmontools.org/wiki/Supported_RAID-Controllers" > https://www.smartmontools.org/wiki/Supported_RAID-Controllers< / a >
< a href = "https://www.smartmontools.org/wiki/Supported_USB-Devices" > https://www.smartmontools.org/wiki/Supported_USB-Devices< / a >
2025-12-12 11:57:38 +01:00
< / pre >
2025-12-14 22:21:44 +01:00
< p > Na przykład:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
smartctl parity -d sat %s
< / pre >
2026-03-30 10:01:17 +02:00
< / div >
< div class = "manual-section-level-2" >
< h2 id = "sec7-17" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
smartignore DISK/PARITY ATTR [ATTR...]
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Ignoruje określony atrybut SMART podczas obliczania prawdopodobieństwa
2025-12-12 11:57:38 +01:00
awarii dysku. Ta opcja jest przydatna, jeśli dysk zgłasza nietypowe lub
wprowadzające w błąd wartości dla określonego atrybutu.
2026-03-30 10:01:17 +02:00
< / p > < p > DISK to ta sama nazwa dysku określona w opcji < b > data< / b > .
PARITY to jedna z nazw parzystości: < b > parity< / b > , < b > 2-parity< / b > , < b > 3-parity< / b > ,
< b > 4-parity< / b > , < b > 5-parity< / b > , < b > 6-parity< / b > lub < b > z-parity< / b > .
2025-12-12 11:57:38 +01:00
Specjalna wartość * może być użyta do zignorowania atrybutu na wszystkich dyskach.
2026-03-30 10:01:17 +02:00
< / p > < p > Na przykład, aby zignorować atrybut < b > Current Pending Sector Count< / b > na
2025-12-12 11:57:38 +01:00
wszystkich dyskach:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
smartignore * 197
< / pre >
2025-12-14 22:21:44 +01:00
< p > Aby zignorować go tylko na pierwszym dysku parzystości:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
smartignore parity 197
< / pre >
2026-03-30 10:01:17 +02:00
< / div >
< div class = "manual-section-level-2" >
< h2 id = "sec7-18" class = "manual-title-level-2" >
2025-12-12 11:57:38 +01:00
Examples
2026-03-30 10:01:17 +02:00
< / h2 >
2025-12-14 22:21:44 +01:00
< p > Przykład typowej konfiguracji dla systemu Unix:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
parity /mnt/diskp/snapraid.parity
content /mnt/diskp/snapraid.content
content /var/snapraid/snapraid.content
data d1 /mnt/disk1/
data d2 /mnt/disk2/
data d3 /mnt/disk3/
exclude /lost+found/
exclude /tmp/
smartctl d1 -d sat %s
smartctl d2 -d usbjmicron %s
smartctl parity -d areca,1/1 /dev/sg0
smartctl 2-parity -d areca,2/1 /dev/sg0
< / pre >
2025-12-14 22:21:44 +01:00
< p > Przykład typowej konfiguracji dla systemu Windows:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
parity E:\snapraid.parity
content E:\snapraid.content
content C:\snapraid\snapraid.content
data d1 G:\array\
data d2 H:\array\
data d3 I:\array\
exclude Thumbs.db
exclude \$RECYCLE.BIN
exclude \System Volume Information
smartctl d1 -d sat %s
smartctl d2 -d usbjmicron %s
smartctl parity -d areca,1/1 /dev/arcmsr0
smartctl 2-parity -d areca,2/1 /dev/arcmsr0
< / pre >
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< div class = "manual-section-level-1" >
< h1 id = "sec8" class = "manual-title-level-1" >
2025-12-12 11:57:38 +01:00
Pattern
2026-03-30 10:01:17 +02:00
< / h1 >
< p > Wzorce zapewniają elastyczny sposób filtrowania plików do uwzględnienia lub
wykluczenia. Używając znaków globbingowych, można zdefiniować reguły, które
pasują do określonych nazw plików lub całych struktur katalogów bez
ręcznego wymieniania każdej ścieżki.
< / p > < p > Znak zapytania < b > ?< / b > dopasowuje dowolny pojedynczy znak z wyjątkiem
separatora katalogów. Dzięki temu jest przydatny do dopasowywania nazw plików ze
zmiennymi znakami, przy jednoczesnym ograniczeniu wzorca do jednego poziomu katalogu.
< / p > < p > Pojedyncza gwiazdka < b > *< / b > dopasowuje dowolną sekwencję znaków, ale podobnie jak
znak zapytania, nigdy nie przekracza granic katalogów. Zatrzymuje się na
ukośniku, co czyni ją odpowiednią do dopasowywania w obrębie jednego
składnika ścieżki. Jest to standardowe zachowanie symboli wieloznacznych znane
z globbingu powłoki (shell).
< / p > < p > Podwójna gwiazdka < b > **< / b > jest potężniejsza, dopasowuje dowolną sekwencję
znaków, w tym separatory katalogów. Pozwala to wzorcom dopasowywać się
na wielu poziomach katalogów. Gdy < b > **< / b > pojawia się bezpośrednio wewnątrz
wzorca, może dopasować zero lub więcej znaków, w tym ukośniki między
otaczającym tekstem dosłownym.
< / p > < p > Najważniejszym zastosowaniem < b > **< / b > jest specjalna forma < b > /**/< / b > . Dopasowuje ona
zero lub więcej pełnych poziomów katalogów, umożliwiając dopasowanie plików
na dowolnej głębokości w drzewie katalogów bez znajomości dokładnej struktury ścieżki.
Na przykład wzorzec < b > src/**/main.js< / b > pasuje do < b > src/main.js< / b > (pomijając
zero katalogów), < b > src/ui/main.js< / b > (pomijając jeden katalog) oraz
< b > src/ui/components/main.js< / b > (pomijając dwa katalogi).
< / p > < p > Klasy znaków używające nawiasów kwadratowych < b > []< / b > dopasowują pojedynczy znak z
określonego zestawu lub zakresu. Podobnie jak inne wzorce pojedynczych znaków,
nie pasują one do separatorów katalogów. Klasy obsługują zakresy i negację za pomocą
wykrzyknika.
< / p > < p > Podstawową różnicą, o której należy pamiętać, jest to, że < b > *< / b > , < b > ?< / b > i klasy znaków
wszystkie respektują granice katalogów i dopasowują się tylko w obrębie jednego
składnika ścieżki, podczas gdy < b > **< / b > jest jedynym wzorcem, który może dopasowywać się poprzez
separatory katalogów.
2025-12-14 22:21:44 +01:00
< / p > < p > Istnieją cztery różne typy wzorców:
2026-03-30 10:01:17 +02:00
< / p > < div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
FILE
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
Wybiera dowolny plik o nazwie FILE.
2025-12-12 11:57:38 +01:00
Ten wzorzec dotyczy tylko plików, a nie katalogów.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
DIR/
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
Wybiera dowolny katalog o nazwie DIR i wszystko, co się w nim znajduje.
2025-12-12 11:57:38 +01:00
Ten wzorzec dotyczy tylko katalogów, a nie plików.
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
/PATH/FILE
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
Wybiera dokładnie określoną ścieżkę pliku. Ten wzorzec dotyczy
tylko plików, a nie katalogów.
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
2025-12-12 11:57:38 +01:00
/PATH/DIR/
2026-03-30 10:01:17 +02:00
< / div > < div class = "manual-option-description" >
Wybiera dokładnie określoną ścieżkę katalogu i wszystko, co się w nim
znajduje. Ten wzorzec dotyczy tylko katalogów, a nie plików.
< / div >
< / div >
< / div >
2025-12-14 22:21:44 +01:00
< p > Gdy określisz ścieżkę bezwzględną zaczynającą się od /, jest ona stosowana w
2025-12-12 11:57:38 +01:00
katalogu głównym macierzy, a nie w katalogu głównym lokalnego systemu plików.
2025-12-14 22:21:44 +01:00
< / p > < p > W systemie Windows możesz użyć ukośnika odwrotnego \ zamiast ukośnika /.
2025-12-12 11:57:38 +01:00
Katalogi systemowe Windows, połączenia, punkty montowania i inne
specjalne katalogi Windows są traktowane jako pliki, co oznacza, że aby je
wykluczyć, musisz użyć reguły pliku, a nie katalogu.
2026-03-30 10:01:17 +02:00
< / p > < p > Jeśli nazwa pliku zawiera znak < b > *< / b > , < b > ?< / b > , < b > [< / b > ,
lub < b > ]< / b > , musisz go uciec, aby uniknąć interpretacji jako
znaku globbing. W systemie Unix znakiem ucieczki jest < b > \< / b > ; w systemie Windows jest to < b > ^< / b > .
2025-12-12 11:57:38 +01:00
Gdy wzorzec znajduje się w wierszu poleceń, musisz podwoić znak ucieczki,
aby uniknąć interpretacji przez powłokę poleceń.
2025-12-14 22:21:44 +01:00
< / p > < p > W pliku konfiguracyjnym możesz użyć różnych strategii do filtrowania
2025-12-12 11:57:38 +01:00
plików do przetworzenia.
2026-03-30 10:01:17 +02:00
Najprostszym podejściem jest użycie tylko reguł < b > exclude< / b > , aby usunąć wszystkie
2025-12-12 11:57:38 +01:00
pliki i katalogi, których nie chcesz przetwarzać. Na przykład:
2026-03-30 10:01:17 +02:00
< / p > < pre >
# Wyklucza dowolny plik o nazwie < b > *.unrecoverable< / b >
2025-12-12 11:57:38 +01:00
exclude *.unrecoverable
2026-03-30 10:01:17 +02:00
# Wyklucza katalog główny < b > /lost+found< / b >
2025-12-12 11:57:38 +01:00
exclude /lost+found/
2026-03-30 10:01:17 +02:00
# Wyklucza dowolny podkatalog o nazwie < b > tmp< / b >
2025-12-12 11:57:38 +01:00
exclude tmp/
< / pre >
2025-12-14 22:21:44 +01:00
< p > Odwrotnym podejściem jest zdefiniowanie tylko plików, które chcesz przetwarzać,
2026-03-30 10:01:17 +02:00
używając tylko reguł < b > include< / b > . Na przykład:
< / p > < pre >
2025-12-12 11:57:38 +01:00
# Włącza tylko niektóre katalogi
include /movies/
include /musics/
include /pictures/
< / pre >
2026-03-30 10:01:17 +02:00
< p > Ostatecznym podejściem jest mieszanie reguł < b > exclude< / b > i < b > include< / b > . W tym przypadku
2025-12-12 11:57:38 +01:00
kolejność reguł jest ważna. Wcześniejsze reguły mają
pierwszeństwo przed późniejszymi.
2026-03-30 10:01:17 +02:00
Aby uprościć, możesz najpierw wymienić wszystkie reguły < b > exclude< / b > , a następnie
wszystkie reguły < b > include< / b > . Na przykład:
< / p > < pre >
# Wyklucza dowolny plik o nazwie < b > *.unrecoverable< / b >
2025-12-12 11:57:38 +01:00
exclude *.unrecoverable
2026-03-30 10:01:17 +02:00
# Wyklucza dowolny podkatalog o nazwie < b > tmp< / b >
2025-12-12 11:57:38 +01:00
exclude tmp/
# Włącza tylko niektóre katalogi
include /movies/
include /musics/
include /pictures/
< / pre >
2026-03-30 10:01:17 +02:00
< p > W wierszu poleceń, używając opcji -f, możesz użyć tylko wzorców < b > include< / b > .
2025-12-12 11:57:38 +01:00
Na przykład:
2026-03-30 10:01:17 +02:00
< / p > < pre >
2025-12-12 11:57:38 +01:00
# Sprawdza tylko pliki .mp3.
# W systemie Unix użyj cudzysłowów, aby uniknąć rozszerzenia globbing przez powłokę.
snapraid -f "*.mp3" check
< / pre >
2025-12-14 22:21:44 +01:00
< p > W systemie Unix, używając znaków globbing w wierszu poleceń, musisz
2025-12-12 11:57:38 +01:00
je cytować, aby zapobiec ich rozszerzeniu przez powłokę.
2026-03-30 10:01:17 +02:00
< / p > < / div >
< div class = "manual-section-level-1" >
< h1 id = "sec9" class = "manual-title-level-1" >
Ignore File
< / h1 >
< p > Oprócz reguł globalnych w pliku konfiguracyjnym, możesz umieścić pliki
< b > .snapraidignore< / b > w dowolnym katalogu w macierzy, aby zdefiniować
zdecentralizowane reguły wykluczania.
< / p > < p > Reguły zdefiniowane w < b > .snapraidignore< / b > są stosowane po regułach w pliku
konfiguracyjnym. Oznacza to, że mają one wyższy priorytet i mogą być używane
do wykluczania plików, które zostały wcześniej uwzględnione przez konfigurację
globalną. Skutecznie, jeśli reguła lokalna pasuje, plik jest wykluczany bez
względu na globalne ustawienia uwzględniania.
< / p > < p > Logika wzorców w < b > .snapraidignore< / b > odzwierciedla konfigurację globalną, ale
zakotwicza wzorce w katalogu, w którym znajduje się plik:
< / p > < div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
FILE
< / div > < div class = "manual-option-description" >
Wybiera dowolny plik o nazwie FILE w tym katalogu lub poniżej.
Podlega to tym samym zasadom dopasowywania (globbing) co wzorzec globalny.
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
DIR/
< / div > < div class = "manual-option-description" >
Wybiera dowolny katalog o nazwie DIR i wszystko w jego wnętrzu,
znajdujący się w tym katalogu lub poniżej.
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
/PATH/FILE
< / div > < div class = "manual-option-description" >
Wybiera dokładnie określony plik względem lokalizacji
pliku < b > .snapraidignore< / b > .
< / div >
< / div >
< / div >
< div class = "manual-option-list" >
< div class = "manual-option-entry" >
< div class = "manual-option-name" >
/PATH/DIR/
< / div > < div class = "manual-option-description" >
Wybiera dokładnie określony katalog i wszystko w jego wnętrzu,
względem lokalizacji pliku < b > .snapraidignore< / b > .
< / div >
< / div >
< / div >
< p > W przeciwieństwie do konfiguracji globalnej, pliki < b > .snapraidignore< / b > obsługują
tylko reguły wykluczania; nie można używać wzorców < b > include< / b > ani negacji (!).
< / p > < p > Na przykład, jeśli masz < b > .snapraidignore< / b > w < b > /mnt/disk1/projects/< / b > :
< / p > < pre >
# Wyklucza TYLKO /mnt/disk1/projects/output.bin
/output.bin
# Wyklucza każdy katalog o nazwie < b > build< / b > wewnątrz projects/
build/
# Wyklucza każdy plik .tmp wewnątrz projects/ lub jego podfolderach
*.tmp
< / pre >
< / div >
< div class = "manual-section-level-1" >
< h1 id = "sec10" class = "manual-title-level-1" >
2025-12-12 11:57:38 +01:00
Content
2026-03-30 10:01:17 +02:00
< / h1 >
2025-12-14 22:21:44 +01:00
< p > SnapRAID przechowuje listę i sumy kontrolne Twoich plików w pliku zawartości.
< / p > < p > Jest to plik binarny, który zawiera listę wszystkich plików obecnych w Twojej macierzy dysków,
2025-12-12 11:57:38 +01:00
wraz ze wszystkimi sumami kontrolnymi w celu weryfikacji ich integralności.
2026-03-30 10:01:17 +02:00
< / p > < p > Ten plik jest odczytywany i zapisywany przez polecenia < b > sync< / b > i < b > scrub< / b >
oraz odczytywany przez polecenia < b > fix< / b > , < b > check< / b > i < b > status< / b > .
< / p > < / div >
< div class = "manual-section-level-1" >
< h1 id = "sec11" class = "manual-title-level-1" >
2025-12-12 11:57:38 +01:00
Parity
2026-03-30 10:01:17 +02:00
< / h1 >
2025-12-14 22:21:44 +01:00
< p > SnapRAID przechowuje informacje o parzystości Twojej macierzy w plikach
2025-12-12 11:57:38 +01:00
parzystości.
2025-12-14 22:21:44 +01:00
< / p > < p > Są to pliki binarne zawierające obliczoną parzystość wszystkich
2026-03-30 10:01:17 +02:00
bloków zdefiniowanych w pliku < b > content< / b > .
< / p > < p > Pliki te są odczytywane i zapisywane przez polecenia < b > sync< / b > i < b > fix< / b >
oraz tylko odczytywane przez polecenia < b > scrub< / b > i < b > check< / b > .
< / p > < / div >
< div class = "manual-section-level-1" >
< h1 id = "sec12" class = "manual-title-level-1" >
2025-12-12 11:57:38 +01:00
Encoding
2026-03-30 10:01:17 +02:00
< / h1 >
2025-12-14 22:21:44 +01:00
< p > SnapRAID w systemie Unix ignoruje wszelkie kodowanie. Odczytuje i przechowuje
2025-12-12 11:57:38 +01:00
nazwy plików z tym samym kodowaniem używanym przez system plików.
2025-12-14 22:21:44 +01:00
< / p > < p > W systemie Windows wszystkie nazwy odczytane z systemu plików są konwertowane i
2025-12-12 11:57:38 +01:00
przetwarzane w formacie UTF-8.
2025-12-14 22:21:44 +01:00
< / p > < p > Aby nazwy plików były poprawnie drukowane, musisz ustawić konsolę Windows
2026-03-30 10:01:17 +02:00
na tryb UTF-8 za pomocą polecenia < b > chcp 65001< / b > i użyć
czcionki TrueType, takiej jak < b > Lucida Console< / b > , jako czcionki konsoli.
2025-12-12 11:57:38 +01:00
Dotyczy to tylko drukowanych nazw plików; jeśli
przekierujesz wyjście konsoli do pliku, wynikowy plik jest zawsze
w formacie UTF-8.
2026-03-30 10:01:17 +02:00
< / p > < / div >
2025-12-12 11:57:38 +01:00
2026-03-30 10:01:17 +02:00
< / div >
< / main >
< / div >
2025-12-12 11:57:38 +01:00
2026-03-30 10:01:17 +02:00
<!-- Footer -->
< footer >
< div class = "container footer-content" >
< div class = "footer-col" >
< div class = "logo" >
< img src = "android-chrome-192x192.png" width = "32" height = "32" / >
SnapRAID
< / div >
< p > Copyright © 2026 Andrea Mazzoleni< / p >
< p class = "license" > Distributed under GPL v3 License< / p >
< / div >
< div class = "footer-col" >
2026-04-14 09:47:17 +02:00
< h4 > Links< / h4 >
2026-04-14 09:56:55 +02:00
< ul class = "footer-list" >
2026-04-14 09:47:17 +02:00
< li > < a href = "https://github.com/amadvance/snapraid/" > GitHub SnapRAID CLI< / a > < / li >
< li > < a href = "https://github.com/amadvance/snapraid-daemon/" > GitHub SnapRAID Daemon< / a > < / li >
< li > < a href = "https://www.reddit.com/r/Snapraid/" > Reddit< / a > < / li >
< li > < a href = "https://sourceforge.net/p/snapraid/" > SourceForge< / a > < / li >
< / ul >
2026-03-30 10:01:17 +02:00
< / div >
< / div >
< / footer >
2025-12-12 11:57:38 +01:00
< / body >
< / html >
