idrisdose/node-sharex-server

ShareX server for files (images etc.), text (soon) and urls (soon)

node-sharex-server

• What is this
• Installation
• Configuration
• ShareX client configuration
• License

What is this

node-sharex-server is a ShareX upload server which is easy to setup and to use. Currently node-sharex-server provides the following features:

• File-sharing:
  • Uploading files (also images)
  • Allowing only configured file extensions (for more safety)

Installation

NOTE: You need git (to clone this repo) and nodejs (with npm) to run this program.
First we have to clone this repo. You can do that by typing git clone [email protected]:Moquo/node-sharex-server.git (for ssh) or git clone https://github.com/Moquo/node-sharex-server.git (for https). After going into the directory, we have to install the dependencies. Type npm install to do so. You can start node-sharex-server now by typing node app.js. You could use e.g. pm2 to run node-sharex-server in the background. Environment variables:

• PORT: The port which is used by the web server

Configuration

NOTE: To make changes effective, you have to restart the server!
You can configure the server in the config.json file. Options:

• keys: You can add keys (authentication tokens) here.
• fileSizeLimit: You can set the file size limit (in bytes) here. Example: You want to set the limit to 100 mb. That means we have to change the value to 100 (MB) * 1024 (kB) * 1024 (B) = 104857600 (B).
• fileNameLength: The length of the generated file names.
• serverUrl: The url where you can reach the server without the finalizing slash (/).
• fileExtensionCheck: Check the extension of uploaded files
  • enabled: Is this feature enabled?
  • extensionsAllowed: The extensions which are whitelisted (if the feature is enabled).

ShareX client configuration

NOTE: Replace UPLOADER_NAME, SERVER_URL and YOUR_KEY with your own values!

{
    "Name": "UPLOADER_NAME",
    "DestinationType": "ImageUploader, FileUploader",
    "RequestType": "POST",
    "RequestURL": "SERVER_URL/upload",
    "FileFormName": "file",
    "Arguments": {
        "key": "YOUR_KEY"
    },
    "ResponseType": "Text",
    "URL": "$json:file.url$",
    "ThumbnailURL": "",
    "DeletionURL": "$json:file.delete_url$"
}

License

MIT