简单易用,无需部署的目录列表程序。 特性:
- 无需环境,无需数据库,低内存占用
- 支持webdav管理
- 支持视频在线播放,支持字幕(srt, ass, ssa, vtt等)
- 支持图片预览,支持常见jpg, gif, png, tif, psd格式预览,图片画廊带来流畅体验
- 支持音频在线播放,支持解析专辑图片和歌手信息
- 支持文档在线预览,包括常见各类代码格式,如html, js, css, php, py, pdf等
- 支持office在线预览
- 支持共享链接,支持共享链接管理
- 集成aria2ng,并安全的指向内部转发地址
- 文件搜索,即时搜索整个列表文件夹
- 中英多语言支持
- 支持常用文件管理,文件一拖即传
- 支持主流浏览器,完整支持IE11,部分支持IE10和IE9
- 响应式布局,适配移动浏览器,适配黑暗模式
这不是一个Onedrive/GoogleDrive/Dropbox/OSS 的列表程序,这是服务器的硬盘目录列表程序。
使用方式
本程序为linux amd64可执行文件,点击这里 下载后执行 chmod +x FolderMagic
然后就可以 ./FolderMagic
运行了,默认共享当前所在文件夹,公开访问无认证。所有可选参数如下:
命令行参数
-aria string
Aria2 RPC地址 (默认 "http://127.0.0.1:6800/jsonrpc"),列表程序将安全的转发这个地址
-auth string
认证: "用户名:密码" 认证信息用于网页登录和webdav,不设置则无认证,webdav将被禁用
-bind string
监听端口 (默认 ":80"),以 ip:端口 的格式输入,ip可省略,直接输入 :端口 即可监听所有接口
-gzip
使用gzip压缩 (默认 true)
-nosearch
关闭内置搜索功能
-page404 string
自定义404页面
-root string
列表根目录 (默认为当前目录)
-share int
默认共享链接有效期,单位分钟 (默认 60)
-wd string
用于webdav的认证路径, 不可使用根目录 (默认 "/manager")
webdav 使用
使用命令行 -auth user:password
启用鉴权后webdav即自动启用。
使用raidrive或其他webdav兼容客户端连接 http://your.domain:port/manager 输入用户名和密码即可连接。
/manager 可使用 -wd
指令更改
文件管理在网页列表界面右键即可操作文件和文件夹,可以新建和删除。
不使用认证时只能下载文件,不能进行其他操作
文件上传使用webdav客户端上传。
直接把文件拖到列表界面,出现蓝框提示松手上传即可。
上传过程中可继续拖入新的文件排队上传。不支持拖文件夹上传。
IE9 及以下浏览器由于浏览器限制无法上传。
视频预览支持预览mp4, mkv格式,能否成功播放取决于实际视频容器内的编码格式。
字幕需要在视频同一文件夹下,字幕文件名包含视频名称即可,如a.mp4
和a_en.srt
即为匹配字幕。多个字幕将被同时载入可以在播放界面选择。字幕支持所有常见字幕,ass特效字幕保留文字部分,特效无法支持。
音频预览支持mp3和ogg,具体支持视浏览器而定。点击即可在左下角开始播放。
音频将被自动解析专辑图片和歌曲名称,歌手。(IE9不支持解析)
点击新的音频可以自动加入播放列表,切换文件夹不影响播放。 (IE9 将中断播放)
图片预览支持各种常见图片预览,图片将自动生成合适缩略图并使用webp格式(如果浏览器支持)传输
支持psd格式预览,gif格式生成缩略图后没有动画。
Office预览基于微软在线预览实现。按照微软的预览要求,需要将拥有域名并且FolderMagic需要在80或443端口,否则无法预览。
即:浏览器中显示的地址必须为 http://example.com/example.doc 或者 https://example.com/example.ppt 这样的形式才能被预览,否则会显示无法打开文件。
共享管理通过右键复制的临时链接自动拥有一定时间的有效期(默认60分钟,可通过-share
指令更改),到期后无法被下载。
在右下角菜单中选择共享管理即可添加或减少共享时间,也可删除共享
复制的永久链接除非移动文件或更改用户名密码,否则永远有效,不可删除。
重启FolderMagic后,所有临时共享都会失效,永久连接依然有效
AriaNG通过右下角菜单可以调用内置的ariaNg,并默认指向/jsonrpc路径。FolderMagic将默认转发/jsonrpc到http://127.0.0.1:6800/jsonrpc
(aria2 rpc默认路径),可通过-aria
指令更改转发地址
/jsonrpc 需要被认证后才能访问(如果启用了认证的话),所以该转发是安全的,即便没有密码,其他人也无法连接到你的aria2rpc
文件搜索启动后FolderMagic即开始检索被列表的文件夹并监听文件夹的所有改动。
可以在右下角菜单处打开搜索,也可使用Ctrl+F或者F3立刻开始搜索。
索引文件占用少量内存(约3M/10k文件)。监听文件夹基于inotify,如果存在海量文件夹(如十几万个)则将会占用较多内存,甚至可能用完inotify的所有监听额度,请不要直接共享根目录。
可以用-nosearch
指令关闭搜索功能。如果您尝试在例如网络映射文件夹等文件系统上使用FolderMagic,索引可能会变得很慢并占用额外的资源,这时您就可以关闭搜索。
搜索功能关闭后,系统会恢复使用浏览器原生的页面内查找功能。
移动端适配FolderMagic 针对移动端、触摸屏设计了适合对应设备操作的界面。只要在文件列表轻轻右划即可进入适合iOS和Android的操作界面,方便的进行上传下载和文件管理。
安全措施启用鉴权后,FolderMagic将只允许授权用户登录,每个IP有5次密码试错机会,失败后将被禁用15分钟,期间FolderMagic任何服务都无法访问。
推荐使用root用户,FolderMagic将使用chroot保护运行环境,完全避免由于潜在的bug而被黑到系统其他核心文件夹的机会。
如不使用root,请开放对应用户的chroot权限。无权限时chroot将被禁用,安全性将被降低。
由于chroot的使用,符号链接文件和符号链接文件夹可能无法使用,因为他们将指向一个完全不同的路径
httpsFolderMagic 没有https的原生支持,你可以通过nginx或者caddy做前端来添加https的支持。
假设你的FolderMagic绑定于127.0.0.1:81
,以下例子仅供参考:
nginx
server {
listen 443 ssl;
server_name 域名或ip;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload" always;
#证书文件
ssl_certificate www.example.com.crt;
#私钥文件
ssl_certificate_key www.example.com.key;
#优先采取服务器算法
ssl_prefer_server_ciphers on;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_ciphers "EECDH+ECDSA+AESGCM EECDH+aRSA+AESGCM EECDH+ECDSA+SHA384 EECDH+ECDSA+SHA256 EECDH+aRSA+SHA384 EECDH+aRSA+SHA256 EECDH+aRSA+RC4 EECDH EDH+aRSA !aNULL !eNULL !LOW !3DES !MD5 !EXP !PSK !SRP !DSS !RC4";
location / {
proxy_buffering off;
# 一定要加,否则FolderMagic在反代后不能识别客户ip,直接封锁全部用户
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://127.0.0.1:81;
}
}
caddy v1 (v2 内容待添加,目前请自行google解决,本人没使用过caddy :-D)
https://example.com, https://www.example.com {
gzip
header / {
Strict-Transport-Security "max-age=31536000;includeSubdomains;preload"
}
## HTTP 代理配置
### 此时访问 example.com,实际访问的是 127.0.0.1:81 的内容
proxy / 127.0.0.1:81
header_upstream Host {host}
header_upstream X-Real-IP {remote}
header_upstream X-Forwarded-For {remote}
header_upstream X-Forwarded-Port {server_port}
header_upstream X-Forwarded-Proto {scheme}
tls user@example.com
}
已知问题- 初次访问的语言将被记录,此后访问将使用第一次访问的语言。可使用
?lng=zh_CN
或?lng=en
强制切换到中文或英文 - IE10及以下符号显示不正常,IE9及以下不能上传文件,切换文件夹将丢失当前正在预览的图像或音视频
- 360浏览器 由于奇葩的设计,极速模式下所有文件拖放上传功能都不可用,只能在兼容模式下的IE内核才能上传
- 和部分拖放打开的插件有冲突,会出现有时能拖放有时不能,或者拖放时页面闪烁等情况,只能对本列表页面禁用插件解决。
- iOS Chrome存在一些特有问题,播放动画等会出现不流畅的情况,其他浏览器无问题,应为Chrome的自有代码缺陷。
from https://github.com/FolderMagic/FolderMagic
No comments:
Post a Comment