pywebfs
Simple Python HTTP(S) File Server
Install
$ pip install pywebfs
Quick start
- start http server sharing current directory listening on 0.0.0.0 port 8080
$ pywebfs -
Browse/Download/Search files using browser
http://<yourserver>:8080 - search text in files (like grep -ri)
features
- Serve static files
- Download folder as zip file
- Quick filter files
- Keyboard navigation using arrows
- Search files by name recursively with multiple word any order
- Search text in files recursively (disable feature with –nosearch)
- Basic Auth support (single user)
- Safe url token Auth
- HTTPS support
- HTTPS self-signed certificate generator
- Display owner/group/permissions (POSIX) (disable feature with –noperm)
- Can be started as a daemon (POSIX)
Customize server
$ pywebfs --dir /mydir --title "my fileserver" --listen 0.0.0.0 --port 8080
$ pywebfs -d /mydir -t "my fileserver" -l 0.0.0.0 -p 8080
Basic auth user/password
$ pywebfs --dir /mydir --user myuser [--password mypass]
$ pywebfs -d /mydir -u myuser [-P mypass]
Generated password is given if no --pasword option
Safe url token auth
$ pywebfs --dir /mydir --tokenurl
$ pywebfs --d /mydir --T
A Token is generated, unless PYWEBFS_TOKEN environment variable is set
HTTPS server
- Generate auto-signed certificate and start https server
$ pywebfs --dir /mydir --gencert $ pywebfs -d /mydir --g - Start https server using existing certificate
$ pywebfs --dir /mydir --cert /pathto/host.cert --key /pathto/host.key $ pywebfs -d /mydir -c /pathto/host.cert -k /pathto/host.key
Launch server as a daemon (Linux)
$ pywebfs start
$ pywebfs status
$ pywebfs stop
- log of server are stored in
~/.pywebfs/pwfs_<listen>:<port>.log
Disclaimer
As built on python http.server, read in the python3 documentation:
Warning http.server is not recommended for production. It only implements basic security checks.