package com.custom.webui.config.props; import lombok.Data; import org.springframework.boot.context.properties.ConfigurationProperties; import java.util.ArrayList; import java.util.List; /** * 文件存储配置,前缀 {@code webui.storage}。 * *

安全相关:{@link #allowedExtensions} 是白名单,只有列出的扩展名允许上传。 * 这是防御上传漏洞的第一道防线,生产环境不要放宽为「允许全部」。 */ @Data @ConfigurationProperties(prefix = "webui.storage") public class StorageProperties { /** 本地磁盘存储根目录 */ private String location = "./data/uploads"; /** 扩展名白名单(小写,不带点) */ private List allowedExtensions = new ArrayList<>(List.of( "txt", "md", "markdown", "pdf", "docx", "doc", "csv", "json", "log", "html", // 图片:对话中上传走 OCR 提取文字;也可直接入库当知识库资料 "png", "jpg", "jpeg", "webp", "bmp", "gif", "tif", "tiff")); /** 单文件最大字节数,默认 50MB */ private long maxFileSize = 50L * 1024 * 1024; }