linx-server/README.md

linx-server

Self-hosted file/media sharing website.

Features

• Display common filetypes (image, video, audio, markdown, pdf)
• Display syntax-highlighted code with in-place editing
• Documented API with keys if need to restrict uploads (can use linx-client for uploading through command-line)
• Torrent download of files using web seeding
• File expiry, deletion key, and random filename options

Screenshots

Get release and run

1. Grab the latest binary from the releases
2. Run ./linx-server...

Usage

Common options

• -bind 127.0.0.1:8080 -- what to bind to (default is 127.0.0.1:8080)
• -sitename myLinx -- the site name displayed on top (default is linx)
• -siteurl "http://mylinx.example.org/" -- the site url (for generating links)
• -filespath files/" -- Path to store uploads (default is files/)
• -metapath meta/ -- Path to store information about uploads (default is meta/)
• -maxsize 4294967296 maximum upload file size in bytes (default 4GB)
• -contentsecuritypolicy "..." -- Content-Security-Policy header for pages (default is "default-src 'self'; img-src 'self' data:; style-src 'self' 'unsafe-inline'; referrer origin;")
• -filecontentsecuritypolicy "..." -- Content-Security-Policy header for files (default is "default-src 'none'; img-src 'self'; object-src 'self'; media-src 'self'; sandbox; referrer origin;"")
• -xframeoptions "..." -- X-Frame-Options header (default is "SAMEORIGIN")
• -remoteuploads -- (optionally) enable remote uploads (/upload?url=https://...)
• -nologs -- (optionally) disable request logs in stdout

SSL with built-in server

• -certfile path/to/your.crt -- Path to the ssl certificate (required if you want to use the https server)
• -keyfile path/to/your.key -- Path to the ssl key (required if you want to use the https server)

Use with http proxy

• -realip -- let linx-server know you (nginx, etc) are providing the X-Real-IP and/or X-Forwarded-For headers.

Use with fastcgi

• -fastcgi -- serve through fastcgi

Require API Keys for uploads

• -authfile path/to/authfile -- (optionally) require authorization for upload/delete by providing a newline-separated file of scrypted auth keys
• -remoteauthfile path/to/remoteauthfile -- (optionally) require authorization for remote uploads by providing a newline-separated file of scrypted auth keys

A helper utility linx-genkey is provided which hashes keys to the format required in the auth files.

Deployment

1. Using fastcgi

A suggested deployment is running nginx in front of linx-server serving through fastcgi. This allows you to have nginx handle the TLS termination for example.
An example configuration:

server {
    ...
    server_name yourlinx.example.org;
    ...
    
    client_max_body_size 4096M;
    location / {
        fastcgi_pass 127.0.0.1:8080;
        include fastcgi_params;
    }
}

And run linx-server with the -fastcgi option.

2. Using the built-in https server

Run linx-server with the -certfile path/to/cert.file and -keyfile path/to/key.file options.

3. Using the built-in http server

Run linx-server normally.

Development

Any help is welcome, PRs will be reviewed and merged accordingly.
The official IRC channel is #linx on irc.oftc.net

1. go get -u github.com/andreimarcu/linx-server
2. cd $GOPATH/src/github.com/andreimarcu/linx-server
3. go build && ./linx-server

License

Copyright (C) 2015 Andrei Marcu

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Author

Andrei Marcu, http://andreim.net/