ammarkov / ammarserver Goto Github PK

A lightweight http server for linux

License: Other

CMake 2.65% Shell 6.39% HTML 14.90% CSS 1.52% C 55.93% C++ 12.83% JavaScript 1.24% Makefile 3.82% M4 0.08% Roff 0.38% Gnuplot 0.10% Python 0.16%

cmake c mytube myurl 4chan linux myloader http-server fast low-latency low-level low-power httpd url-shortener remote-desktop youtube-clone blog-engine embedded

ammarserver's Introduction

AmmarServer

A lightweight extendable barebones HTTP server for linux

Please see the wiki for more info on whats going on in this repository : ) https://github.com/AmmarkoV/AmmarServer/wiki

This repository is also tracked via OpenHub https://www.openhub.net/p/AmmarServer

One of the most basic philosophies behind this is to try to add as much functionality possible in a reusable way WITHOUT overly increasing loc and dependencies.. The biggest recent improvements have been actually trying to merge common functionality and reducing loc.

Building

The projects build dependencies are the gcc compiler , pthreads , cmake and pretty basic things so if you issue sudo apt-get install cmake build-essential ( assuming a Debian/Ubuntu based system ) you should be able to compile it without problems..

Compression is supported , so you might want to also apt-get install liblzma-dev if you ENABLE_COMPRESSION at server_configuration.h MyURL Service needs libjpeg in order to serve captchas , so to add it sudo apt-get install libjpeg-dev

To perform a compilation you just need to issue "mkdir build && cd build && cmake .. && make" from the root directory

This should try to compile all of the project files which you can then run using the scripts listed in the list below

To update your version of the project you can use the provided script that updates directly from github It will remove any changes you have made to any of the files in the repository
./update_from_git from the root directory

Running

After building the server you can use one of the provided scripts in the root directory

./run_ammarserver will start a basic file server ( serving public_html/ files ) on localhost:8080
./run_myblog will start a small Wordpress like blog service on localhost:8086
./run_social will start a small Social chat service on localhost:8087
./run_myloader will start a file upload service on localhost:8085
./run_mytube will start a youtube like service on localhost:8084 , you will need to change the VIDEO_FILES_PATHS paths and recompile
./run_myurl will start a url shortner service (like tinyurl/goo.gl etc ) on localhost:8082
./run_habchan will start a small 4chan clone on localhost:8083
./run_geoposshare will start a GPS location server on localhost:8081 to track mobile phones ( see this Android Application )
./run_myremotedesktop will start a remote desktop session viewable by a browser on localhost:8080 ( see video )
./run_mysearch will start a server that serves a google like front page ( that does no searching though and is only cosmetic ;P ) on localhost:8080
./startAmmarServerSuite.sh will start most of these simultaneously ( except remote desktop ) so you can try them out..
./stopAmmarServerSuite.sh will stop them

Installing

Install scripts are provided ( ./install.sh and ./uninstall.sh ) but at the moment they only provide the "vanilla" file static server. Until sufficient testing has been done it is not advisable to use this in a production enviornment..

Features

This Repository contains :

The AmmarServer library with which you can build your own highly optimized and fully customizable web service..
A template for starting to build your own webserver which is very well documented https://github.com/AmmarkoV/AmmarServer/blob/master/src/Services/SimpleTemplate/main.c You can run it by issuing ./run_simpleTemplate from root directory
A simple (but extensible) webserver demo showcasing some dynamic pages https://github.com/AmmarkoV/AmmarServer/blob/master/src/Services/main.c You can run it by issuing ./run_ammarserver from root directory
A URL Shortner service like tinyurl , bitly , goo.gl etc.. https://github.com/AmmarkoV/AmmarServer/tree/master/src/Services/MyURL/ You can run it by issuing ./run_myurl from root directory
A File Uploader service based on MyLoader https://github.com/AmmarkoV/AmmarServer/tree/master/src/Services/MyLoader/ You can run it by issuing ./run_myloader from root directory
A Web Service that allows location sharing .. https://github.com/AmmarkoV/AmmarServer/tree/master/src/Services/GeoPosShare/ You can run it by issuing ./run_geoposshare from root directory
A Remote Desktop Sharing Web Service that allows controlling your linux desktop through a web browser .. https://github.com/AmmarkoV/AmmarServer/tree/master/src/Services/MyRemoteDesktop/ You can run it by issuing ./run_myremotedesktop from root directory
A Youtube like clone .. https://github.com/AmmarkoV/AmmarServer/tree/master/src/Services/MyTube/ You can run it by issuing ./run_mytube from root directory
A Blog engine that can use Wordpress skins.. https://github.com/AmmarkoV/AmmarServer/tree/master/src/Services/MyBlog/ You can run it by issuing ./run_myblog from root directory
A 4chan like engine for hosting a small image board , currently under construction.. https://github.com/AmmarkoV/AmmarServer/tree/master/src/Services/HabChan/ You can run it by issuing ./run_habchan from root directory

