{"id":17156523,"url":"https://github.com/savsgio/kratgo","last_synced_at":"2025-10-25T01:07:32.394Z","repository":{"id":36078899,"uuid":"169068792","full_name":"savsgio/kratgo","owner":"savsgio","description":"Simple, lightweight and ultra-fast HTTP Cache to speed up your websites","archived":false,"fork":false,"pushed_at":"2023-03-17T16:08:26.000Z","size":235,"stargazers_count":64,"open_issues_count":0,"forks_count":7,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-10-15T22:06:40.598Z","etag":null,"topics":["caching","fasthttp-cache","high-performance","http","http-cache","lightweight-cache"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/savsgio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-02-04T11:30:28.000Z","updated_at":"2024-10-10T11:45:09.000Z","dependencies_parsed_at":"2024-06-20T11:11:10.792Z","dependency_job_id":"eae25754-a03c-45b5-8059-3db9615f9137","html_url":"https://github.com/savsgio/kratgo","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/savsgio%2Fkratgo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/savsgio%2Fkratgo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/savsgio%2Fkratgo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/savsgio%2Fkratgo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/savsgio","download_url":"https://codeload.github.com/savsgio/kratgo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221832331,"owners_count":16888216,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["caching","fasthttp-cache","high-performance","http","http-cache","lightweight-cache"],"created_at":"2024-10-14T22:06:42.068Z","updated_at":"2025-10-25T01:07:27.364Z","avatar_url":"https://github.com/savsgio.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"Kratgo\n======\n\n[![Test status](https://github.com/savsgio/kratgo/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/savsgio/kratgo/actions?workflow=test)\n[![Go Report Card](https://goreportcard.com/badge/github.com/savsgio/kratgo)](https://goreportcard.com/report/github.com/savsgio/kratgo)\n[![GitHub release](https://img.shields.io/github/release/savsgio/kratgo.svg)](https://github.com/savsgio/kratgo/releases)\n[![Docker](https://img.shields.io/docker/automated/savsgio/kratgo.svg?colorB=blue\u0026style=flat)](https://hub.docker.com/r/savsgio/kratgo)\n\u003c!-- [![GoDoc](https://godoc.org/github.com/savsgio/kratgo?status.svg)](https://godoc.org/github.com/savsgio/kratgo) --\u003e\n\nSimple, lightweight and ultra-fast HTTP Cache to speed up your websites.\n\n\n### Requirements\n\n- [Go](https://golang.org/dl/) \u003e= 1.20.X\n- make\n- git\n\n\n## Features:\n\n- Cache proxy.\n- Load balancing beetwen backends.\n- Cache invalidation via API (Admin).\n- Configuration to non-cache certain requests.\n- Configuration to set or unset headers on especific requests.\n\n## General\n\nTo known if request pass across Kratgo Cache in backend servers, check the request header `X-Kratgo-Cache` with value `true`.\n\n\n## Install\n\nClone the repository:\n\n```bash\ngit clone https://github.com/savsgio/kratgo.git \u0026\u0026 cd kratgo\n```\n\nand execute:\n\n```bash\nmake\nmake install\n```\n\nThe binary file will install in `/usr/local/bin/kratgo` and configuration file in `/etc/kratgo/kratgo.conf.yml`\n\n\n## Cache invalidation (Admin)\n\nThe cache invalidation is available via API. The API's address is configured in ***admin*** section of the configuration file.\n\nThis API only accepts ***POST*** requests with ***json***, under the path `/invalidate/`.\n\nEx: `http://localhost:6082/invalidate/`\n\nThe complete json body must be as following example:\n\n```json\n{\n\t\"host\": \"www.example.com\",\n\t\"path\": \"/es/\",\n\t\"header\": {\n\t\t\"key\": \"Content-Type\",\n\t\t\"value\": \"text/plain; charset=utf-8\"\n\t}\n}\n```\n\n**IMPORTANT: All fields are optional, but at least you must specify one.**\n\nAll invalidations will process by workers in Kratgo. You can configure the maximum available workers in the configuration.\n\nThe workers are activated only when necessary.\n\n\n## Docker\n\nThe docker image is available in Docker Hub: [savsgio/kratgo](https://hub.docker.com/r/savsgio/kratgo)\n\nGet a basic configuration from [here](https://github.com/savsgio/kratgo/blob/master/config/kratgo.conf.yml) and customize it.\n\nRun with:\n\n```bash\ndocker run --rm --name kratgo -it -v \u003cVOLUME WITH CONFIG\u003e -p 6081:6081 -p 6082:6082 savsgio/kratgo -config \u003cCONFIG FILE PATH IN THE VOLUME\u003e\n```\n\n## Developers\n\nCopy configuration file `./config/kratgo.conf.yml` to `./config/kratgo-dev.conf.yml`, and customize it.\n\nRun with:\n\n```bash\nmake run\n```\n\nContributing\n------------\n\n**Feel free to contribute it or fork me...** :wink:\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsavsgio%2Fkratgo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsavsgio%2Fkratgo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsavsgio%2Fkratgo/lists"}