把吃灰的 Android 手机变成全平台私有云控制中枢。 本项目不仅是一个轻量级的文件服务器，而是一个包含了服务端、网页端、手机客户端、电视盒子端、智能手表端、桌面 GUI、极客 CLI，甚至涵盖了苹果原生、鸿蒙原生与微信小程序的十端全平台生态闭环。
原生内置 WebDAV、FTP、LocalSend、DLNA 四大主流局域网协议；支持跨端协同投屏与配置秒下发；手机端支持相册自动增量备份；全端支持局域网剪贴板同步；在 Root 特权加持下，更能解锁底层目录（
/data,/system）访问、Web Shell 终端执行、以及基于 H264 硬件编码的多模态云端远控。🔥 多核生态驱动 (Multi-Core Architecture)：本项目除了主打极限兼容的 Java 主干外，还在生态上进行了深度扩展，独立孵化了 .NET 10 (MAUI) 次世代分支与纯血 HarmonyOS (ArkTS) 分支。详见下方链接。
为了让不同的技术栈发挥极致的性能，部分核心端已独立建仓维护，并与主项目保持 API 100% 互通：
- 👉 android-nas-lite（精简版）：剥离远控、Root 全盘、Web Shell、内网穿透等高风险功能与低使用率模块，专注 HTTP/WebDAV/FTP 文件服务主线。跟随完整版大版本同步更新，非独立分叉。
- 👉 android-nas-dotnet（高版本现代重构）：基于 .NET 10 (MAUI) 与 ASP.NET Core，彻底拥抱现代 Android 权限模型，提供跨平台原生 GUI 体验。
- 👉 HarmonyNAS（纯血鸿蒙原生）：基于纯正 ArkTS 重写，拒绝任何黑科技，利用系统级
backgroundTaskManager合法保活，适配鸿蒙全家桶。
本项目拥有极其详尽的文档体系，无论你是小白还是极客，都能找到你需要的说明书：
- 📖 终极使用与运维指南 (USAGE.md)： 从零部署、网络映射（WebDAV/FTP）、跨端协同配置、相册备份实操、远控配置、CLI 终端指令大全以及深度故障排查。这是你上手 NAS 的第一站。
- 🔌 开发者 API 接口规范 (API_DOC.md)： 包含服务端 8080 端口的所有 HTTP API 细节、WebDAV 底层协议规范、跨端协同 UDP 协议以及特殊端口分配。
- 🏗️ 底层架构深度解析 (ARCHITECTURE.md)： 深入剖析纯 Socket 手写协议栈、H264 远控推流原理、极限兼容 API 8 的妥协之道、全盘突破机制以及四层保活矩阵。
- 🛡️ 安全策略与高危警告 (SECURITY.md)： （高危必读） 使用全盘模式、Web Shell、自毁模式和公网穿透前，请务必阅读此文档，了解明文传输风险与防变砖守则。
- 🤝 开发者贡献指南 (CONTRIBUTING.md)： AI 生成代码的声明、深度项目结构图、多环境编译隔离说明、代码提交规范。
- 🤖 AI 生成声明 (AI_DISCLOSURE.md)： 关于本项目 99% 代码由大模型生成的真实开发流程与局限性声明。
- 📝 版本更新日志 (CHANGELOG.md)： 追溯项目从 v1.0.0 到 v4.5.1 的完整演进史。
由于本项目采用极其激进的 CI/CD 自动化迭代，GitHub 右侧的 Releases 页面往往滞后于最新代码。请直接前往 GitHub Actions 页面下载最新构建产物！
👉 点此进入 Android NAS 主干 Actions 获取最新版构建产物
💡 极客一键全量平铺发版模式： 本项目配置了极其严谨的双轨制 CI/CD：
- 日常改代码：只触发对应端的快速独立编译（已配置忽略
.md等文档修改）。- 全量发版：每次修改根目录
CHANGELOG.md并推送，CI 会瞬间启动build-all.yml矩阵，将 10 个端 全部并行编译。最终产物不会被塞进恶心的 ZIP，而是自动重命名并直接平铺展示在 Releases 页面的 Assets 列表中，供用户按需下载。
市面上的手机 NAS 软件往往存在各种妥协：要么不支持老旧系统，要么 UI 落后，或者受限于单一平台。本项目专为极客打造，具备以下优势：
- 十端合一，全场景覆盖：服务端、Web、手机、TV、手表、桌面、CLI、苹果、鸿蒙、小程序。无论你在哪块屏幕上，都能无缝访问你的数据。
- 多协议制霸：原生实现 WebDAV、FTP、LocalSend、DLNA。在开启 Root 全盘模式后，这些协议可直接穿透 Android 沙盒访问系统底层。
- 极客特权与网络中枢：支持 OOM 免死注入、静音音频保活、Web Shell 终端、H264 远控引擎。网页端全新实装服务状态大盘（端口探针监控）与局域网极限测速，更有强大的短信中心可远程收发短信并转发验证码。
- 极致兼容与美观并存：服务端最低兼容十年前的 Android 2.2 (API 8)；手机端和网页端全面采用 Material Design 3 规范，Web 端现已支持 PWA 及全量 MD3 SVG 矢量图标。
- 企业级五重安全防线：内置密码加盐哈希、防暴力破解（Fail2Ban）、原生 2FA 两步验证（默认关闭）、隐藏入口暗号防扫、高危 API 局域网物理锁、防 CC 限流。全端支持 HTTPS / WSS 加密传输，更提供“多重验证自毁模式”。
- 物理级挂机防护：专为旧手机 7x24 小时插电设计，全新加入电池温度熔断保护。实时监控电池物理温度，超过 45℃ 触发报警并支持 Root 自动停充，彻底杜绝电池鼓包风险。
- 多端口并发调度：
8080：Web 网页管理 / JSON API / 流媒体分片。8081：标准 WebDAV 协议（纯 Socket 手写实现）。2121：原生 FTP 服务（支持 PASV 被动模式）。53317：LocalSend 接收端。8090：跨端协同发现服务（UDP）。8082：WebSocket 远控服务（H264 推流与触控指令）。
- 多用户隔离 (SQLite)：底层生成
nas_core.db，支持多账号注册，不同账号自动映射到独立的物理目录，互不干扰。 - 五大高级安全防线：支持纯 Java 实现的 2FA 动态口令绑定、算数验证码、防 CC 限流、隐藏暗号入口、高危操作局域网锁。
- 短信与通知中枢：接管旧手机短信功能，可在网页端直接发送短信，或通过 Webhook 将收到的验证码实时转发至主力机。
- 全盘 Root 模式与无敌保活：一键突破沙盒，静音音频欺骗与 Root 注入免死。
- 大文件秒传与断点续传：底层实装 MD5 秒传校验与 2MB 分片流式合并，支持超大文件无视网络波动的稳定上传。
- Webhook 自动化通知：支持配置 Telegram/企业微信 Webhook，实现文件上传、高温报警、异常登录等事件的实时推送。
- 服务状态大盘：MD3 胶囊卡片风格，多线程并发探测并展示宿主机各项服务（Alist、Jellyfin 等）的存活状态与延迟。
- 网络极限测速：一键生成 20MB 数据流，瞬间测出手机与路由器的真实局域网带宽。
- 多模态远程桌面：H264 硬件编码 30fps 推流 + Root 截图降级方案，支持触控反向控制。
- PWA 与全量矢量图标：集成
manifest.json与Service Worker，全站 UI 及图标 100% 替换为 Material Design 3 风格。 - 家庭媒体库：内置时光相册瀑布流与真实影视海报墙（免 Key 刮削），支持远程播放。
- 系统控制台：可直接修改密码、端口、配置 2FA、高级安全防线及触发终极自毁程序（Panic Wipe）。
- 相册自动增量备份：利用
MediaStore扫描本地，自动建目录并比对增量上传。 - 全端功能对齐：支持影视墙、时光相册、大文件秒传与断点续传。
- 深度服务端控制：可以在客户端直接修改服务端别名、Webhook、安全开关。
- 双重验证自毁：支持输入 NAS 密码并结合手机系统级指纹/锁屏密码验证的核按钮。
- 远控与控制台：原生
WebViewActivity，一键全屏打开终端与远控面板。
- 纯原生 Tkinter：无内置浏览器，秒开不卡顿，支持最小化至系统托盘（后台静默）。
- 全局搜索与剪贴板：顶部全局搜索，以及局域网剪贴板双向同步。
- 大文件秒传：带 MD5 秒传校验与分片进度条。
- 高级分享：支持设置提取码与有效期，一键复制外链。
- 在线编辑与解压：多选并发上传，自带在线文本编辑与 ZIP 解压。
- 交互式 Shell：输入
shell进入，支持 Tab 路径自动补全。 - 极客专属：支持
put命令的秒传与分片；支持生成带提取码的分享链接；支持exec直接执行服务端 Root 命令。
- 原生体验：全端对齐了文件搜索、剪贴板同步与外部 Web 控制台唤起。
- 鸿蒙专属：基于 ArkUI 声明式开发，一套代码自适应手机/平板/PC，依托官方长时任务合法驻留。
- TV 端：Leanback 卡片流，遥控器焦点移动 1.1 倍放大动画。已全面支持影视墙与时光相册。
- 手表端：RecyclerView 卡片布局，按压动画。支持媒体预览、投屏与下载至专属沙盒。
- 免安装即用：支持全盘文件搜索、局域网剪贴板浮层、以及生成免密分享短链。
- 一键下发配置：手机端点击“发送配置到电视”，通过 UDP 发现电视并下发 NAS 密码。
- 短信自动转发：旧手机收到银行/登录验证码，瞬间推送至你的主力机微信或 TG。
- 全端剪贴板同步：手机复制文字，网页端、桌面端直接粘贴。
- 终极自毁 (Panic Wipe)：网页端或手机端发起，可配置仅擦除文件或连系统底层一起格式化，防止隐私泄露。
| 端 | 最低兼容系统 | 核心技术栈 | 核心取舍 |
|---|---|---|---|
| 服务端 (Java) | Android 2.2 (API 8) | 纯 Java + NanoHTTPD + Socket + SQLite | 锁定 targetSdk 22 跳过动态权限，极限兼容。 |
| 手机端 | Android 5.0 (API 21) | Java + Material Design 3 + OkHttp | 强制动态取色，适配 Android 13+ 权限。 |
| 桌面端 / CLI | Win 7 / Linux | Python 3 + Tkinter / cmd | 无内置浏览器，秒开不卡顿。 |
| 苹果 / 鸿蒙 | iOS 15 / Harmony 4 | SwiftUI / ArkTS | 原生声明式 UI，系统级 Want/OpenURL 调用。 |
| 次世代 (.NET) | Android 10+ / Win 10+ | C# + MAUI + ASP.NET Core | 现代存储权限模型，原生跨平台 GUI。 |
- 版本号控制：项目引入了
sync_version.py。Actions 会自动读取CHANGELOG.md的版本号，注入到所有端的工程配置中，并支持全端 API 版本对齐。 - 纯手写协议栈：WebDAV 与 FTP 完全手写 Socket 报文解析，不依赖重型库，保证极低包体积。
- 并发安全底座：HTTP、FTP、WebDAV 采用
ThreadLocal进行用户身份隔离，从底层杜绝高并发越权。
- 隐藏入口遗忘风险：高级安全防线中的“隐藏入口”如果遗忘，将导致无法访问控制台，仅能通过局域网修改配置。
- 2FA 密钥丢失：开启 2FA 后请务必保存好密钥，一旦手机丢失将无法登录。
- Root 模式与自毁的危险性：全盘模式、Web Shell、自毁模式拥有极高的系统权限。在执行操作前，请确保清楚后果，切勿在主力机上随意测试。
- 多用户共享：请妥善保管
admin账号，普通用户被限制在自己的根目录下。 - 明文传输提示：虽然已支持 HTTPS/WSS，但老设备强制降级环境仍为明文，若在公共网络使用，建议开启 HTTPS 或自建 SSH 穿透加密。
本项目使用 MIT License。