AmmarServer is also an integral part , providing network connectivity and used in the following projects :

This project has also been successfully deployed as a means to control embedded platforms like Robots

ammarserver's People

Contributors

Stargazers

Watchers

Forkers

bstrds killvxk riztazz ajunlonglive sitedata

ammarserver's Issues

Add POST files implementation

Add a SIGTERM handler for smooth socket closing...

Add a client request dispatcher

If we have multiple AmmarServers running on different machines , it would be cool to have a primary AmmarServer that is always on and redirects requests ( like a reverse proxy ) to load balance the other servers..

The same goes for high availiability content , we could create two different instances of the server redirect to the second one , recompile the first one and then change the dispatcher to have no downtime ..

Implement Range Requests ( Resume file download capability )

Add configuration file ammServ.conf parsing..

Just as a tool to help with setting up and quickly configuring the webserver without having to recompile the whole binary..

Improve implemented file caching mechanism

Use merge sort and binary search instead of brute force searching..
Add string comparison to make code hash collision free

Dynamic Requests should double buffer shared content

Dynamic requests wait for a callback to complete and then send back the content for shared content with a callback cooldown , I should implement double buffering of content to make sure that they get serviced instantly instead of blocking the requests until the new content is ready..!

https://github.com/AmmarkoV/AmmarServer/blob/master/src/AmmServerlib/cache/dynamic_requests.c#L16

Improve directory listings ( add filesizes , dates etc )

Add sort ( by name , date ) functionality , a potential search field for files inside the directory or other UI goodies on directory listing generated sites..

MyURL is susceptible to CSRF

MyURL -> http://domain.com/index.html

Is susceptible to Cross-Site Request Forgery. A csrf canary needs to be added to prevent this.
POC:

Dynamic Request not handled properly

One one occasion the
./stats.html request got handled using the file ./stats.html instead of the dynamic request handle ..
this needs to be investigated..

When restarting AmmarServer it worked ok ..

HTTPS Support..

Implement http://en.wikipedia.org/wiki/HTTP_Secure , maybe in the future..!

Change the project name

I don't like "AmmarServer" as a webserver's name.

You should try something different. What do you say about "MasterServer", "MonsterServer" or something like that?

HTTP 2.0 Support ?

HTTP 2.0 Specs are out , although AmmarServer does not even comply fully with HTTP 1.1 xD
This is a todo note here ..
https://http2.github.io/

Deep Pentesting.. To find any expoits that may exist..

Given enough eyeballs , all bugs are shallow..
Since I only have 2 eyeballs I will have to pentest the S*#t out of the server to find any bugs lurking in the codebase ..

Add Apache like logging capabilities

AmmarServer should mimic the way apache logs visits in order for log analyzing programs that are compatible with apache to be compatible with ammarserver too..
Logs should also be FlashDisk friendly so there could be some kind of internal memory to hold them and maybe compress them before writing them on the disk.. , or writing them after an interval and not on each visit..

For now this is a first way to prepare buffers to be served to clients , there needs to be a proper implementation of the inject mechanism that will auto reallocate memory buffers etc

https://github.com/AmmarkoV/AmmarServer/blob/master/src/AmmServerlib/AString/AString.c#L196

any ideas are also welcome