一个真正的三端全栈博客系统
集成 极致体验的博客端 + 移动优先的管理端 + 高性能后端 API
不同于传统的静态博客，本项目提供完整的动态管理方案，且实现了前台与后台的双重移动端适配。
 |
 |
 |
 |
 |
 |
 |
本项目由三个独立的模块组成，实现了完美的动静分离与逻辑解耦：
- 博客前端 (Astro 5)：极致的性能与 SEO，带来如丝般顺滑的阅读感。
- 管理后台 (Vue 3)：基于 Naive UI 开发的现代化内容管理控制中心。
- 后端 API (FastAPI)：异步高性能后端，支持 RESTful API。
大多数开源项目只做前台适配，我们走得更远：
- 前台适配：流式布局与侧边栏折叠，提供完美的沉浸式阅读。
- 后台适配：管理端采用卡片式重构与手势优化，让你在手机浏览器上也能轻松写博、管理友链、监控动态。
- 实时管理：无需重新构建或推送 Git，修改后台数据，前台瞬间同步更新。
- 友链/资源动态分发：集成的资源管理中心，支持实时分类搜索与折叠展示。
- 现代美学：采用玻璃拟态 (Glassmorphism) 风格，极致的视觉舒适度。
- 深色模式：支持全站深色/浅色模式无缝切换。
- Live2D 看板娘：支持多种动作交互，让博客更有灵气。
- 内置音乐播放器：可在阅读时享受动听旋律。
- 视觉特效：樱花飘落、全屏壁纸组件、Swup 页面过渡。
- 自动化图片/字体压缩：节省 90% 以上的资源体积，秒开体验。
- 本地搜索：集成 Pagefind，在毫秒级内完成全站搜索。
| 领域 | 技术方案 |
|---|---|
| 前端框架 | Astro + Svelte |
| 管理后台 | Vue 3 + Naive UI |
| 后端 API | FastAPI + SQLAlchemy |
| 样式处理 | TailwindCSS |
| 数据库 | SQLite |
| 动画效果 | Swup + PixiJS |
如果你想在本地进行二次开发或调试：
git clone https://github.com/AVIDS2/my_blog.git
cd my_blogcd server
# 建议创建虚拟环境
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
# 启动
python main.pycd client
pnpm install
pnpm devcd server/admin
npm install
npm run dev推荐使用 Docker Compose 进行一键部署，只需运行：
# 1. 复制配置环境
cp .env.example .env
# 2. 编辑 .env 文件
# 设置你的 SECRET_KEY 和 ADMIN_PASSWORD
# 3. 启动
docker-compose up -d --build详细的手动部署步骤与网络配置，请参阅 DEPLOY.md。
管理后台支持打包为 Android APK，方便在手机上管理博客。
- Android Studio
- Android SDK 35+
# 1. 进入管理后台目录
cd server/admin
# 2. 构建前端
npm run build
# 3. 同步到 Android 项目
npx cap sync android
# 4. 用 Android Studio 打开
npx cap open android在 Android Studio 中，点击 Build → Build APK(s) 即可生成 APK 文件。
生成的 APK 位于：server/admin/android/app/build/outputs/apk/debug/app-debug.apk
注意：APK 采用远程模式，会直接访问服务器上的管理后台。修改代码后需要推送到服务器并重新构建 Docker，APK 刷新即可看到更新。
.
├── client/ # 博客前端 (Astro项目)
├── server/
│ ├── app/ # 后端 API (FastAPI)
│ ├── admin/ # 管理后台 (Vue 3项目)
│ └── scripts/ # 数据管理与修复脚本
├── data/ # [持久化] 数据库文件
├── uploads/ # [持久化] 用户上传的图片
├── Dockerfile # 多阶段构建文件
└── docker-compose.yml # 容器编排配置
本项目基于 MIT License 开源。你可以自由地使用、修改和分发。