2016-10-09 13:55:47 +08:00
|
|
|
|
|
|
|
# file-manager
|
|
|
|
|
|
|
|
A basic node.js file manager.
|
|
|
|
|
|
|
|
## Features
|
|
|
|
|
2016-10-09 14:10:38 +08:00
|
|
|
- [x] [Simple authentication](https://github.com/ambrosechua/file-manager#key)
|
2016-10-09 13:55:47 +08:00
|
|
|
- [x] Directory browsing
|
|
|
|
- [x] Filesize
|
|
|
|
- [ ] Permissions
|
|
|
|
- [ ] Owner
|
|
|
|
- [x] Folder creation
|
|
|
|
- [x] File uploads
|
|
|
|
- [ ] Bulk file uploads
|
|
|
|
- [ ] File/folder renaming
|
|
|
|
- [x] Bulk file/folder selection
|
|
|
|
- [x] Delete
|
2016-10-09 14:25:45 +08:00
|
|
|
- [ ] Recursive directory delete
|
2016-10-09 14:43:58 +08:00
|
|
|
- [ ] Move
|
|
|
|
- [ ] Copy
|
2016-10-09 13:55:47 +08:00
|
|
|
- [x] Download archive
|
|
|
|
- [ ] Change permissions
|
2016-10-09 14:10:38 +08:00
|
|
|
|
|
|
|
## Screenshots
|
|
|
|
|
2016-10-09 20:29:40 +08:00
|
|
|
![](https://ambrose.makerforce.io/file-manager/login1.png)
|
2016-10-09 14:10:38 +08:00
|
|
|
|
|
|
|
![](https://ambrose.makerforce.io/file-manager/upl2.png)
|
|
|
|
|
|
|
|
![](https://ambrose.makerforce.io/file-manager/ls1.png)
|
|
|
|
|
|
|
|
![](https://ambrose.makerforce.io/file-manager/rm1.png)
|
|
|
|
|
|
|
|
![](https://ambrose.makerforce.io/file-manager/dl1.png)
|
2016-10-09 13:55:47 +08:00
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
```zsh
|
|
|
|
git clone https://github.com/ambrosechua/file-manager.git ~/path/to/file-manager
|
|
|
|
node ~/path/to/file-manager/index.js
|
|
|
|
# or
|
|
|
|
npm i -g https://github.com/ambrosechua/file-manager.git
|
|
|
|
file-manager
|
|
|
|
```
|
|
|
|
|
|
|
|
## Options
|
|
|
|
|
|
|
|
Options are currently only suppliable via ENV variables.
|
|
|
|
|
2016-10-09 14:10:38 +08:00
|
|
|
### PORT=
|
2016-10-09 13:55:47 +08:00
|
|
|
|
2016-10-09 14:10:38 +08:00
|
|
|
Listen on $PORT. Default: 8080
|
2016-10-09 13:55:47 +08:00
|
|
|
|
2016-10-09 14:10:38 +08:00
|
|
|
### KEY=
|
2016-10-09 13:55:47 +08:00
|
|
|
|
|
|
|
Setting this variable enables authentication using
|
2016-10-09 14:10:38 +08:00
|
|
|
TOTP (RFC6238). $KEY is a base32 encoded shared
|
2016-10-09 13:55:47 +08:00
|
|
|
secret. This key is only a weak means of protection
|
|
|
|
as it is succeptable to brute-force. You can generate
|
|
|
|
one from [here](http://www.xanxys.net/totp/) or manually.
|