mirror of
https://github.com/fumiama/simple-http-server.git
synced 2026-06-05 00:30:23 +08:00
82 lines
2.4 KiB
Markdown
82 lines
2.4 KiB
Markdown
<div align="center">
|
|
<img src=".github/shinsako.jpg" width = "360" height = "360" alt="Shinsako"><br>
|
|
<h1>simple-http-server</h1>
|
|
A variant of Tinyhttpd.<br><br>
|
|
</div>
|
|
|
|
> Created November 1999 by J. David Blackstone.
|
|
>
|
|
> Optimized June 2021 by Fumiama(源文雨)
|
|
|
|
## Protocol
|
|
A necessary subset of `HTTP 1.0` with following options of request header being supported.
|
|
|
|
### From client
|
|
- Content-Length
|
|
|
|
### From server
|
|
- Content-Length
|
|
- Content-Type (only support text/plain image/x-icon text/css text/html)
|
|
- Server
|
|
|
|
### Code
|
|
- 200 OK
|
|
- 400 BAD REQUEST
|
|
- 403 Forbidden
|
|
- 404 NOT FOUND
|
|
- 500 Internal Server Error
|
|
- 501 Method Not Implemented
|
|
|
|
## Features
|
|
1. Serve files
|
|
2. CGI
|
|
3. Listen on `ipv6`
|
|
4. Listen on unix socket
|
|
5. Multi-thread
|
|
|
|
## Compile
|
|
```bash
|
|
git clone https://github.com/fumiama/simple-http-server.git
|
|
cd simple-http-server
|
|
mkdir build
|
|
cd build
|
|
cmake ..
|
|
make
|
|
make install
|
|
```
|
|
|
|
## Command line usage
|
|
```bash
|
|
simple-http-server [-d] [-h] [-n host.name.com:port] [-p <port|unix socket path>] [-q 16] [-r <rootdir>] [-u <uid>]
|
|
```
|
|
|
|
- **-d**: run as daemon.
|
|
- **-h**: display this help.
|
|
- **-n**: check hostname and port.
|
|
- **-p**: if not set, we will choose a random port.
|
|
- **-q**: listen queue length (defalut is 16).
|
|
- **-r**: http root dir.
|
|
- **-u**: run as this uid.
|
|
|
|
## CGI usage
|
|
When you put an executable file into the web path, the server will call `execl` to run it while passing 3 parameters as below
|
|
|
|
```c
|
|
argv[0] = path; //Path of the executable file
|
|
argv[1] = method; //request method (GET/POST)
|
|
argv[2] = query_string; //the query string, like "a=1&b=2&c=3"
|
|
```
|
|
|
|
The server will read a `4 bytes` unsigned integer from pipe, indicating the `length` of the remaining content. Then it will send `length` bytes of data to the client directly with nothing being decorated, which means that you need to assemble the HTTP header by yourself. After all writings, please wait the server write `CGIFINRECV` to your `stdin`, showing that the server has read all data you send, then it is safe to exit.
|
|
|
|
Here is a CGI example [CMoe-Counter](https://github.com/fumiama/CMoe-Counter)
|
|
|
|
And its realization is here:
|
|
|
|
<div align=center> <a href="#"> <img src="https://counter.seku.su/cmoe?name=shttps&theme=gb" /> </a> </div>
|
|
|
|
## Appendix
|
|
### 4096 Threads Pressure Test Video
|
|
|
|
https://user-images.githubusercontent.com/41315874/223675866-3536d0ba-3400-46f4-9431-795f133cb94b.mp4
|