gsengun/simple-upload-server

go-simple-upload-server镜像说明

镜像概述

本镜像基于go-simple-upload-server构建，是一款轻量级HTTP服务器，专注于文件的快速存储与访问，支持基础的上传、下载及文件存在性验证功能，并通过token机制实现访问权限控制。

核心功能

• 文件上传：支持两种方式：POST /upload（自动保留原文件名）、PUT /files/(filename)（自定义文件名）
• 文件下载：通过GET /files/(filename)获取指定文件内容
• 存在性检查：使用HEAD /files/(filename)验证文件是否存在
• 安全认证：所有请求需携带与服务器一致的token参数，未匹配则返回401未授权

使用场景

• 个人/团队临时搭建轻量文件存储服务
• 小项目构建产物（artifact）的快速存储
• 本地测试环境中的文件传输需求

配置说明

启动参数

• -token：指定访问认证token（可选，未指定时服务器自动生成并输出到日志）
• 存储目录：启动时需指定文件存储的根路径

Docker部署示例

bash
docker run -p 25478:25478 -v $HOME/tmp:/var/root gsengun/simple-upload-server app -token f9403fc5f537b4ab332d /var/root

参数说明：

• -p 25478:25478：映射容器端口到主机
• -v $HOME/tmp:/var/root：将主机$HOME/tmp目录挂载为容器存储目录
• -token：设置访问认证token
• /var/root：容器内文件存储根目录

基础操作示例

上传文件

bash
# POST方式（保留原文件名）
curl -Ffile=@sample.txt 'http://localhost:25478/upload?token=f9403fc5f537b4ab332d'

# PUT方式（自定义文件名）
curl -X PUT -Ffile=@sample.txt "http://localhost:25478/files/another_sample.txt?token=f9403fc5f537b4ab332d"

下载文件

bash
curl 'http://localhost:25478/files/sample.txt?token=f9403fc5f537b4ab332d'

检查文件存在性

bash
curl -I 'http://localhost:25478/files/sample.txt?token=f9403fc5f537b4ab332d'