HTTPC

보안 HTTP 클라이언트 라이브러리, 기본 보안, 스마트 재시도, 미들웨어 체인 및 객체 풀 재사용 내장.

특징

• TLS 1.2+ - 최소 TLS 버전 강제, 기본 TLS 1.2-1.3
• SSRF 방어 - 기본적으로 사설 IP 연결 차단, 면제 CIDR 구성 가능
• 스마트 재시도 - 지수 백오프 + 지터, 사용자 정의 재시도 전략 가능
• 연결 풀 관리 - 고성능 연결 재사용, HTTP/2 지원
• 미들웨어 체인 - 로깅, 감사, 메트릭, 복구, 요청 ID 등 내장 미들웨어
• 파일 다운로드 - 이어서 다운로드, 진행률 콜백, 체크섬 검증 지원
• DNS-over-HTTPS - 내장 DoH 리졸루션, DNS 하이재킹 위험 감소
• 객체 풀 재사용 - 내장 sync.Pool로 메모리 할당 감소, GC 부하 감소

설치

go get github.com/cybergodev/httpc

30초 체험

package main

import (
    "fmt"
    "github.com/cybergodev/httpc"
)

func main() {
    result, err := httpc.Get("https://httpbin.org/get")
    if err != nil {
        panic(err)
    }
    defer httpc.ReleaseResult(result)

    fmt.Println(result.StatusCode()) // 200
}

시작하기

목표에 따라 읽기 경로를 선택하세요:

목표	추천
5분 안에 시작하기	빠른 시작
30분 실전 연습	실전 튜토리얼
특정 사용법 찾기	치트시트
보안 기능 이해하기	보안 개요
API 시그니처 확인	API 참조

핵심 개념

HTTPC는 간단한 것부터 유연한 것까지 세 가지 사용 방식을 제공합니다:

패키지 레벨 함수         클라이언트 인스턴스                   도메인 클라이언트
httpc.Get()  →  client, _ := httpc.New()  →  dc, _ := httpc.NewDomain(url)
일회성 요청          사용자 정의 설정/미들웨어       세션 관리/Cookie 자동 유지

구성 프리셋

프리셋	적용 시나리오
DefaultConfig()	일반 시나리오, 안전한 기본값
SecureConfig()	보안 민감 시나리오, 엄격한 타임아웃
PerformanceConfig()	높은 처리량, 대형 연결 풀
TestingConfig()	테스트 환경, 보안 검사 비활성화
MinimalConfig()	경량 스크립트, 재시도 및 리다이렉트 없음