ServeFS

English

一个基于 FastAPI 和 Vue.js 的简单文件服务器，支持文件和文件夹的上传、预览和管理。

screenshot

更多截图查看 GALLERY

功能特点

📁 文件和文件夹浏览
📤 支持文件和文件夹上传
🖼️ 图片文件预览
🗑️ 文件和文件夹删除
📊 文件大小显示
🔄 实时进度显示
💫 拖放上传支持
🖥️ 命令行界面支持

预览功能

.jpg、.jpeg、.png、.gif、.webp 图片预览。
.json、.html、.css、.txt、.md、.py 以文本格式预览。
.ttf 字体文件预览。

安装

推荐使用 pipx 安装（保证依赖隔离）：

pipx install servefs

或使用 pip：

pip install servefs

使用

命令行

# 在当前目录启动服务器
servefs

# 指定目录
servefs --directory /path/to/directory
# or
servefs -d /path/to/directory

# 指定端口
servefs --port 7001
# or
servefs -p 7001

# 显示帮助
servefs --help

完整命令行选项：

选项:
  -d, --directory TEXT     要服务的根目录 [default: .]
  -h, --host TEXT     绑定的主机地址 [default: 0.0.0.0]
  -p, --port INTEGER  绑定的端口号 [default: 8000]
  -b, --basic-auth TEXT  启用基本认证，格式为 username:password
  -v, --version       显示版本号并退出
  --help             显示帮助信息并退出

基本认证

你可以使用基本认证来限制文件的访问权限：

# 设置用户名和密码
servefs --basic-auth admin:password123

# 或使用短选项
servefs -b admin:password123

启用基本认证后：

未认证用户只能查看和下载文件
认证用户可以执行所有操作（上传、删除、重命名等）
认证信息会通过浏览器的基本认证机制传输

你也可以通过环境变量设置认证信息：

export SERVEFS_BASIC_AUTH=admin:password123
servefs

开发

如果你想参与开发，请查看开发指南。

TODO

支持文件重命名
支持链接复制
添加用户认证
支持文件搜索
支持文件分享

感谢

Windsurf

Metadata

Release files for servefs 0.2.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for servefs 0.2.5
File	Size	Uploaded
servefs-0.2.5.tar.gz	1.1 MB	Jul 28, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for servefs 0.2.5
File	Interpreter	ABI	Platform	Reset
servefs-0.2.5-py3-none-any.whl 1.1 MB Jul 28, 2025	Python 3	none	any	Details

Total release size: 2.2 MB

Release files / servefs-0.2.5.tar.gz

Download URL	servefs-0.2.5.tar.gz
Size	1.1 MB
Tags	Source
SHA-256 checksum How to use checksums	`a6b331f4a8a937d3b826d72467d2669f649dae71737f06f97dd88bba769253d0`
BLAKE2b-256 checksum How to use checksums	`12ed592a3847e1c2648ed6b3b64cf96624dd49f475c15ccaf85754166c91c62c`
Upload date	Jul 28, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.12.9`

Release files / servefs-0.2.5-py3-none-any.whl

Download URL	servefs-0.2.5-py3-none-any.whl
Size	1.1 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`778ad7aae4a42c0fa42b98391597acc9dd5484840b36415cf685b0630d4e7df0`
BLAKE2b-256 checksum How to use checksums	`f7a87c022585bc15bec4e11b8d7177f9f7e01a64c01cd28b469ca63ff1d5e591`
Upload date	Jul 28, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.12.9`