家用NAS配置指北

2024-06-13T00:00:00+00:00

建议材料</h2> </tbody></table>

OS配置</h2>
OMV安装完毕后，暂时不要在UI里更新系统。尽管安装过程可能按照指引已经配置了国内的Apt源，但有些（比如Debian Security）未覆盖到，会导致`apt update</code>等速度非常慢。</p>`
`因此建议先配置镜像</a>。</p>`

容器运行环境</h2>
为方便管理容器和Docker Compose部署的服务等，还是要装一下openmediavault-compose</code>这个插件。</p>
官方文档建议先安装OMV-Extras，然后就可以在界面里操作安装Docker CE。但事实上两者并无强绑定关系。</p>
虽然但是，如果添加了OMV-Extras的源，在界面中可以方便查看各种插件的安装状态，会提供一定的方便。还是鼓励装一下：</p>

涉及GayHub的资源，最好还是加个反代来用，这里我选了https://kkgithub.com</a></p>
</blockquote>
wget</span> -O - https://kkgithub.com/OpenMediaVault-Plugin-Developers/packages/raw/master/install</span> |</span> sed</span> 's/github/kkgithub/g'</span> |</span> bash</span></span></code></pre>
这里装完就装完了，在国内就别指望用它来装Docker等等。</p>
接下来，就是使用国内的Docker CE镜像来安装Docker。装好后设置镜像/反代方便拉取images。</p>
最后来到openmediavault-compose</code>插件：</p>
apt</span> install openmediavault-compose</span></span></code></pre>
另外，一些插件（比如openmediavault-photoprism</code>）用到Podman。</p>
但照旧要配置国内镜像</a>。</p>
文件系统</h2>
文件系统我选了Btrfs1</a></sup>。</p>
我认为Btrfs是拥抱未来的文件系统，虽然当下尚有很多缺陷（比如社区报告的RAID5/6不稳定等），但把RAID、LVM等功能集成到文件系统中是大势所趋。</p>
虽然使用它自带的RAID0/1/10或者DUP</code>模式都是安全的，但我嫌弃这些方案：要么磁盘利用率低，要么不安全。</p>
所以最后还是用openmediavault-md</code>做了软RAID。然后Btrfs在RAID后的卷上创建，模式选了Single</code>。</p>
但默认的挂载参数不够理想。最后采取了如下设置2</a></sup>：</p>
omv-env</span> set -- OMV_FSTAB_MNTOPS_BTRFS "defaults,nofail,compress=zstd,autodefrag,noatime"</span></span>
monit</span> restart omv-engined</span></span>
omv-salt</span> stage run prepare</span></span>
omv-salt</span> stage run deploy</span></span></code></pre>bcache缓存</h2>

我是使用了一段时间才苟到一块NVMe做缓存盘的。如果文件系统上有数据，理应先备份全盘</a>。

