Repository navigation
Releases
v4.5.1
👑 Android NAS v4.5.1 正式发布!
十端生态矩阵:全平台私有云控制中枢
🚀 核心更新亮点
🗿 终极磐石版:120+ 项核心重构与全端深度除虫
这是一个经历了极客级别深度源码审计后的抢救性补丁。彻底肃清了 v4.5.0 初版遗留的大量阻断性崩溃、并发死锁、验证机制失效与底层兼容性问题。
Fixed (🚨 核心安全与鉴权)
- 2FA 生死劫全面修复:修复了 2FA 校验死锁导致前端收不到
2FA_REQUIRED的致命 Bug;修复了密钥未持久化导致扫码永远无效的问题;修复了 FTP/WebDAV 协议因无法携带 TOTP 而导致账号锁死的问题。 - IP 获取与局域网锁:废弃了 NanoHTTPD 2.2.0 不支持的
getRemoteIpAddress();修复了172.2公网 IP 误判为内网的越权漏洞;彻底修复了因 IP 获取错误导致五重安全防线(白名单、防爆破、防 CC)全局失效的灾难性缺陷。 - 验证码死锁与越权:修复了算数验证码永远不触发的死锁;强制
/api/2fa与短信收发接口必须管理员(Admin)权限,杜绝普通用户窃取验证码与 TOTP 密钥。 - 路径穿越与逻辑越权:修复了新建用户的
root路径穿越漏洞;修复了 LocalSend 上传文件名的路径穿越风险;修复了 WebDAV 允许DELETE /导致根目录被一键清空的夺命 Bug。 - 分享与配置安全:彻底实装了分享链接的“提取码”与“有效期”校验;修复了 Webhook 推送及系统设置接口因未转义 JSON 导致的崩溃。
Fixed (🩹 底层网络与并发逻辑)
- 分片与秒传重构:彻底解决了多端并发导致的最后一片分片补 0 损坏文件的问题;改用
RandomAccessFile解决分片乱序覆盖;修复了秒传接口只返回成功却不真正复制文件的逻辑脱节。 - WebDAV 与 FTP 引擎:WebDAV 新增原生
Range断点续传支持(修复视频拖动失败);FTP 改用遍历NetworkInterface获取真实局域网 IP,解决热点模式下数据通道完全不可用的死穴。 - API 8 与老版本兼容:修复了
RadioGroup在 Android 4.2 及以下触发的NoSuchMethodError崩溃;移除不支持的waitFor(long, TimeUnit)API;补齐startForegroundService防范 Android 8+ 后台启动崩溃。 - 服务启动与状态:修复了
running状态假报错;补齐了 DLNA、LocalSend、短信监听和静音保活的真实启动与注销逻辑,防止内存泄漏。 - 数据库与系统:修复了数据库升级时会错误重置管理员密码的致命 Bug;修复了
isDefaultPwd静态变量不持久化的问题;彻底剥离了协议开关与“极寒模式”的强制绑定。
Fixed (🌐 Web 与多端联调)
- 全站白屏与 ES5 兼容:彻底重写了
window.fetch拦截器,清理了重复注入与残缺代码;全面消灭了擅自引入的 ES6 箭头函数,保证老旧浏览器正常运行。 - POST 参数全面恢复:解决了因
FormData与getParms脱节导致保存设置时清空所有配置、新建/重命名/删除完全失效的灾难级 Bug。 - 多文件与预览修复:修复了前端上传只能传第一个文件的限制;修复了预览时因丢失
f.path导致的无限报错。 - PWA 缓存与 Range:更新了
Service Worker版本号并加入skipWaiting,解决了 PWA 页面永不更新的顽疾;放行了Range请求防止视频播放被缓存拦截。 - 多端边缘修复:彻底修复了鸿蒙端
btoa报错(改用原生@ohos.util);修复了微信小程序TextEncoder缺失导致的认证崩溃;修复了桌面端与客户端的变量捕获、UI 复用与文件异常。
Changed (CI/CD 与构建)
- 发版链路抢救:全面废弃容易在 YAML 中引发语法崩溃的 Here-Document,改用
printf追加生成 Release Notes。 - 编译错误肃清:修复了 NanoHTTPD 2.2.0 缺失的状态码、
SettingsManager的括号雪崩、AuthManager参数不匹配等数十项阻断编译的错误。
📦 安装包下载指南 (Assets)
请直接点击下方对应的文件下载(所有端版本号均已同步):
- 📱 服务端 (旧手机):
AndroidNAS-Server-v4.5.1.apk - 🖥️ 手机客户端 (主力机):
AndroidNAS-Client-v4.5.1.apk - 📺 TV 电视端:
AndroidNAS-TV-v4.5.1.apk - ⌚ 手表端:
AndroidNAS-Watch-v4.5.1.apk - 💻 Windows GUI:
AndroidNAS-Desktop-Windows-v4.5.1.exe - 🐧 Linux GUI:
AndroidNAS-Desktop-Linux-v4.5.1 - ⌨️ Windows CLI:
nas-cli-windows-v4.5.1.exe - ⌨️ Linux CLI:
nas-cli-linux-v4.5.1 - 🌐 浏览器插件 / 微信小程序:
.zip压缩包
(注:苹果与鸿蒙端需使用开发者工具自行编译签名。)
⚠️ 安全与高危警告
- 全盘模式与远控的危险性:开启 Web Shell、H264 远控或 Root 免死保活时,应用将拥有极高的系统权限。请绝对不要在公共 WiFi 下暴露远控端口。
- 保活模块冲突:若刷入了 Magisk 特权模块,可能会导致系统安装器提示“应用未卸载”。请进入 Magisk 临时关闭模块并重启后,使用
pm uninstall强删。 - 明文传输:局域网传输默认明文 HTTP。公网访问请务必自建 SSH 穿透进行加密。
Enjoy your personal cloud! 如果觉得项目对你有帮助,欢迎点一个 ⭐ Star!
v4.5.0
👑 Android NAS v4.5.0 正式发布!
十端生态矩阵:全平台私有云控制中枢
🚀 核心更新亮点
🛡️ 终极网关堡垒:五大安全防线、服务大盘与硬件哨兵
这是一个将 Android NAS 从“文件服务器”升格为“全栈私有云网关”的重磅版本。实装了极其严苛的安全拦截矩阵、多端联动的短信中枢、一键网络测速与可视化服务大盘,并为旧手机挂机加入了物理级电池熔断保护。
Added (🛡️ 五重高级安全防线控制台)
- 原生 2FA 两步验证 (默认关闭):纯 Java 实现 TOTP 算法(兼容 Google Authenticator),需在网页端手动开启并扫码绑定,所有未授权的非密码请求将被直接斩断。
- 隐藏入口暗号:支持自定义 Secret Path,未携带暗号的请求统一返回伪装 404,防扫站脚本探测。
- 算数图形验证码:连续登录失败触发 Fail2Ban 后,前端自动弹出算数验证码,彻底阻断并发爆破脚本。
- 高危 API 物理局域网锁:强制限制
/api/shell、/api/settings、/api/system/wipe等核心接口仅限局域网 IP(如 192.168.x.x)访问,杜绝公网穿透被黑客提权。 - 防 CC 限流与会话防护:新增基于滑动窗口的单 IP QPS 限制;新增闲置自动登出机制;隐藏默认的
Server响应头,防止底层指纹泄露。
Added (📡 服务大盘与网络中枢)
- 原生端口探针大盘:Web 端新增 MD3 胶囊卡片风格的服务大盘,多线程并发探测宿主机(Alist、Jellyfin、WebDAV 等)的存活状态与延迟。
- 局域网极限测速:新增
/api/speedtest接口,直接消耗 20MB 数据流,瞬间测出旧手机与局域网的真实带宽。 - 短信中心与通知转发:旧手机新增强大短信中枢。可在网页端直接收发短信,并自动通过 Webhook 转发新短信(如验证码)至主力机。
Added (🔋 挂机防护与 UI 升级)
- 电池温度熔断保护:实时监控电池物理温度,超 45℃ 触发保护报警,支持通过 Root 自动停充。
- 全量 MD3 SVG 图标:网页端菜单、顶部导航与 PWA 桌面图标全部替换为纯 Material Symbols 矢量图标,彻底告别 Emoji。
Changed (架构与底层重构)
- CI 发版链路抢救:全量废弃极易崩溃的 Here-Document (<<EOF),改用
printf追加生成 Release Notes;重构SettingsManager与NasHttpServer,彻底消灭历史遗留的括号雪崩。
Fixed (🚨 核心漏洞与致命 Bug 修复)
- 沙箱逃逸全量修复:修复
NasHttpServer与FtpServer因new File(rootDir, "/path")前导斜杠导致的父目录忽略缺陷,修复 Guest 账号全站 404 问题。 - 鉴权死锁与编译错误:修复
AuthManager参数缺失导致的编译崩溃;修复 NanoHTTPD 2.2.0 不支持的 429 状态码,降级兼容至 403。
📦 安装包下载指南 (Assets)
请直接点击下方对应的文件下载(所有端版本号均已同步):
- 📱 服务端 (旧手机):
AndroidNAS-Server-v4.5.0.apk - 🖥️ 手机客户端 (主力机):
AndroidNAS-Client-v4.5.0.apk - 📺 TV 电视端:
AndroidNAS-TV-v4.5.0.apk - ⌚ 手表端:
AndroidNAS-Watch-v4.5.0.apk - 💻 Windows GUI:
AndroidNAS-Desktop-Windows-v4.5.0.exe - 🐧 Linux GUI:
AndroidNAS-Desktop-Linux-v4.5.0 - ⌨️ Windows CLI:
nas-cli-windows-v4.5.0.exe - ⌨️ Linux CLI:
nas-cli-linux-v4.5.0 - 🌐 浏览器插件 / 微信小程序:
.zip压缩包
(注:苹果与鸿蒙端需使用开发者工具自行编译签名。)
⚠️ 安全与高危警告
- 全盘模式与远控的危险性:开启 Web Shell、H264 远控或 Root 免死保活时,应用将拥有极高的系统权限。请绝对不要在公共 WiFi 下暴露远控端口。
- 保活模块冲突:若刷入了 Magisk 特权模块,可能会导致系统安装器提示“应用未卸载”。请进入 Magisk 临时关闭模块并重启后,使用
pm uninstall强删。 - 明文传输:局域网传输默认明文 HTTP。公网访问请务必自建 SSH 穿透进行加密。
Enjoy your personal cloud! 如果觉得项目对你有帮助,欢迎点一个 ⭐ Star!
v4.4.1
👑 Android NAS v4.4.1 正式发布!
十端生态矩阵:全平台私有云控制中枢
🚀 核心更新亮点
🚑 紧急核弹补丁:全端沙箱重生与 CI 发版链路抢救
这是一个专门针对 v4.4.0 遗留的高危逻辑漏洞、底层语法雪崩与自动化发版链路的抢救性版本。彻底拔除了潜伏在底层的所有致命隐患。
Fixed (🚨 核心安全与全站瘫痪)
- 普通用户全站 404 与沙箱逃逸:彻底修复了
NasHttpServer与FtpServer中因new File(rootDir, "/path")前导斜杠导致父目录被忽略的底层 Bug。修复前 Guest 账号访问任何文件均报 404,且存在底层越权风险。 - CI 自动化发版脚本崩溃:废弃了极易引发 YAML/Bash 语法错乱的 Here-Document (<<EOF),改用
printf追加生成 Release Notes,彻底解决发版环节的报错。
Fixed (🩹 历史遗留的编译雪崩)
- SettingsManager 括号嵌套死局:全量重写类结构,拔除了导致 93 个连锁报错的未闭合方法。
- NanoHTTPD 2.2.0 状态码错乱:将不支持的
429 TOO_MANY_REQUESTS与503 SERVICE_UNAVAILABLE降级兼容为403 FORBIDDEN,完美适配极限 API 8。 - HttpServerService 导包缺失:补齐了被遗漏的
java.io.File导入,解决cleanOldParts报错。 - FtpServer 幽灵代码残留:清理了错误复制的
break语句与重复声明的变量,恢复纯 Socket 线程的正常运转。
Changed (开发规范与文档)
- 新增移动端极限开发规范:引入
DEVELOPMENT_CONSTRAINTS.md,诚实披露本项目的物理开发环境限制与责任边界。 - AI 协作透明化:进一步细化 AI 开发声明与真机验证模块清单。
📦 安装包下载指南 (Assets)
请直接点击下方对应的文件下载(所有端版本号均已同步):
- 📱 服务端 (旧手机):
AndroidNAS-Server-v4.4.1.apk - 🖥️ 手机客户端 (主力机):
AndroidNAS-Client-v4.4.1.apk - 📺 TV 电视端:
AndroidNAS-TV-v4.4.1.apk - ⌚ 手表端:
AndroidNAS-Watch-v4.4.1.apk - 💻 Windows GUI:
AndroidNAS-Desktop-Windows-v4.4.1.exe - 🐧 Linux GUI:
AndroidNAS-Desktop-Linux-v4.4.1 - ⌨️ Windows CLI:
nas-cli-windows-v4.4.1.exe - ⌨️ Linux CLI:
nas-cli-linux-v4.4.1 - 🌐 浏览器插件 / 微信小程序:
.zip压缩包
(注:苹果与鸿蒙端需使用开发者工具自行编译签名。)
⚠️ 安全与高危警告
- 全盘模式与远控的危险性:开启 Web Shell、H264 远控或 Root 免死保活时,应用将拥有极高的系统权限。请绝对不要在公共 WiFi 下暴露远控端口。
- 保活模块冲突:若刷入了 Magisk 特权模块,可能会导致系统安装器提示“应用未卸载”。请进入 Magisk 临时关闭模块并重启后,使用
pm uninstall强删。 - 明文传输:局域网传输默认明文 HTTP。公网访问请务必自建 SSH 穿透进行加密。
Enjoy your personal cloud! 如果觉得项目对你有帮助,欢迎点一个 ⭐ Star!
v4.4.0
👑 Android NAS v4.4.0 正式发布!
十端生态矩阵:全平台私有云控制中枢
🚀 核心更新亮点
🛡️ 终极安全大满贯、媒体视界与全端底座重构
这是一个将 NAS 安全防线提升至企业级标准,并全面补齐全端多媒体视觉体验的重磅版本。彻底解决了上一版遗留的并发越权、WebSocket 裸奔与沙箱逃逸隐患,同时实装了原生 HTTPS、防爆破与终极自毁机制。
Added (🛡️ 顶级安全底座与自毁机制)
- 密码加盐哈希与防爆破:彻底废弃明文存储,采用 SHA-256 + 随机盐;新增 Fail2Ban 防暴力破解,连续输错 5 次自动封禁 IP 15 分钟。
- IP 白名单与安全审计:支持通配符(如
192.168.1.*)访问控制;新增持久化安全审计日志,记录异常登录与敏感操作。 - 紧急安全码与自毁模式:敏感操作(修改设置、执行 Shell)需二次验证 PIN 码;网页与手机端均支持终极自毁(Panic Wipe),支持系统级锁屏验证。
- 原生 HTTPS / WSS:服务端动态生成自签证书,Web 端与 WebSocket 远控均支持加密传输,老旧设备自动平滑降级。
Added (多媒体视界与 Web 体验)
- 免 Key 真实影视刮削:新增
MediaScraper引擎,基于纯正则解析文件名,自动请求开源 API 获取真实电影海报、评分与简介。 - 全端影视墙与相册:TV 端与手机客户端新增影视墙与时光相册,完美适配遥控器焦点动画与网格瀑布流。
- PWA (渐进式 Web 应用) 支持:注入
manifest.json与Service Worker,支持“添加到主屏幕”,全屏无地址栏运行。
Added (传输与通知中枢)
- 大文件断点续传与秒传:实装 MD5 秒传校验与 2MB 分片流式合并,全端(Web/桌面/手机/CLI)支持网络波动下的大文件稳定上传。
- Webhook 事件推送:支持配置 Telegram/企业微信 Webhook,实现文件上传、异常登录等事件的实时推送。
- 自动化清理与备份:服务端定时清理超 24 小时的临时分片;在线编辑自动生成带时间戳的
.bak历史备份。
Changed (架构与底层重构)
- ThreadLocal 并发隔离:彻底废弃全局静态用户变量,在 HTTP/WebDAV/FTP 请求中通过
ThreadLocal隔离身份,并在finally清理,杜绝高并发越权。 - 应用包名迁移:全端包名统一迁移至
com.androidnas.all.*。 - CI/CD 双轨制签名:日常构建触发
assembleDebug(带.debug后缀);全量发版触发assembleRelease并注入正式签名。
Fixed (🚨 核心漏洞与致命 Bug 修复)
- WebSocket 鉴权与注入:修复远控无鉴权漏洞,强制使用 Token 鉴权且仅限 Admin;触控坐标强制类型转换,杜绝 Shell 注入。
- 沙箱逃逸与越权:修复了
new File(ROOT, "/xxx")导致的父目录忽略缺陷;彻底修复 FTP/WebDAV 鉴权拦截,普通用户无法逃逸;分享链接绑定 Owner 并支持过期。 - 秒传跨用户投毒:为秒传哈希增加用户路径匹配,杜绝 A 用户命中 B 用户文件导致的假秒传。
- 流处理与句柄泄漏:移除分片上传错误的
parseBody;重写 Range 视频拖拽,引入LimitedInputStream解决高并发句柄泄漏。 - 前端鉴权死循环:废弃
btoaUnicode 崩溃逻辑,修复 401 无限弹窗;媒体预览改用短效 Share Token 绕过原生标签 401。 - CI/CD 编译与 Lint:解决
targetSdkVersion 22的lintVitalRelease拦截;修复 NanoHTTPD 状态码错误。
📦 安装包下载指南 (Assets)
请直接点击下方对应的文件下载(所有端版本号均已同步):
- 📱 服务端 (旧手机):
- 🖥️ 手机客户端 (主力机):
- 📺 TV 电视端:
- ⌚ 手表端:
- 💻 Windows GUI:
- 🐧 Linux GUI:
- ⌨️ Windows CLI:
- ⌨️ Linux CLI:
- 🌐 浏览器插件 / 微信小程序: 压缩包
(注:苹果与鸿蒙端需使用开发者工具自行编译签名。)
⚠️ 安全与高危警告
- 全盘模式与远控的危险性:开启 Web Shell、H264 远控或 Root 免死保活时,应用将拥有极高的系统权限。请绝对不要在公共 WiFi 下暴露远控端口。
- 保活模块冲突:若刷入了 Magisk 特权模块,可能会导致系统安装器提示“应用未卸载”。请进入 Magisk 临时关闭模块并重启后,使用 强删。
- 明文传输:局域网传输默认明文 HTTP。公网访问请务必自建 SSH 穿透进行加密。
Enjoy your personal cloud! 如果觉得项目对你有帮助,欢迎点一个 ⭐ Star!
v4.3.0
👑 Android NAS v4.3.0 正式发布!
十端生态矩阵:全平台私有云控制中枢
🚀 核心更新亮点
🛡️ 史诗级安全重构:多用户沙箱筑底与全端鉴权闭环
这是一个极其硬核的底层安全重构版本。在彻底完成了十端生态覆盖后,我们将重心转向了系统级安全与并发架构。本版本彻底解决了上一版遗留的全局变量越权、WebSocket 裸奔、沙箱逃逸等致命隐患,将 NAS 的安全防线提升到了企业级标准。
Fixed (🚨 核心安全架构重构与致命 Bug 排雷)
- 彻底解决并发越权漏洞 (ThreadLocal 隔离):重构
AuthManager,彻底废弃全局静态变量,引入ThreadLocal存储当前请求用户身份。在 HTTP、WebDAV、FTP 请求的finally块中强制清理,杜绝了高并发下 A 用户的请求串到 B 用户沙箱,或因线程复用导致身份残留的漏洞。 - 修复 WebSocket 远控未授权与命令注入:WebSocket 8082 端口不再接受无鉴权连接。前端通过
ws://ip:8082/?token=xxx传递凭据,后端严格URLDecoder解码,且仅限Admin角色接入。触控坐标强制转换Float并限制范围,彻底杜绝su -c input tap的 Shell 注入风险。 - 彻底修复多用户沙箱逃逸漏洞:
- 修复了
new File(ROOT, "/Users/guest")这种因为绝对路径导致父目录被忽略的致命缺陷。底层强制剥离root_dir的前导斜杠。 - 修复了 FTP/WebDAV 鉴权拦截逻辑,普通用户再也无法通过
CWD ..退出其专属目录。 - 修复了
/api/share匿名越权问题,分享访问现在会绑定 Token 的所有者(Owner)身份进行沙箱路径解析,并加入了 24 小时强制过期校验。
- 修复了
- 修复秒传跨用户投毒:为
file_hashes增加用户路径匹配校验(LIKE '/Users/xxx/%'),杜绝了 A 用户通过相同 MD5 命中 B 用户文件,导致“假秒传”数据丢失的问题。同名分片临时文件带入了 Hash 后缀,防止并发覆盖损坏。 - 修复流处理吞流与句柄泄漏:移除分片上传接口中错误的
parseBody调用,避免二进制流被拦截消费;重写 Range 视频拖拽播放逻辑,引入LimitedInputStream,彻底解决RandomAccessFile导致的高并发句柄泄漏与视频越界崩溃。 - 补全极高危 API 权限校验:为
/api/settings(POST)、/api/users、/api/password、/api/shell等关键接口补齐了严格的role == 1(Admin) 校验,并实现了真实的密码修改逻辑;修复了全盘模式下删除/sdcard等系统关键目录的风险。 - 前端 401 鉴权死循环修复:废弃了前端使用
btoa导致 Unicode 崩溃的旧逻辑,修复了密码错误时无限递归弹窗的Promise死锁。 - 前端媒体 401 拦截修复:重写了前端
<img>/<video>预览与下载逻辑,改用短效 Share Token 进行鉴权验证,解决了原生标签无法携带 Header 导致的预览黑屏问题。 - CI/CD 编译错误修复:解决了
targetSdkVersion 22触发lintVitalRelease导致编译中断;修复了签名注入正则错误导致的Could not find method signingConfig()崩溃;替换了 NanoHTTPD 不存在的高危状态码,确保 10 端 CI 矩阵顺利产出。
📦 安装包下载指南 (Assets)
请直接点击下方对应的文件下载(所有端版本号均已同步):
- 📱 服务端 (旧手机):
- 🖥️ 手机客户端 (主力机):
- 📺 TV 电视端:
- ⌚ 手表端:
- 💻 Windows GUI:
- 🐧 Linux GUI:
- ⌨️ Windows CLI:
- ⌨️ Linux CLI:
- 🌐 浏览器插件 / 微信小程序: 压缩包
(注:苹果与鸿蒙端需使用开发者工具自行编译签名。)
⚠️ 安全与高危警告
- 全盘模式与远控的危险性:开启 Web Shell、H264 远控或 Root 免死保活时,应用将拥有极高的系统权限。请绝对不要在公共 WiFi 下暴露远控端口。
- 保活模块冲突:若刷入了 Magisk 特权模块,可能会导致系统安装器提示“应用未卸载”。请进入 Magisk 临时关闭模块并重启后,使用 强删。
- 明文传输:局域网传输默认明文 HTTP。公网访问请务必自建 SSH 穿透进行加密。
Enjoy your personal cloud! 如果觉得项目对你有帮助,欢迎点一个 ⭐ Star!
v4.2.0
👑 Android NAS v4.2.0 正式发布!
十端生态矩阵:全平台私有云控制中枢
🚀 核心更新亮点
🚀 生态大满贯:真实影视刮削、PWA 进化与 TB 级传输底座
这是一个补齐私有云核心拼图的重磅版本。我们彻底告别了 Mock 演示,引入了免 Key 的真实影视元数据刮削;打通了 PWA,让 Web 端拥有原生级全屏体验;并实装了底层 MD5 秒传与分片断点续传,完美解决大文件传输痛点。
Added (多媒体视界与 Web 体验)
- 免 Key 真实影视刮削:新增
MediaScraper.java引擎。基于纯 Java 正则解析文件名(如Inception.2010),自动请求第三方开源 API 获取真实的电影海报、评分与简介,彻底告别枯燥的文件夹列表。 - PWA (渐进式 Web 应用) 支持:为网页端注入了
manifest.json与Service Worker。在手机浏览器中访问可“添加到主屏幕”,全屏无地址栏运行,体验媲美原生 App。 - 大文件断点续传与秒传 (正式实装):
- 秒传校验:前端引入
SparkMD5计算特征码,请求/api/upload/check,若服务端已有该 Hash 文件直接 0 秒完成。 - 分片续传:前端基于
File.slice()将大文件切为 2MB 块,服务端按序追加写入.tmp文件,并在最后一片到达时自动合并。
- 秒传校验:前端引入
Added (自动化与通知中枢)
- Webhook 事件推送:新增
WebhookManager.java。支持配置文件上传、异常事件等自动向 Telegram、企业微信群机器人 发送实时通知,NAS 动态尽在掌握。
Changed (架构与底层重构)
- 应用包名 (ApplicationId) 统一迁移:为满足多版本共存与更清晰的生态隔离,服务端、客户端、TV、手表端包名统一迁移至
com.androidnas.all.*。 - 双轨制 CI 签名机制重构:
- 日常调试:独立构建触发
assembleDebug,包名自动追加.debug后缀,确保测试包与正式包不冲突。 - 全量发版:
build-all触发assembleRelease,通过 GitHub Secrets 注入正式 keystore 进行安全签名。
- 日常调试:独立构建触发
Fixed (核心 Bug 修复)
- Lint 致命拦截修复:彻底解决
targetSdkVersion 22在assembleRelease时触发lintVitalRelease报错导致编译中断的问题,在build.gradle中全局关闭了阻塞式 Lint 检查。 - 签名注入正则错误修复:修复了旧版脚本因正则匹配不准,导致
signingConfig被错误嵌套注入到signingConfigs内部,从而引发的Could not find method signingConfig()构建崩溃。 - PWA 静态资源路由修复:在
NasHttpServer中补全了对/manifest.json与/sw.js的拦截路由,防止前端 404。
📦 安装包下载指南 (Assets)
请直接点击下方对应的文件下载(所有端版本号均已同步):
- 📱 服务端 (旧手机):
- 🖥️ 手机客户端 (主力机):
- 📺 TV 电视端:
- ⌚ 手表端:
- 💻 Windows GUI:
- 🐧 Linux GUI:
- ⌨️ Windows CLI:
- ⌨️ Linux CLI:
- 🌐 浏览器插件 / 微信小程序: 压缩包
(注:苹果与鸿蒙端需使用开发者工具自行编译签名。)
⚠️ 安全与高危警告
- 全盘模式与远控的危险性:开启 Web Shell、H264 远控或 Root 免死保活时,应用将拥有极高的系统权限。请绝对不要在公共 WiFi 下暴露远控端口。
- 保活模块冲突:若刷入了 Magisk 特权模块,可能会导致系统安装器提示“应用未卸载”。请进入 Magisk 临时关闭模块并重启后,使用 强删。
- 明文传输:局域网传输默认明文 HTTP。公网访问请务必自建 SSH 穿透进行加密。
Enjoy your personal cloud! 如果觉得项目对你有帮助,欢迎点一个 ⭐ Star!
v4.1.1
👑 Android NAS v4.1.1 正式发布!
十端生态矩阵:全平台私有云控制中枢
🚀 核心更新亮点
🔥 紧急修复:前端崩溃与接口兼容
这是一个针对 v4.1.0 发布后发现的严重问题进行紧急修复的补丁版本。
Fixed
- 网页端全局假死修复:彻底移除了网页端注入的 ES6 模板字符串与 Lambda 箭头函数。解决了因部分老旧浏览器/WebView 不支持新语法而引发的
SyntaxError崩溃,恢复了文件列表、删除、重命名等所有核心功能。 - 客户端预览失败修复:重构了服务端
/api/share接口与handleSecureShare处理逻辑,增加空值容错。解决了旧版安卓客户端在未携带提取码和过期时间参数时,因解析异常导致的预览黑屏与分享失败。 - CI 发版文案变量解析修复:修复了 GitHub Actions 中生成 Release Notes 时
cat << 'EOF'屏蔽变量展开的问题,确保发版说明中的${VERSION}被正确替换。
📦 安装包下载指南 (Assets)
请直接点击下方对应的文件下载(所有端版本号均已同步):
- 📱 服务端 (旧手机):
- 🖥️ 手机客户端 (主力机):
- 📺 TV 电视端:
- ⌚ 手表端:
- 💻 Windows GUI:
- 🐧 Linux GUI:
- ⌨️ Windows CLI:
- ⌨️ Linux CLI:
- 🌐 浏览器插件 / 微信小程序: 压缩包
(注:苹果与鸿蒙端需使用开发者工具自行编译签名。)
⚠️ 安全与高危警告
- 全盘模式与远控的危险性:开启 Web Shell、H264 远控或 Root 免死保活时,应用将拥有极高的系统权限。请绝对不要在公共 WiFi 下暴露远控端口。
- 保活模块冲突:若刷入了 Magisk 特权模块,可能会导致系统安装器提示“应用未卸载”。请进入 Magisk 临时关闭模块并重启后,使用 强删。
- 明文传输:局域网传输默认明文 HTTP。公网访问请务必自建 SSH 穿透进行加密。
Enjoy your personal cloud! 如果觉得项目对你有帮助,欢迎点一个 ⭐ Star!
v4.1.0
👑 Android NAS v4.1.0 正式发布!
十端生态矩阵:全平台私有云控制中枢
🚀 核心更新亮点
家庭私有云蜕变:多用户隔离与多媒体视界
这是一个从“极客单机玩具”向“家庭级私有云”演进的关键版本。我们在保持底层极致轻量与多端兼容的前提下,引入了数据库引擎,重构了媒体视觉体验,并大幅增强了文件流转能力。
Added (核心底座与多用户隔离)
- SQLite 多用户体系:服务端底层引入
DatabaseManager,自动生成nas_core.db。支持多用户注册与鉴权,系统默认内置admin(全盘上帝视角)与guest(仅限 Public 目录)。普通用户的物理路径被严格锁定在专属沙箱内,实现真正的权限隔离。 - 硬件监控面板:Web 端新增硬件仪表盘。实时展示服务端的 CPU 占用、内存消耗、存储空间与电池电量(内置 API 8 版本守卫,老旧设备自动降级显示)。
- 安全分享机制升级:生成免密外链时,支持自定义提取码与有效期(如 1 天),避免分享链接被公开滥用。
Added (Web 多媒体视界与工具)
- 时光相册 (时间轴):利用服务端新增的缩略图引擎,网页端新增瀑布流相册。按拍摄时间倒序展示,海量图片秒级加载。
- 影视海报墙:内置媒体刮削引擎(Mock 版),自动解析视频文件名并匹配海报,告别枯燥的文件夹列表。
- 流式打包下载:Web 端支持多选文件,服务端实时压缩成 ZIP 流推送给前端,不占用手机临时存储空间。
- 用户管理控制台:在网页端新增可视化面板,可直接查看现有用户,并动态创建新账号。
Added (传输与网络)
- 断点续传与秒传 (底座预留):底层新增 MD5 秒传校验接口与分片合并接口,为 TB 级大文件传输铺平道路。
Changed (架构与安全)
- 优雅的版本兼容:全面检查并重写了涉及高版本 API 的代码(如
BatteryManager),通过Build.VERSION.SDK_INT进行严格包裹,确保在极限的minSdkVersion 8(Android 2.2) 下依然稳如磐石。 - 权限拦截器重构:
NasHttpServer.safeFile()方法重写,从数据库动态读取用户根目录并注入路径校验,彻底封死越权访问。
Fixed
- 编译链兼容性:彻底移除导致老版本 AGP (4.2.2) 编译失败的 Java 8 Lambda 表达式,全面降级为传统的
Comparator匿名内部类,确保 CI 矩阵绿灯常亮。 - UI 遮挡修复:解决了 Web 端部分弹窗在极小屏幕下溢出的问题。
📦 安装包下载指南 (Assets)
请直接点击下方对应的文件下载(所有端版本号均已同步):
- 📱 服务端 (旧手机):
android-nas-server-v4.1.0.apk - 🖥️ 手机客户端 (主力机):
android-nas-client-v4.1.0.apk - 📺 TV 电视端:
android-nas-tv-v4.1.0.apk - ⌚ 手表端:
android-nas-watch-v4.1.0.apk - 💻 Windows GUI:
nas-client-windows-v4.1.0.exe - 🐧 Linux GUI:
nas-client-linux-v4.1.0 - ⌨️ Windows CLI:
nas-cli-windows-v4.1.0.exe - ⌨️ Linux CLI:
nas-cli-linux-v4.1.0 - 🌐 浏览器插件 / 微信小程序:
.zip压缩包
(注:苹果与鸿蒙端需使用开发者工具自行编译签名。)
⚠️ 安全与高危警告
- 全盘模式与远控的危险性:开启 Web Shell、H264 远控或 Root 免死保活时,应用将拥有极高的系统权限。请绝对不要在公共 WiFi 下暴露远控端口。
- 保活模块冲突:若刷入了 Magisk 特权模块,可能会导致系统安装器提示“应用未卸载”。请进入 Magisk 临时关闭模块并重启后,使用
pm uninstall强删。 - 明文传输:局域网传输默认明文 HTTP。公网访问请务必自建 SSH 穿透进行加密。
Enjoy your personal cloud! 如果觉得项目对你有帮助,欢迎点一个 ⭐ Star!
v4.0.0
👑 Android NAS v4.0.0 正式发布!
史诗级生态闭环:十端大满贯与多模态云端控制
这是一个具有极其重要里程碑意义的版本。我们在保持底层极致轻量与极限兼容的前提下,实现了史无前例的“十端全覆盖”。不仅如此,我们将触角伸向了 Android 系统的底层控制,成功将 NAS 演变成了一个真正的“云端手机控制台”。
🚀 核心更新亮点
-
多模态远程控制中心 (全新模块)
- 引入 H264 硬件级 30fps 画面推流,结合前端
JMuxer.js实现毫秒级低延迟。鼠标点哪,手机点哪。 - 独创 Root 截图流降级方案:无需录屏授权,直接通过 Root 极速刷新画面。
- 双引擎触控注入:未 Root 走无障碍服务,已 Root 走底层
input注入,完美兼容所有设备。
- 引入 H264 硬件级 30fps 画面推流,结合前端
-
十端独占功能全面对齐
- 手机端:内嵌全屏 WebView 远控面板,新增系统分享外链。
- 桌面端:新增全局实时搜索、剪贴板同步、一键复制分享外链。
- 小程序 / 苹果 / 鸿蒙:全面补齐搜索、剪贴板与免密分享。
-
.NET 10 双核架构开启
- 孵化全新 android-nas-dotnet 分支,彻底解耦 C/S 架构,拥抱现代存储权限模型与跨平台原生 GUI。
-
自动化发版革命
- 彻底废除“打包大 ZIP”的反人类设计,所有产物直接平铺展示在下方 Assets 列表中。
- 引入高容错机制,单端编译失败不再阻断其他 9 个端的发布。
📦 安装包下载指南 (Assets)
请直接点击下方对应的文件下载(所有端版本号均已同步):
- 📱 服务端 (装在旧手机):
AndroidNAS-Server-v4.0.0.apk - 🖥️ 手机客户端 (装在主力机):
AndroidNAS-Client-v4.0.0.apk - 📺 TV 电视端:
AndroidNAS-TV-v4.0.0.apk - ⌚ 手表端:
AndroidNAS-Watch-v4.0.0.apk - 💻 Windows GUI:
AndroidNAS-Desktop-Windows-v4.0.0.exe - 🐧 Linux GUI:
AndroidNAS-Desktop-Linux-v4.0.0 - ⌨️ Windows CLI:
AndroidNAS-CLI-Windows-v4.0.0.exe - ⌨️ Linux CLI:
AndroidNAS-CLI-Linux-v4.0.0 - 🌐 浏览器插件 / 微信小程序:
.zip压缩包
(注:苹果与鸿蒙端需使用开发者工具自行编译签名。)
⚠️ 安全与高危警告
- 全盘模式与远控的危险性:开启 Web Shell、H264 远控或 Root 免死保活时,应用将拥有极高的系统权限。请绝对不要在公共 WiFi 下暴露远控端口。
- 保活模块冲突:若刷入了 Magisk 特权模块,可能会导致系统安装器提示“应用未卸载”。请进入 Magisk 临时关闭模块并重启后,使用
pm uninstall强删。 - 明文传输:局域网传输默认明文 HTTP。公网访问请务必自建 SSH 穿透进行加密。
Enjoy your personal cloud! 如果觉得项目对你有帮助,欢迎点一个 ⭐ Star!
v3.3.0
🚀 Android NAS v3.3.0 正式发布!
极客帝国:七端齐聚,打破边界与全盘掌控
这是一个极其硬核的版本。我们不仅补全了缺失的所有核心功能,还将触角伸向了底层系统。现在,它不仅是一个 NAS,更是一个可以通过 Web、甚至 CLI 直接控制的 Root 级服务器。
🌟 核心亮点
- 七端全覆盖:服务端、手机端、TV、手表、Windows/Linux 桌面 GUI、极客 CLI,只需一个压缩包全部带走。
- 全盘 Root 模式:支持一键突破 Android 沙盒限制,直接浏览并操作
/data、/system等底层目录。 - Web Shell 控制台:网页端直接呼出终端,执行
su级 Root 命令(自带rm -rf /防误触拦截)。 - 无敌保活矩阵:静音音频欺骗、双进程守护、AlarmManager 心跳,以及 Root OOM 免死注入(
oom_score_adj=-1000)。
📦 包含的构建产物 (v3.3.0)
android-nas-server-v3.3.0.apk(服务端,最低兼容 Android 2.2)android-nas-client-v3.3.0.apk(手机端,最低兼容 Android 5.0)android-nas-tv-v3.3.0.apk(电视端,最低兼容 Android 4.4)android-nas-watch-v3.3.0.apk(手表端,最低兼容 Android 5.0)nas-client-windows-v3.3.0.exe(Windows 桌面端)nas-client-linux-v3.3.0(Linux 桌面端)nas-cli-windows-v3.3.0.exe(Windows 命令行端)nas-cli-linux-v3.3.0(Linux 命令行端)
⚡ 各端更新详情
- Web 网页端:MD3 革命性重写,操作全部收纳进底部弹出面板。新增 401 拦截,告别白屏。支持在线修改密码、端口。
- 手机客户端:接入相册自动增量备份;支持局域网一键扫描;补齐批量下载、一键投屏功能。
- TV / 手表端:全面弃用旧版列表,改用 Leanback/RecyclerView 卡片流,加入 1.1 倍放大动画与按压反馈。
- 桌面端:抛弃臃肿的 Webview,改用纯原生 Tkinter 扁平化 UI,支持多选并发上传。
- CLI 端:新增交互式极客终端,支持 Tab 补全、在线文本编辑与免密分享。
⚠️ 安全提示:开启 Root 全盘模式与 Web Shell 拥有极高的系统权限,请在可信的局域网内使用,并务必修改默认的admin/admin密码。
Enjoy your private cloud!