a simple file server
Project description
1. 主要功能
- 支持用作简单文件列表,无需数据库,无用户管理,分享等功能
- 支持基本网盘功能,需要安装MongoDB及Redis,支持用户注册,文件分享,用户目录可设置公开访问,公共目录等功能
- 用户可设置自己的目录是否完全公开,公开时所有人都可访问,但无法修改文件
- 公共目录内的文件只有管理员可管理,所有人都可公开访问,但无法修改文件
- 大文件分片上传,文件夹上传,剪切板粘贴上传图片
- 离线下载,需要安装
axel,可粘贴http/https链接进行下载 - 批量删除、批量分享至公共空间、批量分享、批量取消分享
- 预览功能,支持
.sh.py.java.c.js.css等代码预览,且支持代码高亮,支持.jpg.txt.pdf.md,.html等文件格式预览,支持.zip.tar.gz.tar.bz2等压缩格式预览,在可外网访问的环境下,支持.docx.xlsx.pptx等Office文件预览 - 播放功能,支持
.mp4.flv.m3u8等视频格式播放,支持.mp3.wav.ogg等音频格式播放 - 推送功能,支持将
.mobi.epub.pdf.txt等Kindle支持的文件推送至Kindle - 文件下载,支持文件夹压缩下载
- 支持实时预览,可切换文件列表模式及预览模式(直接打开图片,播放音乐)
- 支持列表及图标布局,图标布局模式下采用瀑布流加载
- 支持切换显示树形目录
- 支持文件搜索,若采用网盘模式时只搜索当前目录及子目录下的文件,否则搜索全部文件
安装部署
确保您的Python版本>=3.6,一键安装方式如下
pip install kk # 安装
kk # 运行
若采用网盘模式启动,需先安装MongoDB及Redis,推荐使用docker进行安装,同时设置必要的环境变量
若MongoDB有密码,如用户名密码为admin/123456,则需设置环境变量MONGO_URI
export MONGO_URI=mongodb://admin:123456@localhost:27017/admin
若Redis有密码,如密码为123456,则需设置环境变量REDIS_URI
export REDIS_URI=redis://:123456@localhost:6379
要发送邮件,需先设置邮件服务器相关的环境变量
export EMAIL_SENDER=
export EMAIL_SMTP=
export EMAIL_USER=
export EMAIL_PWD=
然后再以网盘模式启动
kk --auth=true
本源码使用的默认数据库名为kk,第一个注册的用户即为管理员,建议对如下字段建立索引
db.share.ensureIndex({token: 1})
db.share.ensureIndex({name: 1})
db.users.ensureIndex({id: 1}, {unique: 1})
db.users.ensureIndex({username: 1}, {unique: 1})
db.users.ensureIndex({email: 1}, {unique: 1})
其他可选参数
--auth=true # 以网盘模式启动
--tools=true # 显示工具箱,用于画图及制表
--root=. # 设置根目录,默认为当前文件夹
--db=kk # 设置数据库名称,默认为kk
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
kk-0.7.8.tar.gz
(1.4 MB
view details)
File details
Details for the file kk-0.7.8.tar.gz.
File metadata
- Download URL: kk-0.7.8.tar.gz
- Upload date:
- Size: 1.4 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.62.0 CPython/3.9.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
30e1b158119c2a1c4484c0271c79223a7600bb088a04d9d3db763f92f07e1906
|
|
| MD5 |
fd7eca86aec8a480eafba0103fb15006
|
|
| BLAKE2b-256 |
156e71cfcae931f47ef08b7587fd4de577f15410b8016ee9078b7eb2218d0afc
|