存储配置

M-Doc 使用 S3 兼容的对象存储服务来存储用户上传的文件（图片、PDF 等）。

---

配置

s3:
  enabled: true
  region: "us-east-1"
  bucket: "your-bucket"
  access_key: "your-access-key"
  secret_key: "your-secret-key"
  endpoint: ""                      # S3 兼容服务的 endpoint
  cdn: ""                           # CDN 加速域名
  upload_path: "mdoc/uploads"       # 上传路径前缀
  max_file_size: 52428800           # 最大文件大小（字节）
  allowed_types:                    # 允许的文件类型
    - "image/jpeg"
    - "image/png"
    - "image/gif"
    - "image/webp"
    - "image/svg+xml"
    - "application/pdf"
    - "application/msword"
    - "application/vnd.openxmlformats-officedocument.wordprocessingml.document"

支持的存储服务

服务	endpoint 配置
AWS S3	留空（使用默认）
MinIO	http://minio-host:9000
白山云存储	http://ss.bscstorage.com
阿里云 OSS	https://oss-cn-hangzhou.aliyuncs.com

CDN 加速

设置 cdn 字段后，上传文件的访问 URL 将使用 CDN 域名：

s3:
  cdn: "https://static.your-domain.com"

上传后的文件 URL 格式：https://static.your-domain.com/mdoc/uploads/xxx.png

如不设置 CDN，将使用存储服务的原始 URL。

文件大小限制

max_file_size 以字节为单位，默认 50MB（52428800 字节）。

常用值：

• 10MB = 10485760
• 50MB = 52428800
• 100MB = 104857600

禁用文件上传

设置 s3.enabled: false 即可禁用文件上传功能。