# Docker

在 RK3588 的 Ubuntu 24.04 主机上，为 Docker 运行的 OpenAlist 新增宿主机侧 rclone 只读 FUSE 挂载，把夸克网盘指定电影子目录经本机 WebDAV 挂到宿主目录，供播放器或媒体库读取，且不改动原有容器、端口和存储。挂载由 systemd 管理，关闭 VFS 落盘缓存，仅内存分段读取和 5 分钟目录缓存，并限制 CPU0–3、512MiB 内存。凭据文件权限 700/600，pass 仅混淆非加密，不可分享。已验证认证、只读、分段读取和拒绝写入，未做整机重启、完整 4K、并发或断网测试。卸载前需释放占用，归档还原不自动启动服务。

本文记录在RK3588 ARM64上，为宿主机Cloudreve 4.19.1部署Tika和Meilisearch全文搜索，服务仅监听本机回环端口。本轮只完成依赖部署和局部验证，未开启后台开关、未重建业务索引或扫描历史文件，语义搜索暂未部署。后台需填回环端点，密钥从.env读取，最大20MB、分块1KB。已有文件不会自动入索引，需手动重建；普通Tika无OCR，扫描件和图片不能文字检索。撤销时关闭全文搜索并停止容器，down勿加-v。

usb-storage-guard 解决 RK3588 盒子外接 USB 盘的缺盘阻塞开机和容器旧挂载视图问题。它按 UUID 识别盘，禁用服务直接开机入口，将外盘容器 restart 改为 no，守护无外盘依赖；盘回来自动拉起业务。守护还会复核容器内绑定，纠正盘后挂载仍见 eMMC 空目录的旧视图，并支持自动发现外盘 bind、暂停与手停持久化。实测覆盖缺盘、错误 UUID、只读和恢复，但未做真实拔插、断电或缺盘整机重启验收。

Cloudreve 4.19.1 离线下载报错，根因是主节点只配 provider=aria2，缺少 aria2 子配置且未装下载器，导致空指针 panic。修复不升级、不重启本体，在 RK3588/Ubuntu 24.04 新建独立 aria2 1.37.0 容器，仅回环发布 6800，随机 RPC 令牌，非 root、只读 rootfs、资源受限，并配合 usb-storage-guard 与外盘挂载；再用 manage.py 经官方 API 补全节点配置。验证 API 返回 1.37.0，认证 RPC 正常，未认证和局域网访问被拒，真实下载 LICENSE 35146 字节且 SHA256 一致，原有失败任务未重试。回退须先关闭主节点离线下载再停容器，不能清空子配置却保留 provider。未实测 BT、大文件、断电与缺盘重启。

NVIDIA Container Toolkit 是桥接容器运行时与主机 GPU 驱动的工具集，使 Docker、containerd、Podman、Kubernetes 能运行 GPU 容器。它支持 --gpus all 启用 GPU，保证 CUDA 与驱动兼容、避免冲突，并可精细控制 GPU。安装前需装驱动并配置科学上网或全局代理；添加仓库密钥和包源后安装 nvidia-container-toolkit，按需将 Docker 配置为默认 NVIDIA 运行时。测试运行 CUDA 容器并执行 nvidia-smi，显示显卡信息即成功。