理论上用blocks</a>工具直接转换也是可以的，但依赖环境看着很吓人。</p>
</blockquote>
确认SSD的erase block size</h3>
创建高速缓存的时候尽量还是尊重一下SSD固有的erase block size，这样可以减少write amplification</a>现象的发生。但多数SSD的参数规格中并未提及这点，如果不想将就，可以用flashbench</a>工具去猜。</p>
安装flashbench：</p>
apt</span> install flashbench</span></span></code></pre>
猜：</p>
# 建议先写入一定量的随机数据，猜起来准一些</span></span>
# dd if=/dev/urandom of=/dev/nvme1n1 bs=4096 status=progress</span></span>
flashbench</span> -a /dev/nvme1n1  --blocksize=1024</span></span></code></pre>
在我的case里，虽然pattern不甚明显，还是值得参考的：</p>
</p>
配置缓存</h3>
bcache已经并入内核很久了，但还是需要安装bcache-tools</code>来配置：</p>
apt</span> install bcache-tools</span></span></code></pre>
先擦除文件系统，若出现Device or resource busy</code>错误请参照这节</a>：</p>
wipefs</span> -a /dev/md0</span></span>
wipefs</span> -a /dev/nvme1n1</span></span></code></pre>
然后格式化后端和缓存设备3</a></sup>：</p>
# 这里会创建/dev/bcache0</span></span>
make-bcache</span> --data-offset 1290240k -B /dev/md0</span></span>
make-bcache</span> --bucket 4M -C /dev/nvme1n1</span></span></code></pre>
搞定后检查一下uuid，并将其绑定至/dev/bcache0</code>:</p>
bcache-super-show</span> /dev/nvme1n1</span> |</span> grep</span> cset</span></span>
echo</span> 9b72f96d-7e85-4fd3-a78f-a283504b938c</span> ></span> /sys/block/bcache0/bcache/attach</span></span></code></pre>后续配置</h3>
到这里就可以在UI中创建Btrfs分区并且挂载了。</p>
检查状态：</p>
cat</span> /sys/block/bcache0/bcache/state</span></span></code></pre>
如果返回内容是clean</code>，说明一切正常。</p>
修改为只用于读缓存：</p>
echo</span> writearound</span> ></span> /sys/block/bcache0/bcache/cache_mode</span></span></code></pre>Device or resource busy</h3>
进行配置过程中常见Device or resource busy</code>错误。针对不同的对象，有不同的处理方式。</p>
高速缓存盘</h4>
echo</span> 1</span> ></span> /sys/fs/bcache/9b72f96d-7e85-4fd3-a78f-a283504b938c/unregister</span></span></code></pre>后端低速盘</h4>
在擦除文件系统之前，后端低速盘往往已经挂载并有服务相关联，首先要先停止服务并解挂载。</p>
如果盘已经被配置作为bcache后端，则需要先停掉：</p>
echo</span> 1</span> ></span> /sys/block/bcache0/bcache/stop</span></span></code></pre>新建用户</h2>
在新建好的Btrfs分区上创建一个home</code>目录作为用户的家目录。</p>
新建用户时不选择用户组，则默认会赋予一个users</code>的组，一般来讲权限足够用。</p>
PhotoPrism</h2>
PhotoPrism（下简称PP</strong>）虽然可以在UI里选择openmediavault-podman</code>安装，但事实上由于连接速度的问题，podman pull</code>拉取images的过程会非常长且在UI里没有正常的进度显示。</p>
这会大大增长（心理上的）不确定性，因此还是建议命令行安装：</p>
apt</span> install openmediavault-photoprism</span></span></code></pre>
安装完毕后可以在UI中设置将其启动起来，建议按照官方文档</a>中截图方式设置（目录需预先创建）：</p>
</p>
Caddy</h2>
PP如果想在公网访问需要通过SSL加密的连接，我选用Caddy来做反代。</p>
这里因为PP已经在Podman下跑起来了，最理想的路线就是在host上直接跑Caddy4</a></sup>。</p>
定制Caddy（带CF插件</a>去编译）：</p>
# 苟一下七牛云的CDN</span></span>
go</span> env -w GO111MODULE=on</span></span>
go</span> env -w  GOPROXY=https://goproxy.cn,direct</span></span>
xcaddy</span> build --with github.com/caddy-dns/cloudflare</span></span></code></pre>
然后就可以删掉Go了：</p>
rm</span> -rf /usr/local/go</span> &&</span> rm</span> -rf ~/go</span>*</span></span></code></pre>
为了使Caddy能提供稳定的代理，可以按照官方文档</a>创建service。</p>
最后，为了让PP能够正确处理web请求，需要将配置好的地址绑定上：</p>
omv-env</span> set -- OMV_PHOTOPRISM_APP_CONTAINER_START_OPTIONS "-e PHOTOPRISM_SITE_URL=http://localhost:2342/photo"</span></span>
omv-salt</span> stage run prepare</span></span>
omv-salt</span> deploy run photoprism</span></span></code></pre>

mdadm</span> -D /dev/mdX</span> |</span> grep</span> Chunk</span></span></code></pre>
如果RAID是通过其他方式创建的，那么可以参考内核文档</a>里的叙述去计算这个数值。</p>

当然也可以把PP和Caddy都用Docker跑，把podman build</code>替换成docker build</code>就可以，但OMV既然已经提供了插件，就费事自己去抄作业/改作业了。</p>
</blockquote>
也可以在制作镜像时用代理：</p>
Dockerfile</code></strong></p>
FROM</span> caddy:builder-alpine </span>AS</span> builder</span></span>
</span>
RUN</span> xcaddy build \</span></span>
    --with github.com/caddy-dns/cloudflare</span></span>
</span>
FROM</span> caddy:alpine</span></span>
</span>
COPY</span> --from=builder /usr/bin/caddy /usr/bin/caddy</span></span></code></pre>podman</span> build</span> \</span></span>
    --build-arg "HTTP_PROXY=http://192.168.31.151:7890"</span> \</span></span>
    --build-arg "HTTPS_PROXY=http://192.168.31.151:7890"</span> \</span></span>
    --build-arg "NO_PROXY=localhost,127.0.0.1"</span> \</span></span>
    -t caddy:cf .</span></span></code></pre>
