twostoryrobot/simple-file-upload

simple-file-upload

镜像概述和主要用途

simple-file-upload是一个提供API端点的Docker容器，用于实现简单、安全的文件上传功能。该容器暴露单个写权限端点/upload，接受文件上传并通过token GET参数进行身份验证。上传文件的存储位置和身份验证配置通过容器环境变量实现，确保上传过程安全可控。

核心功能和特性

• 安全上传限制：仅支持文件上传，不提供文件下载或读取功能
• 身份验证机制：通过token GET参数进行身份验证，确保只有授权用户可上传
• 密钥-存储位置映射：每个身份验证密钥与磁盘上的一个存储位置形成1:1映射
• 文件覆盖机制：同一密钥的新上传文件会覆盖该密钥对应的历史文件，不保留多个版本
• 多密钥支持：支持配置多个身份验证密钥，每个密钥独立对应不同存储位置

使用场景和适用范围

适用于需要安全文件上传功能的场景，例如：

• 用户特定文件上传（如用户配置文件、数据备份）
• 自动化系统间的文件传输（如监控数据、日志文件上传）
• 需要限制上传权限和存储位置的内部服务

使用方法和配置说明

基本使用

通过docker run命令启动容器，需配置环境变量、卷挂载和端口映射：

bash
docker run \
  -e "KEY_TESTUSER=/uploads/testuser-file.txt" \
  -v /my_local_dir/:/uploads/ \
  -p 3000:3000 \
  twostoryrobot/simple-file-upload

参数说明：

• -e "KEY_<密钥名>=<存储路径>"：配置身份验证密钥及其对应的文件存储路径，可配置多个（如KEY_USER1=/path1/file.txt、KEY_USER2=/path2/file.txt）
• -v /my_local_dir/:/uploads/：将主机目录/my_local_dir/挂载到容器内/uploads/，用于持久化存储上传文件
• -p 3000:3000：将容器内3000端口映射到主机3000端口，暴露API服务

文件上传示例

使用curl工具上传文件：

bash
curl -XPOST -F 'data=@本地文件路径' http://dockerhost:3000/upload?key=TESTUSER

说明：

• data=@本地文件路径：指定本地待上传的文件路径
• key=TESTUSER：身份验证密钥，需与容器环境变量中配置的KEY_TESTUSER对应
• 上传成功后，文件将保存到容器内/uploads/testuser-file.txt（即主机/my_local_dir/testuser-file.txt）