WaterNasOS 使用教程

服务端目前面向 Windows x64。前往官网下载页（或 GitHub Releases）下载 WaterNasOS-Server-win-x64-….zip，解压到一个磁盘空间充足的目录（例如 D:\WaterNasOSServer）。

• 解压后目录内应有 WaterNasOSServer.exe 及其依赖文件，请勿只拷贝 exe，整目录一起用。
• 首次安装建议把服务端放在非系统盘；缩略图、地图瓦片、海报等缓存会逐渐变大，后续也可以在服务端里把缓存目录改到别的磁盘。
• 如需 AI 能力（人脸 / 场景 / OCR / 语义搜索），把模型目录 onnx_models 一并放到服务端目录（部分发布包不含模型，需按说明下载后放入）。

双击 WaterNasOSServer.exe 启动。首次启动会自动建库、初始化配置，随后服务端主窗口（服务端 UI）会打开。

服务端启动后监听两个端口：HTTP 默认 6789、HTTPS 默认 6799。在 状态 页可看到本机 IP 与可访问的服务地址，形如 http://192.168.1.10:6789。若端口被占用，服务会自动顺延，实际端口以界面显示为准。

首次启动会生成一组初始管理员账号与密码，请在 状态 页查看并立即记录，下一步登录后尽快修改。

用浏览器打开 状态 页显示的服务地址，用初始账号登录服务端 UI。左侧菜单依次是：状态 日志 管理员 设置 访问范围 进程 教程。

① 修改管理员账号密码

进入 管理员，在“修改用户名 / 密码”里设置新密码，点“确认修改”。密码不能为连续字符或同一字符重复，也不能与用户名相同。如果你还在用初始密码，状态 页会有醒目提示。

② 建议开启两步验证（2FA）

管理员 → “两步验证 (2FA)”，按提示启用；如需重置换机，可在同处“重置 2FA”。

③ 设置界面语言与启动行为

设置 → “通用设置”。界面语言支持 13 种语言；可按需勾选“开机自启动”“启动后最小化到托盘”；“自动发现服务器”用于在局域网广播，让客户端自动发现本机。

④（可选）把缓存目录迁到别的磁盘

设置 → “缓存目录”。缓存（缩略图、地图瓦片、海报、字幕等）默认在用户数据目录下，实际位于所选目录的 nascabos_cache 子目录。改到其他磁盘后点“保存并搬迁”，需重启服务以完成搬迁（搬迁期间服务暂不可用）。

按你的设备选择客户端。首次打开时，输入服务器地址 + 管理员账号密码完成连接；连接成功后，桌面端与安卓端会记住服务器与账号并自动登录（主动登出可取消）。

• Windows 桌面端 WaterNasClient：主力客户端，管理全部应用，支持各应用独立开窗。
• Windows 同步端 WaterNasSync：只做目录同步，专注“电脑 ↔ NAS”双向同步。
• Android 主端 / 相册端 / 音乐端：三个独立 APK，图标与启动模式分离，按需安装；装一个不影响另一个。
• TV：Android TV / Apple TV 大屏播放，遥控器操作。
• 网页端：浏览器直接访问服务地址，零安装即可管理与浏览。

若客户端搜不到服务器，检查服务器与客户端是否在同一局域网、服务器防火墙是否放行对应端口，或在客户端里手动输入服务地址。

WaterNasOS 的功能都建立在你指定的文件夹（来源目录）之上。在客户端的相应模块里添加来源，例如：

• 文件管理：添加要浏览 / 备份 / 分享的目录；
• 照片：添加照片来源目录；
• 影视库：按“电影 / 电视剧 / 图片 / 混合”等库类型添加来源目录；
• 音乐库：添加音乐来源目录。

添加后，服务端会扫描目录并生成索引；之后这些目录里的文件变动会被自动检测并更新索引，无需手动重扫。若目录路径发生变更，记得在对应模块的“来源设置”里做重定位。

访问范围（限制服务端能碰哪些目录）

服务端 UI → 访问范围，设定本应用可用的目录范围：

• 指定目录：只允许访问你选定的目录（更安全，推荐）；
• 全部目录：允许访问应用可用的全部目录。

同一页还有 终端 开关：是否允许管理员账号通过客户端使用“终端”应用，默认开启，可关闭。

在 文件管理 里浏览、上传下载、移动复制、分享来源目录中的文件，并支持全局文件搜索（后台索引进程）。围绕文件还有几个常用能力：

• 分享管理：把目录以 WebDAV / FTP / SFTP 形式分享出去；
• 远程挂载：挂载网络目录（含 SMB 等）与网盘；
• 文件备份：按备份规则把本地内容备份到 NAS；
• 媒体工具：图片批量压缩 / 转换、视频 / 音频批量转换、媒体整理；
• 下载：内置 BT / PT 下载（Transmission）。

把照片来源目录加入后，服务端会后台扫描、生成缩略图并建立索引，在 照片 应用中按时间轴浏览。它自带一套本地 AI 能力（无需联网）：

• 人脸识别：自动识别照片中的人物；
• 场景识别：给照片打上场景标签；
• 文字识别（OCR）：识别照片中的文字；
• 语义搜索：用中文短语搜照片（如“海边 日落 狗”）；
• 足迹地图：按拍摄地点在地图上聚合、点开范围、反查地名；
• 去重与相似：按内容找重复 / 相似照片，清理过程为预演 → 执行 → 可撤销；
• 相册备份：把手机相册备份到 NAS。

