gin

KO | EN

gitlite — search

#python #ai #typescript #golang #go #deep-learning #docker #macos #nodejs #awesome #kubernetes #ios #openai #open-source

(★ 89,076)

Gin은 Go로 작성된 고성능 HTTP 웹 프레임워크입니다. httprouter 덕분에 Martini와 유사한 API를 제공하면서도 최대 40배 더 빠른 성능을 자랑합니다. Gin은 REST API, 웹 애플리케이션 및 마이크로서비스 구축을 위해 설계되었습니다.

gin 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Gin 웹 프레임워크

[![Build Status](https://github.com/gin-gonic/gin/actions/workflows/gin.yml/badge.svg?branch=master)](https://github.com/gin-gonic/gin/actions/workflows/gin.yml)
[![Trivy Security Scan](https://github.com/gin-gonic/gin/actions/workflows/trivy-scan.yml/badge.svg)](https://github.com/gin-gonic/gin/actions/workflows/trivy-scan.yml)
[![codecov](https://codecov.io/gh/gin-gonic/gin/branch/master/graph/badge.svg)](https://codecov.io/gh/gin-gonic/gin)
[![Go Report Card](https://goreportcard.com/badge/github.com/gin-gonic/gin)](https://goreportcard.com/report/github.com/gin-gonic/gin)
[![Go Reference](https://pkg.go.dev/badge/github.com/gin-gonic/gin?status.svg)](https://pkg.go.dev/github.com/gin-gonic/gin?tab=doc)
[![Sourcegraph](https://sourcegraph.com/github.com/gin-gonic/gin/-/badge.svg)](https://sourcegraph.com/github.com/gin-gonic/gin?badge)
[![Open Source Helpers](https://www.codetriage.com/gin-gonic/gin/badges/users.svg)](https://www.codetriage.com/gin-gonic/gin)
[![Release](https://img.shields.io/github/release/gin-gonic/gin.svg?style=flat-square)](https://github.com/gin-gonic/gin/releases)

## 📰 Gin 1.12.0 버전이 출시되었습니다!

**[Gin 1.12.0](https://gin-gonic.com/en/blog/news/gin-1-12-0-release-announcement/)** 출시 소식을 알려드리게 되어 기쁩니다! 이번 릴리스에서는 새로운 기능, 성능 개선 및 중요한 버그 수정이 포함되었습니다. 자세한 내용은 공식 블로그의 [릴리스 공지](https://gin-gonic.com/en/blog/news/gin-1-12-0-release-announcement/)를 확인하세요.

---

Gin은 [Go](https://go.dev/)로 작성된 고성능 HTTP 웹 프레임워크입니다. [httprouter](https://github.com/julienschmidt/httprouter) 덕분에 Martini와 유사한 API를 제공하면서도 최대 40배 더 빠른 성능을 자랑합니다. Gin은 속도와 개발자 생산성이 필수적인 REST API, 웹 애플리케이션 및 마이크로서비스 구축을 위해 설계되었습니다.

**왜 Gin을 선택해야 할까요?**

Gin은 Express.js 스타일 라우팅의 단순함과 Go의 성능 특성을 결합하여 다음과 같은 용도에 이상적입니다:

- 고처리량 REST API 구축
- 많은 동시 요청을 처리해야 하는 마이크로서비스 개발
- 빠른 응답 시간이 필요한 웹 애플리케이션 제작
- 최소한의 보일러플레이트로 웹 서비스의 신속한 프로토타이핑

**Gin의 주요 특징:**

- **Zero allocation 라우터** - 힙 할당이 없는 극도로 효율적인 메모리 라우팅
- **고성능** - 다른 Go 웹 프레임워크와 비교하여 우수한 속도를 보여주는 벤치마크 결과
- **미들웨어 지원** - 인증, 로깅, CORS 등을 위한 확장 가능한 미들웨어 시스템
- **Crash-free** - 내장된 recovery 미들웨어가 패닉으로 인해 서버가 중단되는 것을 방지
- **JSON 검증** - 자동 요청/응답 JSON 바인딩 및 검증
- **라우트 그룹화** - 관련 라우트를 정리하고 공통 미들웨어 적용
- **에러 관리** - 중앙 집중식 에러 처리 및 로깅
- **내장 렌더링** - JSON, XML, HTML 템플릿 등 지원
- **확장성** - 커뮤니티 미들웨어 및 플러그인의 방대한 생태계

## 시작하기

### 사전 요구 사항

- **Go 버전**: Gin은 [Go](https://go.dev/) 버전 [1.25](https://go.dev/doc/devel/release#go1.25.0) 이상이 필요합니다.
- **기본적인 Go 지식**: Go 문법 및 패키지 관리에 익숙하면 도움이 됩니다.

### 설치

[Go의 모듈 지원](https://go.dev/wiki/Modules#how-to-use-modules) 덕분에, 코드에서 Gin을 import 하기만 하면 빌드 중에 Go가 자동으로 가져옵니다:

```go
import "github.com/gin-gonic/gin"
```

### 첫 번째 Gin 애플리케이션

Gin의 단순함을 보여주는 전체 예제입니다:

```go
package main

import (
  "log"
  "net/http"

"github.com/gin-gonic/gin"
)

func main() {
  // Create a Gin router with default middleware (logger and recovery)
  r := gin.Default()

// Define a simple GET endpoint
  r.GET("/ping", func(c *gin.Context) {
    // Return JSON response
    c.JSON(http.StatusOK, gin.H{
      "message": "pong",
    })
  })

// Start server on port 8080 (default)
  // Server will listen on 0.0.0.0:8080 (localhost:8080 on Windows)
  if err := r.Run(); err != nil {
    log.Fatalf("failed to run server: %v", err)
  }
}
```

**애플리케이션 실행 방법:**

1. 위 코드를 `main.go`로 저장하세요.
2. 애플리케이션을 실행합니다:

```sh
   go run main.go
   ```

3. 브라우저를 열고 [`http://localhost:8080/ping`](http://localhost:8080/ping)에 접속하세요.
4. `{"message":"pong"}` 결과가 표시됩니다.

**이 예제에서 보여주는 내용:**

- 기본 미들웨어가 포함된 Gin 라우터 생성
- 단순한 핸들러 함수를 사용한 HTTP 엔드포인트 정의
- JSON 응답 반환
- HTTP 서버 시작

### 다음 단계

첫 번째 Gin 애플리케이션을 실행한 후, 다음 리소스를 통해 더 자세히 알아보세요:

#### 📚 학습 리소스

- **[Gin 퀵 스타트 가이드](docs/doc.md)** - API 예제와 빌드 구성이 포함된 종합 튜토리얼
- **[예제 저장소](https://github.com/gin-gonic/examples)** - 다양한 Gin 사용 사례를 보여주는 즉시 실행 가능한 예제:
  - REST API 개발
  - 인증 및 미들웨어
  - 파일 업로드 및 다운로드
  - WebSocket 연결
  - 템플릿 렌더링

## 📖 문서

### API 레퍼런스

- **[Go.dev API Documentation](https://pkg.go.dev/github.com/gin-gonic/gin)** - 예제가 포함된 전체 API 레퍼런스

### 사용자 가이드

종합 문서는 [gin-gonic.com](https://gin-gonic.com)에서 여러 언어로 제공됩니다:

- [English](https://gin-gonic.com/en/docs/) | [简体中文](https://gin-gonic.com/zh-cn/docs/) | [繁體中文](https://gin-gonic.com/zh-tw/docs/)
- [日本語](https://gin-gonic.com/ja/docs/) | [한국어](https://gin-gonic.com/ko-kr/docs/) | [Español](https://gin-gonic.com/es/docs/)
- [Turkish](https://gin-gonic.com/tr/docs/) | [Persian](https://gin-gonic.com/fa/docs/) | [Português](https://gin-gonic.com/pt/docs/)
- [Russian](https://gin-gonic.com/ru/docs/) | [Indonesian](https://gin-gonic.com/id/docs/)

### 공식 튜토리얼

- [Go.dev Tutorial: Developing a RESTful API with Go and Gin](https://go.dev/doc/tutorial/web-service-gin)

## ⚡ 성능 벤치마크

Gin은 다른 Go 웹 프레임워크와 비교하여 탁월한 성능을 보여줍니다. 최대 효율을 위해 [HttpRouter](https://github.com/julienschmidt/httprouter)의 커스텀 버전을 사용합니다. [상세 벤치마크 보기 →](/BENCHMARKS.md)

**Gin vs. 다른 Go 프레임워크** (GitHub API 라우팅 벤치마크):

| Benchmark name                 |       (1) |             (2) |          (3) |             (4) |
| ------------------------------ | --------: | --------------: | -----------: | --------------: |
| BenchmarkGin_GithubAll         | **43550** | **27364 ns/op** |   **0 B/op** | **0 allocs/op** |
| BenchmarkAce_GithubAll         |     40543 |     29670 ns/op |       0 B/op |     0 allocs/op |
| BenchmarkAero_GithubAll        |     57632 |     20648 ns/op |       0 B/op |     0 allocs/op |
| BenchmarkBear_GithubAll        |      9234 |    216179 ns/op |   86448 B/op |   943 allocs/op |
| BenchmarkBeego_GithubAll       |      7407 |    243496 ns/op |   71456 B/op |   609 allocs/op |
| BenchmarkBone_GithubAll        |       420 |   2922835 ns/op |  720160 B/op |  8620 allocs/op |
| BenchmarkChi_GithubAll         |      7620 |    238331 ns/op |   87696 B/op |   609 allocs/op |
| BenchmarkDenco_GithubAll       |     18355 |     64494 ns/op |   20224 B/op |   167 allocs/op |
| BenchmarkEcho_GithubAll        |     31251 |     38479 ns/op |       0 B/op |     0 allocs/op |
| BenchmarkGocraftWeb_GithubAll  |      4117 |    300062 ns/op |  131656 B/op |  1686 allocs/op |
| BenchmarkGoji_GithubAll        |      3274 |    416158 ns/op |   56112 B/op |   334 allocs/op |
| BenchmarkGojiv2_GithubAll      |      1402 |    870518 ns/op |  352720 B/op |  4321 allocs/op |
| BenchmarkGoJsonRest_GithubAll  |      2976 |    401507 ns/op |  134371 B/op |  2737 allocs/op |
| BenchmarkGoRestful_GithubAll   |       410 |   2913158 ns/op |  910144 B/op |  2938 allocs/op |
| BenchmarkGorillaMux_GithubAll  |       346 |   3384987 ns/op |  251650 B/op |  1994 allocs/op |
| BenchmarkGowwwRouter_GithubAll |     10000 |    143025 ns/op |   72144 B/op |   501 allocs/op |
| BenchmarkHttpRouter_GithubAll  |     55938 |     21360 ns/op |       0 B/op |     0 allocs/op |
| BenchmarkHttpTreeMux_GithubAll |     10000 |    153944 ns/op |   65856 B/op |   671 allocs/op |
| BenchmarkKocha_GithubAll       |     10000 |    106315 ns/op |   23304 B/op |   843 allocs/op |
| BenchmarkLARS_GithubAll        |     47779 |     25084 ns/op |       0 B/op |     0 allocs/op |
| BenchmarkMacaron_GithubAll     |      3266 |    371907 ns/op |  149409 B/op |  1624 allocs/op |
| BenchmarkMartini_GithubAll     |       331 |   3444706 ns/op |  226551 B/op |  2325 allocs/op |
| BenchmarkPat_GithubAll         |       273 |   4381818 ns/op | 1483152 B/op | 26963 allocs/op |
| BenchmarkPossum_GithubAll      |     10000 |    164367 ns/op |   84448 B/op |   609 allocs/op |
| BenchmarkR2router_GithubAll    |     10000 |    160220 ns/op |   77328 B/op |   979 allocs/op |
| BenchmarkRivet_GithubAll       |     14625 |     82453 ns/op |   16272 B/op |   167 allocs/op |
| BenchmarkTango_GithubAll       |      6255 |    279611 ns/op |   63826 B/op |  1618 allocs/op |
| BenchmarkTigerTonic_GithubAll  |      2008 |    687874 ns/op |  193856 B/op |  4474 allocs/op |
| BenchmarkTraffic_GithubAll     |       355 |   3478508 ns/op |  820744 B/op | 14114 allocs/op |
| BenchmarkVulcan_GithubAll      |      6885 |    193333 ns/op |   19894 B/op |   609 allocs/op |

- (1): 일정한 시간 내에 달성한 총 반복 횟수, 높을수록 결과의 신뢰도가 높음
- (2): 1회 반복당 소요 시간 (ns/op), 낮을수록 좋음
- (3): 힙 메모리 (B/op), 낮을수록 좋음
- (4): 1회 반복당 평균 할당 횟수 (allocs/op), 낮을수록 좋음

## 🔌 미들웨어 생태계

Gin은 일반적인 웹 개발 요구 사항을 위한 풍부한 미들웨어 생태계를 가지고 있습니다. 커뮤니티에서 기여한 미들웨어를 살펴보세요:

- **[gin-contrib](https://github.com/gin-contrib)** - 다음 내용을 포함한 공식 미들웨어 모음:
  - 인증 (JWT, Basic Auth, 세션)
  - CORS, 처리율 제한(Rate limiting), 압축
  - 로깅, 메트릭, 트레이싱
  - 정적 파일 제공, 템플릿 엔진
- **[gin-gonic/contrib](https://github.com/gin-gonic/contrib)** - 추가 커뮤니티 미들웨어

## 🏢 프로덕션 사용 사례

Gin은 프로덕션 환경의 많은 고트래픽 애플리케이션과 서비스에서 사용되고 있습니다:

- **[gorush](https://github.com/appleboy/gorush)** - 고성능 푸시 알림 서버
- **[fnproject](https://github.com/fnproject/fn)** - 컨테이너 네이티브 서버리스 플랫폼
- **[photoprism](https://github.com/photoprism/photoprism)** - AI 기반 개인 사진 관리
- **[lura](https://github.com/luraproject/lura)** - 초고성능 API 게이트웨이 프레임워크
- **[picfit](https://github.com/thoas/picfit)** - 실시간 이미지 처리 서버
- **[dkron](https://github.com/distribworks/dkron)** - 분산 작업 스케줄링 시스템

## 🤝 기여하기

Gin은 전 세계 수백 명의 기여자들의 노력으로 만들어졌습니다. 여러분의 기여를 언제나 환영하며 감사드립니다! [기여자](https://github.com/gin-gonic/gin/graphs/contributors) 전체 목록을 확인하세요.

### 기여 방법

- 🐛 **버그 보고** - 문제 식별 및 수정 지원
- 💡 **기능 제안** - 개선을 위한 아이디어 공유
- 📝 **문서 개선** - 문서의 명확성 향상 지원
- 🔧 **코드 제출** - 버그 수정 또는 새로운 기능 구현
- 🧪 **테스트 작성** - 테스트 커버리지 향상

### 기여 시작하기

1. 상세 가이드는 [CONTRIBUTING.md](CONTRIBUTING.md)를 확인하세요.
2. 커뮤니티 토론에 참여하고 질문하세요.

**모든 기여는 소중하며, Gin을 모두에게 더 나은 프레임워크로 만드는 데 도움이 됩니다!**

gin

gin 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

gin

gin 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README