updated readme

This commit is contained in:
Ali Bagheri 2023-04-27 21:32:27 +03:30
parent 48894b940b
commit b505eba943
1 changed files with 72 additions and 0 deletions

View File

@ -1,11 +1,83 @@
# ifconfig.io
[![Build Status](https://drone.io/github.com/georgyo/ifconfig.io/status.png)](https://drone.io/github.com/georgyo/ifconfig.io/latest)
Inspired by ifconfig.me, but designed for pure speed. A single server can do 18,000 requests per seconds while only consuming 50megs of ram.
# Contents
- [Short Summery](#short-summery)
- [Deployment](#deployment)
- [Docker Compose](#docker-compose)
- [ENVs](#envs)
# Short Summery
I used the gin framework as it does several things to ensure that there are no memory allocations on each request, keeping the GC happy and preventing unnessary allocations.
Tested to handle 10,000 clients doing 90,000 requests persecond on modest hardware with an average response time of 42ms. Easily servicing over 5 million requests in a minute. (Updated June, 2022)
[![LoadTest](http://i.imgur.com/0vJYumD.png)](https://loader.io/reports/f1e9a7dd516ac0472351e5e0c83b0787/results/a055e51ff317cdf8a688b25e9c0e4147#response_details)
# Deployment
You can use the source code directly to deploy your own server. You can also you can use Docker and Docker Compose.
## Docker-Compose
Here is a sample docker-compose file:
``` bash
version: "3.4"
services:
ifconfig:
image: ifconfig.io:latest
ports:
- 8080:8080
```
Some other compose files:
``` bash
version: "3.4"
services:
ifconfig:
image: ifconfig.io:latest
ports:
- 8080:8080
environment:
HOSTNAME: "ifconfig.io"
```
``` bash
version: "3.4"
services:
ifconfig:
image: ifconfig.io:latest
ports:
- 8080:8080
env_file:
- ./.env
```
## ENVs
This project offers you some customizability over what you show to user and ect. Here is list of all possible environment variable that you can pass to your instance, with their default values.
``` bash
HOSTNAME="ifconfig.io" # Text address shown to user at header
CMD_PROTOCOL="" # Request protocol for curl commands
HOST=""
PORT="8080"
PROXY_PROTOCOL_ADDR=""
FORWARD_IP_HEADER="CF-Connecting-IP" # Request header to get IP from
COUNTRY_CODE_HEADER="CF-IPCountry" # Request header to get country code from
TLS="0"
TLSPORT="8443"
TLSCERT="/opt/ifconfig/.cf/ifconfig.io.crt"
TLSKEY="/opt/ifconfig/.cf/ifconfig.io.key"
```