Gitinn Accueil Explorer Aide
S'inscrire Connexion
u27099
/
httpsify
miroir de https://github.com/alash3al/httpsify.git
1
0
Fork 0
Fichiers Tickets 0 Wiki
Aborescence: 14de2427b1
Branches Tags
httpsify
/
README.md.v1

README.md.v1 2.0 KB
Historique Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051 
  1. # Intro
    2. 

  2. A transparent HTTPS proxy with automatic certificate renewal
    3. 

  3. using https://letsencrypt.org/
    4. 

  4. 

  5. # How it works ?
    6. 

  6. httpsify is a https reverse proxy ...
    7. 

  7. [https request] --> httpsify --> [apache/nginx/nodejs/... etc]
    8. 

  8. but this isn't the point because there are many https offloaders,
    9. 

  9. but httpsify uses letsencrypt (https://letsencrypt.org/)
    10. 

  10. for automatically generating free and valid ssl certificates, as well as auto renewal of certs,
    11. 

  11. this web server by default uses HTTP/2 .
    12. 

  12. you can say that httpsify is just a http/2 & letsencrypt wrapper for any http web server with no hassle, it just works .
    13. 

  13. 

  14. # Features
    15. 

  15. * SSL Offloader.
    16. 

  16. * HTTP/2 support.
    17. 

  17. * Multi-Core support.
    18. 

  18. * Auto-Renewal for generated certificates.
    19. 

  19. * Blazing fast.
    20. 

  20. * Very light.
    21. 

  21. * Portable and small `~ 2 MB`
    22. 

  22. * No system requirements.
    23. 

  23. * No configurations required, just `httpsify --domains="domain.com,www.domain.com,sub.domain.com"`
    24. 

  24. * Passes `X-Forwarded-*` headers, `X-Real-IP` header and `X-Remote-IP`/`X-Remote-Port` to the backend server.
    25. 

  25. 

  26. # Installation
    27. 

  27. > Currently the only available binaries are built for `linux` `386/amd64` and you can download them from [here](https://github.com/alash3al/httpsify/releases) .  
    28. 

  28. 

  29. # Building from source :
    30. 

  30. * Make sure you have `Golang` installed .
    31. 

  31. * `go get github.com/alash3al/httpsify`.
    32. 

  32. * `go install github.com/alash3al/httpsify`.
    33. 

  33. *  make sure that `$GOPATH/bin` in your `$PATH` .
    34. 

  34. 

  35. # Quick Usage
    36. 

  36. > lets say that you have extracted/built httpsify in the current working directory .
    37. 

  37. ```bash
    38. 

  38. # this is the simplest way to run httpsify
    39. 

  39. # this will run a httpsify instance listening on port 443 and passing the incoming requests to http://localhost
    40. 

  40. # and building valid signed cerificates for the specified domains [they must be valid domain names]
    41. 

  41. ./httpsify --domains="domain.tld,www.domain.tld,another.domain.tld"
    42. 

  42. ```
    43. 

  43. 

  44. # Author
    45. 

  45. I'm [Mohammed Al Ashaal](https://www.alash3al.xyz)
    46. 

  46. 

  47. # Thanks
    48. 

  48. I must thank the following awesome libraries
    49. 

  49. 

  50. * [github.com/xenolf/lego](https://github.com/xenolf/lego)
    51. 

  51. * [github.com/dkumor/acmewrapper](https://github.com/dkumor/acmewrapper)
    52.