由于同个 pod 间的网络才是互通的（可参考 Podman pod 文档</a>），所以先确认已经跑起来的photoprism-app</code>属于哪个 pod：</p>
podman</span> ps --pod</span></span></code></pre>
然后尝试在photoprism</code>这个pod里启动Caddy：</p>
podman</span> run -d --pod photoprism --name photoprism_caddy</span> \</span></span>
    -v caddy_data:/data</span> \</span></span>
    -v caddy_config:/config</span> \</span></span>
    -v</span> $PWD</span>/Caddyfile:/etc/caddy/Caddyfile</span> \</span></span>
    -e CF_API_TOKEN=the_fucking_token</span> \</span></span>
    caddy:cf</span></span></code></pre>
到这里就不对劲了，因为同一 pod 中的所有容器共享端口映射规则，我们没办法为 Caddy 指定新的映射规则，也就意味着没有端口给它用了，那还转发个锤子的host流量，这条路走不通。</p>



各文件系统对比：https://en.wikipedia.org/wiki/Comparison_of_file_systems</a> ↩</a></p>
</li>

OMV的文件系统环境变量：https://docs.openmediavault.org/en/stable/various/fs_env_vars.html</a>

Btrfs挂载选项：https://btrfs.readthedocs.io/en/latest/btrfs-man5.html#mount-options</a> ↩</a></p>
</li>

如果全程按照本文配置，那就没必要在意--data-offset</code>的值了。

这是因为OMV中通过UI创建的RAID5的stripe size默认是512</code>k。可以通过如下命令查看： ↩</a></p>
</li>

我有设想和尝试过把Caddy也放在容器里运行，直接的想法就是由于Podman和Docker的容器网络互不联通，所以需要将Caddy也用Podman跑起来。 ↩</a></p>
</li>
</ol>
</section>

类别</th>	型号</th>	理由</th></tr></thead>

Device or resource busy</h3>
进行配置过程中常见`Device or resource busy</code>错误。针对不同的对象，有不同的处理方式。</p>`

新建用户</h2>
在新建好的Btrfs分区上创建一个`home</code>目录作为用户的家目录。</p>`
`新建用户时不选择用户组，则默认会赋予一个users</code>的组，一般来讲权限足够用。</p>`

孙瑜 - OMV

家用NAS配置指北

OS配置</h2>
OMV安装完毕后，暂时不要在UI里更新系统。尽管安装过程可能按照指引已经配置了国内的Apt源，但有些（比如Debian Security）未覆盖到，会导致`apt update</code>等速度非常慢。</p>`
`因此建议先配置镜像</a>。</p>`

孙瑜 - OMV

家用NAS配置指北

OS配置</h2> OMV安装完毕后，暂时不要在UI里更新系统。尽管安装过程可能按照指引已经配置了国内的Apt源，但有些（比如Debian Security）未覆盖到，会导致apt update</code>等速度非常慢。</p> 因此建议先配置镜像</a>。</p>

配置缓存</h3> bcache已经并入内核很久了，但还是需要安装bcache-tools</code>来配置：</p>

后续配置</h3> 到这里就可以在UI中创建Btrfs分区并且挂载了。</p> 检查状态：</p>

Device or resource busy</h3> 进行配置过程中常见Device or resource busy</code>错误。针对不同的对象，有不同的处理方式。</p>

后端低速盘</h4> 在擦除文件系统之前，后端低速盘往往已经挂载并有服务相关联，首先要先停止服务并解挂载。</p> 如果盘已经被配置作为bcache后端，则需要先停掉：</p>

新建用户</h2> 在新建好的Btrfs分区上创建一个home</code>目录作为用户的家目录。</p> 新建用户时不选择用户组，则默认会赋予一个users</code>的组，一般来讲权限足够用。</p>

OS配置</h2>
OMV安装完毕后，暂时不要在UI里更新系统。尽管安装过程可能按照指引已经配置了国内的Apt源，但有些（比如Debian Security）未覆盖到，会导致`apt update</code>等速度非常慢。</p>`
`因此建议先配置镜像</a>。</p>`

Device or resource busy</h3>
进行配置过程中常见`Device or resource busy</code>错误。针对不同的对象，有不同的处理方式。</p>`

新建用户</h2>
在新建好的Btrfs分区上创建一个`home</code>目录作为用户的家目录。</p>`
`新建用户时不选择用户组，则默认会赋予一个users</code>的组，一般来讲权限足够用。</p>`