技术

开源了一个 <a target="_blank" href="http://ASP.NET" rel="nofollow noopener">ASP.NET</a> Core 的 Windows 资源管理器风格文件管理控件

背景
手上几个内部系统都要“让用户管服务器上的文件”:上传、下载、改名、预览、打包。找了一圈,老牌商业控件贵、还停在上一个时代;前端上传组件又只管上传,目录树、预览、权限全得自己补。补着补着就写成了个完整的东西,干脆开源了,MIT。
怎么用
一个标签:
&lt;file-manager                root-folder=&quot;D:\Shared&quot;              root-name=&quot;共享文件&quot;              api-endpoint=&quot;/filemanager-api&quot; /&gt;后端两行:
builder.Services.AddFileManagerNet();app.MapFileManagerNet(&quot;/filemanager-api&quot;, o =&gt; {    o.RootFolder = @&quot;D:\Shared&quot;;});前端纯手写 JS,没有 jQuery,没有 npm 依赖,图标和样式都跟包一起走。
长这样

单根目录和多根目录(虚拟根):

一个页面上放两个实例,选中、剪贴板、视图互不干扰:

能干什么

  • Ribbon、右键菜单、面包屑、目录树、状态栏,该有的都有;7 种视图,每个实例的视图和面板各自记住
  • 复制剪切粘贴、拖拽移动、框选、ZIP 压缩解压、大文件分块上传
  • 图片、视频、音频、PDF、文本代码都能在线预览;图片能缩放旋转翻转,文本会自动猜编码(GB18030、Big5、Shift-JIS 这些,一共 31 种可选)
  • Office 文件可选预览:服务端拿 LibreOffice 转 PDF,转过一次就缓存
  • 文件多了也不卡:超过 300 项自动虚拟滚动,12000 个文件的目录大概只留 30 个 DOM 节点
  • 文件夹级 ACL:按路径配只读、可写、限定文件类型、目录配额、直接禁止。重点是每个操作都在服务端查,不是把按钮藏起来就算完,手搓 API 请求照样 403
  • 客户端只传虚拟路径,..、盘符、绝对路径都进不来;解压防 zip-slip;开关也都在服务端生效
  • 中英文界面
性能上顺手做了点优化
同一个目录被好几个用户同时点开,只会扫一次盘,其他的等结果:1000 项的目录,16 个并发请求从 790ms 降到 121ms;不同目录之间还是并行的。ACL 校验是每目录缓存的,基本测不出开销。
先说不好的

  • 只支持 Windows 文件系统 + .NET 10,跨平台、S3、Azure Blob 还在 Roadmap 上
  • 没有内置登录,认证授权自己用 RequireAuthorization() 挂
  • 搜索是同步遍历,目录特别大建议缩范围或者限制 maxResults
  • Office 预览得服务器装 LibreOffice,没装的话前端会明确禁用,不会给你个坏掉的播放器
  • 还没暗色主题
地址

  • GitHub: https://github.com/virtuamesh/FileManagerNet
  • 中文配置手册在 docs/configuration.zh-CN.md;想直接看效果,dotnet run --project demo/FileManagerNet.Demo 就行
如果你也在给内部系统找能直接塞进 ASP.NET Core 的文件管理,可以拿去试试。更想听的是吐槽:ACL 这套模型够不够用、还缺什么操作、你们实际的目录有多大——这些比 Star 有用多了。


⚠️内容来自互联网,如有侵权请点击反馈!侵权投诉
本帖共 2 条回复,登录后即可查看

回复

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

hot.热文换一批
冰渊噬魂兽100%
琥珀彩蛋
琥珀彩蛋
当前页面有彩蛋,请仔细寻找哦!
牛马论坛(niumabbs.com),一个专注于分享日常新鲜事、职场工作点滴、摸鱼乐趣与各类生活感悟的交流平台。

    关注我们

  • 加入Q群
  • 微信客服
  • QQ客服
Copyright © 2026 NIUMABBS 版权所有 All Rights Reserved. |网站地图 劰载中...
关灯 在本版发帖
扫一扫添加微信客服
QQ客服返回顶部
快速回复 返回顶部 返回列表