1
0
mirror of https://github.com/falk-werner/webfuse synced 2024-10-27 20:34:10 +00:00
falk-werner_webfuse/doc/webfuse.md

3.7 KiB

webfuse command line options

In order to inject a remote filesystem, webfuse mounts a local filesystem via fuse and exposes it's API via websockets.

Usage

webfuse [options] <mountpoint>

Webfuse specific options

Option Argument Default Description
--wf-port port 8081 Specify the port of the websocket server
--wf-vhost vhost localhost Specify the name of the websocket server's virtual host
--wf-cert path - Optional. Specify the file path of the server's public certificate
--wf-key path - Optional. Specify the file path of the server's private key
--wf-authenticator path - Optional. Specify the file path of the authenticator executable
--wf-auth-header name - Optional. Specify the name of the HTTP header used for authentication
--wf-docroot path - Optional. Enabled HTTP server with given document root.
--wf-timeout timeout 10 Optional. Specify the communication timeout.
--wf-version - - Print version and exit.

Note: All paths must be absolute (this might be relaxed if future versions).

Fuse options

Option Descripion
-h, --help print help
-V --version print version
-d -o debug enable debug output (implies -f)
-f foreground operation
-s disable multi-threaded operation
-o clone_fd use separate fuse device fd for each thread
(may improve performance)
-o max_idle_threads the maximum number of idle worker threads
allowed (default: 10)
-o kernel_cache cache files in kernel
-o [no]auto_cache enable caching based on modification times (off)
-o umask=M set file permissions (octal)
-o uid=N set file owner
-o gid=N set file group
-o entry_timeout=T cache timeout for names (1.0s)
-o negative_timeout=T cache timeout for deleted names (0.0s)
-o attr_timeout=T cache timeout for attributes (1.0s)
-o ac_attr_timeout=T auto cache timeout for attributes (attr_timeout)
-o noforget never forget cached inodes
-o remember=T remember cached inodes for T seconds (0s)
-o modules=M1[:M2...] names of modules to push onto filesystem stack
-o allow_other allow access by all users
-o allow_root allow access by root
-o auto_unmount auto unmount on process termination

Options for subdir module

Option Descripion
-o subdir=DIR prepend this directory to all paths (mandatory)
-o [no]rellinks transform absolute symlinks to relative

Options for iconv module

Option Descripion
-o from_code=CHARSET original encoding of file names (default: UTF-8)
-o to_code=CHARSET new encoding of the file names (default: UTF-8)

Examples

  • run webfuse in foreground on default port:
    webfuse -f /path/to/mointpoint
  • run webfuse in forground on port 8080:
    webfuse -f --wf-port 8080 /path/to/mountpoint
  • run webfuse using TLS:
    webfuse -f --wf-cert /path/to/cert --wf-key /path/to/key /path/to/mountpoint
  • run webfuse using authentication via X-Auth-Token header:
    webfuse -f --wf-authenticator /path/to/authenticator \
    --wf-auth-header X-Auth-Token /path/to/mountpoint