이미지는 두 레지스트리에 모두 게시됩니다:

- Docker Hub — `teampass/teampass`
- GitHub Container Registry — `ghcr.io/nilsteampassnet/teampass`

📖 [Docker 가이드](https://github.com/nilsteampassnet/teampass/blob/HEAD/docs/DOCKER.md) · [기존 설치를 Docker로 마이그레이션](https://github.com/nilsteampassnet/teampass/blob/HEAD/docs/DOCKER-MIGRATION.md)

### 🖥️ 베어 메탈 (프로덕션 권장)

PHP/MySQL 서버에 직접 설치하면 최상의 성능과 환경에 대한 최대한의 제어권을 얻을 수 있습니다.

- 📖 [공식 설치 가이드](https://documentation.teampass.net/#/install/installation)
- 🔄 [업그레이드 가이드](https://documentation.teampass.net/#/install/upgrade)
- 🔑 [파일 권한](https://documentation.teampass.net/#/install/file-permissions)
- 🎥 [비디오 튜토리얼](https://youtu.be/eXieWAIsGzc?feature=shared)

---

## 문서

| | |
|---|---|
| 📖 **[전체 문서](https://documentation.teampass.net)** | 설치, 기능, 관리 |
| 🚀 **[설치](https://documentation.teampass.net/#/install/installation)** | 단계별 첫 설정 |
| 🔄 **[업그레이드](https://documentation.teampass.net/#/install/upgrade)** | 버전 간 이동 |
| 🛡️ **[보안 강화](https://documentation.teampass.net/#/install/security-hardening)** | 프로덕션 체크리스트 |
| ⚙️ **[성능](https://documentation.teampass.net/#/install/performance)** | PHP-FPM, 캐싱, 튜닝 |
| 🔌 **[REST API](https://documentation.teampass.net/#/api/api-basic)** | 엔드포인트, JWT 인증, 클라이언트 |
| 🧩 **[브라우저 확장 프로그램](https://documentation.teampass.net/#/misc/extension)** | 설정 및 사용법 |
| 🩺 **[문제 해결](https://documentation.teampass.net/#/misc/troubleshooting)** | 문제가 발생했을 때 |

---

## 언어

Teampass는 커뮤니티가 번역한 **25개 언어**를 지원합니다.

<table>
<tr>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/us.png" width="16" alt="" /> 영어</td>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/fr.png" width="16" alt="" /> 프랑스어</td>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/de.png" width="16" alt="" /> 독일어</td>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/es.png" width="16" alt="" /> 스페인어</td>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/it.png" width="16" alt="" /> 이탈리아어</td>
</tr>
<tr>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/pr.png" width="16" alt="" /> 포르투갈어</td>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/br.png" width="16" alt="" /> 포르투갈어 (브라질)</td>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/nl.png" width="16" alt="" /> 네덜란드어</td>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/ru.png" width="16" alt="" /> 러시아어</td>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/ua.png" width="16" alt="" /> 우크라이나어</td>
</tr>
<tr>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/pl.png" width="16" alt="" /> 폴란드어</td>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/cz.png" width="16" alt="" /> 체코어</td>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/hu.png" width="16" alt="" /> 헝가리어</td>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/ro.png" width="16" alt="" /> 루마니아어</td>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/bg.png" width="16" alt="" /> 불가리아어</td>
</tr>
<tr>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/gr.png" width="16" alt="" /> 그리스어</td>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/tr.png" width="16" alt="" /> 터키어</td>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/se.png" width="16" alt="" /> 스웨덴어</td>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/no.png" width="16" alt="" /> 노르웨이어</td>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/ee.png" width="16" alt="" /> 에스토니아어</td>
</tr>
<tr>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/catalonia.png" width="16" alt="" /> 카탈루냐어</td>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/cn.png" width="16" alt="" /> 중국어</td>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/ja.png" width="16" alt="" /> 일본어</td>
<td><img src="https://raw.githubusercontent.com/nilsteampassnet/teampass/HEAD/public/assets/images/flags/vi.png" width="16" alt="" /> 베트남어</td>
<td>🇸🇦 아랍어 <sub>(진행 중)</sub></td>
</tr>
</table>

번역은 POEditor에서 관리됩니다 — 여러분이 기여한 몇 개의 문자열이 큰 도움이 됩니다.

[![번역에 도움주기](https://img.shields.io/badge/Help_translate-POEditor-24c8ff?style=for-the-badge&labelColor=0f2740)](https://poeditor.com/join/project?hash=0vptzClQrM)

---

## 커뮤니티

### 기여하기

모든 종류의 기여를 환영합니다. 저장소를 포크하고, 변경 사항을 적용한 후 풀 리퀘스트를 열어주세요 — 개발 환경 설정, 코딩 표준 및 브랜치 규칙은 [CONTRIBUTING.md](https://github.com/nilsteampassnet/teampass/blob/HEAD/.github/CONTRIBUTING.md)를, 협업 방식은 [CODE_OF_CONDUCT.md](https://github.com/nilsteampassnet/teampass/blob/HEAD/CODE_OF_CONDUCT.md)를 참조하세요.

[![PR 제출](https://img.shields.io/badge/Submit_a_PR-GitHub-%23060606?style=for-the-badge&logo=github&logoColor=fff)](https://github.com/nilsteampassnet/TeamPass/compare)

### 버그 신고

예상대로 작동하지 않는 것이 있다면 티켓을 등록해 주세요. 재현 단계, 서버 구성, 그리고 **관리자 → 버그 아이콘(왼쪽 하단)** 의 진단 보고서를 포함해 주세요.

[![이슈 등록](https://img.shields.io/badge/Raise_an_Issue-GitHub-%23060606?style=for-the-badge&logo=github&logoColor=fff)](https://github.com/nilsteampassnet/TeamPass/issues/new/choose)

### 질문하기

질문, 배포 조언 및 아이디어는 이슈 트래커가 아닌 Discussions에 올려주세요.

[![Discussions](https://img.shields.io/badge/Ask_a_question-Discussions-%23060606?style=for-the-badge&logo=github&logoColor=fff)](https://github.com/nilsteampassnet/TeamPass/discussions)

### 기여자

Teampass는 이 사람들 덕분에 지금의 모습이 되었습니다.

[![Contributors](https://readme-contribs.as93.net/contributors/nilsteampassnet/TeamPass?perRow=12&shape=squircle)](https://github.com/nilsteampassnet/TeamPass/graphs/contributors)

### 스타 기록

[![Star History Chart](https://api.star-history.com/svg?repos=nilsteampassnet/TeamPass&type=Date)](https://star-history.com/#nilsteampassnet/TeamPass&Date)

---

## Teampass 후원하기

Teampass는 무료이며 GPL-3.0 라이선스로, 2009년부터 한 사람에 의해 유지 관리되고 있습니다. 그 뒤에 회사가 없다는 것이 바로 핵심이며, 동시에 후원이 중요한 이유이기도 합니다.

### 후원금이 사용되는 곳

- **보안 작업** — 보고서 분류, 수정, CVE가 포함된 권고 게시
- **릴리스** — 테스트, 업그레이드 경로, 기존 설치의 지속적 업그레이드 지원
- **문서** — documentation.teampass.net의 가이드
- **번역** — 25개 언어 조율
- **인프라** — Docker 이미지, CI, 프로젝트 웹사이트

### 스폰서가 되기

목표는 **월 100명의 스폰서**입니다. 모든 등급이 도움이 되며, 소액의 정기 후원이 작업을 예측 가능하게 만들기 때문에 가장 큰 도움이 됩니다.

[![GitHub에서 후원](https://img.shields.io/badge/Sponsor_on_GitHub-nilsteampassnet-%23ff4dda?style=for-the-badge&logo=githubsponsors&logoColor=ff4dda)](https://github.com/sponsors/nilsteampassnet)
[![PayPal로 기부](https://img.shields.io/badge/One--off_donation-PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=fff)](https://www.paypal.com/donate/?hosted_button_id=XUVWYJ7J92X6L)

### 스폰서

이 작업을 후원해 주시는 모든 분께 큰 감사를 드립니다 — 여러분 덕분에 Teampass는 다른 모든 사람에게 무료로 제공됩니다.

[![Sponsors](https://readme-contribs.as93.net/sponsors/nilsteampassnet?perRow=12&shape=squircle)](https://github.com/sponsors/nilsteampassnet)

### 상업 지원

후원금은 무료 서버를 지원합니다. 브라우저 확장 프로그램과 전문 서비스는 로드맵을 지원합니다.

| | |
|---|---|
| **Pro 확장 프로그램** | 브라우저 자동 완성, 캡처 및 피싱 방지 — 연간 €49부터, 30일 체험판 |
| **서비스** | 기능 개발, 배포 지원, 우선 처리 — 건별 견적 |

[![가격 보기](https://img.shields.io/badge/See_pricing-teampass.net-24c8ff?style=for-the-badge&labelColor=0f2740)](https://teampass.net/pricing.html)

---

## 라이선스

Teampass는 **[GNU General Public License v3.0](https://github.com/nilsteampassnet/teampass/blob/HEAD/LICENSE.md)** 하에 배포됩니다.

파생 저작물이 동일한 라이선스를 유지하는 한, 상업적 용도를 포함하여 자유롭게 사용, 연구, 수정 및 재배포할 수 있습니다.

📋 [의존성 라이선스 준수 보고서](https://github.com/nilsteampassnet/teampass/blob/HEAD/LICENSE_COMPLIANCE_REPORT.md)

---

<div align="center">

<img src="https://teampass.net/images/madeinfrance.png" width="90" alt="Made in France" />

**2009년부터 [Nils Laumaillé](mailto:[email protected])이(가) 구축하고 유지 관리합니다.**

Copyright © 2009-2026 Nils Laumaillé

<br />

[![StandWithUkraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://github.com/vshymanskyy/StandWithUkraine/blob/main/docs/README.md)

</div>