Teampass

自托管密码管理，值得整个团队信赖

文件夹级访问控制 · 认证 AES-256-GCM 加密 · 合规性证据
您的机密信息永不离开您的基础设施。

🌐 teampass.net · 📖 文档 · 💬 讨论 · 🐳 Docker Hub

关于

Teampass 是一款开源凭据保险库，由您自行部署运行。 无需注册账号，没有幕后公司掌控您的数据——只需在您自己的服务器上运行一个 PHP/MySQL 应用，即可获得文件夹级访问控制、按用户分配的加密密钥以及完整的审计追踪。

自 2009 年起持续开发和维护，始终围绕真实团队的实际痛点：谁应该看到哪条凭据、如何向审计人员证明这一点、以及如何杜绝密码散落在聊天记录和电子表格中。

📸 更多截图

条目与机密

文件夹与角色

认证与 MFA

加密密钥

搜索、导出、一次性查看

后台任务

适用人群

🏠 个人与家庭实验室

真正拥有您的保险库。

可在 Raspberry Pi 或 €5 的 VPS 上运行
个人文件夹使用您自己的密钥加密
支持从 Bitwarden、LastPass、1Password 或 KeePassXC 导入
永久免费，无需注册

👥 团队与中小企业

别再在聊天中共享密码。

用文件夹和角色取代共享文档
完整记录谁在何时访问了什么
面向客户和外包人员的 Secure Send 功能
浏览器扩展，满足日常自动填充需求

🏛️ 企业与受监管行业

证明您的访问控制，而不只是口头宣称。

访问重新认证活动，决策不可篡改
合规性报告与证据导出
支持嵌套组的 LDAP/AD、OAuth2 SSO
数据分类与归属管理

安全性

可以向审计人员解释清楚的加密方案

机密信息使用 AES-256-GCM 加密，采用随机 nonce 和每条机密独立的盐值，密钥为 256 位对象密钥。解锁这些密钥的私钥由您的密码通过 PBKDF2-SHA256、600,000 次迭代 派生而来。

认证加密 — 可检测篡改，而非静默解密 - 按用户分发密钥 — 每位用户持有每个对象密钥的 RSA 包装副本，因此移除账号即真正撤销访问权限，而非仅仅隐藏一个按钮
惰性迁移 — 格式升级在访问时进行，无需停机维护窗口

透明胜过沉默

一个不报告漏洞的密码管理器，并不代表它没有漏洞。

发现的问题经过分类、修复后，以 GitHub Security Advisories 形式发布，并附带 CVE 标识符。

发现漏洞？ 请通过 GitHub Security Advisories 私下报告——切勿在公开 issue 中提交。

功能特性

🗂️ 文件夹与角色访问控制

文件夹 — 无限层级嵌套，按文件夹设置密码复杂度规则
角色 — 按角色授予访问权限，而非逐个用户分配
权限 — 读取、写入、禁止编辑、禁止删除，采用最严格权限优先的解析规则
用户 — 在角色基础上提供按用户的覆盖设置
个人文件夹，包括管理员在内的任何人都无法读取

🔐 认证加密

加密模型 — 密钥如何派生、包装和分发
加密改进 — AES-256-GCM 格式及其惰性迁移
密钥管理 — 重新生成、恢复、按用户密钥修复

📊 安全态势

安全态势仪表盘，对弱密码、重复使用密码和已泄露密码进行评分
泄露检测 — 使用 Have I Been Pwned 检查，且不会发送您的密码
密码更新 — 过期策略与提醒
微学习 — 应用内提示，取代年度幻灯片培训

🏛️ 治理与审计

访问审查 — 重新认证活动，决策不可篡改
合规性报告 — 可交给审计人员的证据
轮换追踪 — 什么被轮换、何时、由谁操作
离职风险 — 离职用户仍可能掌握的信息
数据分类 — 归属与敏感度标签

🪪 身份集成

认证 — 本地、支持嵌套组的 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，用于在保险库外安全共享

快速开始

环境要求


数据库	MySQL 5.7+ 或 MariaDB 10.7+
PHP	8.2 或更高版本（已在 8.3 上测试）
必需扩展	`openssl` `mysqli` `mbstring` `bcmath` `iconv` `xml` `gd` `curl` `gmp` — 另需 `ldap` 以支持 LDAP/AD
推荐扩展	`apcu`（配置缓存）· `opcache`（性能）· `redis`（高可用会话）· `pcntl` + `posix`（WebSocket 守护进程）

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)

---

## 社区

### 贡献

欢迎任何形式的贡献。Fork 仓库、进行修改，然后提交拉取请求——开发环境搭建、编码规范和分支约定请参阅 [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)

### 报告 Bug

如果某些功能无法正常工作，请提交工单。请附上复现步骤、服务器配置，以及 **管理 → Bug 图标（左下角）** 生成的诊断报告。

[![提交 Issue](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 中，而不是 Issue 跟踪器。

[![讨论](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 能有今天，离不开这些人的付出。

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

### Star 历史

[![Star 历史图表](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 对其他人保持免费。

[![赞助者](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 通用公共许可证 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="法国制造" />

**由 [Nils Laumaillé](mailto:[email protected]) 自 2009 年起构建并维护。**

版权所有 © 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>