static-files-guide.md

静态文件路由

功能特性

• 静态文件路由
• 自动 MIME 类型检测
• 安全防护（防止路径遍历攻击）
• 支持子路径访问
• 支持 HEAD 和 GET 方法
• 自动处理 404 和 403 错误

快速开始

from litefs import Litefs

app = Litefs()

# 添加静态文件路由
app.add_static('/static', './static', name='static')

app.run()

目录结构

推荐的静态文件目录结构：

project/
├── app.py
└── static/
    ├── css/           # CSS 样式文件
    ├── js/            # JavaScript 文件
    ├── images/        # 图片文件
    ├── fonts/         # 字体文件
    └── assets/        # 其他资源

安全特性

• 防止路径遍历攻击：自动阻止 ../../../etc/passwd 等恶意请求
• 文件类型检查：自动检测 MIME 类型
• 错误处理：自动返回 404 和 403 错误

高级用法

多个静态文件目录

app.add_static('/static', './static', name='static')
app.add_static('/uploads', './uploads', name='uploads')
app.add_static('/media', './media', name='media')

子路径访问

/static/css/style.css
/static/js/app.js
/static/images/logo.png

最佳实践

• 目录组织：按类型组织静态文件
• 缓存策略：使用 CDN 或反向代理
• 安全建议：不要将敏感文件放在静态文件目录中

性能优化

使用 CDN

<link rel="stylesheet" href="https://cdn.example.com/css/style.css">
<script src="https://cdn.example.com/js/app.js"></script>

反向代理

location /static/ {
    alias /path/to/static/;
    expires 30d;
    add_header Cache-Control "public, immutable";
}

相关文档

• :doc:routing-guide - 路由系统指南
• :doc:middleware-guide - 中间件指南
• :doc:configuration - 配置管理
• :doc:wsgi-deployment - WSGI 部署