智能发现（记忆为新）

相册里的“发现 / 记忆”提供一批智能整理视图：记忆（候选发现 → 确认 / 忽略 / 恢复，卡片写“地点 · 干了什么 · 张数”，可逐张移出）一日一帧（每天一张代表作）票夹（按行程归组票据）年度报告时光对照（同一地点跨年份）旅程回放。

回忆与人生章节

记忆页分“我的 / 待确认 / 已忽略”三态，待确认带红点；人生章节把照片按年“成书”，一页一天、双页对开，可用键盘 / 鼠标翻页；相册首页有大搜索栏，点开即搜索（推荐词 + 联想 + 最近搜索）。

识别模型管理

人脸 / OCR / 场景 / CLIP 等模型可在 AI 设置里集中查看与切换；识别队列可一键暂停 / 恢复，OCR 支持全库重置。

人脸识别出“人脸”之后，还需要把同一个人的人脸聚成一组——这就是“人物分组”。本版把“全部重新识别”升级为全库重建 v2：

• 不再在旧分组上再跑一遍，而是从完整特征库重算一遍全局分组（互为近邻图 → 标签传播 → 簇级审计 → 低质量二次认领）；
• 同一张照片里的两张不同人脸禁止进同一组，减少“合照被认成一个人”的错误；
• 结果先预览再决定是否提交，提交前自动备份，可精确回滚。

入口：照片 → 人脸 / 人物 → “全库重建”，在弹出的对话框里预览结果，满意后再提交。整个重建在后台进行，可在 进程 页观察进度。

影视库支持按 电影 / 电视剧 / 图片 / 混合 划分多个“库”，每个库独立开关。添加来源目录后，服务端会扫描并刮削影片信息，自动整理成海报墙。

• 刮削与信息：自动 / 手动刮削影片信息（NFO），生成影片信息卡（分辨率、HDR、音轨等）；
• 播放：本地 / 网页 / TV 播放，画质按编码分档，转码失败自动降级，支持音频响度归一、默认字幕语言；
• 字幕：从视频中提取内嵌字幕、加载外挂字幕，播放器可切换字幕；
• 重复清理：找出重复的影视文件，确认后清理本版更新；
• 播放设置：画质、字幕、播放偏好在各端（Windows / Android / TV）已统一补齐本版更新。

用网络目录（SMB）作为影视来源本版更新

本版新增 SMB 网络目录 来源类型：在影视 / 文件来源里选择 SMB，填写主机、共享名、子路径、账号密码即可把另一台机器上的目录当作来源。密码经加密后存储；服务端会先做端口可达性探测，那台机器离线时，它的内容会自动隐藏；文件被扫描进索引后，搜索 / 列表 / 查重仍然只读数据库，不受对方开关机影响。

添加音乐来源目录后，服务端扫描曲目、读取元数据与封面，按歌曲 / 专辑 / 播放列表组织，支持网页与客户端播放。音乐索引与文件变动检测在后台运行，目录里增减歌曲会自动更新。

• 图书：索引 EPUB / MOBI / PDF 等格式，在线阅读；
• 笔记：富文本笔记；
• 加密空间：AES 加密存储敏感文件，导出在后台进行。

这些都是独立应用，各自有独立的页面与 API；桌面端还能把某个应用单独开窗。

用 WaterNasSync（Windows 同步端）或桌面客户端里的“同步管理”，建立电脑 ↔ NAS 的目录同步任务。服务端提供 /api/sync 命名空间，任务与每次同步记录都会留痕可查。适合把本机工作目录、资料目录持续同步到 NAS 做备份。

不在同一局域网时，可通过远程连接访问服务端。底层用 P2P 打通，打不通时自动走中继。开启远程连接后，用配对码即可在客户端快速连接，无需手动填写端口或做端口映射。

如需固定公网访问地址，可在服务端配置 DDNS，把域名解析到你的公网 IP。

WaterNasOS 提供统一的接口描述与开放能力，便于二次开发与外部工具接入：

• OpenAPI：GET /api/openapi.json 给出完整的接口清单，可作为单一真源生成客户端或做接口审计；
• MCP：/api/mcp 暴露一组只读工具（搜索照片、读取时间线、查看人物 / 地点等），供支持 MCP 的智能体调用；使用独立的 wnos_ 令牌（与登录令牌分开），令牌仅在轮换时明文出现一次。

服务端 UI 的日常工具

• 状态：服务地址、数据库目录与合计大小、缓存目录、版本与更新状态；可对数据库做“碎片整理”（耗时较长，期间 API 会有短暂影响）；
• 日志：实时日志，排查问题时先看这里；
• 进程：查看各后台进程（索引、人脸 / OCR / 场景识别、缩略图、转码等）与内存占用；
• 设置 → “缓存统计与清理”：按类别统计缩略图 / 海报 / 地图瓦片 / 字幕 / 转码临时文件等占用，勾选后一键清理。

稳定性：watchdog 守护本版更新

本版加入 watchdog 守护：进程内持续采样 CPU、事件循环延迟、内存与子进程风暴并写入日志；进程外还有监督进程，一旦心跳中断（连定时器都被拖死）会记录现场，并按配置决定是否自动重启，让长时间运行的 NAS 更稳。

更新服务端

服务端会检查新版本，在 状态 / 关于 中可看到更新状态并一键更新。升级前建议记录当前版本，并保证数据库 / 缓存所在磁盘有足够空间。