aureliengasser/http-folder

HTTP Folder镜像说明

镜像概述

HTTP Folder是一个基于Node.js开发的轻量级Web服务器，提供文件上传、下载、删除及根目录文件列表展示功能，无额外依赖，部署和使用简单高效。

核心功能

• 文件上传：通过POST请求上传文件到服务器根目录
• 文件下载：通过GET请求下载指定文件
• 文件删除：通过DELETE请求删除指定文件
• 文件列表：访问根路径（/）查看所有文件列表
• 仅支持单根目录，无子文件夹功能

使用场景

• 本地开发测试时的临时文件传输
• 小型团队内部临时文件共享
• 快速搭建轻量级文件存储服务

配置说明

可通过两种方式配置服务器：

1. 命令行参数：指定根目录和端口（格式：http-folder [根目录] [端口]）
2. 环境变量：设置HTTP_FOLDER_ROOT_DIR（根目录）和HTTP_FOLDER_PORT（端口）

Docker部署示例

基础运行

bash
# 创建本地文件目录
mkdir -p /tmp/http-folder-files
# 启动容器（映射端口4242，挂载本地目录到容器/data）
docker run -d \
  -p 4242:4242 \
  -v /tmp/http-folder-files:/data \
  aureliengasser/http-folder \
  /data 4242

使用环境变量配置

bash
docker run -d \
  -p 4242:4242 \
  -v /tmp/http-folder-files:/data \
  -e HTTP_FOLDER_ROOT_DIR=/data \
  -e HTTP_FOLDER_PORT=4242 \
  aureliengasser/http-folder

操作示例

上传文件

bash
# 将本地original-file上传到服务器，命名为uploaded-file
curl --data-binary "@original-file" http://localhost:4242/uploaded-file

下载文件

bash
# 下载服务器上的uploaded-file到本地downloaded-file
curl -s http://localhost:4242/uploaded-file -o downloaded-file

删除文件

bash
# 删除服务器上的uploaded-file
curl -XDELETE http://localhost:4242/uploaded-file