Teampass

팀 전체가 신뢰할 수 있는 자체 호스팅 비밀번호 관리

폴더 수준 접근 제어 · 인증된 AES-256-GCM 암호화 · 규정 준수 증빙
귀하의 비밀은 인프라를 절대 벗어나지 않습니다.

🌐 teampass.net · 📖 문서 · 💬 토론 · 🐳 Docker Hub

소개

Teampass는 직접 운영하는 오픈소스 자격 증명 저장소입니다. 계정을 만들 필요도, 데이터를 보관하는 회사도 없습니다. 자체 서버에서 실행되는 PHP/MySQL 애플리케이션일 뿐이며, 폴더 수준 접근 제어, 사용자별 암호화 키, 전체 감사 추적 기능을 제공합니다.

2009년부터 실제 팀이 직면하는 문제를 바탕으로 구축되고 유지 관리되어 왔습니다. 어떤 자격 증명을 누가 볼 수 있어야 하는지, 감사자에게 이를 어떻게 증명할지, 그리고 비밀번호가 채팅 스레드와 스프레드시트에 남는 것을 어떻게 막을지가 핵심입니다.

📸 더 많은 스크린샷

항목 및 비밀

폴더 및 역할

인증 및 MFA

암호화 키

검색, 내보내기, 일회성 보기

백그라운드 작업

대상 사용자

보안

감사자에게 설명할 수 있는 암호화

비밀은 256비트 객체 키 아래에서 임의 nonce와 비밀별 솔트를 사용하여 AES-256-GCM으로 암호화됩니다. 이를 해제하는 개인 키는 600,000회 반복의 PBKDF2-SHA256으로 비밀번호에서 파생됩니다.

인증된 암호화 — 변조는 조용히 복호화되지 않고 감지됩니다
사용자별 키 배포 — 모든 사용자는 각 객체 키의 RSA로 래핑된 사본을 보유하므로, 계정을 제거하면 버튼을 숨기는 대신 실제로 접근 권한이 철회됩니다
지연 마이그레이션 — 형식 업그레이드는 접근 시 수행되며 유지보수 창이 필요 없습니다

침묵보다 투명성

취약점을 보고하지 않는 비밀번호 관리자는 취약점이 없는 것이 아니라 보고하지 않는 것입니다.

발견된 문제는 분류, 수정 후 CVE 식별자와 함께 GitHub Security Advisories로 게시됩니다.

취약점을 발견하셨나요? 공개 이슈가 아닌 GitHub Security Advisories를 통해 비공개로 신고해 주세요.

기능

🗂️ 폴더 및 역할 접근 제어

폴더 — 무제한 중첩, 폴더별 비밀번호 복잡성 규칙
역할 — 사용자별이 아닌 역할별로 접근 권한 부여
권한 — 읽기, 쓰기, 편집 금지, 삭제 금지, 최소 권한 우선 방식으로 해석
사용자 — 역할 위에 사용자별 재정의
관리자를 포함한 누구도 읽을 수 없는 개인 폴더

🔐 인증된 암호화

암호화 모델 — 키가 어떻게 파생, 래핑, 배포되는지
암호화 개선 — AES-256-GCM 형식 및 지연 마이그레이션
키 관리 — 재생성, 복구, 사용자별 키 복구

📊 보안 상태

취약, 재사용, 유출된 자격 증명을 점수화하는 보안 상태 대시보드
유출 감지 — 비밀번호를 전송하지 않는 Have I Been Pwned 검사
비밀번호 갱신 — 만료 정책 및 알림
마이크로 러닝 — 연례 슬라이드쇼 대신 앱 내 알림

🏛️ 거버넌스 및 감사

접근 검토 — 변경 불가능한 결정이 포함된 재인증 캠페인
규정 준수 보고서 — 감사자에게 제출할 수 있는 증빙
교체 추적 — 무엇이, 언제, 누구에 의해 교체되었는지
퇴사자 위험 — 퇴사하는 사용자가 여전히 알 수 있는 정보
데이터 분류 — 소유권 및 민감도 라벨

🪪 ID 통합

인증 — 로컬, 중첩 그룹을 지원하는 LDAP/AD, OAuth2 / SSO
다중 요소: TOTP(Google Authenticator), Duo Security, YubiKey, AGSES
네트워크 ACL — IP 범위로 접근 제한
세션 관리 — 시간 초과, 동시 세션, Redis 기반 저장소

🤖 자동화

REST API — JWT 인증, OpenAPI 3.1 사양, Bash 및 PowerShell 클라이언트
브라우저 확장 프로그램 — 자동 완성, 캡처, 원클릭 자동 구성
백그라운드 작업 — 키 배포, 알림, 유지보수
실시간 협업 — WebSocket 동기화 및 편집 잠금
백업 — 예약된 암호화 데이터베이스 덤프

📦 마이그레이션 가져오기 및 내보내기

가져오기 — Bitwarden, LastPass, 1Password, KeePassXC, CSV
내보내기 — CSV, PDF 및 자체 포함 암호화 오프라인 HTML 저장소
잠금 없음: 귀하의 서버에 있는 귀하의 데이터베이스이며 GPL-3.0 하에 있습니다

⚡ 일상 생산성

검색 — 라벨, 설명, 태그 및 사용자 정의 필드 전반
명령 팔레트 — 키보드 우선 탐색
즐겨찾기 및 최근 항목 빠른 접근
사용자 정의 필드 — 개별 암호화 가능, 역할 제한
지식 베이스 및 알림 센터
저장소 외부 공유를 위한 일회성 보기 링크 및 Secure Send

시작하기

요구 사항

Teampass는 활성 PHP 지원을 따릅니다. 보안과 성능 모두를 위해 최신 안정 PHP 릴리스를 실행하는 것을 강력히 권장합니다.

🐳 Docker```bash

docker run -d --name teampass
-p 8080:80
-v teampass_data:/var/www/html
teampass/teampass:latest

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

- 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>

데이터베이스	MySQL 5.7+ 또는 MariaDB 10.7+
PHP	8.2 이상(8.3에서 테스트됨)
필수 확장	`openssl` `mysqli` `mbstring` `bcmath` `iconv` `xml` `gd` `curl` `gmp` — LDAP/AD용 `ldap` 추가
권장 확장	`apcu`(구성 캐시) · `opcache`(성능) · `redis`(HA 세션) · `pcntl` + `posix`(WebSocket 데몬)

인기

TeamPass

🏠 개인 및 홈랩

👥 팀 및 중소기업

🏛️ 기업 및 규제 대상

인기