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"等
}