yoyuz/my_site

Fork 0

Files

yoyuzh 3afebbb338 chore(repo): consolidate local env and clean root files

2026-04-06 23:50:56 +08:00

6.0 KiB

Raw Permalink Blame History

yoyuzh.xyz

一个基于 React + Spring Boot 构建的个人站点项目，包含个人网盘、浏览器快传、账号系统与后台管理台。

项目简介

这个仓库是 yoyuzh.xyz 的完整源码。

它不是一个单页 Demo，而是一个持续迭代中的全栈个人网站，覆盖了前端门户、后端 API、文件存储、账号体系和管理功能。

功能特性

用户系统

用户注册与登录
邀请码注册
同账号支持桌面端与移动端同时在线
个人资料管理

网盘

文件上传、文件夹上传
下载、重命名、删除
文件与文件夹移动
文件与文件夹复制
树状目录浏览
分享链接生成与导入

快传

取件码分享
分享链接打开
浏览器间 P2P 传输
接收端可选择部分文件接收
支持整包 ZIP 下载
支持接收后直接存入网盘

管理台

用户管理
文件管理
注册邀请码查看

技术栈

前端

React 19
TypeScript
Vite 6
Tailwind CSS v4

后端

Java 17
Spring Boot 3.3
Spring Security
Spring Data JPA
Maven

存储与基础设施

MySQL 8.x
本地文件系统 / 多吉云 S3 兼容对象存储
S3 兼容静态资源发布

仓库结构

.
├── backend/      Spring Boot 后端
├── front/        React 前端
├── docs/         计划与文档
├── docs/agents/  agent 补充交接文档
├── scripts/      部署与辅助脚本
├── data/         本地数据或辅助文件
└── 模板/         页面参考模板

快速开始

环境要求

Node.js
npm
JDK 17+
Maven 3.9+
MySQL 8.x

1. 启动后端

先准备根目录环境变量：

cp .env.example .env

填好 APP_JWT_SECRET 后，在当前 shell 里加载：

set -a
source .env
set +a

cd backend
mvn spring-boot:run

如果要使用本地开发配置：

cd backend
mvn spring-boot:run -Dspring-boot.run.profiles=dev

说明：

默认端口：8080
Swagger：http://localhost:8080/swagger-ui.html
dev 环境默认使用 H2，更适合本地联调

2. 启动前端

cd front
npm run dev

说明：

默认端口：3000
本地前端代理配置位于 front/vite.config.ts

常用命令

前端

cd front
npm run dev
npm run build
npm run preview
npm run clean
npm run lint
npm run test

后端

cd backend
mvn spring-boot:run
mvn spring-boot:run -Dspring-boot.run.profiles=dev
mvn test
mvn package

环境变量

推荐把本地密钥和部署配置统一维护在仓库根目录 .env，模板在 .env.example。

后端必填

APP_JWT_SECRET=<至少32字节的密钥>

后端可选

APP_ADMIN_USERNAMES=admin1,admin2
APP_AUTH_REGISTRATION_INVITE_CODE=<初始化邀请码种子>

S3 相关

YOYUZH_STORAGE_PROVIDER=s3
YOYUZH_DOGECLOUD_API_BASE_URL=https://api.dogecloud.com
YOYUZH_DOGECLOUD_API_ACCESS_KEY=...
YOYUZH_DOGECLOUD_API_SECRET_KEY=...
YOYUZH_DOGECLOUD_STORAGE_SCOPE=yoyuzh-files
YOYUZH_DOGECLOUD_STORAGE_TTL_SECONDS=3600
YOYUZH_DOGECLOUD_S3_REGION=automatic

前端发布配置

前端发布脚本会优先从仓库根目录 .env 读取多吉云 API 凭据，再动态换取临时 S3 密钥；旧 .env.oss.local 只保留兼容回退读取。前端静态桶应填写逻辑桶名 yoyuzh-front，不要直接把底层 s3Bucket 写死到配置里。

常用变量：

YOYUZH_DOGECLOUD_API_ACCESS_KEY=...
YOYUZH_DOGECLOUD_API_SECRET_KEY=...
YOYUZH_DOGECLOUD_FRONT_SCOPE=yoyuzh-front
YOYUZH_DOGECLOUD_FRONT_TTL_SECONDS=3600
YOYUZH_DOGECLOUD_FRONT_PREFIX=
YOYUZH_DOGECLOUD_STORAGE_SCOPE=yoyuzh-files
YOYUZH_DOGECLOUD_ANDROID_SCOPE=yoyuzh-files
YOYUZH_ANDROID_RELEASE_PREFIX=android/releases

参考文件：

.env.example
.env

部署

前端发布

在仓库根目录执行：

node scripts/deploy-front-oss.mjs

可选参数：

node scripts/deploy-front-oss.mjs --dry-run
node scripts/deploy-front-oss.mjs --skip-build

Android APK 发包

在仓库根目录执行：

node scripts/deploy-android-apk.mjs

这个脚本会自动完成以下步骤：

cd front && npm run build
cd front && npx cap sync android
自动补回 Android 插件工程里的 Google Maven 镜像配置
cd front/android && ./gradlew assembleDebug
node scripts/deploy-front-oss.mjs --skip-build
node scripts/deploy-android-release.mjs

如果只想重新上传 APK，不想重发前端静态站，可以直接执行：

node scripts/deploy-android-release.mjs

阿里云 OSS 到多吉云 S3 迁移

静态站点桶或文件桶需要整桶迁移时，可在仓库根目录执行：

node scripts/migrate-aliyun-oss-to-s3.mjs \
  --source-bucket=<阿里云源 Bucket> \
  --source-access-key-id=<阿里云 AccessKeyId> \
  --source-access-key-secret=<阿里云 AccessKeySecret> \
  --target-scope=<多吉云逻辑桶名> \
  --target-api-access-key=<多吉云 AccessKey> \
  --target-api-secret-key=<多吉云 SecretKey>