snapraid/manual-zh.html

2307 lines
99 KiB
HTML
Raw Normal View History

2026-03-30 10:01:17 +02:00
<!DOCTYPE html>
2025-12-15 15:15:14 +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-15 15:15:14 +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-15 15:15:14 +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-15 15:15:14 +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-15 15:15:14 +01:00
2026-03-30 10:01:17 +02:00
</select>
2025-12-15 15:15:14 +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-15 15:15:14 +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">
2026-10-29 06:56:28 +01:00
概要 (Synopsis)
2026-03-30 10:01:17 +02:00
</h1>
2025-12-15 15:15:14 +01:00
<pre>
snapraid [-c, --conf CONFIG]
&nbsp;&nbsp;&nbsp;&nbsp;[-f, --filter PATTERN] [-d, --filter-disk NAME]
&nbsp;&nbsp;&nbsp;&nbsp;[-m, --filter-missing] [-e, --filter-error]
&nbsp;&nbsp;&nbsp;&nbsp;[-a, --audit-only] [-h, --pre-hash] [-i, --import DIR]
&nbsp;&nbsp;&nbsp;&nbsp;[-p, --plan PERC|bad|new|full]
&nbsp;&nbsp;&nbsp;&nbsp;[-o, --older-than DAYS] [-l, --log FILE]
&nbsp;&nbsp;&nbsp;&nbsp;[-s, --spin-down-on-error] [-w, --bw-limit RATE]
2026-03-30 10:01:17 +02:00
&nbsp;&nbsp;&nbsp;&nbsp;[-t, --tail]
2025-12-15 15:15:14 +01:00
&nbsp;&nbsp;&nbsp;&nbsp;[-Z, --force-zero] [-E, --force-empty]
&nbsp;&nbsp;&nbsp;&nbsp;[-U, --force-uuid] [-D, --force-device]
&nbsp;&nbsp;&nbsp;&nbsp;[-N, --force-nocopy] [-F, --force-full]
2026-03-30 10:01:17 +02:00
&nbsp;&nbsp;&nbsp;&nbsp;[-R, --force-realloc] [-W, --force-realloc-tail]
2025-12-15 15:15:14 +01:00
&nbsp;&nbsp;&nbsp;&nbsp;[-S, --start BLKSTART] [-B, --count BLKCOUNT]
&nbsp;&nbsp;&nbsp;&nbsp;[-L, --error-limit NUMBER]
&nbsp;&nbsp;&nbsp;&nbsp;[-A, --stats]
&nbsp;&nbsp;&nbsp;&nbsp;[-v, --verbose] [-q, --quiet]
&nbsp;&nbsp;&nbsp;&nbsp;status|smart|probe|up|down|diff|sync|scrub|fix|check
2026-03-30 10:01:17 +02:00
&nbsp;&nbsp;&nbsp;&nbsp;|list|dup|pool|devices|touch|rehash|locate
2025-12-15 15:15:14 +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">
2026-10-29 06:56:28 +01:00
描述 (Description)
2026-03-30 10:01:17 +02:00
</h1>
2025-12-15 15:15:14 +01:00
<p>SnapRAID 是一款专为磁盘阵列设计的备份程序,它存储奇偶校验信息,
以在最多六个磁盘发生故障时进行数据恢复。
</p><p>SnapRAID 主要面向拥有大型、不常更改文件的家庭媒体中心,提供以下特性:
</p><ul>
<li>
您可以使用已填充文件的磁盘,无需重新格式化,并像往常一样访问它们。
</li>
<li>
您的所有数据都会被散列,以确保存储完整性并防止静默损坏。
</li>
<li>
当故障磁盘数量超过奇偶校验数时,数据丢失仅限于受影响的磁盘;
其他磁盘上的数据仍然可访问。
</li>
<li>
如果您不小心删除了磁盘上的文件,可以进行恢复。
</li>
<li>
磁盘可以有不同的尺寸。
</li>
<li>
您可以随时添加磁盘。
</li>
<li>
SnapRAID 不会锁定您的数据;您可以随时停止使用它,无需重新格式化或移动数据。
</li>
<li>
访问文件时,只需一个磁盘转动,从而节省电力并降低噪音。
</li>
</ul>
<p>欲了解更多信息,请访问 SnapRAID 官方网站:
2026-03-30 10:01:17 +02:00
</p><pre>
<a href="https://www.snapraid.it/">https://www.snapraid.it/</a>
2025-12-15 15:15:14 +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">
2026-10-29 06:56:28 +01:00
限制 (Limitations)
2026-03-30 10:01:17 +02:00
</h1>
2026-10-29 06:56:28 +01:00
<p>SnapRAID 是 RAID 和备份程序之间的混合体,旨在结合两者的最佳优势。
但是,在使用它之前,您应该考虑它的一些限制。
</p><p>主要的限制是,如果磁盘发生故障,您只能将数据恢复到上一次 <b>sync</b>(同步)操作的状态。
自上次同步以来添加的任何数据或进行的任何修改(如果位于发生故障的磁盘上)都将丢失。
</p><p>因此,SnapRAID 主要适用于很少更改的数据。
</p><p>对于上次同步时已经存在的数据,恢复的可靠性取决于是否使用了 <b>snapshot</b>(快照)选项:
</p><ul>
<li>
具有快照支持(在 Btrfs、ZFS、Bcachefs 和 NTFS 上可用),
SnapRAID 可以自动维护每个受支持的数据文件系统的独立冻结引用。
这确保了即使您在同步期间或之后在活动文件系统上修改或删除文件,
恢复过程仍保持一致且可靠。
</li>
</ul>
<ul>
<li>
在没有快照支持的情况下,在 <b>sync</b> 之后删除或更改文件
可能会阻止其他损坏磁盘的完全恢复。发生这种情况
是因为校验数据不再与修改后的文件匹配,即使
这些文件不在损坏的磁盘上。另一方面,新添加的文件
不会阻止已存在文件的恢复。
</li>
</ul>
<p>SnapRAID 的其他限制包括:
2025-12-15 15:15:14 +01:00
</p><ul>
<li>
使用 SnapRAID,每个磁盘仍然有单独的文件系统。
使用 RAID,您可以获得一个单一的大型文件系统。
</li>
<li>
SnapRAID 不进行数据条带化。
使用 RAID,您可以通过条带化获得速度提升。
</li>
<li>
SnapRAID 不支持实时恢复。
使用 RAID,当磁盘发生故障时,您不必停止工作。
</li>
<li>
SnapRAID 只能从有限数量的磁盘故障中恢复数据。
使用备份,您可以从整个磁盘阵列的完全故障中恢复。
</li>
<li>
仅保存文件名、时间戳、符号链接和硬链接。
不保存权限、所有权和扩展属性。
</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">
2026-10-29 06:56:28 +01:00
入门 (Getting Started)
2026-03-30 10:01:17 +02:00
</h1>
2025-12-15 15:15:14 +01:00
<p>要使用 SnapRAID,您需要首先选择磁盘阵列中的一个磁盘专用于
2026-03-30 10:01:17 +02:00
<b>parity</b>(奇偶校验)信息。使用一个奇偶校验磁盘,
2025-12-15 15:15:14 +01:00
您将能够从单磁盘故障中恢复,类似于 RAID5。
</p><p>如果您想从更多的磁盘故障中恢复,类似于 RAID6,
您必须预留额外的磁盘用于奇偶校验。每增加一个奇偶校验磁盘,
就可以多恢复一个磁盘故障。
</p><p>作为奇偶校验磁盘,您必须选择阵列中最大的磁盘,
因为奇偶校验信息可能会增长到阵列中最大的数据磁盘的大小。
2026-03-30 10:01:17 +02:00
</p><p>这些磁盘将专门用于存储 <b>parity</b> 文件。
2025-12-15 15:15:14 +01:00
您不应该在它们上面存储您的数据。
2026-03-30 10:01:17 +02:00
</p><p>然后,您必须定义要使用 SnapRAID 保护的 <b>data</b>(数据)磁盘。
2025-12-15 15:15:14 +01:00
如果这些磁盘包含很少更改的数据,保护会更有效。因此,
最好**不要**包含 Windows C:\ 磁盘或 Unix 的 /home、/var 和 /tmp 目录。
2026-03-30 10:01:17 +02:00
</p><p>文件列表保存在 <b>content</b>(内容)文件中,通常存储在数据、奇偶校验或
2025-12-15 15:15:14 +01:00
引导磁盘上。
该文件包含备份的详细信息,包括所有用于验证其完整性的校验和。
2026-03-30 10:01:17 +02:00
<b>content</b> 文件存储有多个副本,每个副本必须位于不同的磁盘上,
2025-12-15 15:15:14 +01:00
以确保存储有多个磁盘故障时,至少有一个副本可用。
</p><p>例如,假设您只对一个奇偶校验保护级别感兴趣,并且您的磁盘位于:
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +01:00
/mnt/diskp &lt;- 选定的奇偶校验磁盘
/mnt/disk1 &lt;- 第一个要保护的磁盘
/mnt/disk2 &lt;- 第二个要保护的磁盘
/mnt/disk3 &lt;- 第三个要保护的磁盘
</pre>
<p>您必须创建配置文件 /etc/snapraid.conf,并包含以下选项:
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +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>
<p>如果您使用 Windows,您应该使用 Windows 路径格式,
用驱动器号和反斜杠代替斜杠。
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +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>
<p>如果您有许多磁盘且驱动器号用尽,您可以将磁盘直接挂载到子文件夹中。请参阅:
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-15 15:15:14 +01:00
</pre>
2026-03-30 10:01:17 +02:00
<p>此时,您已准备好运行 <b>sync</b> 命令来构建奇偶校验信息。
</p><pre>
2025-12-15 15:15:14 +01:00
snapraid sync
</pre>
<p>第一次运行此过程可能需要几个小时,具体取决于磁盘上已存在数据的大小。
如果磁盘是空的,则过程是即时的。
</p><p>您可以随时按 Ctrl+C 停止它,在下次运行时,它将从中断的地方恢复。
</p><p>当此命令完成时,您的数据是**安全的**。
2026-03-30 10:01:17 +02:00
</p><p>现在您可以开始随意使用您的阵列,并定期运行 <b>sync</b> 命令更新奇偶校验信息。
</p><div class="manual-section-level-2">
<h2 id="sec4-1" class="manual-title-level-2">
2026-10-29 06:56:28 +01:00
数据擦洗 (Scrubbing)
2026-03-30 10:01:17 +02:00
</h2>
<p>要定期检查数据和奇偶校验的错误,您可以运行 <b>scrub</b> 命令。
</p><pre>
2025-12-15 15:15:14 +01:00
snapraid scrub
</pre>
2026-03-30 10:01:17 +02:00
<p>此命令将阵列中的数据与 <b>sync</b> 命令期间计算的散列进行比较,
2025-12-15 15:15:14 +01:00
以验证完整性。
</p><p>每次运行该命令会检查大约 8% 的阵列,排除在过去 10 天内
已被 scrub 的数据。
您可以使用 -p, --plan 选项来指定不同的量,
并使用 -o, --older-than 选项来指定不同的天数。
例如,要检查 20 天以上块的 5% 阵列,请使用:
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +01:00
snapraid -p 5 -o 20 scrub
</pre>
<p>如果在过程中发现静默错误或输入/输出错误,
2026-03-30 10:01:17 +02:00
相应的块会在 <b>content</b> 文件中被标记为坏块,并列在 <b>status</b> 命令中。
</p><pre>
2025-12-15 15:15:14 +01:00
snapraid status
</pre>
2026-03-30 10:01:17 +02:00
<p>要修复它们,您可以使用 <b>fix</b> 命令,使用 -e, --filter-error 选项过滤坏块:
</p><pre>
2025-12-15 15:15:14 +01:00
snapraid -e fix
</pre>
2026-03-30 10:01:17 +02:00
<p>在下次 <b>scrub</b> 时,如果它们确实被修复了,错误将从 <b>status</b> 报告中消失。
2025-12-15 15:15:14 +01:00
为了更快,您可以使用 -p bad 来仅 scrub 标记为坏块的块。
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +01:00
snapraid -p bad scrub
</pre>
2026-03-30 10:01:17 +02:00
<p>在未同步的阵列上运行 <b>scrub</b> 可能会报告由已删除或已修改文件引起的错误。
这些错误会在 <b>scrub</b> 输出中报告,但相关块不会被标记为坏块。
</p></div>
<div class="manual-section-level-2">
<h2 id="sec4-2" class="manual-title-level-2">
2026-10-29 06:56:28 +01:00
合并池 (Pooling)
2026-03-30 10:01:17 +02:00
</h2>
<p>注意:下面描述的 pooling 功能已被 mergerfs 工具取代,
mergerfs 现在是 SnapRAID 社区推荐的 Linux 用户选项。
2026-10-29 06:56:28 +01:00
Mergerfs 提供了一种更灵活、更高效的方式,将多个驱动器汇集到一个
2025-12-15 15:15:14 +01:00
统一的挂载点中,允许跨阵列无缝访问文件,而无需依赖符号链接。
它与 SnapRAID 很好地集成以提供奇偶校验保护,常用于
OpenMediaVault (OMV) 或自定义 NAS 配置等设置中。
</p><p>要使阵列中的所有文件显示在同一个目录树中,
2026-03-30 10:01:17 +02:00
您可以启用 <b>pooling</b> 功能。它使用符号链接创建了一个
2025-12-15 15:15:14 +01:00
阵列中所有文件的只读虚拟视图。
2026-03-30 10:01:17 +02:00
</p><p>您可以在配置文件中使用以下选项配置 <b>pooling</b> 目录:
</p><pre>
2025-12-15 15:15:14 +01:00
pool /pool
</pre>
<p>或者,如果您使用 Windows,则使用:
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +01:00
pool C:\pool
</pre>
2026-03-30 10:01:17 +02:00
<p>然后运行 <b>pool</b> 命令创建或更新虚拟视图。
</p><pre>
2025-12-15 15:15:14 +01:00
snapraid pool
</pre>
<p>如果您使用 Unix 平台并希望通过网络将此目录共享给 Windows 或 Unix 机器,
您应该在 /etc/samba/smb.conf 中添加以下选项:
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +01:00
# 在 smb.conf 的全局部分
unix extensions = no
</pre>
<pre>
# 在 smb.conf 的共享部分
[pool]
comment = Pool
path = /pool
read only = yes
guest ok = yes
wide links = yes
follow symlinks = yes
</pre>
<p>在 Windows 中,通过网络共享符号链接需要客户端远程解析它们。
要启用此功能,除了共享 pool 目录之外,您还必须独立共享所有磁盘,
使用配置文件中定义的磁盘名称作为共享点。
2026-03-30 10:01:17 +02:00
您还必须在配置文件的 <b>share</b> 选项中指定远程客户端访问这些
2025-12-15 15:15:14 +01:00
共享磁盘所需的 Windows UNC 路径。
2026-03-30 10:01:17 +02:00
</p><p>例如,在名为 <b>darkstar</b> 的服务器上操作,您可以使用以下选项:
</p><pre>
2025-12-15 15:15:14 +01:00
data d1 F:\array\
data d2 G:\array\
data d3 H:\array\
pool C:\pool
share \\darkstar
</pre>
<p>并通过网络共享以下目录:
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +01:00
\\darkstar\pool -&gt; C:\pool
\\darkstar\d1 -&gt; F:\array
\\darkstar\d2 -&gt; G:\array
\\darkstar\d3 -&gt; H:\array
</pre>
<p>以允许远程客户端访问 \\darkstar\pool 处的所有文件。
</p><p>您可能还需要配置远程客户端,使用以下命令启用对远程符号链接的访问:
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +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">
2026-10-29 06:56:28 +01:00
取消删除 (Undeleting)
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>SnapRAID 的功能更像一个备份程序而不是 RAID 系统,
它可以使用 -f, --filter 选项来恢复或取消删除文件到其以前的状态:
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +01:00
snapraid fix -f FILE
</pre>
<p>或者对于一个目录:
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +01:00
snapraid fix -f DIR/
</pre>
<p>您也可以使用 -m, --filter-missing 选项来仅恢复目录内意外删除的文件,
该选项仅恢复丢失的文件,保持所有其他文件不变。
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +01:00
snapraid fix -m -f DIR/
</pre>
<p>或者使用以下命令恢复所有驱动器上所有已删除的文件:
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +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">
2026-10-29 06:56:28 +01:00
数据恢复 (Recovering)
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>最糟糕的情况发生了,您丢失了一个或多个磁盘!
</p><p>**不要惊慌!** 您将能够恢复它们!
</p><p>您必须做的第一件事是避免对磁盘阵列进行进一步的更改。
禁用对其的任何远程连接以及任何计划的进程,包括任何计划的 SnapRAID
夜间同步或 scrub。
</p><p>然后继续执行以下步骤。
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-15 15:15:14 +01:00
STEP 1 -&gt; 重新配置
2026-03-30 10:01:17 +02:00
</h3>
2025-12-15 15:15:14 +01:00
<p>您需要一些空间来恢复,理想情况下是在额外的备用磁盘上,
但外部 USB 磁盘或远程磁盘也足够。
2026-03-30 10:01:17 +02:00
</p><p>修改 SnapRAID 配置文件,使故障磁盘的 <b>data</b> 或 <b>parity</b> 选项指向
2025-12-15 15:15:14 +01:00
一个具有足够空闲空间来恢复文件的位置。
2026-03-30 10:01:17 +02:00
</p><p>例如,如果磁盘 <b>d1</b> 发生故障,则从:
</p><pre>
2025-12-15 15:15:14 +01:00
data d1 /mnt/disk1/
</pre>
<p>更改为:
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +01:00
data d1 /mnt/new_spare_disk/
</pre>
2026-03-30 10:01:17 +02:00
<p>如果需要恢复的磁盘是奇偶校验磁盘,请更新相应的 <b>parity</b> 选项。
2025-12-15 15:15:14 +01:00
如果您有多个故障磁盘,请更新所有它们的配置选项。
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-15 15:15:14 +01:00
STEP 2 -&gt; 修复
2026-03-30 10:01:17 +02:00
</h3>
2025-12-15 15:15:14 +01:00
<p>运行 fix 命令,并将日志存储在外部文件中:
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +01:00
snapraid -d NAME -l fix.log fix
</pre>
2026-03-30 10:01:17 +02:00
<p>其中 NAME 是磁盘的名称,例如我们前面例子中的 <b>d1</b>。
如果需要恢复的磁盘是奇偶校验磁盘,请使用名称 <b>parity</b>、<b>2-parity</b> 等。
2025-12-15 15:15:14 +01:00
如果您有多个故障磁盘,请使用多个 -d 选项来指定所有它们。
</p><p>此命令将花费很长时间。
</p><p>确保您有几 GB 的可用空间来存储 fix.log 文件。
在有足够可用空间的磁盘上运行它。
</p><p>现在您已经恢复了所有可恢复的内容。如果有些文件部分或完全不可恢复,
2026-03-30 10:01:17 +02:00
它们将被重命名并添加 <b>.unrecoverable</b> 扩展名。
</p><p>您可以通过检查所有以 <b>unrecoverable:</b> 开头的行,在 fix.log 文件中
2025-12-15 15:15:14 +01:00
找到所有不可恢复块的详细列表。
</p><p>如果您对恢复不满意,您可以根据需要重试多次。
2026-03-30 10:01:17 +02:00
</p><p>例如,如果您在上次 <b>sync</b> 之后从阵列中删除了文件,
2025-12-15 15:15:14 +01:00
这可能导致某些文件无法恢复。
2026-03-30 10:01:17 +02:00
在这种情况下,您可以使用 -i, --import 选项重试 <b>fix</b>,
2025-12-15 15:15:14 +01:00
指定这些文件现在在哪里,以便将它们再次包含在恢复过程中。
</p><p>如果您对恢复感到满意,您可以继续进行,
2026-03-30 10:01:17 +02:00
但请注意,在同步之后,您不能再重试 <b>fix</b> 命令了!
</p></div>
<div class="manual-section-level-3">
<h3 id="sec4-4-3" class="manual-title-level-3">
2025-12-15 15:15:14 +01:00
STEP 3 -&gt; 检查
2026-03-30 10:01:17 +02:00
</h3>
<p>作为一项谨慎的检查,您现在可以运行 <b>check</b> 命令,以确保
2025-12-15 15:15:14 +01:00
恢复的磁盘上的一切都是正确的。
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +01:00
snapraid -d NAME -a check
</pre>
2026-03-30 10:01:17 +02:00
<p>其中 NAME 是磁盘的名称,例如我们前面例子中的 <b>d1</b>。
</p><div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-d 和 -a 选项告诉 SnapRAID 只检查指定的磁盘并忽略所有奇偶校验数据。
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
</div>
</div>
</div>
2025-12-15 15:15:14 +01:00
<p>此命令将花费很长时间,但如果您不是过于谨慎,可以跳过它。
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-15 15:15:14 +01:00
STEP 4 -&gt; 同步
2026-03-30 10:01:17 +02:00
</h3>
<p>运行 <b>sync</b> 命令以将阵列与新磁盘重新同步。
</p><pre>
2025-12-15 15:15:14 +01:00
snapraid sync
</pre>
<p>如果所有内容都已恢复,此命令是即时的。
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">
2026-10-29 06:56:28 +01:00
命令 (Commands)
2026-03-30 10:01:17 +02:00
</h1>
2026-10-29 06:56:28 +01:00
<p>SnapRAID 提供了几个简单的命令,允许您:
2025-12-15 15:15:14 +01:00
</p><ul>
<li>
2026-03-30 10:01:17 +02:00
打印阵列的状态 -&gt; <b>status</b>
2025-12-15 15:15:14 +01:00
</li>
<li>
2026-03-30 10:01:17 +02:00
控制磁盘 -&gt; <b>smart</b>、<b>probe</b>、<b>up</b>、<b>down</b>
2025-12-15 15:15:14 +01:00
</li>
<li>
2026-10-29 06:56:28 +01:00
创建备份/恢复点 -&gt; <b>sync</b>
2025-12-15 15:15:14 +01:00
</li>
<li>
2026-03-30 10:01:17 +02:00
定期检查数据 -&gt; <b>scrub</b>
2025-12-15 15:15:14 +01:00
</li>
<li>
2026-10-29 06:56:28 +01:00
恢复上一个备份/恢复点 -&gt; <b>fix</b>。
2025-12-15 15:15:14 +01:00
</li>
</ul>
2026-10-29 06:56:28 +01:00
<p>命令必须用小写字母编写。
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-15 15:15:14 +01:00
status
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>打印磁盘阵列状态的摘要。
2026-10-29 06:56:28 +01:00
</p><p>它包括有关奇偶校验碎片、块未经检查有多久,以及在数据擦洗 (scrubbing)
2025-12-15 15:15:14 +01:00
期间遇到的所有记录的静默错误的信息。
2026-03-30 10:01:17 +02:00
</p><p>所提供的信息指的是您上次运行 <b>sync</b> 的时间。
2025-12-15 15:15:14 +01:00
不考虑后来的修改。
</p><p>如果检测到坏块,则会列出它们的块号。
2026-03-30 10:01:17 +02:00
要修复它们,您可以使用 <b>fix -e</b> 命令。
2025-12-15 15:15:14 +01:00
</p><p>它还会显示一个图表,表示每个块上次被 scrub 或 sync 的时间。
2026-03-30 10:01:17 +02:00
被 scrub 的块显示为 <b>*</b>,已同步但尚未 scrub 的块显示为 <b>o</b>。
2025-12-15 15:15:14 +01:00
</p><p>不会修改任何内容。
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-15 15:15:14 +01:00
smart
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>打印系统中所有磁盘的 SMART 报告。
</p><p>它包括对明年故障概率的估计,允许您计划更换显示
可疑属性的磁盘进行维护。
</p><p>此概率估计是通过将磁盘的 SMART 属性与
Backblaze 提供的以下数据进行关联获得的:
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-15 15:15:14 +01:00
</pre>
2026-03-30 10:01:17 +02:00
<p>如果 SMART 报告磁盘正在发生故障,则会为该磁盘打印 <b>FAIL</b> 或 <b>PREFAIL</b>,
2025-12-15 15:15:14 +01:00
并且 SnapRAID 返回错误。
在这种情况下,**强烈建议**立即更换磁盘。
</p><p>其他可能的状态字符串有:
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-15 15:15:14 +01:00
logfail
2026-03-30 10:01:17 +02:00
</div><div class="manual-tag-description">
2025-12-15 15:15:14 +01:00
过去,某些属性低于阈值。
2026-03-30 10:01:17 +02:00
</div>
</div>
<div class="manual-tag-entry">
<div class="manual-tag-name">
2025-12-15 15:15:14 +01:00
logerr
2026-03-30 10:01:17 +02:00
</div><div class="manual-tag-description">
2025-12-15 15:15:14 +01:00
设备错误日志包含错误。
2026-03-30 10:01:17 +02:00
</div>
</div>
<div class="manual-tag-entry">
<div class="manual-tag-name">
2025-12-15 15:15:14 +01:00
selferr
2026-03-30 10:01:17 +02:00
</div><div class="manual-tag-description">
2025-12-15 15:15:14 +01:00
设备自检日志包含错误。
2026-03-30 10:01:17 +02:00
</div>
</div>
</div>
2025-12-15 15:15:14 +01:00
<p>如果指定了 -v, --verbose 选项,则会提供更深入的统计分析。
此分析可以帮助您决定是否需要更多或更少的奇偶校验。
2026-03-30 10:01:17 +02:00
</p><p>此命令使用 <b>smartctl</b> 工具,相当于在所有设备上运行 <b>smartctl -a</b>。
2025-12-15 15:15:14 +01:00
</p><p>如果您的设备未正确自动检测,您可以使用配置
2026-03-30 10:01:17 +02:00
文件中的 <b>smartctl</b> 选项指定自定义命令。
2025-12-15 15:15:14 +01:00
</p><p>不会修改任何内容。
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-15 15:15:14 +01:00
probe
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>打印系统中所有磁盘的**电源**状态。
2026-03-30 10:01:17 +02:00
</p><p><b>Standby</b>(待机)表示磁盘未转动。<b>Active</b>(活动)表示
2025-12-15 15:15:14 +01:00
磁盘正在转动。
2026-03-30 10:01:17 +02:00
</p><p>此命令使用 <b>smartctl</b> 工具,相当于在所有设备上运行
<b>smartctl -n standby -i</b>。
2025-12-15 15:15:14 +01:00
</p><p>如果您的设备未正确自动检测,您可以使用配置
2026-03-30 10:01:17 +02:00
文件中的 <b>smartctl</b> 选项指定自定义命令。
2025-12-15 15:15:14 +01:00
</p><p>不会修改任何内容。
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-15 15:15:14 +01:00
up
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>使阵列中的所有磁盘转动起来。
</p><p>您可以使用 -d, --filter-disk 选项只启动特定的磁盘。
</p><p>同时启动所有磁盘需要大量的电力。
确保您的电源能够承受。
</p><p>不会修改任何内容。
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-15 15:15:14 +01:00
down
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>使阵列中的所有磁盘停转。
2026-03-30 10:01:17 +02:00
</p><p>此命令使用 <b>smartctl</b> 工具,相当于在所有设备上运行
<b>smartctl -s standby,now</b>。
2025-12-15 15:15:14 +01:00
</p><p>您可以使用 -d, --filter-disk 选项只停转特定的磁盘。
</p><p>要在发生错误时自动停转,您可以将 -s, --spin-down-on-error
2026-03-30 10:01:17 +02:00
选项与任何其他命令一起使用,这相当于在发生错误时手动运行 <b>down</b>。
2025-12-15 15:15:14 +01:00
</p><p>不会修改任何内容。
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-15 15:15:14 +01:00
diff
2026-03-30 10:01:17 +02:00
</h2>
<p>列出自上次 <b>sync</b> 以来所有已修改、需要重新计算奇偶校验数据的
2025-12-15 15:15:14 +01:00
文件。
</p><p>此命令不检查文件数据,仅检查文件时间戳、大小和 inode。
</p><p>列出所有更改的文件后,会显示更改的摘要,按以下方式分组:
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-15 15:15:14 +01:00
equal
2026-03-30 10:01:17 +02:00
</div><div class="manual-tag-description">
2025-12-15 15:15:14 +01:00
文件与之前相比未更改。
2026-03-30 10:01:17 +02:00
</div>
</div>
<div class="manual-tag-entry">
<div class="manual-tag-name">
2025-12-15 15:15:14 +01:00
added
2026-03-30 10:01:17 +02:00
</div><div class="manual-tag-description">
2025-12-15 15:15:14 +01:00
之前不存在、已添加的文件。
2026-03-30 10:01:17 +02:00
</div>
</div>
<div class="manual-tag-entry">
<div class="manual-tag-name">
2025-12-15 15:15:14 +01:00
removed
2026-03-30 10:01:17 +02:00
</div><div class="manual-tag-description">
2025-12-15 15:15:14 +01:00
已删除的文件。
2026-03-30 10:01:17 +02:00
</div>
</div>
<div class="manual-tag-entry">
<div class="manual-tag-name">
2025-12-15 15:15:14 +01:00
updated
2026-03-30 10:01:17 +02:00
</div><div class="manual-tag-description">
2025-12-15 15:15:14 +01:00
大小或时间戳不同的文件,表示它们已被修改。
2026-03-30 10:01:17 +02:00
</div>
</div>
<div class="manual-tag-entry">
<div class="manual-tag-name">
2025-12-15 15:15:14 +01:00
moved
2026-03-30 10:01:17 +02:00
</div><div class="manual-tag-description">
2026-10-29 06:56:28 +01:00
在同一磁盘上移动或重命名并保留相同 inode 的文件。
它们通过具有相同的 inode、大小和时间戳,但路径不同来识别。
文件名也可以不同。
2026-03-30 10:01:17 +02:00
</div>
</div>
<div class="manual-tag-entry">
<div class="manual-tag-name">
2025-12-15 15:15:14 +01:00
copied
2026-03-30 10:01:17 +02:00
</div><div class="manual-tag-description">
在相同或不同磁盘上复制的文件,且原始文件仍然存在。
它们通过具有相同的名称、大小和时间戳进行识别。
如果亚秒级时间戳为零,则必须完整路径匹配才能识别,而不仅仅是名
称。
</div>
</div>
<div class="manual-tag-entry">
<div class="manual-tag-name">
relocated
</div><div class="manual-tag-description">
2026-10-29 06:56:28 +01:00
移动到不同目录或磁盘的文件,且原始文件已消失并不保留 inode。
2026-03-30 10:01:17 +02:00
它们通过具有相同的名称、大小和时间戳进行识别。
如果亚秒级时间戳为零,则必须完整路径匹配才能识别。
2026-10-29 06:56:28 +01:00
与 'moved' 文件不同,重定位的文件要求文件名保持不变。
2026-03-30 10:01:17 +02:00
</div>
</div>
<div class="manual-tag-entry">
<div class="manual-tag-name">
2025-12-15 15:15:14 +01:00
restored
2026-03-30 10:01:17 +02:00
</div><div class="manual-tag-description">
inode 不同但目录、名称、大小和时间戳匹配的文件。
2025-12-15 15:15:14 +01:00
这些通常是删除后恢复的文件。
2026-03-30 10:01:17 +02:00
</div>
</div>
</div>
<p>如果需要 <b>sync</b>,进程返回码为 2,而不是默认的 0。
2025-12-15 15:15:14 +01:00
返回码 1 用于一般错误情况。
</p><p>不会修改任何内容。
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-15 15:15:14 +01:00
sync
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>更新奇偶校验信息。读取磁盘阵列中所有已修改的文件,
并更新相应的奇偶校验数据。
</p><p>您可以随时按 Ctrl+C 停止此过程,而不会丢失已完成的工作。
2026-03-30 10:01:17 +02:00
在下次运行时,<b>sync</b> 过程将从中断的地方恢复。
2025-12-15 15:15:14 +01:00
</p><p>如果在过程中发现静默错误或输入/输出错误,
相应的块会被标记为坏块。
</p><p>文件通过路径和/或 inode 识别,并检查大小和时间戳。
如果文件大小或时间戳不同,则会为整个文件重新计算奇偶校验数据。
如果文件在同一磁盘上被移动或重命名,保持相同的 inode,则不重新计算奇偶校验。
如果文件移动到另一个磁盘,则重新计算奇偶校验,
但保留以前计算的散列信息。
2026-03-30 10:01:17 +02:00
</p><p>如果需要,会修改 <b>content</b> 和 <b>parity</b> 文件。
2025-12-15 15:15:14 +01:00
阵列中的文件**不会**被修改。
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-15 15:15:14 +01:00
scrub
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>Scrub 阵列,检查数据和奇偶校验磁盘中的静默或输入/输出错误。
</p><p>每次调用检查大约 8% 的阵列,排除在过去 10 天内
已被 scrub 的数据。
这意味着每周 scrub 一次可确保每隔三个月至少检查一次数据的每一位。
</p><p>您可以使用 -p, --plan 选项定义不同的 scrub 计划或数量,
该选项接受:
bad - Scrub 标记为坏块的块。
new - Scrub 刚刚同步但尚未 scrub 的块。
full - Scrub 所有内容。
0-100 - Scrub 指定百分比的块。
</p><p>如果指定了百分比数量,您还可以使用 -o, --older-than
选项来定义块应该有多旧。
最旧的块首先被 scrub,确保最佳检查。
如果您只想 scrub 刚刚同步但尚未 scrub 的块,
2026-03-30 10:01:17 +02:00
请使用 <b>-p new</b> 选项。
</p><p>要获取 scrub 状态的详细信息,请使用 <b>status</b> 命令。
2025-12-15 15:15:14 +01:00
</p><p>对于发现的任何静默错误或输入/输出错误,相应的块
2026-03-30 10:01:17 +02:00
会在 <b>content</b> 文件中被标记为坏块。
这些坏块列在 <b>status</b> 中,可以使用 <b>fix -e</b> 修复。
2025-12-15 15:15:14 +01:00
修复后,在下次 scrub 时,它们将被重新检查,如果发现已更正,
则会删除坏块标记。
2026-03-30 10:01:17 +02:00
要仅 scrub 坏块,您可以使用 <b>scrub -p bad</b> 命令。
</p><p>建议仅在已同步的阵列上运行 <b>scrub</b>,以避免
2025-12-15 15:15:14 +01:00
由未同步数据引起的报告错误。这些错误被识别为不是静默错误,
并且块不会被标记为坏块,但此类错误会在命令的输出中报告。
2026-03-30 10:01:17 +02:00
</p><p><b>content</b> 文件会被修改以更新每个块上次检查的时间
2025-12-15 15:15:14 +01:00
并标记坏块。
2026-03-30 10:01:17 +02:00
<b>parity</b> 文件**不会**被修改。
2025-12-15 15:15:14 +01:00
阵列中的文件**不会**被修改。
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-15 15:15:14 +01:00
fix
2026-03-30 10:01:17 +02:00
</h2>
2026-10-29 06:56:28 +01:00
<p>修复所有文件和校验数据。
</p><p>将所有文件和校验数据与上一次 <b>sync</b> 中保存的状态进行比较。
如果发现差异,则将其恢复到存储的状态。
</p><p>警告!
<b>fix</b> 命令不区分错误和故意修改。
它会无条件地将文件状态恢复到上一次 <b>sync</b> 的状态。
2025-12-15 15:15:14 +01:00
</p><p>如果未指定其他选项,则处理整个阵列。
使用过滤选项选择要操作的文件或磁盘的子集。
2026-03-30 10:01:17 +02:00
</p><p>要仅修复在 <b>sync</b> 和 <b>scrub</b> 期间标记为坏块的块,
2025-12-15 15:15:14 +01:00
请使用 -e, --filter-error 选项。
2026-03-30 10:01:17 +02:00
与其他过滤选项不同,此选项仅对自上次 <b>sync</b> 以来未更改的
2025-12-15 15:15:14 +01:00
文件应用修复。
</p><p>SnapRAID 会重命名所有无法修复的文件,并添加
2026-03-30 10:01:17 +02:00
<b>.unrecoverable</b> 扩展名。
</p><p>在修复之前,会扫描整个阵列以查找自上次 <b>sync</b>
2025-12-15 15:15:14 +01:00
操作以来移动的任何文件。
这些文件通过它们的时间戳识别,忽略它们的名称
和目录,并在必要时用于恢复过程。
如果您将其中一些移到了阵列之外,您可以使用 -i, --import
选项指定额外的目录进行扫描。
</p><p>文件仅通过路径识别,而不通过 inode 识别。
2026-03-30 10:01:17 +02:00
</p><p><b>content</b> 文件**不会**被修改。
如果需要,<b>parity</b> 文件会被修改。
2025-12-15 15:15:14 +01:00
如果需要,阵列中的文件会被修改。
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-15 15:15:14 +01:00
check
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>验证所有文件和奇偶校验数据。
2026-03-30 10:01:17 +02:00
</p><p>它的工作方式类似于 <b>fix</b>,但它只模拟恢复,**不会**对阵列
2025-12-15 15:15:14 +01:00
写入任何更改。
</p><p>此命令主要用于手动验证,
例如在恢复过程之后或在其他特殊条件下。
2026-03-30 10:01:17 +02:00
对于定期和计划的检查,请使用 <b>scrub</b>。
2025-12-15 15:15:14 +01:00
</p><p>如果您使用 -a, --audit-only 选项,则仅检查文件
数据散列,而忽略奇偶校验数据,以加快运行速度。
</p><p>文件仅通过路径识别,而不通过 inode 识别。
</p><p>不会修改任何内容。
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-15 15:15:14 +01:00
list
2026-03-30 10:01:17 +02:00
</h2>
<p>列出上次 <b>sync</b> 时阵列中包含的所有文件。
2025-12-15 15:15:14 +01:00
</p><p>使用 -v 或 --verbose,还会显示亚秒级时间。
</p><p>不会修改任何内容。
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-15 15:15:14 +01:00
dup
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>列出所有重复文件。如果两个文件的散列匹配,则认为它们相等。
不读取文件数据;仅使用预先计算的散列。
</p><p>不会修改任何内容。
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-15 15:15:14 +01:00
pool
2026-03-30 10:01:17 +02:00
</h2>
<p>在 <b>pooling</b> 目录中创建或更新磁盘阵列中所有文件
2025-12-15 15:15:14 +01:00
的虚拟视图。
</p><p>文件不会被复制,而是使用符号链接连接。
</p><p>更新时,所有现有的符号链接和空
子目录都会被删除,并替换为阵列的新视图。
任何其他常规文件保留在原位。
</p><p>不会修改 pool 目录之外的任何内容。
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-15 15:15:14 +01:00
devices
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>打印阵列使用的低级设备。
</p><p>此命令显示阵列中的设备关联,主要用作脚本接口。
</p><p>前两列是低级设备 ID 和路径。
接下来的两列是高级设备 ID 和路径。
最后一列是阵列中的磁盘名称。
</p><p>在大多数情况下,阵列中的每个磁盘都有一个低级设备,
但在一些更复杂的配置中,单个阵列磁盘可能会使用多个
低级设备。
</p><p>不会修改任何内容。
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-15 15:15:14 +01:00
touch
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>为所有亚秒级时间戳设置为零的文件设置一个任意的
亚秒级时间戳。
</p><p>这提高了 SnapRAID 识别移动和复制文件的能力,
因为它使时间戳几乎独一无二,减少了可能的重复。
</p><p>更具体地说,如果亚秒级时间戳不为零,
则移动或复制的文件在名称、大小和时间戳匹配时被识别为
此类。如果亚秒级时间戳为零,则仅当完整路径、
大小和时间戳都匹配时才被视为副本。
</p><p>不会修改秒精度时间戳,
因此会保留文件的所有日期和时间。
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-15 15:15:14 +01:00
rehash
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>安排对整个阵列进行重新散列。
</p><p>此命令更改使用的散列类型,通常是在从 32 位系统升级到 64 位系统时,
以从 MurmurHash3 切换到更快的 SpookyHash。
</p><p>如果您已经在使用最佳散列,则此命令不执行任何操作,
并通知您无需执行任何操作。
2026-03-30 10:01:17 +02:00
</p><p>重新散列不会立即执行,而是在 <b>sync</b> 和 <b>scrub</b> 期间
2025-12-15 15:15:14 +01:00
逐步进行。
2026-03-30 10:01:17 +02:00
</p><p>您可以使用 <b>status</b> 检查重新散列状态。
2025-12-15 15:15:14 +01:00
</p><p>在重新散列期间,SnapRAID 保持完全功能,
2026-03-30 10:01:17 +02:00
唯一的例外是 <b>dup</b> 无法使用不同的散列检测重复的文件。
</p></div>
<div class="manual-section-level-2">
<h2 id="sec5-17" class="manual-title-level-2">
locate
2025-12-15 15:15:14 +01:00
</h2>
2026-03-30 10:01:17 +02:00
<p>查找存储在校验盘中的文件。对于每个匹配的文件,它会打印其在校验文件中的位置
以及占用的分片数量。
</p><p>您可以使用 -t, --tail 选项将操作限制在占用校验盘指定尾部部分的
文件上。
</p><p>如果您想重新分配这些文件,可以使用 -W, --force-realloc-tail 选项。
请注意,在重新分配过程中,此类文件将不受校验保护。
</p></div>
</div>
<div class="manual-section-level-1">
<h1 id="sec6" class="manual-title-level-1">
2026-10-29 06:56:28 +01:00
选项 (Options)
2026-03-30 10:01:17 +02:00
</h1>
2025-12-15 15:15:14 +01:00
<p>SnapRAID 提供以下选项:
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-15 15:15:14 +01:00
-c, --conf CONFIG
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
2025-12-15 15:15:14 +01:00
选择要使用的配置文件。如果未指定,在 Unix 中,
2026-03-30 10:01:17 +02:00
如果存在,则使用文件 <b>/usr/local/etc/snapraid.conf</b>,
否则使用 <b>/etc/snapraid.conf</b>。
在 Windows 中,它使用与 <b>snapraid.exe</b> 相同的目录中的文件 <b>snapraid.conf</b>。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-f, --filter PATTERN
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
过滤要在 <b>check</b> 和 <b>fix</b> 中处理的文件。
2025-12-15 15:15:14 +01:00
仅处理与指定模式匹配的文件。
此选项可以多次使用。
有关模式规范的更多详细信息,请参阅 PATTERN 部分。
在 Unix 中,如果使用 globbing 字符,请确保它们被引用。
2026-03-30 10:01:17 +02:00
此选项只能与 <b>check</b> 和 <b>fix</b> 一起使用。
不能与 <b>sync</b> 和 <b>scrub</b> 一起使用,因为它们总是处理整个阵列。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-d, --filter-disk NAME
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
过滤要在 <b>check</b>、<b>fix</b>、<b>up</b> 和 <b>down</b> 中处理的磁盘。
2025-12-15 15:15:14 +01:00
您必须指定配置文件中定义的磁盘名称。
2026-03-30 10:01:17 +02:00
您也可以指定奇偶校验磁盘的名称:<b>parity</b>、<b>2-parity</b>、
<b>3-parity</b> 等,以将操作限制到特定的奇偶校验磁盘。
2025-12-15 15:15:14 +01:00
如果您组合使用多个 --filter、--filter-disk 和 --filter-missing 选项,
则仅选择与所有过滤器匹配的文件。
此选项可以多次使用。
2026-03-30 10:01:17 +02:00
此选项只能与 <b>check</b>、<b>fix</b>、<b>up</b> 和 <b>down</b> 一起使用。
不能与 <b>sync</b> 和 <b>scrub</b> 一起使用,因为它们总是处理整个阵列。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-m, --filter-missing
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
过滤要在 <b>check</b> 和 <b>fix</b> 中处理的文件。
2025-12-15 15:15:14 +01:00
仅处理阵列中丢失或已删除的文件。
2026-03-30 10:01:17 +02:00
与 <b>fix</b> 一起使用时,此选项充当 <b>undelete</b> 命令。
2025-12-15 15:15:14 +01:00
如果您组合使用多个 --filter、--filter-disk 和 --filter-missing 选项,
则仅选择与所有过滤器匹配的文件。
2026-03-30 10:01:17 +02:00
此选项只能与 <b>check</b> 和 <b>fix</b> 一起使用。
不能与 <b>sync</b> 和 <b>scrub</b> 一起使用,因为它们总是处理整个阵列。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-e, --filter-error
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
处理 <b>check</b> 和 <b>fix</b> 中有错误的文件。
它仅处理在 <b>sync</b> 和 <b>scrub</b> 期间块被标记为静默或输入/输出错误的
文件,如 <b>status</b> 中所列。
此选项只能与 <b>check</b> 和 <b>fix</b> 一起使用。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-p, --plan PERC|bad|new|full
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
2025-12-15 15:15:14 +01:00
选择 scrub 计划。如果 PERC 是一个介于 0 到 100 之间的数值,
则将其解释为要 scrub 的块的百分比。
除了百分比,您还可以指定一个计划:
2026-03-30 10:01:17 +02:00
<b>bad</b> scrub 坏块,<b>new</b> scrub 尚未 scrub 的块,
<b>full</b> scrub 所有内容。
此选项只能与 <b>scrub</b> 一起使用。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-o, --older-than DAYS
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
选择要在 <b>scrub</b> 中处理的阵列的最旧部分。
2025-12-15 15:15:14 +01:00
DAYS 是块被 scrub 的最小天数;默认值为 10。
无论此选项如何,标记为坏块的块始终会被 scrub。
2026-03-30 10:01:17 +02:00
此选项只能与 <b>scrub</b> 一起使用。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-a, --audit-only
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
在 <b>check</b> 中,验证文件的散列而不
2025-12-15 15:15:14 +01:00
检查奇偶校验数据。
如果您只对检查文件数据感兴趣,此选项可以显著加快
检查过程。
2026-03-30 10:01:17 +02:00
此选项只能与 <b>check</b> 一起使用。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-h, --pre-hash
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
在 <b>sync</b> 中,运行所有新数据的初步散列阶段,
2025-12-15 15:15:14 +01:00
以便在奇偶校验计算之前进行额外验证。
2026-03-30 10:01:17 +02:00
通常,在 <b>sync</b> 中,不进行初步散列,并且新
2025-12-15 15:15:14 +01:00
数据仅在首次读取进行奇偶校验计算之前散列。
此过程在系统处于
重负载下发生,所有磁盘都在转动,CPU 也很忙。
这对机器来说是一种极端情况,如果它有潜在的硬件问题,
静默错误可能无法被检测到,因为数据尚未散列。
2026-03-30 10:01:17 +02:00
为避免此风险,您可以启用 <b>pre-hash</b> 模式,将
2025-12-15 15:15:14 +01:00
所有数据读取两次以确保其完整性。
此选项还会验证阵列内移动的文件,
以确保移动操作成功,并在必要时
允许您在继续之前运行 fix 操作。
2026-03-30 10:01:17 +02:00
此选项只能与 <b>sync</b> 一起使用。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-i, --import DIR
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
从指定目录导入自上次 <b>sync</b> 以来从阵列中删除的任何文件。
如果您仍然拥有此类文件,它们可用于 <b>check</b>
和 <b>fix</b> 以改进恢复过程。
2025-12-15 15:15:14 +01:00
读取文件,包括在子目录中,并且无论其名称如何都会被识别。
2026-03-30 10:01:17 +02:00
此选项只能与 <b>check</b> 和 <b>fix</b> 一起使用。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-s, --spin-down-on-error
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
2025-12-15 15:15:14 +01:00
在任何错误发生时,在退出并带有非零状态码之前,
将所有托管的磁盘停转。这可以防止驱动器在中止操作后
保持活动和转动,有助于避免不必要的热量积聚和功耗。
使用此选项可确保即使命令失败,磁盘也能安全停止。
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-15 15:15:14 +01:00
-w, --bw-limit RATE
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
2025-12-15 15:15:14 +01:00
对所有磁盘应用全局带宽限制。RATE 是
每秒的字节数。您可以指定乘数,例如 K、M 或 G
(例如,--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">
2026-10-29 06:56:28 +01:00
-t, --tail SIZE
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
将文件列表限制为那些使用校验盘指定尾部大小以内的文件。
您可以使用乘数,如 K、M、G 或 T(例如 --tail 1G)。
此选项仅在与 <b>locate</b> 命令配合使用时有效。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-A, --stats
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
2025-12-15 15:15:14 +01:00
启用扩展状态视图,显示附加信息。
屏幕显示两个图表:
第一个图表显示每个磁盘的缓冲条带数,以及
当前正在该磁盘上访问的文件的文件路径。
通常,最慢的磁盘将没有可用缓冲区,
这决定了可达到的最大带宽。
第二个图表显示在过去 100 秒内等待所花费的时间百分比。
预计最慢的磁盘会导致大部分等待时间,
而其他磁盘应该只有很少或没有等待时间,
因为它们可以使用缓冲条带。
此图表还显示了等待散列计算和 RAID
计算所花费的时间。
所有计算都与磁盘操作并行运行。
因此,只要至少一个磁盘有可测量的等待时间,
就表明 CPU 足够快,能够跟上工作负载。
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-15 15:15:14 +01:00
-Z, --force-zero
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
2025-12-15 15:15:14 +01:00
强制执行不安全的同步操作:同步大小为零但以前非零的文件。
如果 SnapRAID 检测到这种情况,它会停止进行,
除非您指定此选项。
这使您可以轻松检测到在系统崩溃后,
某些访问的文件被截断的情况。
这在带有 ext3/ext4 文件系统的 Linux 中是一种可能的情况。
2026-03-30 10:01:17 +02:00
此选项只能与 <b>sync</b> 一起使用。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-E, --force-empty
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
2025-12-15 15:15:14 +01:00
强制执行不安全的同步操作:同步所有原始文件丢失的磁盘。
如果 SnapRAID 检测到磁盘上最初存在的所有文件都丢失或被重写,
它会停止进行,除非您指定此选项。
这使您可以轻松检测到数据文件系统未挂载的情况。
2026-03-30 10:01:17 +02:00
此选项只能与 <b>sync</b> 一起使用。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-U, --force-uuid
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
2025-12-15 15:15:14 +01:00
强制执行不安全的同步、检查和修复操作,当磁盘更改了它们的 UUID 时。
如果 SnapRAID 检测到某些磁盘更改了 UUID,
它会停止进行,除非您指定此选项。
这使您可以检测到您的磁盘被挂载在
错误的挂载点的情况。
但是,允许在单奇偶校验下进行单个 UUID 更改,
在多奇偶校验下进行更多更改,因为这是恢复后更换磁盘时的正常情况。
2026-03-30 10:01:17 +02:00
此选项只能与 <b>sync</b>、<b>check</b> 或 <b>fix</b> 一起使用。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-D, --force-device
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
2025-12-15 15:15:14 +01:00
强制执行不安全的修复操作,当磁盘无法访问或位于同一物理设备上时。
例如,如果您丢失了两个数据磁盘,并且有一个备用磁盘
只能恢复第一个,您可以忽略第二个无法访问的磁盘。
或者,如果您想在已使用的磁盘上剩余的可用空间中恢复一个磁盘,
共享同一物理设备。
2026-03-30 10:01:17 +02:00
此选项只能与 <b>fix</b> 一起使用。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-N, --force-nocopy
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
在 <b>sync</b>、<b>check</b> 和 <b>fix</b> 中,禁用复制检测启发式。
2025-12-15 15:15:14 +01:00
如果没有此选项,SnapRAID 假定具有相同属性(例如名称、大小和时间戳)
的文件是具有相同数据的副本。
这允许识别从一个磁盘移动到另一个磁盘的复制或移动的文件,
并重用已计算的散列信息以检测静默错误或恢复丢失的文件。
在某些罕见的情况下,此行为可能导致误报
或由于许多散列验证而导致过程缓慢,此选项允许您解决此类问题。
2026-03-30 10:01:17 +02:00
此选项只能与 <b>sync</b>、<b>check</b> 和 <b>fix</b> 一起使用。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-F, --force-full
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
在 <b>sync</b> 中,强制完全重新计算奇偶校验。
2025-12-15 15:15:14 +01:00
当您添加新的奇偶校验级别或如果使用较新的奇偶校验数据恢复到旧的内容文件时,
可以使用此选项。
这允许您重用内容文件中存在的散列来验证数据,
2026-03-30 10:01:17 +02:00
并使用现有奇偶校验数据在 <b>sync</b> 过程中保持数据保护,
2025-12-15 15:15:14 +01:00
而不是从头开始重新创建奇偶校验。
2026-03-30 10:01:17 +02:00
此选项只能与 <b>sync</b> 一起使用。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-R, --force-realloc
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
在 <b>sync</b> 中,强制完全重新分配文件并重建奇偶校验。
2025-12-15 15:15:14 +01:00
此选项可用于完全重新分配所有文件,
消除碎片,同时重用内容文件中存在的散列来验证数据。
2026-03-30 10:01:17 +02:00
此选项只能与 <b>sync</b> 一起使用。
2025-12-15 15:15:14 +01:00
**警告!** 此选项仅供专家使用,强烈建议不要使用它。
2026-03-30 10:01:17 +02:00
在 <b>sync</b> 操作期间,您**没有**数据保护。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2026-10-29 06:56:28 +01:00
-W, --force-realloc-tail SIZE
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
工作方式类似于 -R, --force-realloc,但仅限于每个校验文件的
2026-10-29 06:56:28 +01:00
指定尾部部分(最后 SIZE 字节)。
2026-03-30 10:01:17 +02:00
它会强制重新分配(移动)当前存储在该尾部部分的任何文件分片/块,
允许它们被放置在校验文件中任何有可用空间的地方(包括现有的
空隙)。
此选项的主要目的是缩小校验文件的磁盘占用大小。
如果重新分配成功清空了整个尾部区域(没有块继续使用它),
则校验文件将被截断,回收未使用的尾部空间。
您可以使用乘数,如 K、M、G 或 T(例如
--force-realloc-tail 1G)。
您可以使用 locate -t, --tail 提前了解受影响的文件。
警告!
此选项仅供专家使用,强烈建议不要使用。
在执行 <b>sync</b> 操作期间,受影响的文件将没有数据保护。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-l, --log FILE
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
2025-12-15 15:15:14 +01:00
将详细日志写入指定文件。
如果未指定此选项,则会将意外错误打印到屏幕,
在出现许多错误的情况下,可能导致输出过多。
指定 -l, --log 时,仅将导致 SnapRAID 停止的**致命错误**打印到
屏幕。
2026-03-30 10:01:17 +02:00
如果路径以 <b>&gt;&gt;</b> 开头,则文件以追加模式打开。
名称中的 <b>%D</b> 和 <b>%T</b> 出现会被替换为日期和时间,格式分别为 YYYYMMDD 和
HHMMSS。在 Windows 批处理文件中,您必须双写 <b>%</b> 字符,
例如 result-%%D.log。要使用 <b>&gt;&gt;</b>,您必须将名称括在引号中,
例如 <b>"&gt;&gt;result.log"</b>。
2025-12-15 15:15:14 +01:00
要将日志输出到标准输出或标准错误,
2026-03-30 10:01:17 +02:00
您可以使用 <b>"&gt;&amp;1"</b> 和 <b>"&gt;&amp;2"</b>。
2025-12-15 15:15:14 +01:00
有关日志标签描述,请参阅 snapraid_log.txt 文件或 man 页面。
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-15 15:15:14 +01:00
-L, --error-limit NUMBER
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
2025-12-15 15:15:14 +01:00
设置停止执行前的新错误限制。
默认情况下,如果 SnapRAID 遇到超过 100 个
输入/输出错误,它会停止,表明磁盘可能正在发生故障。
2026-03-30 10:01:17 +02:00
此选项影响 <b>sync</b> 和 <b>scrub</b>,它们被允许在第一组
2025-12-15 15:15:14 +01:00
磁盘错误后继续,以尝试完成其操作。
2026-03-30 10:01:17 +02:00
但是,<b>check</b> 和 <b>fix</b> 总是会在第一次错误时停止。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
-S, --start BLKSTART
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
2025-12-15 15:15:14 +01:00
从指定的块号开始处理。
在磁盘损坏的情况下,这对于重试检查或修复特定块可能很有用。
2026-10-29 06:56:28 +01:00
此选项主要用于高级手动恢复,并且仅受 <b>check</b> 和 <b>fix</b> 支持。
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-15 15:15:14 +01:00
-B, --count BLKCOUNT
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
2025-12-15 15:15:14 +01:00
仅处理指定数量的块。
2026-10-29 06:56:28 +01:00
此选项主要用于高级手动恢复,并且仅受 <b>check</b> 和 <b>fix</b> 支持。
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-15 15:15:14 +01:00
-C, --gen-conf CONTENT
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
2025-12-15 15:15:14 +01:00
从现有内容文件生成一个虚拟配置文件。
配置文件写入标准输出,不会覆盖现有文件。
此配置文件还包含在您丢失整个系统的情况下
重建磁盘挂载点所需的信息。
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-15 15:15:14 +01:00
-v, --verbose
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
2025-12-15 15:15:14 +01:00
向屏幕打印更多信息。
如果指定一次,它会打印排除的文件
和附加统计信息。
此选项对日志文件没有影响。
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-15 15:15:14 +01:00
-q, --quiet
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
2025-12-15 15:15:14 +01:00
向屏幕打印更少信息。
如果指定一次,它会删除进度条;两次,
正在运行的操作;三次,信息
消息;四次,状态消息。
致命错误始终会打印到屏幕。
此选项对日志文件没有影响。
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-15 15:15:14 +01:00
-H, --help
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
2025-12-15 15:15:14 +01:00
打印简短的帮助屏幕。
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-15 15:15:14 +01:00
-V, --version
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
2025-12-15 15:15:14 +01:00
打印程序版本。
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">
2026-10-29 06:56:28 +01:00
配置 (Configuration)
2026-03-30 10:01:17 +02:00
</h1>
2025-12-15 15:15:14 +01:00
<p>SnapRAID 需要一个配置文件来了解您的磁盘阵列
位于何处以及在哪里存储奇偶校验信息。
2026-03-30 10:01:17 +02:00
</p><p>在 Unix 中,如果存在,它使用文件 <b>/usr/local/etc/snapraid.conf</b>,
否则使用 <b>/etc/snapraid.conf</b>。
在 Windows 中,它使用与 <b>snapraid.exe</b> 相同的目录中的文件 <b>snapraid.conf</b>。
2025-12-15 15:15:14 +01:00
</p><p>它必须包含以下选项(区分大小写):
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-15 15:15:14 +01:00
parity FILE [,FILE] ...
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>定义用于存储奇偶校验信息的文件。
奇偶校验可实现针对单个磁盘
故障的保护,类似于 RAID5。
</p><p>您可以指定多个文件,它们必须位于不同的磁盘上。
当一个文件不能再增长时,使用下一个文件。
总可用空间必须至少与阵列中最大的数据磁盘一样大。
</p><p>您可以稍后添加额外的奇偶校验文件,但是您
不能重新排序或删除它们。
</p><p>将奇偶校验磁盘保留用于奇偶校验可确保它们不会碎片化,从而提高性能。
</p><p>在 Windows 中,每个磁盘会留下 256 MB 未使用空间,以避免
有关磁盘已满的警告。
</p><p>此选项是强制性的,并且只能使用一次。
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-15 15:15:14 +01:00
(2,3,4,5,6)-parity FILE [,FILE] ...
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>定义用于存储额外奇偶校验信息的文件。
</p><p>为指定的每个奇偶校验级别启用一个额外的保护级别:
</p><ul>
<li>
2-parity 启用 RAID6 双奇偶校验。
</li>
<li>
3-parity 启用三奇偶校验。
</li>
<li>
4-parity 启用四奇偶校验。
</li>
<li>
5-parity 启用五奇偶校验。
</li>
<li>
6-parity 启用六奇偶校验。
</li>
</ul>
<p>每个奇偶校验级别都需要存在所有先前的奇偶校验级别。
2026-03-30 10:01:17 +02:00
</p><p>与 <b>parity</b> 选项相同的注意事项适用。
2025-12-15 15:15:14 +01:00
</p><p>这些选项是可选的,并且只能使用一次。
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-15 15:15:14 +01:00
z-parity FILE [,FILE] ...
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>定义用于存储三奇偶校验的备用文件和格式。
2026-03-30 10:01:17 +02:00
</p><p>此选项是 <b>3-parity</b> 的替代方案,主要面向不支持
2025-12-15 15:15:14 +01:00
SSSE3 指令集的低端 CPU,如 ARM 或 AMD Phenom、Athlon 和 Opteron。
在这种情况下,它提供了更好的性能。
</p><p>此格式类似于 ZFS RAIDZ3 使用的格式,但更快。
与 ZFS 一样,它在三奇偶校验之外不起作用。
2026-03-30 10:01:17 +02:00
</p><p>当使用 <b>3-parity</b> 时,如果建议使用 <b>z-parity</b> 格式以提高性能,
2025-12-15 15:15:14 +01:00
您将收到警告。
</p><p>可以通过调整配置文件中的所需 z-parity 或 3-parity 文件,
2026-03-30 10:01:17 +02:00
并使用 <b>fix</b> 重新创建它,从一种格式转换为另一种格式。
</p></div>
<div class="manual-section-level-2">
<h2 id="sec7-4" class="manual-title-level-2">
2025-12-15 15:15:14 +01:00
content FILE
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>定义用于存储磁盘阵列中所有文件的列表和校验和的文件。
</p><p>它可以放置在用于数据、奇偶校验或
任何其他可用磁盘上。
2026-03-30 10:01:17 +02:00
如果您使用数据磁盘,此文件会自动从 <b>sync</b> 过程中排除。
2025-12-15 15:15:14 +01:00
</p><p>此选项是强制性的,并且可以多次使用以保存
同一文件的多个副本。
</p><p>您必须为使用的每个奇偶校验磁盘存储至少一个副本,
再加上一个。使用额外的副本不会有害。
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-15 15:15:14 +01:00
data NAME DIR
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>定义阵列中数据磁盘的名称和挂载点。
NAME 用于标识磁盘,并且必须是唯一的。
DIR 是磁盘在文件系统中的挂载点。
</p><p>您可以根据需要更改挂载点,只要保持 NAME 固定即可。
2026-10-29 06:56:28 +01:00
</p><p>但是,配置的路径必须始终解析为相同的基础数据。如果路径包含符号链接,
其目标必须保持稳定。不支持重定向此类符号链接以在运行中切换数据目录。
2025-12-15 15:15:14 +01:00
</p><p>您应该为阵列中的每个数据磁盘使用一个选项。
2026-03-30 10:01:17 +02:00
</p><p>您可以通过直接在配置文件中更改 NAME,然后运行 <b>sync</b> 命令来
2025-12-15 15:15:14 +01:00
稍后重命名磁盘。
在重命名的情况下,关联是使用存储的磁盘 UUID 完成的。
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>定义要通过 <b>smart</b> 和 <b>probe</b> 命令监控的额外磁盘的名称和挂载点。
</p><p>这对于监控不属于阵列但系统运行所必需的磁盘(例如启动盘)非常有用。
</p><p>请注意,此类磁盘不受 <b>up</b> 和 <b>down</b> 命令的影响,因为它们被预期始终处于
旋转状态。
</p></div>
<div class="manual-section-level-2">
<h2 id="sec7-7" class="manual-title-level-2">
2026-10-29 06:56:28 +01:00
snapshot
</h2>
<p>为 <b>sync</b>、<b>scrub</b>、<b>check</b> 和 <b>fix</b> 命令启用文件系统快照的使用。
</p><p>启用后,SnapRAID 会在“sync”开始时为每个受支持的数据文件系统创建
只读快照。这提供了每个文件系统的稳定视图,防止后续修改改变用于
计算校验的数据。
</p><p>这显著提高了恢复能力:如果从实时文件系统中删除了一个文件,
它仍会保留在快照中。这可以防止该数据块的校验数据变得“损坏”,
从而确保在另一个磁盘发生故障时您仍能成功恢复数据。
</p><p>此选项仅适用于在 Linux 中格式化为 Btrfs、Bcachefs 或 ZFS 文件系统,
以及在 Windows 中格式化为 NTFS 的数据磁盘。
校验磁盘或使用其他文件系统的数据磁盘将始终使用文件系统的活动版本。
</p><p>快照的创建和删除需要管理权限。
启用此选项时,请确保以必要的权限(例如 sudo)运行 SnapRAID。
</p><p>有关快照生命周期的详细说明,请参阅 SNAPSHOTS(快照)部分。
</p></div>
<div class="manual-section-level-2">
<h2 id="sec7-8" class="manual-title-level-2">
2025-12-15 15:15:14 +01:00
nohidden
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>排除所有隐藏文件和目录。
2026-03-30 10:01:17 +02:00
在 Unix 中,隐藏文件是以 <b>.</b> 开头的文件。
2025-12-15 15:15:14 +01:00
在 Windows 中,它们是具有隐藏属性的文件。
2026-03-30 10:01:17 +02:00
</p></div>
<div class="manual-section-level-2">
2026-10-29 06:56:28 +01:00
<h2 id="sec7-9" class="manual-title-level-2">
2025-12-15 15:15:14 +01:00
exclude/include PATTERN
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>定义要从同步过程中排除或包含的文件或目录模式。
所有模式都按指定的顺序处理。
2026-03-30 10:01:17 +02:00
</p><p>如果匹配的第一个模式是 <b>exclude</b> 模式,则排除该文件。
如果它是 <b>include</b> 模式,则包含该文件。
如果没有模式匹配,则如果指定的最后一个模式是 <b>include</b>,则排除该文件,
或者如果指定的最后一个模式是 <b>exclude</b>,则包含该文件。
2026-10-29 06:56:28 +01:00
</p><p>请注意,过滤是在目录遍历期间分层进行的。如果目录匹配 <b>exclude</b> 规则,
则整个目录将被跳过(修剪),并且不会评估其内部文件或子目录的任何 <b>include</b> 规则。
2025-12-15 15:15:14 +01:00
</p><p>有关模式规范的更多详细信息,请参阅 PATTERN 部分。
</p><p>此选项可以多次使用。
2026-03-30 10:01:17 +02:00
</p></div>
<div class="manual-section-level-2">
2026-10-29 06:56:28 +01:00
<h2 id="sec7-10" class="manual-title-level-2">
2025-12-15 15:15:14 +01:00
blocksize SIZE_IN_KIBIBYTES
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>定义奇偶校验的基本块大小(以 KiB 为单位)。
一 KiB 是 1024 字节。
</p><p>默认的 blocksize 是 256,这应该适用于大多数情况。
</p><p>**警告!** 此选项仅供专家使用,强烈建议不要更改此值。
将来要更改此值,您将需要重新创建整个奇偶校验!
</p><p>使用不同 blocksize 的一个原因是,如果您有许多小型文件,
数量级为数百万。
</p><p>对于每个文件,即使只有几个字节,也会分配一个完整的奇偶校验块,
并且对于许多文件,这可能导致大量的未使用奇偶校验空间。
当您完全填满奇偶校验磁盘时,不允许向数据磁盘
添加更多文件。
但是,浪费的奇偶校验不会跨数据磁盘累积。
数据磁盘上大量文件导致的浪费空间仅限制该数据磁盘上的数据量,
而不限制其他磁盘上的数据量。
</p><p>作为一个近似值,您可以假设每个文件浪费了半个块大小的空间。
例如,对于 100,000 个文件和 256 KiB 的块大小,您将浪费 12.8 GB 的奇偶校验空间,
这可能导致数据磁盘上少 12.8 GB 的可用空间。
2026-03-30 10:01:17 +02:00
</p><p>您可以使用 <b>status</b> 检查每个磁盘上浪费的空间量。
2025-12-15 15:15:14 +01:00
这是您必须在数据磁盘上留出的空闲空间量,
或用于不包含在阵列中的文件的空间量。
如果此值为负,则表示您即将填满奇偶校验空间,
它表示您仍然可以浪费的空间。
</p><p>为避免此问题,您可以为奇偶校验使用更大的分区。
例如,如果奇偶校验分区比数据磁盘大 12.8 GB,
则您有足够的额外空间来处理每个数据磁盘上多达 100,000 个
文件而不会浪费任何空间。
</p><p>在 Linux 中获得更大的奇偶校验分区的一个技巧是使用以下命令格式化它:
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +01:00
mkfs.ext4 -m 0 -T largefile4 DEVICE
</pre>
<p>这会导致大约 1.5% 的额外空间,对于 4 TB 磁盘约为 60 GB,
这允许每个数据磁盘上大约 460,000 个文件而不会浪费任何空间。
2026-03-30 10:01:17 +02:00
</p></div>
<div class="manual-section-level-2">
2026-10-29 06:56:28 +01:00
<h2 id="sec7-11" class="manual-title-level-2">
2025-12-15 15:15:14 +01:00
hashsize SIZE_IN_BYTES
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>定义保存块的散列大小(以字节为单位)。
</p><p>默认的 hashsize 是 16 字节(128 位),这应该适用于大多数情况。
</p><p>**警告!** 此选项仅供专家使用,强烈建议不要更改此值。
将来要更改此值,您将需要重新创建整个奇偶校验!
</p><p>使用不同 hashsize 的一个原因是,如果您的系统内存有限。
根据经验,SnapRAID 通常每 16 TB 的阵列数据需要 1 GiB 的 RAM。
</p><p>具体来说,为了存储数据的散列,SnapRAID 大约需要
2026-10-29 06:56:28 +01:00
TS*(1+HS)/BS 字节的 RAM,
其中 TS 是您的磁盘阵列的总大小(以字节为单位),BS 是块大小(以字节为单位),
HS 是散列大小(以字节为单位)。
2025-12-15 15:15:14 +01:00
</p><p>例如,对于 8 个 4 TB 磁盘,块大小为 256 KiB
(1 KiB = 1024 字节),散列大小为 16,您将获得:
</p><pre>
2026-10-29 06:56:28 +01:00
RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 GiB
2025-12-15 15:15:14 +01:00
</pre>
<p>切换到散列大小为 8,您将获得:
</p><pre>
2026-10-29 06:56:28 +01:00
RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 GiB
2025-12-15 15:15:14 +01:00
</pre>
<p>切换到块大小为 512,您将获得:
</p><pre>
2026-10-29 06:56:28 +01:00
RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB
2025-12-15 15:15:14 +01:00
</pre>
<p>切换到散列大小为 8 和块大小为 512,您将获得:
</p><pre>
2026-10-29 06:56:28 +01:00
RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB
2025-12-15 15:15:14 +01:00
</pre>
2026-03-30 10:01:17 +02:00
</div>
<div class="manual-section-level-2">
2026-10-29 06:56:28 +01:00
<h2 id="sec7-12" class="manual-title-level-2">
2025-12-15 15:15:14 +01:00
autosave SIZE_IN_GIGABYTES
2026-03-30 10:01:17 +02:00
</h2>
2026-10-29 06:56:28 +01:00
<p>在同步或 scrub 期间,每处理指定数量的 GB 后就自动保存状态。
2025-12-15 15:15:14 +01:00
此选项有助于避免在机器崩溃或任何其他事件中断时,
2026-03-30 10:01:17 +02:00
从头开始重新启动长时间的 <b>sync</b> 命令。
</p></div>
<div class="manual-section-level-2">
2026-10-29 06:56:28 +01:00
<h2 id="sec7-13" class="manual-title-level-2">
2025-12-15 15:15:14 +01:00
temp_limit TEMPERATURE_CELSIUS
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>设置允许的最高磁盘温度(摄氏度)。指定后,
SnapRAID 会使用 smartctl 工具定期检查所有磁盘的温度。
SnapRAID 运行时会显示当前磁盘温度。
如果任何磁盘超过此限制,所有操作都会停止,
2026-03-30 10:01:17 +02:00
并在 <b>temp_sleep</b> 选项定义的持续时间内将磁盘停转(置于待机状态)。
2025-12-15 15:15:14 +01:00
在休眠期过后,操作恢复,如果温度限制再次达到,
可能会再次暂停。
</p><p>在操作期间,SnapRAID 还会分析每个磁盘的加热曲线,
并估计如果活动继续,它们预计将达到的长期稳定温度。
仅在磁盘温度增加了四次后才执行估计,
以确保有足够的数据点来建立可靠的趋势。
此预测的稳定温度显示在当前值旁边的括号中,
有助于评估系统的冷却是否足够。
此估计温度仅供参考,对 SnapRAID 的行为没有影响。
程序的动作仅基于实际测量的磁盘温度。
2026-10-29 06:56:28 +01:00
</p><p>要执行此分析,SnapRAID 需要一个系统温度的参考基准值。
2025-12-15 15:15:14 +01:00
它首先尝试从可用的硬件传感器读取。
如果无法访问系统传感器,它会使用运行时测量的最低磁盘温度
2026-10-29 06:56:28 +01:00
作为备用基准值。
2025-12-15 15:15:14 +01:00
</p><p>通常,SnapRAID 只显示最热磁盘的温度。
要显示所有磁盘的温度,请使用 -A 或 --stats 选项。
2026-03-30 10:01:17 +02:00
</p></div>
<div class="manual-section-level-2">
2026-10-29 06:56:28 +01:00
<h2 id="sec7-14" class="manual-title-level-2">
2025-12-15 15:15:14 +01:00
temp_sleep TIME_IN_MINUTES
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>设置达到温度限制时的待机时间(以分钟为单位)。
在此期间,磁盘保持停转状态。默认值为 5 分钟。
2026-03-30 10:01:17 +02:00
</p></div>
<div class="manual-section-level-2">
2026-10-29 06:56:28 +01:00
<h2 id="sec7-15" class="manual-title-level-2">
2025-12-15 15:15:14 +01:00
pool DIR
2026-03-30 10:01:17 +02:00
</h2>
<p>定义 <b>pooling</b> 目录,其中使用 <b>pool</b> 命令创建磁盘
2025-12-15 15:15:14 +01:00
阵列的虚拟视图。
</p><p>目录必须已经存在。
2026-03-30 10:01:17 +02:00
</p></div>
<div class="manual-section-level-2">
2026-10-29 06:56:28 +01:00
<h2 id="sec7-16" class="manual-title-level-2">
2025-12-15 15:15:14 +01:00
share UNC_DIR
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>定义远程访问磁盘所需的 Windows UNC 路径。
</p><p>如果指定了此选项,则在 pool 目录中创建的符号链接会使用此 UNC 路径
来访问磁盘。
如果没有此选项,则生成的符号链接仅使用本地路径,
这不允许通过网络共享 pool 目录。
2026-03-30 10:01:17 +02:00
</p><p>符号链接是使用指定的 UNC 路径,添加在 <b>data</b> 选项中指定的
2025-12-15 15:15:14 +01:00
磁盘名称,最后添加文件目录和名称形成的。
</p><p>此选项仅在 Windows 中需要。
2026-03-30 10:01:17 +02:00
</p></div>
<div class="manual-section-level-2">
2026-10-29 06:56:28 +01:00
<h2 id="sec7-17" class="manual-title-level-2">
2025-12-15 15:15:14 +01:00
smartctl DISK/PARITY OPTIONS...
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>定义自定义 smartctl 选项以获取每个磁盘的 SMART 属性。
这对于 RAID 控制器和一些无法自动检测的 USB
磁盘可能需要。%s 占位符会被设备名称替换,
但对于固定的设备(如 RAID 控制器)是可选的。
2026-03-30 10:01:17 +02:00
</p><p>DISK 是在 <b>data</b> 选项中指定的相同磁盘名称。
PARITY 是奇偶校验名称之一:<b>parity</b>、<b>2-parity</b>、<b>3-parity</b>、
<b>4-parity</b>、<b>5-parity</b>、<b>6-parity</b> 或 <b>z-parity</b>。
</p><p>在指定的 OPTIONS 中,字符串 <b>%s</b> 被设备名称替换。
2025-12-15 15:15:14 +01:00
对于 RAID 控制器,设备可能是固定的,
2026-03-30 10:01:17 +02:00
您可能不需要使用 <b>%s</b>。
2026-10-29 06:56:28 +01:00
</p><p>您还可以使用 <b>[info: ...]</b> 标记指定自定义信息选项字符串,以替换默认的 <b>-a</b> 选项。
2025-12-15 15:15:14 +01:00
</p><p>请参阅 smartmontools 文档以了解可能的选项:
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-15 15:15:14 +01:00
</pre>
<p>例如:
2026-03-30 10:01:17 +02:00
</p><pre>
2026-10-29 06:56:28 +01:00
smartctl d1 [info: -H -i -c -A] -d sat %s
2025-12-15 15:15:14 +01:00
smartctl parity -d sat %s
</pre>
2026-03-30 10:01:17 +02:00
</div>
<div class="manual-section-level-2">
2026-10-29 06:56:28 +01:00
<h2 id="sec7-18" class="manual-title-level-2">
2025-12-15 15:15:14 +01:00
smartignore DISK/PARITY ATTR [ATTR...]
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>在计算磁盘故障概率时忽略指定的 SMART 属性。
如果磁盘报告了特定属性的不寻常或误导值,此选项很有用。
2026-03-30 10:01:17 +02:00
</p><p>DISK 是在 <b>data</b> 选项中指定的相同磁盘名称。
PARITY 是奇偶校验名称之一:<b>parity</b>、<b>2-parity</b>、<b>3-parity</b>、
<b>4-parity</b>、<b>5-parity</b>、<b>6-parity</b> 或 <b>z-parity</b>。
2025-12-15 15:15:14 +01:00
特殊值 * 可用于在所有磁盘上忽略该属性。
2026-10-29 06:56:28 +01:00
</p><p>可以指定多个属性,用空格分隔。
每个属性可以指定为 1 到 255 之间的数字,或者不区分大小写的名称
(例如 <b>Current_Pending_Sector</b>)。
</p><p>例如,要在所有磁盘上通过编号或名称忽略 <b>Current Pending Sector Count</b> 和
<b>Reallocated Sectors Count</b> 属性:
2026-03-30 10:01:17 +02:00
</p><pre>
2026-10-29 06:56:28 +01:00
smartignore * 197 5
smartignore * Current_Pending_Sector Reallocated_Sector_Ct
2025-12-15 15:15:14 +01:00
</pre>
2026-10-29 06:56:28 +01:00
<p>要仅在第一个奇偶校验磁盘上忽略它们:
2026-03-30 10:01:17 +02:00
</p><pre>
2026-10-29 06:56:28 +01:00
smartignore parity 197 5
2025-12-15 15:15:14 +01:00
</pre>
2026-03-30 10:01:17 +02:00
</div>
<div class="manual-section-level-2">
2026-10-29 06:56:28 +01:00
<h2 id="sec7-19" class="manual-title-level-2">
2025-12-15 15:15:14 +01:00
Examples
2026-03-30 10:01:17 +02:00
</h2>
2025-12-15 15:15:14 +01:00
<p>Unix 的典型配置示例如下:
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +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/
2026-10-29 06:56:28 +01:00
smartctl d1 [info: -H -i -c -A] -d sat %s
2025-12-15 15:15:14 +01:00
smartctl d2 -d usbjmicron %s
smartctl parity -d areca,1/1 /dev/sg0
smartctl 2-parity -d areca,2/1 /dev/sg0
</pre>
<p>Windows 的典型配置示例如下:
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +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
2026-10-29 06:56:28 +01:00
smartctl d1 [info: -H -i -c -A] -d sat %s
2025-12-15 15:15:14 +01:00
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">
2026-10-29 06:56:28 +01:00
快照 (Snapshots)
</h1>
<p>如果配置中启用了快照选项,SnapRAID 将使用文件系统快照来保持操作期间
读取的数据稳定,即使实时文件系统上的文件随后被修改或删除也是如此。
</p><p>快照的管理是完全自动且透明的。
您可以完全像以前一样继续使用 SnapRAID,而快照提供的
额外保护完全在后台处理。
</p><p>这提供了两个主要好处:
</p><div class="manual-tag-list">
<div class="manual-tag-entry">
<div class="manual-tag-name">
一致性
</div><div class="manual-tag-description">
在运行时间较长的 sync 或 scrub 期间在活动文件系统上修改的文件
不会导致校验不匹配或操作中止,因为每个创建了快照的文件系统在操作期间
都保持不变。
</div>
</div>
<div class="manual-tag-entry">
<div class="manual-tag-name">
恢复
</div><div class="manual-tag-description">
如果从实时文件系统中更新或删除了一个文件,
它仍会保留在快照中。如果下次 sync 运行之前发生磁盘故障,
SnapRAID 会使用快照中保留的数据来重建发生故障的磁盘。
在活动同步过程中发生磁盘故障的情况下,
SnapRAID 还能自动从上一次校验计算的快照和当前的快照中读取数据。
这通过提供解校验方程所需的精确数据块访问,
最大程度地提高了完全恢复的概率,即使这些数据块在同步之间被修改或删除。
如果没有快照,健康磁盘上更新或删除的文件会导致缺少数据块,
而这些数据块可能是修复其他损坏磁盘所必需的。
</div>
</div>
</div>
<p>快照仅为数据磁盘创建,并且仅在底层文件系统支持此功能时创建。
校验磁盘始终使用实时文件系统。
</p><p>目前,Linux 上的 Btrfs、Bcachefs 和 ZFS 以及 Windows 上的 NTFS 支持此功能。
</p><p>您可以混合使用具有不同文件系统的数据磁盘。只有那些
支持快照的磁盘才会利用它们,而其他磁盘将继续直接在实时文件系统上运行。
</p><p>快照的创建和删除需要管理权限。
启用快照时,请确保以必要的权限(例如 sudo)运行 SnapRAID。
</p><div class="manual-section-level-2">
<h2 id="sec8-1" class="manual-title-level-2">
快照的命令行为
</h2>
<p><b>sync</b> 和 <b>scrub</b> 命令对支持快照的文件系统的数据磁盘使用快照。
在启用了快照的磁盘上,该命令看到的是一个不受实时文件系统并发更改影响的
稳定文件系统镜像。
在 <b>sync</b> 期间,会为每个受支持的数据文件系统独立创建新的快照。
这些快照共同提供用于校验计算的数据。
相比之下,<b>scrub</b> 命令利用上一个快照(即在最近一次同步期间创建的快照)
来维持与现有校验匹配的可靠参考点。
</p><p>对于 <b>check</b> 和 <b>fix</b> 命令,上一个快照的使用
取决于是否使用 -d, --filter-disk 选项指定了特定磁盘。
</p><p>通过 -d 明确选择的磁盘(操作的“目标”)始终使用实时文件系统。
对于 <b>fix</b>,这允许将数据恢复到活动的替代磁盘。对于 <b>check</b>,
它允许在相同条件下模拟 <b>fix</b> 操作。
</p><p>所有其他数据磁盘(“参考”磁盘)都将通过其快照进行访问。
这确保了即使您在恢复进行时修改健康磁盘上的文件,
SnapRAID 也有一个稳定、冻结的参考来求解校验方程。
</p><p>如果没有提供 -d 选项,SnapRAID 会假设该操作适用于整个阵列,
在这种情况下,<b>check</b> 和 <b>fix</b> 将排他性地使用实时文件系统。
</p><p>所有其他命令完全在实时文件系统上运行。
</p></div>
</div>
<div class="manual-section-level-1">
<h1 id="sec9" class="manual-title-level-1">
快照生命周期 (Snapshots Lifecycle)
</h1>
<p>SnapRAID 在每个数据子卷根目录下的隐藏目录中管理三个特定的快照:
<b>stable</b>(稳定)、<b>pending</b>(待定)和 <b>scan</b>(扫描)。
在 Btrfs、Bcachefs 和 NTFS 中使用 <b>.snapraid/</b> 目录,
在 ZFS 中使用标准的 <b>.zfs/snapshot/</b>。
</p><p><b>stable</b> 快照代表上一次成功完成的 <b>sync</b> 的状态,
包含用于计算当前校验的准确数据。它作为 <b>scrub</b>、<b>check</b>
和 <b>fix</b> 命令的主要数据源。
</p><p><b>scan</b> 快照是在 <b>sync</b> 开始时创建的临时镜像,
用于为扫描和校验计算提供冻结状态。在扫描并保存新的内容状态后,
它将替换以前的 <b>pending</b> 快照。
</p><p><b>pending</b> 快照是中断的 <b>sync</b> 所使用的镜像。
在操作成功完成后,以前的 <b>stable</b> 快照将被删除,
并且 <b>pending</b> 快照将被提升以接替其作为新的稳定参考。
</p><p>如果 <b>sync</b> 中断,<b>pending</b> 快照将被保留。
随后的 <b>scrub</b>、<b>check</b> 和 <b>fix</b> 命令将使用此待定快照,
因为它与 .content 文件中记录的文件系统状态相匹配,即使校验仅部分同步。
</p><p>在 <b>sync</b> 中断的情况下,<b>check</b> 和 <b>fix</b> 命令
还会从 <b>stable</b> 快照中读取数据,以检索在同步期间更新或删除的文件的
数据块。这是可能的,因为 .content 文件在整个同步过程中保留了
所有修改或删除的文件的元数据。此历史信息仅在同步
成功完成并保存 .content 文件的最终版本后才会清除。
</p><p>如果 <b>sync</b> 在中断后重新启动,现有的 pending 快照将被删除,
并创建一个新快照以捕获实时文件系统的当前状态。
但是,如果 <b>sync</b> 中断,请避免在后续 <b>sync</b> 成功完成之前修改、删除、
替换或移动文件。校验可能仍包含根据中断的同步所使用的快照计算的块。
以后的同步可能会替换该快照,从而导致中间文件版本无法用于恢复。
</p><div class="manual-section-level-2">
<h2 id="sec9-1" class="manual-title-level-2">
使用文件系统快照进行外部备份 (External backups with filesystem snapshots)
</h2>
<p>当启用文件系统快照时,SnapRAID 会在每个数据子卷、卷或数据集(dataset)
的根目录下访问或创建快照。
</p><p>避免与外部工具发生冲突的一种简单方法,是将 <b>data</b> 配置指向子卷或卷内的
常规子目录(例如 <b>/mnt/subvol/data</b> 而不是 <b>/mnt/subvol</b>)。SnapRAID
始终会在子卷根目录下创建快照目录(例如 <b>/mnt/subvol/.snapraid/</b>),从而保持
数据子目录整洁,使快照保留在外部且对在该目录内运行的备份工具不可见。
</p><p>否则,如果配置的 <b>data</b> 目录本身就是子卷或卷的根目录,SnapRAID 会直接在其中
创建 <b>.snapraid/</b> 目录(在 Btrfs、Bcachefs 和 NTFS 上)。虽然 SnapRAID
会在其自身的扫描中自动排除此目录,但外部备份工具或文件同步工具会发现它。如果未
将其排除,它们可能会遍历快照或目录链接并复制整个冻结的数据树,从而导致数据
重复并耗尽备份存储空间。请务必将外部备份工具配置为排除 <b>.snapraid/</b> 目录。
</p><p>在 ZFS 上,快照是通过标准虚拟目录 <b>.zfs/snapshot/</b> 而不是 <b>.snapraid/</b>
公开的。默认情况下(<b>snapdir=hidden</b>),ZFS 会在目录列表中隐藏此目录,因此
外部备份工具不会遍历它。如果您启用了 <b>snapdir=visible</b>,请确保您的备份工具
排除 <b>.zfs/</b> 目录。
</p></div>
</div>
<div class="manual-section-level-1">
<h1 id="sec10" class="manual-title-level-1">
模式 (Pattern)
2026-03-30 10:01:17 +02:00
</h1>
<p>模式提供了一种灵活的方法来过滤要包含或排除的文件。通过使用通配符(globbing),
您可以定义匹配特定文件名或整个目录结构的规则,而无需手动列出每个路径。
</p><p>问号 <b>?</b> 匹配除目录分隔符以外的任何单个字符。这使得它在匹配具有变量字符
的文件名时非常有用,同时将模式限制在单个目录层级内。
</p><p>单星号 <b>*</b> 匹配任何字符序列,但与问号一样,它绝不会跨越目录边界。
它在正斜杠处停止,因此适用于匹配单个路径组件内的内容。
这是 Shell 通配符中常见的标准行为。
2026-10-29 06:56:28 +01:00
</p><p>双星号通配符 <b>**</b> 仅在与目录分隔符相邻时(前面或后面有斜杠)才能跨越
目录分隔符进行匹配。在此形式下,它可以跨越多个目录层级匹配零个或多个字符。
例如,<b>foo/**/bar</b> 匹配 <b>foo/bar</b>、<b>foo/a/bar</b> 和 <b>foo/a/b/bar</b>;
<b>**/build</b> 匹配 <b>build</b> 和 <b>foo/bar/build</b>;<b>src/**.js</b> 匹配 <b>src/main.js</b>
和 <b>src/ui/components/main.js</b>。
单独的形式 <b>/**/</b> 不被接受为完整的模式。
</p><p>当 <b>**</b> 不与斜杠相邻时,其行为类似于 <b>*</b>,不会匹配目录分隔符。例如,
<b>**.jpg</b> 匹配当前目录中的 <b>photo.jpg</b>,但不会匹配 <b>dir/photo.jpg</b>。
如需匹配子目录中的文件,请使用 <b>**/*.jpg</b>。
2026-03-30 10:01:17 +02:00
</p><p>使用方括号 <b>[]</b> 的字符类匹配指定集合或范围内的单个字符。
与其他单字符模式一样,它们不匹配目录分隔符。字符类支持使用
感叹号进行范围指定和否定。
</p><p>需要记住的根本区别是,<b>*</b>、<b>?</b> 和字符类都遵循目录边界,
2026-10-29 06:56:28 +01:00
并且仅在单个路径组件内匹配,而 <b>**</b> 仅在与斜杠相邻时才能跨越
目录分隔符进行匹配。
2025-12-15 15:15:14 +01:00
</p><p>有四种不同类型的模式:
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-15 15:15:14 +01:00
FILE
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
选择任何名为 FILE 的文件。
2025-12-15 15:15:14 +01:00
此模式仅适用于文件,不适用于目录。
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-15 15:15:14 +01:00
DIR/
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
2025-12-15 15:15:14 +01:00
选择任何名为 DIR 的目录及其内部的所有内容。
此模式仅适用于目录,不适用于文件。
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-15 15:15:14 +01:00
/PATH/FILE
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
选择指定的确切文件路径。此模式仅适用于文件,不适用于目录。
</div>
</div>
</div>
<div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
2025-12-15 15:15:14 +01:00
/PATH/DIR/
2026-03-30 10:01:17 +02:00
</div><div class="manual-option-description">
选择指定的确切目录路径及其内部的所有内容。此模式仅适用于目录,
不适用于文件。
</div>
</div>
</div>
2025-12-15 15:15:14 +01:00
<p>当您指定以 / 开头的绝对路径时,它应用于阵列**根目录**,
而不是本地文件系统根目录。
</p><p>在 Windows 中,您可以使用反斜杠 \ 代替正斜杠 /。
Windows 系统目录、连接点、挂载点和其他 Windows
特殊目录被视为文件,这意味着要排除它们,
您必须使用文件规则,而不是目录规则。
2026-03-30 10:01:17 +02:00
</p><p>如果文件名包含 <b>*</b>、<b>?</b>、<b>[</b>
或 <b>]</b> 字符,您必须对其进行转义,以避免将其解释为
globbing 字符。在 Unix 中,转义字符是 <b>\</b>;在 Windows 中,它是 <b>^</b>。
2025-12-15 15:15:14 +01:00
当模式在命令行上时,您必须双写转义
字符,以避免命令 shell 对其进行解释。
</p><p>在配置文件中,您可以使用不同的策略来过滤要处理的文件。
2026-03-30 10:01:17 +02:00
最简单的方法是仅使用 <b>exclude</b> 规则来删除所有您不想处理的
2025-12-15 15:15:14 +01:00
文件和目录。例如:
2026-03-30 10:01:17 +02:00
</p><pre>
# 排除任何名为 <b>*.unrecoverable</b> 的文件
2025-12-15 15:15:14 +01:00
exclude *.unrecoverable
2026-03-30 10:01:17 +02:00
# 排除根目录 <b>/lost+found</b>
2025-12-15 15:15:14 +01:00
exclude /lost+found/
2026-03-30 10:01:17 +02:00
# 排除任何名为 <b>tmp</b> 的子目录
2025-12-15 15:15:14 +01:00
exclude tmp/
</pre>
2026-03-30 10:01:17 +02:00
<p>相反的方法是仅定义您想要处理的文件,仅使用 <b>include</b> 规则。例如:
</p><pre>
2025-12-15 15:15:14 +01:00
# 仅包含一些目录
include /movies/
include /musics/
include /pictures/
</pre>
2026-03-30 10:01:17 +02:00
<p>最后的方法是混合使用 <b>exclude</b> 和 <b>include</b> 规则。在这种情况下,
2025-12-15 15:15:14 +01:00
规则的顺序很重要。较早的规则优先于
较晚的规则。
2026-03-30 10:01:17 +02:00
为了简化,您可以先列出所有 <b>exclude</b> 规则,然后
列出所有 <b>include</b> 规则。例如:
</p><pre>
# 排除任何名为 <b>*.unrecoverable</b> 的文件
2025-12-15 15:15:14 +01:00
exclude *.unrecoverable
2026-03-30 10:01:17 +02:00
# 排除任何名为 <b>tmp</b> 的子目录
2025-12-15 15:15:14 +01:00
exclude tmp/
# 仅包含一些目录
include /movies/
include /musics/
include /pictures/
</pre>
2026-10-29 06:56:28 +01:00
<p>请注意,排除目录(使用 DIR/ 或 /PATH/DIR/)会阻止 SnapRAID 进入并扫描该目录。
因此,无法使用 <b>include</b> 规则重新包含位于已排除父目录内的文件或子目录,
因为扫描器根本不会遍历到该目录中。
</p><p>例如,以下配置将不会包含 <b>file.dat</b>,因为 <b>/keep/</b> 在看到 <b>file.dat</b> 之前已被修剪:
</p><pre>
# 无法按预期工作: /keep/ 会被完全跳过
include /keep/file.dat
exclude /keep/
</pre>
<p>若要排除目录中的文件但保留特定文件,请匹配目录内的文件模式,而不是排除目录本身:
</p><pre>
# 可以正常工作: 会遍历 /keep/,但其中的其他文件会被排除
include /keep/file.dat
exclude /keep/*
</pre>
2026-03-30 10:01:17 +02:00
<p>在命令行上,使用 -f 选项,您只能使用 <b>include</b>
2025-12-15 15:15:14 +01:00
模式。例如:
2026-03-30 10:01:17 +02:00
</p><pre>
2025-12-15 15:15:14 +01:00
# 仅检查 .mp3 文件。
# 在 Unix 中,使用引号以避免 shell 扩展 globbing。
snapraid -f "*.mp3" check
</pre>
<p>在 Unix 中,在命令行上使用 globbing 字符时,必须
引用它们以防止 shell 扩展它们。
2026-03-30 10:01:17 +02:00
</p></div>
<div class="manual-section-level-1">
2026-10-29 06:56:28 +01:00
<h1 id="sec11" class="manual-title-level-1">
忽略文件 (Ignore File)
2026-03-30 10:01:17 +02:00
</h1>
<p>除了配置文件中的全局规则外,您还可以在阵列内的任何目录中放置
<b>.snapraidignore</b> 文件,以定义分散的排除规则。
</p><p>在 <b>.snapraidignore</b> 中定义的规则会在配置文件中的规则之后应用。
这意味着它们具有更高的优先级,可用于排除先前由全局配置包含的文件。
实际上,如果本地规则匹配,则无论全局包含设置如何,该文件都会被排除。
</p><p><b>.snapraidignore</b> 中的模式逻辑与全局配置相同,但模式锚定在
该文件所在的目录:
</p><div class="manual-option-list">
<div class="manual-option-entry">
<div class="manual-option-name">
FILE
</div><div class="manual-option-description">
选择此目录或其下方任何名为 FILE 的文件。
这遵循与全局模式相同的通配符规则。
</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">
选择任何名为 DIR 的目录及其内部的所有内容,
位于此目录或其下方。
</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">
选择相对于 <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">
选择相对于 <b>.snapraidignore</b> 文件位置指定的精确目录
及其内部的所有内容。
</div>
</div>
</div>
<p>与全局配置不同,<b>.snapraidignore</b> 文件仅支持排除规则;
您不能使用 <b>include</b> 模式或否定符号 (!)。
</p><p>例如,如果您在 <b>/mnt/disk1/projects/</b> 中有一个 <b>.snapraidignore</b>:
</p><pre>
# 仅排除 /mnt/disk1/projects/output.bin
/output.bin
# 排除 projects/ 中任何名为 <b>build</b> 的目录
build/
# 排除 projects/ 或其子文件夹中任何 .tmp 文件
*.tmp
</pre>
</div>
<div class="manual-section-level-1">
2026-10-29 06:56:28 +01:00
<h1 id="sec12" class="manual-title-level-1">
内容 (Content)
2026-03-30 10:01:17 +02:00
</h1>
2025-12-15 15:15:14 +01:00
<p>SnapRAID 将文件列表和校验和存储在 content 文件中。
</p><p>它是一个二进制文件,列出了磁盘阵列中存在的所有文件,
以及用于验证其完整性的所有校验和。
2026-10-29 06:56:28 +01:00
</p><p>content 文件由 <b>sync</b>、<b>scrub</b>、<b>touch</b> 和 <b>rehash</b> 命令读取和写入。
它由 <b>status</b>、<b>diff</b>、<b>check</b>、<b>fix</b>、<b>list</b>、<b>dup</b>、<b>locate</b> 和
<b>pool</b> 命令读取,并被 <b>smart</b>、<b>probe</b>、<b>up</b>、<b>down</b> 和 <b>devices</b>
命令完全忽略。
2026-03-30 10:01:17 +02:00
</p></div>
<div class="manual-section-level-1">
2026-10-29 06:56:28 +01:00
<h1 id="sec13" class="manual-title-level-1">
奇偶校验 (Parity)
2026-03-30 10:01:17 +02:00
</h1>
2025-12-15 15:15:14 +01:00
<p>SnapRAID 将阵列的奇偶校验信息存储在 parity 文件中。
2026-03-30 10:01:17 +02:00
</p><p>这些是二进制文件,包含 <b>content</b> 文件中定义的所有
2025-12-15 15:15:14 +01:00
块的计算奇偶校验。
2026-03-30 10:01:17 +02:00
</p><p>这些文件由 <b>sync</b> 和 <b>fix</b> 命令读取和写入,
并且仅由 <b>scrub</b> 和 <b>check</b> 命令读取。
</p></div>
<div class="manual-section-level-1">
2026-10-29 06:56:28 +01:00
<h1 id="sec14" class="manual-title-level-1">
编码 (Encoding)
2026-03-30 10:01:17 +02:00
</h1>
2025-12-15 15:15:14 +01:00
<p>SnapRAID 在 Unix 中忽略任何编码。它读取并存储
文件系统使用的相同编码的文件名。
</p><p>在 Windows 中,从文件系统读取的所有名称都会被转换并
以 UTF-8 格式处理。
2026-03-30 10:01:17 +02:00
</p><p>要使文件名正确打印,您必须使用命令 <b>chcp 65001</b> 将 Windows
控制台设置为 UTF-8 模式,并使用 TrueType 字体,如 <b>Lucida Console</b>,
2025-12-15 15:15:14 +01:00
作为控制台字体。这仅影响打印的文件名;如果
您将控制台输出重定向到文件,则生成的文件始终
采用 UTF-8 格式。
2026-10-29 06:56:28 +01:00
</p></div>
<div class="manual-section-level-1">
<h1 id="sec15" class="manual-title-level-1">
退出码 (Exit Code)
</h1>
<p>SnapRAID 终止并返回以下错误代码:
</p><div class="manual-tag-list">
<div class="manual-tag-entry">
<div class="manual-tag-name">
0
</div><div class="manual-tag-description">
一切正常。
</div>
</div>
<div class="manual-tag-entry">
<div class="manual-tag-name">
1
</div><div class="manual-tag-description">
命令遇到一些错误。
</div>
</div>
<div class="manual-tag-entry">
<div class="manual-tag-name">
2
</div><div class="manual-tag-description">
<b>diff</b> 命令发现一切正常,但需要进行 <b>sync</b>。
</div>
</div>
<div class="manual-tag-entry">
<div class="manual-tag-name">
3
</div><div class="manual-tag-description">
磁盘设备命令(<b>probe</b>、<b>smart</b>、<b>devices</b>、<b>up</b>、<b>down</b>)已完成,
但至少有一个文件系统因缺少设备而以降级(degraded)模式运行。
</div>
</div>
</div>
</div>
<div class="manual-section-level-1">
<h1 id="sec16" class="manual-title-level-1">
已知问题 (Known Issues)
</h1>
<div class="manual-section-level-2">
<h2 id="sec16-1" class="manual-title-level-2">
文件系统边界
</h2>
<p>SnapRAID 在扫描数据磁盘时不会跨越文件系统、挂载点或子卷边界。
当检测到此类边界时,SnapRAID 会报告警告(WARNING)并且不会扫描其范围之外的内容。
</p><p>位于此类边界之外的文件不包含在数据磁盘中,如果需要保护它们,则必须单独配置。
</p></div>
<div class="manual-section-level-2">
<h2 id="sec16-2" class="manual-title-level-2">
带有文件系统快照的挂载点
</h2>
<p>启用文件系统快照时,不支持数据磁盘内的嵌套挂载点和 bind 挂载。
</p><p>挂载点属于活动系统的挂载命名空间,不会保存在文件系统快照中。
因此,在扫描快照时,活动文件系统中被挂载点隐藏的目录可能会变为可见。
</p><p>启用文件系统快照时,请勿在数据磁盘内放置嵌套挂载点或 bind 挂载。
</p></div>
<div class="manual-section-level-2">
<h2 id="sec16-3" class="manual-title-level-2">
带有文件系统快照的多套配置
</h2>
<p>使用相同文件系统快照命名空间的多套独立 SnapRAID 配置无法安全共享快照支持。
</p><p>在 Btrfs 和 Bcachefs 上,只有一套启用了快照支持的 SnapRAID 配置可以使用
同一子卷内的数据目录。在 ZFS 上,相同的限制适用于数据集,在 NTFS 上适用于卷。
</p><p>共享相同快照命名空间的多套配置使用相同的 <b>stable</b>、<b>pending</b> 和 <b>scan</b> 快照。
因此,运行其中一套配置可能会替换或删除另一套配置所需的恢复快照。
</p></div>
<div class="manual-section-level-2">
<h2 id="sec16-4" class="manual-title-level-2">
未更改时间戳的原地文件修改
</h2>
<p>SnapRAID 通过比较文件大小和修改时间戳(mtime)来检测文件修改。
</p><p>如果应用程序在不更改文件大小或不更新其修改时间戳的情况下原地修改文件,
则 “diff” 和 “sync” 将不会检测到文件已更改,并且其奇偶校验也不会更新。
</p><p>为确保 SnapRAID 识别此类更改,请更新文件的修改时间戳(例如使用 “touch” 实用程序)。
否则,该差异仅在后续的 “scrub” 或 “check” 期间作为哈希不匹配被检测到。
</p></div>
<div class="manual-section-level-2">
<h2 id="sec16-5" class="manual-title-level-2">
Windows 非 ASCII 大小写匹配
</h2>
<p>SnapRAID 在所有平台上均使用标准且可预测的 UTF-8 编码,仅对 ASCII 字符进行
不区分大小写的匹配。
</p><p>Windows 文件系统受到遗留设计的困扰,即通过任意的、依赖于系统的大小写折叠表在
Unicode 文件名之间强制实行不区分大小写。因此,Windows 掩盖了文件系统的真实情况,
将完全不同的 Unicode 字节序列视为同一个文件。
</p><p>例如,<b>À.txt</b> 和 <b>à.txt</b> 是不同的 Unicode 名称,但 Windows 却不合逻辑地将它们
视为相同文件,而 SnapRAID 则保留了它们的真实区别。
</p><p>该限制是由于 Windows 对 Unicode 文件名的不一致处理及其对不区分大小写别名的
执着所致。为了防止因 Windows 的大小写折叠而产生差异,请在配置路径和过滤器中
始终为非 ASCII 字符指定准确的大小写。
</p></div>
<div class="manual-section-level-2">
<h2 id="sec16-6" class="manual-title-level-2">
部分 fix 恢复
</h2>
<p>当使用 <b>-S, --start</b> 或 <b>-B, --count</b> 限制 <b>fix</b> 时,
SnapRAID 仅对选定的块进行操作,而不执行文件级别的最终化处理或隔离。
</p><p>如果恢复产生了无法证实代表当前内容的尽力而为(best-effort)数据,
此类块仍可能以常规文件名写入。与这些已恢复块相关的不确定性在命令终止后
不会保留。
</p><p>因此,后续的 <b>fix</b> 会将这些可读取的块视为有效的文件数据,并且不会尝试
再次恢复它们。这可能导致后续恢复报告成功,但在文件中留下不完整或过时的数据。
</p><p><b>-S</b> 和 <b>-B</b> 选项仅适用于高级手动恢复,通常在常规 <b>fix</b> 失败后使用。
如果部分 <b>fix</b> 报告了无法恢复的数据,请在尝试另一次恢复之前删除受影响的
文件或对其重命名,或者手动验证其内容。
</p></div>
<div class="manual-section-level-2">
<h2 id="sec16-7" class="manual-title-level-2">
NTFS 硬链接与排除的路径
</h2>
<p>在 NTFS 上,目录条目会为每个硬链接单独缓存文件大小和时间戳。
当通过其中一个链接修改文件时,指向同一文件的其他链接的目录条目
可能会保留过时的元数据,直到它们被访问为止。
</p><p>如果在扫描过程中遇到同一文件的至少两个硬链接,SnapRAID 会自动
检测并规范化这种情况。但是,如果仅扫描了一个硬链接,而其他硬链接
被过滤器排除或位于数据磁盘路径之外,SnapRAID 将无法检测到 inode 冲突,
并会依赖单个可见链接的缓存元数据。
</p><p>因此,通过被排除或外部的硬链接所做的修改,在操作系统刷新所包含链接
的元数据之前(例如通过该路径访问或打开文件时),可能会被 SnapRAID 忽略。
</p><p>为避免此限制,请避免通过已从 SnapRAID 中排除的硬链接来修改受保护
的文件,或者确保文件的所有硬链接都包含在扫描中,以便 SnapRAID 可以
对它们进行规范化。
</p></div>
<div class="manual-section-level-2">
<h2 id="sec16-8" class="manual-title-level-2">
中断的多重奇偶校验 sync 后的恢复
</h2>
<p>在具有多个奇偶校验磁盘的阵列中,中断的 <b>sync</b> 可能会使不同奇偶校验
级别之间暂时彼此不同步。例如,奇偶校验 1 可能已经包含新更新的数据,
而奇偶校验 2 仍包含旧数据。
</p><p>在执行 <b>check</b> 或 <b>fix</b> 期间,SnapRAID 会尝试不同的奇偶校验组合,
并根据已知的块哈希(覆盖整个块,通常为 256 KiB)验证重建的数据。
</p><p>如果 SnapRAID 尝试使用新旧奇偶校验的不一致混合进行重建,线性 RAID
方程将产生不正确的数据。要错误地接受这种无效组合,这些方程必须在同一
条带中的其他未同步块被重建为错误数据的情况下,巧合地完美重建出至少一个
完整的 256 KiB 块以使其哈希完全匹配。
</p><p>这种情况并不依赖于哈希碰撞;相反,它需要混合奇偶校验方程本身碰巧
生成原始的完整 256 KiB 块内容。虽然在特别构造的数据或高度重复的数据
情况下在数学上是可能的,但在实际数据中这几乎是不可能的。
</p><p>如果所有磁盘都运行良好,在进行进一步更改之前完成中断的 <b>sync</b> 可以消除
这种不确定性。如果磁盘发生故障且需要恢复,在运行 <b>check</b> 或 <b>fix</b> 之前
请避免修改任何数据磁盘。
</p></div>
<div class="manual-section-level-2">
<h2 id="sec16-9" class="manual-title-level-2">
保留的文件和目录名称
</h2>
<p>SnapRAID 保留了一些文件、目录和快照名称用于其内部操作。请勿将这些名称
用于用户数据:
</p><div class="manual-tag-list">
<div class="manual-tag-entry">
<div class="manual-tag-name">
.snapraidignore
</div><div class="manual-tag-description">
本地排除规则文件。
</div>
</div>
<div class="manual-tag-entry">
<div class="manual-tag-name">
.snapraid
</div><div class="manual-tag-description">
快照容器目录。
</div>
</div>
<div class="manual-tag-entry">
<div class="manual-tag-name">
snapraid-*
</div><div class="manual-tag-description">
由 SnapRAID 管理的 ZFS 快照名称。
</div>
</div>
<div class="manual-tag-entry">
<div class="manual-tag-name">
*.unrecoverable
</div><div class="manual-tag-description">
在恢复过程中被隔离的受损文件。
</div>
</div>
<div class="manual-tag-entry">
<div class="manual-tag-name">
CONTENT.tmp
</div><div class="manual-tag-description">
用于 content 更新的临时文件。
</div>
</div>
<div class="manual-tag-entry">
<div class="manual-tag-name">
CONTENT.lock
</div><div class="manual-tag-description">
content 锁定文件。
</div>
</div>
<div class="manual-tag-entry">
<div class="manual-tag-name">
PARITY.spaceholder
</div><div class="manual-tag-description">
在 Windows 上分配奇偶校验期间使用的临时占位文件。
</div>
</div>
</div>
<p>将这些名称用于无关数据可能会导致文件或快照被忽略、被误认为是元数据、
被覆盖、重命名或删除。
</p><p>在 Windows 上,所有大小写变体也都被保留,即使在配置为区分大小写的 NTFS
目录中也是如此(例如 .SNAPRAIDIGNORE、.SnapRaid、CONTENT.TMP 和
CONTENT.Lock)。
</p></div>
</div>
<div class="manual-section-level-1">
<h1 id="sec17" class="manual-title-level-1">
翻译 (Translation)
</h1>
<p>本文档是英文手册的自动翻译。
请参阅英文手册以获取权威版本。
</p></div>
<div class="manual-section-level-1">
<h1 id="sec18" class="manual-title-level-1">
版权 (Copyright)
</h1>
<p>此文件版权所有 (C) 2026 Andrea Mazzoleni
</p></div>
<div class="manual-section-level-1">
<h1 id="sec19" class="manual-title-level-1">
参见 (See Also)
</h1>
<p>snapraid_log(1), snapraidd(1), rsync(1)
2026-03-30 10:01:17 +02:00
</p></div>
2025-12-15 15:15:14 +01:00
2026-03-30 10:01:17 +02:00
</div>
</main>
</div>
2025-12-15 15:15:14 +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 &copy; 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-15 15:15:14 +01:00
</body>
</html>