{"id":49077531,"url":"https://github.com/s00inx/goserver","last_synced_at":"2026-04-20T10:34:33.133Z","repository":{"id":339771812,"uuid":"1158655842","full_name":"s00inx/goserver","owner":"s00inx","description":"high-performance HTTP Web server using Linux epoll API and raw syscalls.","archived":false,"fork":false,"pushed_at":"2026-04-17T15:19:54.000Z","size":113,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-17T17:28:56.061Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/s00inx.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-15T18:08:27.000Z","updated_at":"2026-04-17T15:21:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/s00inx/goserver","commit_stats":null,"previous_names":["s00inx/goserver"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/s00inx/goserver","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s00inx%2Fgoserver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s00inx%2Fgoserver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s00inx%2Fgoserver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s00inx%2Fgoserver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/s00inx","download_url":"https://codeload.github.com/s00inx/goserver/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s00inx%2Fgoserver/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32043176,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T10:33:29.490Z","status":"ssl_error","status_checked_at":"2026-04-20T10:32:30.107Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2026-04-20T10:34:31.109Z","updated_at":"2026-04-20T10:34:33.121Z","avatar_url":"https://github.com/s00inx.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# goserver\ngoserver — это реализация HTTP-сервера с нуля (без использования стандартной библиотеки `net/http`). \nПроект создавался как образовательный: мне хотелось спуститься на уровень ниже и на практике разобраться, как работают сетевые сокеты, событийные циклы (event loops) и как писать код с минимальным влиянием на Garbage Collector.\n\n### Что было реализовано и изучено\nОсновной фокус в разработке был сделан на производительность и оптимизацию потребления памяти.\n\n* **Свой Event Loop на epoll:** Отказался от стандартной модели \"горутина на каждое соединение\". Реализовал асинхронную обработку соединений через системные вызовы Linux (`epoll`), чтобы понять, как серверы держат тысячи подключений.\n* **Минимизация аллокаций (Zero-Allocation Hot Path):** Жизненный цикл HTTP-запроса спроектирован так, чтобы не выделять память в куче (heap). Для этого активно используется `sync.Pool` и переиспользование байтовых буферов.\n* **No-Copy парсинг:** Чтение заголовков и роутинг работают напрямую с индексами в сыром `[]byte`. Я избегал конвертации срезов в `string` без крайней необходимости, чтобы не копировать данные в памяти.\n* **Оптимизация конкурентности:** При управлении состоянием соединений постарался уйти от \"тяжелых\" блокировок (`sync.Mutex`), заменив их на атомарные операции (`sync/atomic`). Это заметно снизило contention (борьбу за ресурсы) при тестировании на многоядерном процессоре.\n* **Профилирование:** В процессе разработки активно использовал `pprof` (CPU и Heap профили), чтобы находить узкие места в парсере и устранять лишние выделения памяти.\n\n### Технический стек\n* **Язык**: Go (с использованием пакета `unsafe` для конвертаций без копирования).\n* **ОС**: Только Linux (так как ядро сети завязано на Linux syscalls).\n\n### Результаты (Бенчмарки)\nСервер тестировался на машине с Intel Core Ultra 5 125H (18 потоков) с помощью `wrk`.\n\n* **Пропускная способность**: ~980k RPS.\n* **Latency**: Среднее время отклика ~1.13 мс.\n* **Память**: 0 B/op на горячем пути (подтверждено Go-бенчмарками `Benchmark_... -benchmem`).\n\n\u003e **Важное примечание:** Проект является пет-проектом для глубокого изучения языка и системного программирования. В угоду производительности и простоты экспериментов здесь опущены некоторые проверки безопасности (например, таймауты медленных клиентов) и кроссплатформенность, обязательные для production-решений.\n\n### Запуск и тестирование\n*(Требуется Linux или WSL)*\n```bash\nmake run        # Запуск сервера\nmake bmem       # Запуск внутренних бенчмарков памяти\nmake testwrk    # Нагрузочное тестирование (потребуется утилита wrk)\n```\n\n### Пример использования\n```go\nfunc main() {\n    srv := server.New()\n\n    // Определение роутов\n    api := srv.Group(\"/api/v1\")\n    api.Get(\"/hello\", func(c *server.Context) {\n        c.String(200, \"Hello World\")\n    })\n\n    // Парсинг IP пока реализован на низком уровне массивом байт\n    srv.Run([4]byte{127, 0, 0, 1}, 8080)\n}\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fs00inx%2Fgoserver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fs00inx%2Fgoserver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fs00inx%2Fgoserver/lists"}