分类：blogTech

本博客采用 Nuxt 3 + FastAPI + SQLite 全栈架构。本文从技术选型、构建配置到架构图完整解析每个决策背后的原因。

本博客前端毛玻璃（Glassmorphism）设计系统的完整说明，涵盖四个玻璃层级、交互体系、CSS 变量驱动架构以及后台可视化管理器。

本地调试被 CPU 告警邮件轰炸，站点被扫却一封通知都没有。我把散落的 6 个发信点收敛成统一闸门，补上环境静音与攻击告警，顺手修掉总开关失效、时间差 8 小时和邮件头注入。

后台文章分类拖拽排序功能突然返回405错误，代码明明有路由却报Method Not Allowed，最终发现是Python字节码缓存导致旧代码被加载的坑

记录 7 个典型踩坑案例：bcrypt 版本兼容、Node.js 版本要求、自引用 cascade、相对导入、Hydration 不匹配、Windows 路径、npm 平台绑定。附通用经验总结。

发现 backdrop-filter 样式(玻璃效果的实现核心)因元素过高被浏览器禁用，通过动态检测高度并递归分割内容，确保每块低于阈值以优化视觉效果

韩国服务器 + Nginx 反代 + Let's Encrypt + systemd 服务管理。本文详解从安全组配置到一键部署脚本的完整流程。

我的网站服务器上 Nginx 配置了四个 server 块，其中两个同时服务于博客，搜索引擎看到的是两个内容完全相同的网站，导致 SEO 权重被分散。

网站从 `blog.vue2.xyz` 统一迁移到 `vue2.xyz` 做主域名，百度搜索资源平台也需要跟着迁移，并实现自动化推送新文章入口。

详细的技术架构文档：系统设计、请求流程、数据库表结构、API 接口、前端页面路由、样式体系、目录结构。

个人博客 blog.vue2.xyz 的系统级安全升级记录——密码哈希从 SHA256 升级到 bcrypt、统一 JWT 认证、XSS 消毒、路径穿越防护等全链路加固实践。

基于导航方向差异化页面过渡动画的设计思路和技术实现。从导航栏数字顺序推导前进/后退/相同页面三种滑入/滑出行为，附避坑记录和手感调优参数。

基于 SQLite + SQLAlchemy 的博客系统数据库设计实践，涵盖 ER 设计、ORM 技巧、分页查询、级联策略和踩坑记录。

基于 Nuxt.js 3 + FastAPI + SQLite 的个人博客系统，支持文章发布、分类标签、评论审核、全文搜索、RSS 订阅、后台管理等功能。

6 张 ORM 表的设计决策：文章-标签多对多、自引用评论、JSON 扩展字段、SQLite 路径兼容。本文详解每个字段的设计意图。

22 个 API 端点分公开/网盘/管理三层。本文详解文章列表分页、全文搜索、JWT 认证和安全机制的设计与实现。

Nuxt 3 SSR 在 SEO 和首屏性能上优势明显，但也带来了 hydration 匹配的挑战。本文详解数据获取策略、分页缓存和三个实际踩坑案例。

12 个前端组件分基础/业务/后台三层。本文详解 GlassCard 基座、Pagination 截断、ArticleCard 点击事件和组件状态设计。