kongdeqiang
2026-10-14 9f9e043849b6f497e00399900ff234cf097eba82
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
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}。
 *
 * <p>安全相关:{@link #allowedExtensions} 是白名单,只有列出的扩展名允许上传。
 * 这是防御上传漏洞的第一道防线,生产环境不要放宽为「允许全部」。
 */
@Data
@ConfigurationProperties(prefix = "webui.storage")
public class StorageProperties {
 
    /** 本地磁盘存储根目录 */
    private String location = "./data/uploads";
 
    /** 扩展名白名单(小写,不带点) */
    private List<String> 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;
}