Skip to content

About

一款专为 OpenWrt 设计的轻量级网页端文件管理器。

Resources

Stars

290 stars

Watchers

8 watching

Forks

Latest commit

 

History

62 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

luci-app-quickfile

一款专为 OpenWrt 设计的高性能轻量 Web 文件管理器。后端采用 Rust 构建,前端基于 Vue 3 + Vite + Tailwind CSS。


界面预览

浅色模式 深色模式
Light Theme Dark Theme

主要特性

  • 文件浏览与管理
    • 提供列表与网格两种视图,支持按名称、体积、修改时间排序
    • 文件列表与分页流式加载,首屏响应迅速,滚动平滑加载海量文件
    • 完整键鼠交互:鼠标框选、多选(Ctrl / Shift)、全选(Ctrl+A)
    • 目录树侧边栏:懒加载展开、一键折叠全部、跟随隐藏文件开关,选中即跳转
    • 右键上下文菜单:新建、重命名、权限修改(chmod)、属性查看、复制、剪切、粘贴、压缩与解压
  • 传输与上传
    • 支持拖拽移动、拖拽上传文件及文件夹(自动保留目录树层级)
    • 支持剪贴板粘贴直接上传(Ctrl+V 图片与文件)
    • 上传管理面板:实时进度、速率显示、传输取消及同名覆盖/重命名策略
    • 远程 URL 离线下载
  • 归档与压缩
    • 支持格式:zip、gz、tar、tar.gz、tar.xz、tar.zst、ipk、apk、img、ext4、squashfs
    • ZIP 归档支持 WinZip AES-256 加密与解密
  • 多媒体与文档预览
    • 图片浏览器:支持平移、无级缩放与前后切换
    • 媒体播放:内置音频播放器与视频播放器(支持倍速、画中画、全屏)
    • PDF 阅读器:支持平滑滚动、旋转、分页与全文检索
  • 开发与系统集成
    • 内置终端:基于 xterm.js 与 WebSocket,自动定位至当前浏览目录;支持 Ctrl+滚轮 / Ctrl+= / Ctrl+- 缩放字号(右下角提示当前字号),Ctrl+Shift+C 复制选中内容
    • 移动端终端快捷键工具栏:Tab、Esc、Ctrl 组合键、粘贴与方向键,兼容虚拟键盘退格与中文输入法组词
    • 代码编辑器:集成 CodeMirror 6,内置 40+ 语言高亮,主题自动联动,支持快捷键搜索(Ctrl+F)与保存(Ctrl+S);Ctrl+Shift+Z 重做
    • OpenWrt 专属语法:内置 uci(config / option / list / package)高亮,ucode 按 JavaScript 高亮与格式化
    • 一键格式化(右键菜单 / Shift+Alt+F):支持 JS / TS / JSON / CSS / Less / SCSS / HTML / Vue / Markdown / YAML / shell / Lua
    • 文档预览:.md 走 GitHub 风格渲染,.html 以沙箱 iframe 预览,编辑与预览间切换
    • 哈希校验:支持在文件属性中直接计算 MD5 与 SHA-256
  • OpenWrt 系统深度适配
    • 支持 OpenWrt 24.10 / 25.12 软件包一键安装
    • init.d 服务管理:支持直接执行 start、stop、restart、reload、enable、disable
    • 原生 ipk2apk 转换:基于 Rust 独立实现 APK v3 (ADB 容器) 格式打包,无需依赖完整 apk-tools 即可完成 .ipk 至 .apk 转换并保留完整元数据

编译指南

# 克隆源码至 OpenWrt SDK 或源码根目录
git clone https://github.com/sbwml/luci-app-quickfile package/quickfile

# 配置并选择包: LuCI -> Applications -> luci-app-quickfile
make menuconfig

# 编译单独模块
make package/quickfile/luci-app-quickfile/compile V=s

⚠ 本项目使用 OpenWrt 原生 Token 验证,Web 服务依赖 nginx 反向代理,非开发人员不建议自行编译使用。


Nginx 配置参考

OpenWrt 下 Nginx 默认启用 HTTPS 与自签证书。如需改为标准 HTTP(80 端口)监听,可执行以下 UCI 指令:

uci set nginx.global.uci_enable='true'
uci del nginx._lan
uci del nginx._redirect2ssl
uci add nginx server
uci rename nginx.@server[0]='_lan'
uci set nginx._lan.server_name='_lan'
uci add_list nginx._lan.listen='80 default_server'
uci add_list nginx._lan.listen='[::]:80 default_server'
uci add_list nginx._lan.include='conf.d/*.locations'
uci set nginx._lan.access_log='off; # logd openwrt'
uci commit nginx

service nginx restart

About

一款专为 OpenWrt 设计的轻量级网页端文件管理器。

Resources

Stars

290 stars

Watchers

8 watching

Forks

Releases

Packages

Contributors

Languages