ShareList全方位解析

一、ShareList简介

ShareList是一个开源的在线文件目录列表生成器，使用Node.js编写。借助ShareList，开发者可以快速构建一个自己的文件分享目录，轻松管理、共享自己的文件。其特点包括易于安装、易于配置、易于扩展等，已经成为很多文件分享站点的首选工具。

二、使用方法

1、下载ShareList

git clone https://github.com/MagicBowen/ShareList.git

2、安装依赖

npm install

3、配置文件

{
  "port": 3300,        // 监听端口
  "username": "root",  // 访问用户名
  "password": "123456",  // 访问密码
  "language": "auto",  // 语言设置："en","zhcn","zhtw"等
  "root": "E:\\share",  // 根目录
  "theme": "default",  // 主题设置："default","flat","gray","material","win10","osx"等
  "sort": "name",      // 排序方式："name","time"
  "sortOrder": "asc",  // 排序方式："asc","desc"
  "showHiddenFiles": false,  // 是否显示隐藏文件
  "hideInaccessible": false,  // 是否隐藏不可访问的文件或文件夹
  "auth": true,  // 是否启用认证
  "database": {
    "type": "sqlite",  // 数据库类型：sqlite3, mysql, mariadb, postgres, mssql, oracle等
    "database": "./sharelist.db",  // 数据库名称
    "synchronize": true  // 是否自动更新数据表
  }
}

4、启动ShareList

npm start

三、主要功能

1、文件上传和下载

ShareList提供了方便的文件上传和下载功能，只要访问者有相关权限，就可以轻松地上传和下载自己需要的文件。此外，管理员可以在配置文件中设置文件大小限制、文件类型限制等功能，有效防止恶意上传或下载。

{
  // 文件上传相关设置
  "limits": {
    "maxFieldsSize": 2 * 1024 * 1024,  // 最大文件大小，单位为字节
    "maxFields": 10,  // 最多上传文件数量
    "maxFileSize": 20 * 1024 * 1024,  // 最大文件大小，单位为字节
    "maxFilesSize": 30 * 1024 * 1024  // 总体文件大小上限，单位为字节
  },
  // 文件类型过滤
  "files": {
    "allowUpload": ["png", "jpg", "jpeg", "gif", "pdf", "zip"],  // 允许上传的文件类型
    "allowDownload": ["pdf", "zip", "rar"]  // 允许下载的文件类型
  }
}

2、权限管理

在ShareList中，可以轻松设置访问者的权限，管理员可以设定具体的读写权限，避免机密数据被恶意窃取。

{
  "users": [
    {
      "username": "root",
      "password": "123456",
      "permissions": "rw"  // 用户权限：r-只读，w-读写
    },
    {
      "username": "guest",
      "password": "guest",
      "permissions": "r"
    }
  ]
}

3、文件预览

ShareList支持在线预览各种常见文件类型，包括图片、文档、音频、视频等类型，访问者可以在不离开网页的情况下轻松查看、播放自己需要的文件。此外，由于采用HTML5技术，可以有效避免Flash等插件的安全漏洞。

"viewers": [
    {
      "ext": "jpg,jpeg,png,gif,bmp,webp",
      "viewer": "ImageViewer"
    },
    {
      "ext": "mp3,ogg,wma,flac",
      "viewer": "AudioViewer"
    },
    {
      "ext": "mp4,m4v,webm,avi,mov,flv,wmv",
      "viewer": "VideoViewer"
    }
]

4、主题设置

ShareList提供了多种主题选择，管理员可以根据自己的喜好设定具体的界面风格。

{
  "theme": "win10"  // 具体的主题设置，包括"default","flat","gray","material","win10","osx"等
}