Skip to content

sq3/file_server

 
 

Repository files navigation

Portable filebrowser with html5 mobile ui.

TL;DR

Portable file server throught http. Uses:

  • Share videos/audios on your local network.
  • Expose docker volumes to http.
  • Share private server folders online

Run with docker:

docker run --rm -v /home/jordi:/tmp -p 8080:8080 jordic/file_server:1.0

without docker:

wget https://github.com/jordic/file_server/blob/master/builds/file_server_linux_amd64?raw=true
chmod +x file_server_linux_amd64
./file_server_linux_amd64 -dir $HOME  

with systemd: place the file-server.service file in /etc/systemd/system

run systemctl start file-server to start file server on port 8080

run systemctl enable file-server to start fileserver on boot

The docker image, can receive env variables:

FILESERVER_AUTH = username:password for handling basic auth

FILESERVER_COMMAND = allow running shell commands from the UI

FILESERVER_DIR = dir to expose

FILESERVER_PORT = port for the service

Features

  • Mobile UI with almost all "usable displays", android and ios ( on ios, can't upload files)
  • Fast UI. Json + angular
  • Directory fuzzy search / Acces ( style textmate command+T)
  • Inline search ( current list )
  • Upload mutliple files.
  • Big uploads. Tested with 5G files. ( Uploads are streamed to disk )
  • File delete / remove / copy / compress
  • Dir creation
  • File editor with Codemirror ( javascript, html, css, php.. )
  • Filesystem json server
    • POST /dir action=createFolder source=name > Will create a folder in dir with name source
    • POST /dir action=delete source=name > will delete ... see commands.go
    • GET /dir &format=json
  • Download dirs as zip
  • File and video stream.
  • Basic http auth as param
  • Exec system commands ( enable with param )

screenshot

Install

Donwload a binary build: (Stable)

Or compile it:

go get github.com/jordic/file_server

go build or go install

Browser compatibility

  • Firefox, safari, Chrome.
  • Perpahs ie10 but not tested
@Todo
  • Add some type of flahs session, to notify user after an upload
  • Add the current path, and a direct acces to parent path
  • Add file operations, like delete, move or compress zip files..
  • Big code refactor to milestone 1.0.
  • Improbe filesystem json server.
  • Backend. Add system commands as plugin.. with System services or commands The commands must be, system commands, and should be configured, on json. App, only loads them, and handles execution of them
  • Create docs
  • UI. Add a Generic command with output ( Perhaps a modal )
  • UI. Improve javascript prompt, with some kind of widget

  • UI. Add a button on toolbar, with shortcuts to system commands

  • UI/Backend. Add a bookmark system. Perhaps a file .bookmark.js on root.

  • Back. Add param for CORS handling

  • Back. Add some kind of authentification
  • Back. Add some kind of permisions...
  • Back. Review log system.
Changelog
v1.0
  • Updated go-bindata
  • Added Dockerfile
  • Added env variables for handling docker config
  • Updated docs
v0.9
  • Big refactor using Angular for frontend and api calls for actions
v0.5
  • Added version number
  • File deleting operations

About

Portable filebrowser with mobile ui ( html5 + go )

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 85.2%
  • CSS 12.7%
  • Go 1.4%
  • Other 0.7%