🌸 Astris Blog

一个真正的三端全栈博客系统
集成 极致体验的博客端 + 移动优先的管理端 + 高性能后端 API

不同于传统的静态博客，本项目提供完整的动态管理方案，且实现了前台与后台的双重移动端适配。

🖥️ 演示站点 • 📖 部署文档

📸 预览 (Preview)

🖥️ 博客前台 (User Side)

⚙️ 管理后台 & 移动端 (Admin & Mobile)

💎 项目核心优势

🛡️ 三端全栈架构 (3-Part Architecture)

本项目由三个独立的模块组成，实现了完美的动静分离与逻辑解耦：

1. **博客前端 (Astro 5)**：极致的性能与 SEO，带来如丝般顺滑的阅读感。
2. **管理后台 (Vue 3)**：基于 Naive UI 开发的现代化内容管理控制中心。
3. **后端 API (FastAPI)**：异步高性能后端，支持 RESTful API。

📱 真正的双重移动端适配 (Dual Mobile Mastery)

大多数开源项目只做前台适配，我们走得更远：

• 前台适配：流式布局与侧边栏折叠，提供完美的沉浸式阅读。
• 后台适配：管理端采用卡片式重构与手势优化，让你在手机浏览器上也能轻松写博、管理友链、监控动态。

⚙️ 动态内容引擎

• 实时管理：无需重新构建或推送 Git，修改后台数据，前台瞬间同步更新。
• 友链/资源动态分发：集成的资源管理中心，支持实时分类搜索与折叠展示。

✨ 特性亮点

🎨 极致设计

• 现代美学：采用玻璃拟态 (Glassmorphism) 风格，极致的视觉舒适度。
• 深色模式：支持全站深色/浅色模式无缝切换。

🎭 趣味交互

• Live2D 看板娘：支持多种动作交互，让博客更有灵气。
• 内置音乐播放器：可在阅读时享受动听旋律。
• 视觉特效：樱花飘落、全屏壁纸组件、Swup 页面过渡。

🚀 极致性能

• 自动化图片/字体压缩：节省 90% 以上的资源体积，秒开体验。
• 本地搜索：集成 Pagefind，在毫秒级内完成全站搜索。

🛠️ 技术栈

🚀 快速开始

开发环境配置

如果你想在本地进行二次开发或调试：

1. 克隆项目

git clone https://github.com/AVIDS2/my_blog.git
cd my_blog

2. 后端服务 (FastAPI)

cd server
# 建议创建虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
# 启动
python main.py

3. 博客前端 (Astro)

cd client
pnpm install
pnpm dev

4. 管理后台 (Vue)

cd 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 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 开源。你可以自由地使用、修改和分发。