- 目标用户:需要在同一局域网内快速分享文件的个人或小团队。
- 使用场景:临时传输大文件、局域网内共享资料目录、跨设备(手机/电脑)取文件。
二、核心功能
- 目录共享:选择本地磁盘或文件夹作为共享根目录。
- 浏览器访问:局域网内设备通过
IP:端口访问共享内容。 - 目录浏览:网页展示目录结构、文件列表(名称、大小、修改时间)。
- 文件下载:点击文件即可下载。
- 目录导航:进入子目录、返回上级目录。
三、详细功能需求
1. 共享配置
- 指定共享根目录(可为整个磁盘或某个文件夹)。
- 自定义监听端口,支持三种方式(优先级从高到低):
- 命令行参数
--port 8080 - 命令行参数
--urls http://0.0.0.0:8080 - 配置文件
appsettings.json中的Urls
- 命令行参数
- 监听地址支持
0.0.0.0(局域网所有网卡)或指定网卡。 - 启动时打印本机所有可用 IPv4 访问地址,方便其他设备打开。
{
"Urls": "http://0.0.0.0:18899",
"SharedRootPath": "E:\\共享目录",
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}
},
"AllowedHosts": "*"
}
2. 目录浏览
- 列表展示:目录 / 文件名称、大小、修改时间。
- 目录可点击进入,文件可点击下载。
- 面包屑导航,支持快速返回任意上级目录。
- 非根目录提供「上级目录」快捷入口。
- 排序规则:目录优先,再按名称升序(不区分大小写)。
3. 文件下载
- 点击文件直接下载(作为附件)。
- 支持断点续传(HTTP Range,返回 206)。
- 大文件流式传输,避免一次性加载进内存。
- 正确处理中文 / 空格 /
#等特殊文件名(UTF-8 编码 + URL 编码)。