Neutrinos Peludos Magnéticos
    Wondering what’s next for npm?Check out our public roadmap! »


    0.1.0 • Public • Published


    enter image description here

    Harpoon is a file send server written in Javascript using NodeJS & Express.


    • Session Clustering
    • Server Health Data
    • Server Clustering
    • Worker Threading
    • Lag Overload Prevention
    • Session Caching
    • Session Security
    • Bot Detection
    • Spider Detection
    • Throttle Resources
    • Resource Caching
    • Anti-Leeching
    • Anti-Query Scanning
    • Prevents SQL Injections
    • Throttles Requests
    • QoS Uptime
    • Request Logging


    Using Git:

    git clone
    cd harpoon
    npm install

    Using NPM:

    npm install harpoon -g

    Once installed run


    Now visit in your web browser!


    Harpoon allows you to configure and load your own settings using a config.js file located in your file send servers main directory. But before you do that navigate to the directly where you wish to run harpoon from then make a folder called files. All content is served from within the files directory.

    For example: If you installed harpoon and wish to run it from /var/www/harpoon you would add /var/www/harpoon/config.js and /var/www/harpoon/files/

    For an example configuration see the config.js distributed with this source.

    IMPORTANT: Be sure to create your own unique serverSecret phrase in your configuration file.


    • rfcname - the RFC server name
    • localip - the local ip of the box (this is generally your publicly exposed ip)
    • hosts - the hostnames & ip associated with your server
    • peers - the harpoon peer servers if clustering
    • filesDirectory - the directory to serve files from
    • port - the port in which the file send server runs on
    • maxLag - the maximum lag the server will allow before stopping new sends
    • serverSecret - a hash that is unique to your server
    • logging - enable or disable logging (true,false)
    • basekbps - base send speed in kbps
    • burstkbps - burst speed in kbps during file sends
    • exts - array of extensions to allow file sends for
    • picture - the default image to show when a file is missing


    By default harpoon comes with basic statistic information which can be viewed by visiting /ping and /status with the server running. Both of which return a JSON array of data pertaining to the server session and host computer.


    Harpoon is made to replace existing file send servers such as nginx or litespeed. In our tests (data not yet available) we have noticed roughly a 2 - 4x speed increase and 2-4x cpu load decrease over nginx. Harpoon is open-source via the MIT license we encourage Forking.




    npm i harpoon-server

    DownloadsWeekly Downloads






    Last publish


    • avatar