返回产品列表
☁️
开发中 v1.0.0-SNAPSHOT Apache-2.0

悠悠爸家庭云盘

家庭局域网私有云 · 手机备份 · Web 管理 · 数据留在家里

核心痛点

家庭数据存储的真实困扰

📱

手机照片怕丢

宝宝成长照、旅行视频都在手机里,换机或误删后难以找回。

☁️

公有云不放心

家庭照片视频不想上传到第三方网盘,隐私和容量都是问题。

👨‍👩‍👧

家人共享麻烦

想让孩子、老人也能看家里的照片视频,却缺少简单易用的家庭共享方式。

核心功能

三端分工,各司其职

启动器管服务、Web 做管理、Android 负责手机备份与浏览,数据全部存在你家自己的硬盘上。

🖥️

PC 启动器

JavaFX 桌面程序,在家里的电脑上启停服务、配置存储目录与灾备目录、创建家庭账号。

  • • 系统托盘常驻,关窗不退出
  • • 内嵌 Spring Boot Web 服务
  • • 默认端口 8080
🌐

Web 管理端

Vue 3 + Element Plus 响应式界面,浏览器即可管理网盘、浏览媒体、分享家庭内容。

  • • 网盘文件上传与管理
  • • 我的 / 家庭 / 我分享
  • • 管理员用户管理
📱

Android 客户端

手机伴侣 App,局域网自动发现云盘,一键备份相册照片和视频,与家人互相浏览分享。

  • • 立即同步 / 后台自动同步
  • • 分片断点续传 + 智能去重
  • • 云端下载写入系统相册
🚄

局域网极速传输

走家庭内网不走公网,千兆局域网下大文件传输更快;支持大文件分片上传与断点续传。

🔐

数据完全自主

文件存储在你自己指定的硬盘目录,可选灾备目录双重保护;SQLite 本地记录元数据,无第三方云端。

👨‍👩‍👧

家庭分享

先同步到云端再分享给家庭成员;对方在「家庭」Tab 直接浏览、预览、下载,适合长辈查看宝宝照片。

🗑️

回收站

删除文件移入云端回收站,保留期内可恢复;删除云端不会删除手机本地原图,尊重你对本机文件的掌控。

架构说明

项目结构与技术选型

仓库结构

yyba_cloud/ ├── yyba_cloud_server/ # 服务端 │ ├── server-core/ # Spring Boot API │ ├── server-launcher/ # JavaFX 桌面启动器 │ └── server-web/ # Vue 3 + Element Plus 管理界面 └── yyba_cloud_android/ # Android 客户端
服务端 API
Spring Boot 3 + SQLite

JWT 认证、文件管理、分片上传、媒体分享、回收站、灾备同步。

Web 前端
Vue 3 + Element Plus

网盘浏览、媒体画廊、用户管理、首次引导配置。

Android 端
Java · minSdk 26

MediaStore 扫描、Room 去重、WorkManager 后台同步。

存储目录规则

{存储根目录}/ {用户名}/ photos/2026/06/xxx.jpg videos/2026/06/xxx.mp4 uploads/ .chunks/ # 上传临时分片 .trash/ # 回收站

数据库文件:{用户目录}/.yyba_cloud/yyba_cloud.db

快速开始

部署与使用

1

构建服务端

需要 JDK 17+、Maven 3.8+、Node.js 18+。

# 构建 Web 前端 cd yyba_cloud_server/server-web npm install npm run build # 编译服务端 cd .. mvn clean package -DskipTests
2

启动 PC 启动器

Spring Boot 为主入口:先启动 Web 服务(默认 8080),再自动打开 JavaFX 管理界面。

cd yyba_cloud_server/server-launcher ..\mvnw.cmd spring-boot:run
3

初始化与 Web 登录

  1. 在启动器中配置主存储目录(必选)和灾备目录(可选),保存配置
  2. 在「账号注册」页创建管理员账号
  3. 浏览器访问 http://{局域网IP}:8080 登录管理云盘
  4. 管理员在 Web「用户管理」中添加家庭成员账号
4

安装 Android 客户端

  1. 用 Android Studio 打开 yyba_cloud_android 编译安装 APK
  2. 确保手机与云盘在同一 WiFi,App 会自动发现局域网内的服务器
  3. 登录后点击「立即同步」,备份相册照片和视频
  4. 可在设置中开启「仅 WiFi 同步」和「后台自动同步」
💡

端侧分工

Android 负责日常备份、浏览、分享、下载到手机;Web 负责网盘上传、家庭成员管理、系统配置;启动器 负责在家里的电脑上启停服务、首次开户。

API 概览

核心接口

接口 说明
POST /api/auth/login用户登录(JWT)
GET /api/files?path=文件列表
GET /api/files/download?path=下载文件
POST /api/upload/init初始化分片上传
PUT /api/upload/{id}/chunk/{n}上传分片
POST /api/upload/{id}/complete完成上传
规划

Roadmap

已落地

三端核心能力

PC 启动器 + Web 管理 + Android 备份;分片上传、家庭分享、回收站、灾备目录、系统托盘。

规划中

家庭影院

影音 Tab 与家庭媒体中心能力,与 Kodi 媒体库场景配合。

持续改进

体验优化

相册滑动体验、云端数据一致性、成员自助改密等。

把家庭数据留在家里

悠悠爸家庭云盘正在积极开发中,欢迎从源码构建体验