quickfile：OpenWrt 网页文件管理器

项目简介

luci-app-quickfile 是一款专为 OpenWrt 设计的轻量级网页端文件管理器，主打极低的资源占用。它直接使用 OpenWrt 令牌进行登录验证，因此需要依赖 nginx 配合使用。

发布页同时提供 SDK 24.10 的 IPK 包，覆盖 aarch64_cortex-a53、aarch64_generic、x86_64 等架构，并配套 luci-app-quickfile 与 luci-i18n-quickfile-zh-cn 中文语言包。

主要功能

文件管理

• 基础操作：目录浏览，文件与文件夹的创建、重命名、移动、删除。
• 便捷传输：标准上传与下载，支持浏览器拖拽直接上传、在线下载文件。
• 解压缩：支持 zip、tar.gz、tar.xz 文件的压缩与解压。

命令终端

• 内置网页终端，可直接在管理界面中执行当前目录下的系统命令，便于批量操作文件、调试与系统维护。

软件包管理（IPK / APK）

• 支持在网页端直接安装本地上传的 .ipk 或 .apk 软件包。
• 安装失败或缺少依赖时，可同步刷新软件源并尝试自动补齐依赖。
• 内置安装日志捕获，清晰输出安装成功或失败的信息，便于排查问题。

媒体预览

• 内置主流格式的图片与视频预览组件，无需下载到本地即可在浏览器中查看。

文本编辑器

• 集成轻量化的 Monaco Editor，支持多种配置文件与脚本语言的语法高亮，可直接在线编辑路由器配置。

安装与使用

自行编译的方式：

git clone https://github.com/sbwml/luci-app-quickfile package/quickfile
make menuconfig # choose LUCI -> Applications -> luci-app-quickfile
make package/quickfile/luci-app-quickfile/compile V=s

禁用不可信的 SSL 证书（浏览器会拒绝通过不可信证书获取 Session ID）：

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

注意事项

• quickfile 直接使用 OpenWrt 令牌进行登录验证，需要依赖 nginx 配合使用，这可能会让你的 LuCI 失去工作。
• 非开发人员不建议自行编译使用，可优先选用发布页提供的 IPK 包。
• 文件上传大小受限时，可编辑 /etc/nginx/conf.d/quickfile.locations，把 client_body_temp_path 临时目录改为大容量目录，避免上传因体积超限而失败。

---

本作品整理自 GitHub 开源项目 wkccd/quickfile，原作者 @wkccd，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。