TeamPass
一款自托管的团队协作密码管理器，支持本地部署，安全共享和管理凭证。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
团队自建保险箱，密码共享不泄密。
核心功能
- 完全自托管，数据存在自己服务器上，隐私可控
- 支持角色权限、文件夹和标签管理，多人协作井然有序
- 内置WebSocket实时同步，多人同时编辑无冲突
- 集成LDAP/AD、API接口，适合企业现有架构
- 密码过期提醒、自定义字段、审计日志等实用功能
避坑指南
- •PHP版本必须≥8.1，推荐8.2+；老版本PHP可能报错。2. 数据库必须使用MySQL 5.7+或MariaDB 10.7+，SQLite不兼容。3. 如需LDAP/AD认证，必须安装php-ldap扩展。4. 多服务器高可用场景建议配置Redis作为会话存储，否则Session可能丢失。5. 安装前确保服务器时间准确，否则WebSocket证书验证可能失败。6. 官方Docker镜像默认使用Apache，如需Nginx需自行反向代理配置。
适用场景
- 公司内部IT团队共享服务器、数据库等敏感密码
- 中小企业统一管理各部门的系统账号和WiFi密码
- 需要合规审计（如ISO 27001）时，记录密码访问历史
详细介绍
TeamPass 是一款开源的自托管协作密码管理器，专为团队和组织设计。它允许你在自己的服务器上（Linux/Windows + PHP/MySQL 或 Docker）安全地存储、共享和管理密码、密钥、笔记等凭证，支持基于角色的访问控制。核心功能包括条目分类、自定义字段、过期提醒、LDAP/AD集成、API接口、实时同步（WebSocket），以及20多种语言界面。该项目持续活跃更新，注重安全性和易用性，适合需要完全掌控数据的企业、IT团队或中小企业，作为云端密码管理器的自托管替代方案。
常见问题与排障 (2)
故障排除为什么 TeamPass 文件完整性扫描在 Longhorn RWX/NFS 存储上会一直卡在“Scan in progress”？
这会影响 NFS 后端卷（例如 Longhorn RWX）上的 TeamPass 3.2.2.7。扫描状态检查会以只读模式（rb）打开 storage/logs/file-integrity-scan.lock，但请求的是独占锁。在 NFS 上，独占锁需要可写的文件描述符，因此即使扫描完成后该检查也会失败，GUI 会错误地报告扫描仍在运行。
临时解决办法，仅在确实没有扫描运行时：
kubectl exec -n <namespace> <teampass-pod> -- rm /var/www/teampass/storage/logs/file-integrity-scan.lock
然后刷新 File Integrity 页面。该锁文件是持久性的，因此它的存在本身并不表示扫描处于活动状态；不要删除 JSON 报告文件。
永久修复：升级到包含 PR "Fix file integrity scan status on NFS storage" 的 TeamPass 版本，或修补代码，使锁文件以写权限（r+b）而不是只读（rb）打开。
故障排除如何修复在拆分视图中保存条目后 TeamPass 关闭条目视图或折叠侧边栏的问题？
这是 TeamPass 3.1.7.3 中的一个回归问题，当启用用户个人资料选项 "Show item details in page split view mode" 时会出现。请升级到 TeamPass 3.1.7.4，该版本修复了条目保存/窗口关闭的 bug。如果升级后拆分视图仍无法正确渲染，请应用 pull request #5155 中经过验证的补丁，或升级到包含该修复的版本。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
方案一（传统安装）：准备一台Linux或Windows服务器，安装PHP 8.1+、MySQL 5.7+ / MariaDB 10.7+，并确保 openssl、mysqli、mbstring 等PHP扩展已启用；下载TeamPass源码解压到Web目录；访问安装向导完成数据库设置和管理员创建。
方案二（Docker）：运行 docker run -d -p 80:80 teampass/teampass，根据提示配置数据库和初始设置。
首次登录后立即修改管理员密码；邀请团队成员并分配对应权限；导入现有密码或创建新条目并设置文件夹分类。
- 方案一（传统安装）：准备一台Linux或Windows服务器，安装PHP 8.1+、MySQL 5.7+ / MariaDB 10.7+，并确保 openssl、mysqli、mbstring 等PHP扩展已启用；下载TeamPass源码解压到Web目录；访问安装向导完成数据库设置和管理员创建。
- 方案二（Docker）：运行 docker run -d -p 80:80 teampass/teampass，根据提示配置数据库和初始设置。
- 首次登录后立即修改管理员密码；邀请团队成员并分配对应权限；导入现有密码或创建新条目并设置文件夹分类。
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
传统安装：删除Web目录下的teampass文件夹和数据库；如果用了APCu或Redis缓存，清空缓存。Docker安装：docker stop 容器名 && docker rm 容器名 && docker rmi teampass/teampass，并删除持久化卷。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
2 FAQs