💾 本地文件存储配置

🔄 上传流程

⚙️ 配置说明

基础配置示例

files:
- # 业务标识配置
  business-type: demo           # 业务类型标识
  file-type: local             # 存储类型：本地存储
  
  # 存储路径配置
  root-path: /srv/file/data    # 文件根目录
  http-access-path: https://www.wueasy.com  # 文件访问基础路径
  
  # 上传限制
  allowed-upload-suffix: jpg,png,gif,bmp,pdf,doc  # 允许的文件类型
  max-size: 1MIB              # 单文件大小限制

参数说明

参数名	必填	说明	示例值
business-type	是	业务类型标识	demo
file-type	是	存储类型(固定为local)	local
root-path	是	文件存储根目录	/srv/file/data
http-access-path	是	文件访问域名	https://www.wueasy.com
allowed-upload-suffix	是	允许上传的文件后缀	jpg,png,pdf
max-size	是	文件大小限制	1MIB

💡 配置指南

1. 准备工作

1. 创建存储目录

# 创建根目录
mkdir -p /srv/file/data

# 设置目录权限
chmod 755 /srv/file/data
chown -R file-server:file-server /srv/file/data

2. 配置 Nginx

server {
    listen 80;
    server_name files.example.com;
    
    location / {
        root /srv/file/data;
        autoindex off;
        add_header Cache-Control "public, max-age=31536000";
    }
}

2. 安全建议

安全提示

• 避免将存储目录放在 Web 根目录下
• 定期清理临时文件
• 配置目录访问权限
• 开启防盗链功能

3. 性能优化

1. 目录结构优化

   • 使用日期目录分层存储
   • 控制单目录文件数量
   • 定期归档历史文件

2. 访问优化

   • 配置 CDN 加速
   • 启用 Nginx 缓存
   • 开启 GZIP 压缩

❗ 常见问题

1. 上传失败

   • 检查目录权限设置
   • 验证磁盘空间是否充足
   • 确认文件大小是否超限

2. 访问路径问题

   • 确保 Nginx 配置正确
   • 检查文件权限设置
   • 验证域名解析是否正常

3. 性能问题

   • 检查磁盘 I/O 性能
   • 监控目录文件数量
   • 评估存储容量使用情况

注意事项

• 建议使用 SSD 存储以提升性能
• 定期备份重要文件
• 监控磁盘使用率
• 配置日志轮转策略