ants

KO | EN

gitlite — search

#python #hacktoberfest #react #rust #linux #docker #macos #java #nodejs #vue #awesome-list #security #openai #mcp

(★ 14,489)

🐜🐜🐜 ants는 Go 언어를 위한 가장 강력하고 신뢰할 수 있는 풀링(pooling) 솔루션입니다.

ants 최신버젼 다운로드

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![](https://raw.githubusercontent.com/panjf2000/logos/master/ants/logo.png)
**Go 언어를 위한 goroutine 풀**
  
  
[![](https://img.shields.io/github/actions/workflow/status/panjf2000/ants/test.yml?branch=master&style=flat-square&logo=github-actions)](https://github.com/panjf2000/ants/actions?query=workflow%3ATests "Build Status")
[![](https://img.shields.io/codecov/c/github/panjf2000/ants?style=flat-square&logo=codecov)](https://codecov.io/gh/panjf2000/ants "Codecov")
[![](https://img.shields.io/github/v/release/panjf2000/ants.svg?color=161823&style=flat-square&logo=smartthings)](https://github.com/panjf2000/ants/releases "Release")
[![](https://img.shields.io/github/v/tag/panjf2000/ants?color=%23ff8936&logo=fitbit&style=flat-square)](https://github.com/panjf2000/ants/tags "Tag")
  
[![](https://img.shields.io/badge/go-%3E%3D1.19-30dff3?style=flat-square&logo=go)](https://github.com/panjf2000/gnet "Minimum Go Version")
[![](https://img.shields.io/badge/go.dev-doc-007d9c?style=flat-square&logo=read-the-docs)](https://pkg.go.dev/github.com/panjf2000/ants/v2?tab=doc "Doc for ants")
[![](https://awesome.re/mentioned-badge-flat.svg)](https://github.com/avelino/awesome-go#goroutines "Mentioned in Awesome Go")

English | [中文](README\_ZH.md)
## 📖 소개
`ants` 라이브러리는 고정 용량을 가진 goroutine 풀을 구현하여, 수많은 goroutine을 관리하고 재활용함으로써 개발자가 동시성 프로그램 내의 goroutine 수를 제한할 수 있도록 해줍니다.
## 🚀 주요 기능:
- 대규모 goroutine의 자동 관리 및 재활용
- 만료된 goroutine 주기적 정리
- 풍부한 API 제공: 작업 제출, 실행 중인 goroutine 수 확인, 풀 용량 동적 조절, 풀 해제, 풀 재부팅 등
- 프로그램 크래시를 방지하기 위한 패닉(panic)의 우아한 처리
- 효율적인 메모리 사용을 제공하며, Go 언어의 무제한 goroutine 방식보다 \*\*\*더 높은 성능\*\*\*을 달성할 수 있음
- 논블로킹(Nonblocking) 메커니즘
- 사전 할당된 메모리 (링 버퍼, 선택 사항)
## 💡 `ants` 작동 방식
### 흐름도

![ants-flowchart-en](https://user-images.githubusercontent.com/7496278/66396509-7b42e700-ea0c-11e9-8612-b71a4b734683.png)

### Activity Diagrams
![](https://raw.githubusercontent.com/panjf2000/illustrations/master/go/ants-pool-1.png)
![](https://raw.githubusercontent.com/panjf2000/illustrations/master/go/ants-pool-2.png)
![](https://raw.githubusercontent.com/panjf2000/illustrations/master/go/ants-pool-3.png)
![](https://raw.githubusercontent.com/panjf2000/illustrations/master/go/ants-pool-4.png)
## 🧰 설치 방법
### `ants` v1 사용 시
``` powershell
go get -u github.com/panjf2000/ants
```
### `ants` v2 사용 시 (GO111MODULE=on 설정 필요)
```powershell
go get -u github.com/panjf2000/ants/v2
```
## 🛠 사용 방법
기본적인 사용법은 [예제(the examples)](https://pkg.go.dev/github.com/panjf2000/ants/v2#pkg-examples)를 확인하세요.
### 풀을 위한 함수형 옵션
`ants.Options`는 ants 풀의 모든 선택적 설정을 담고 있으며, `NewPool`/`NewPoolWithFunc`/`NewPoolWithFuncGeneric` 메서드 내에서 각 설정을 구성하는 옵션 함수들을 호출하여 goroutine 풀을 커스터마이징할 수 있게 해줍니다.
자세한 내용은 [ants.Options](https://pkg.go.dev/github.com/panjf2000/ants/v2#Options)와 [ants.Option](https://pkg.go.dev/github.com/panjf2000/ants/v2#Option)을 확인하세요.
### 풀 용량 커스터마이징
`ants`는 풀의 용량 커스터마이징을 지원합니다. 다음과 같이 `NewPool` 메서드를 호출하여 지정된 용량의 `Pool`을 인스턴스화할 수 있습니다:
``` go
p, \_ := ants.NewPool(10000)
```
### 작업 제출
작업은 `ants.Submit`을 호출하여 제출할 수 있습니다.
```go
ants.Submit(func(){})
```
### 런타임에 풀 용량 조절
`ants.Tune`을 사용하여 런타임에 `ants` 풀의 용량을 조절할 수 있습니다:
``` go
pool.Tune(1000) // 용량을 1000으로 조절
pool.Tune(100000) // 용량을 100000으로 조절
```
이 경우 경쟁(contention) 문제에 대해 걱정하지 마세요. 여기에 있는 메서드는 스레드 안전(thread-safe)(또는 goroutine-safe)합니다.
### 풀 내 goroutine 큐 사전 할당(Pre-malloc)
`ants`를 사용하면 풀 내 goroutine 큐의 메모리를 미리 할당할 수 있습니다. 초고용량 풀이 필요하고 동시에 goroutine 내의 각 작업이 오랜 시간 동안 지속되는 시나리오와 같은 특정 상황에서는 성능 향상을 얻을 수 있으며, 사전 할당을 통해 goroutine 큐에서 발생하는 많은 메모리 할당을 줄일 수 있습니다.
```go
// ants는 ants.NewPool이 호출될 때 풀의 전체 용량을 미리 할당합니다.
p, \_ := ants.NewPool(100000, ants.WithPreAlloc(true))
```
### 풀 해제
```go
pool.Release()
```
또는
```go
pool.ReleaseTimeout(time.Second \* 3)
```
### 풀 재부팅
```go
// 해제된 풀이라도 Reboot()을 호출한 후에는 다시 사용할 수 있습니다.
pool.Reboot()
```
## ⚙️ 순서 관련 안내
`ants` 풀에 제출된 모든 작업은 일련의 동시성 워커(concurrent worker)들에 분산되기 때문에 순서대로 처리된다는 보장이 없으며, 따라서 이 작업들은 동시에(concurrently) 실행됩니다.
## 👏 기여자분들
PR을 열기 전에 [기여 가이드라인(Contributing Guidelines)](CONTRIBUTING.md)을 읽어주세요. 그리고 이미 `ants`에 기여해주신 모든 개발자분들께 감사드립니다!
[![](https://contrib.rocks/image?repo=panjf2000/ants)](https://github.com/panjf2000/ants/graphs/contributors)
## 📄 라이선스
`ants`의 소스 코드는 [MIT License](/LICENSE) 하에 제공됩니다.
## 📚 관련 아티클
- [Goroutine 并发调度模型深度解析之手撸一个高性能 goroutine 池](https://taohuawu.club/high-performance-implementation-of-goroutine-pool)
- [Visually Understanding Worker Pool](https://medium.com/coinmonks/visually-understanding-worker-pool-48a83b7fc1f5)
- [The Case For A Go Worker Pool](https://brandur.org/go-worker-pool)
- [Go Concurrency - GoRoutines, Worker Pools and Throttling Made Simple](https://twin.sh/articles/39/go-concurrency-goroutines-worker-pools-and-throttling-made-simple)
## 🖥 사용 사례
### 비즈니스 기업 및 오픈소스 조직
다음 기업 및 조직에서 신뢰하고 사용하고 있습니다.

|  |  |  |  |
| --- | --- | --- | --- |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|  |

If you're also using `ants` in production, please help us enrich this list by opening a pull request.
### open-source software
The open-source projects below do concurrent programming with the help of `ants`.
- [gnet](https://github.com/panjf2000/gnet): 순수 Go로 작성된 고성능, 경량, 논블로킹, 이벤트driven 네트워킹 프레임워크입니다.
- [milvus](https://github.com/milvus-io/milvus): 확장 가능한 유사도 검색 및 AI 애플리케이션을 위한 오픈소스 벡터 데이터베이스입니다.
- [nps](https://github.com/ehang-io/nps): 강력한 웹 관리 터미널을 갖춘 경량의 고성능 강력한 인트라넷 침투 프록시 서버입니다.
- [TDengine](https://github.com/taosdata/TDengine): 사물인터넷(IoT), 커넥티드 카, 산업용 IoT에 최적화된 오픈소스 고성능 클라우드 네이티브 시계열 데이터베이스입니다.
- [siyuan](https://github.com/siyuan-note/siyuan): 완전한 오프라인 사용 및 종단간 암호화 동기화를 지원하는 로컬 우선 개인 지식 관리 시스템입니다.
- [BillionMail](https://github.com/aaPanel/BillionMail): 기업과 개인이 이메일 캠페인을 손쉽게 관리할 수 있도록 설계된 차세대 오픈소스 메일 서버이자 이메일 마케팅 플랫폼입니다.
- [WeKnora](https://github.com/Tencent/WeKnora): 복잡하고 이질적인 문서를 처리하는 데 특히 특화된, 심층 문서 이해 및 시맨틱 검색을 위해 설계된 LLM 기반 프레임워크입니다.
- [coze-loop](https://github.com/coze-dev/coze-loop): AI 에이전트의 개발과 운영에 초점을 맞춘 개발자 지향 플랫폼 수준의 솔루션입니다.
- [osmedeus](https://github.com/j3ssie/osmedeus): 모의 해킹(Offensive Security)을 위한 워크플로우 엔진입니다.
- [jitsu](https://github.com/jitsucom/jitsu/tree/master): 오픈소스 Segment 대안입니다. 모던 데이터 팀을 위한 완전 스크립트 가능 데이터 수집 엔진입니다. 며칠이 아닌 몇 분 만에 실시간 데이터 파이프라인을 구축하세요.
- [triangula](https://github.com/RH12503/triangula): 이미지로부터 고품질의 삼각분할 및 다각형 아트를 생성합니다.
- [teler](https://github.com/kitabisa/teler): 실시간 HTTP 침입 탐지입니다.
- [bsc](https://github.com/binance-chain/bsc): go-ethereum 포크를 기반으로 한 Binance Smart Chain 클라이언트입니다.
- [jaeles](https://github.com/jaeles-project/jaeles): 자동화된 웹 애플리케이션 테스트를 위한 스위스 군대 칼입니다.
- [devlake](https://github.com/apache/incubator-devlake): DevOps 도구를 위한 오픈소스 개발 데이터 플랫폼 및 대시보드입니다.
- [matrixone](https://github.com/matrixorigin/matrixone): MatrixOne은 단순화된 분산 데이터베이스 엔진을 통해 여러 데이터 센터, 클라우드, 엣지 및 기타 이종 인프라 전반에서 트랜잭션, 분석 및 스트리밍 워크로드를 지원하는 미래 지향적 하이퍼컨버전스 클라우드 및 엣지 네이티브 DBMS입니다.
- [bk-bcs](https://github.com/TencentBlueKing/bk-bcs): BlueKing Container Service(BCS, 이하 동일)는 BlueKing 생태계 내 마이크로서비스를 위한 컨테이너 관리 및 오케스트레이션 플랫폼입니다.
- [trueblocks-core](https://github.com/TrueBlocks/trueblocks-core): TrueBlocks는 완전히 로컬로 유지되면서 모든 EVM 호환 체인(특히 Ethereum 메인넷)의 블록체인 데이터에 대한 접근성을 향상시킵니다.
- [openGemini](https://github.com/openGemini/openGemini): openGemini는 IoT, 커넥티드카(IoV), O&M 모니터링, 산업용 인터넷 시나리오에서 널리 사용될 수 있는 오픈소스 클라우드 네이티브 시계열 데이터베이스(TSDB)입니다.
- [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS): AdGuard DNS는 트래커 차단, 개인 정보 보호 및 자녀 보호 기능을 위한 대체 솔루션입니다.
- [WatchAD2.0](https://github.com/Qihoo360/WatchAD2.0): WatchAD2.0 是 360 信息安全中心开发的一款针对域安全的日志分析与监控系统，它可以收集所有域控上的事件日志、网络流量，通过特征匹配、协议分析、历史行为、敏感操作和蜜罐账户等方式来检测各种已知与未知威胁，功能覆盖了大部分目前的常见内网域渗透手法。
- [vanus](https://github.com/vanus-labs/vanus): Vanus는 처리 기능을 갖춘 Serverless 이벤트 스트리밍 시스템입니다. SaaS, 클라우드 서비스, 데이터베이스를 쉽게 연결하여 사용자가 차세대 이벤트를 구축할 수 있도록 돕습니다.

driven Applications.
- [trpc-go](https://github.com/trpc-group/trpc-go): Golang으로 작성된 확장 가능하고 고성능인 RPC 프레임워크입니다.
- [motan-go](https://github.com/weibocom/motan-go): Motan은 고성능 분산 서비스를 빠르게 개발하기 위한 언어간 원격 프로시저 호출(RPC) 프레임워크입니다. motan-go는 Motan의 golang 구현체입니다.
#### 모든 사용 사례:
- [ants/v2에 의존하는 저장소들](https://github.com/panjf2000/ants/network/dependents?package\_id=UGFja2FnZS0yMjY2ODgxMjg2)
- [ants/v1에 의존하는 저장소들](https://github.com/panjf2000/ants/network/dependents?package\_id=UGFja2FnZS0yMjY0ODMzNjEw)
프로젝트에 `ants`가 통합되어 있다면, 이 사용 사례 목록을 갱신하는 풀 리퀘스트(pull request)를 자유롭게 열어주세요.
## 🔋 JetBrains OS 라이선스
`ants`는 JetBrains s.r.o.에서 부여한 **무료 JetBrains 오픈소스 라이선스**를 받아 GoLand로 개발되어 왔으며, 이에 감사의 뜻을 표합니다.
[![JetBrains logo.](https://resources.jetbrains.com/storage/products/company/brand/logos/jetbrains.svg)](https://www.jetbrains.com/?from=ants)
## ☕️ 커피 한 잔 사주기
> 감사의 표시로 기부자 목록에 추가할 수 있도록, 아래 수단을 통해 기부하실 때 성함, GitHub 계정 또는 기타 소셜 미디어 계정을 꼭 남겨주시기 바랍니다.

|  |  |  |
| --- | --- | --- |
| [Buy me a coffee](https://buymeacoffee.com/panjf2000) | [Patreon](https://www.patreon.com/panjf2000) | [OpenCollective](https://opencollective.com/panjf2000) |

## 🔋 후원 (Sponsorship)
[![DigitalOcean Referral Badge](https://web-platforms.sfo2.cdn.digitaloceanspaces.com/WWW/Badge%203.svg)](https://www.digitalocean.com/?refcode=5d8774f42124&utm\_campaign=Referral\_Invite&utm\_medium=Referral\_Program&utm\_source=badge)

ants

ants 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

ants

ants 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README