PRIVACY.md

Rama main · réplica de lectura del repositorio original.

# 隐私说明（Privacy）

> 这份说明告诉你：OmniNest 会涉及哪些数据、它们存在哪里、如何被使用，以及你需要注意什么。
> 它适用于源码分发与自托管部署场景。若未来提供由项目方运营的托管服务，会另行补充对应说明。

---

## 一、OmniNest 是什么

OmniNest 是一个自托管的媒体中心，涵盖文件、影视、音乐、相册、阅读、同步、离线与系统管理。
它以源码形式分发，**数据默认保存在你自己部署的服务器与存储中**。

**核心原则：OmniNest 项目开发者不运营任何面向公众的服务器，不收集、不上传你的媒体库内容。**

---

## 二、数据的存储位置

- 所有业务数据（账号、文件元数据、任务、配置等）存储在你自建实例的 **PostgreSQL** 数据库中。
- 文件与媒体原始字节存储在你配置的内容 Provider（默认 MinIO，或你登记的本地文件系统来源）。
- 客户端（Web / Android / Windows 桌面）的本地缓存、播放记录等存储在你的设备上。

上述数据**均在你自己的基础设施内**，不经过 OmniNest 项目开发者。

---

## 三、涉及的数据类型与处理方式

| 数据类型 | 存储位置 | 处理说明 |
|---|---|---|
| 账号凭据（用户名、密码哈希、JWT） | 你的 PostgreSQL | 密码经单向哈希存储；登录状态基于 JWT 校验 |
| 媒体库元数据（文件名、封面、标签、播放记录等） | 你的 PostgreSQL / 本地缓存 | 仅用于在你实例内提供功能 |
| 文件与媒体内容 | 你的 MinIO / 本地来源 | 由你自行上传或登记，开发者不接触 |
| **第三方音乐平台凭据（Cookie / Token）** | 你的 PostgreSQL | **经 AES-256-GCM 加密后落库**，见下文第四节 |
| 音乐平台用户信息（昵称、头像、VIP 状态） | 你的 PostgreSQL | 仅用于在你实例内展示账号状态 |

---

## 四、第三方音乐平台凭据的专门说明

当你选择连接第三方音乐平台（如网易云音乐）时：

1. **你主动提供**平台 Cookie/Token，OmniNest 仅在你实例内保存，用于将你的请求转发至对应平台以获取音乐资源。
2. 凭据**不以明文存储**：落库前经 `CredentialCipher`（AES-256-GCM）加密，密文写入 `encrypted_credentials` 字段，
   并附带密钥版本号以支持密钥轮换；加密密钥由**部署者**通过配置项提供，未配置时凭据功能不可用。
3. 凭据**仅在你主动发起音乐平台请求时**，解密后转发至该平台；不会转发给任何其他第三方。
4. 你可以随时在实例内**断开平台连接**，对应的加密凭据会被删除。

> 提示：第三方平台的 Cookie 本身受该平台服务条款约束。请自行确认你使用该凭据的方式符合平台规则。

---

## 五、数据是否向第三方传输

- 默认情况下，OmniNest **不向任何第三方发送你的数据**。
- 唯一例外：你主动连接第三方音乐平台时，凭据与你发起的请求会转发至**该平台本身**（用于获取你请求的音乐资源）。
- 病毒扫描（ClamAV）、图像分析（可选侧车）等可选组件若由你启用，相关数据仅在**你自己的实例与组件**之间流转。

---

## 六、你的权利

作为自托管部署者/使用者，你可以：

- **删除账号与数据**：在实例内删除账号，或直接管理你自己的数据库与存储。
- **断开第三方连接**：随时撤销音乐平台凭据。
- **导出与备份**：数据在你自己的基础设施内，你可自行导出、备份或迁移。

由于数据在你自己的服务器上，行使上述权利**不依赖 OmniNest 项目开发者**。

---

## 七、责任边界与免责

- 自托管环境下，数据的安全、备份、密钥管理、公网暴露面与访问控制**由部署者自行负责**。
- 因部署者配置不当、权限开放或公网暴露导致的数据泄露、隐私风险，**由部署者自行承担**。
- OmniNest 项目开发者、贡献者不对因使用或无法使用本软件导致的隐私或数据损失承担责任（详见 README「免责声明」）。

---

## 八、一点提醒

- 请留意你所在地区关于个人信息与数据存储的相关规定。
- 如果你把实例开放给其他人一起使用，请自行评估你作为运营者应尽的告知义务。
- 本文档可能随项目更新而调整，重要变化会在 README 或发布说明里提示。

---

_最后更新：2026-09-22_