valterseu/teampass

TeamPass Docker镜像文档

镜像概述

本Docker镜像是为TeamPass项目从零构建的专用部署镜像，首次运行时会自动从TeamPass官方GitHub仓库（https://github.com/nilsteampassnet/TeamPass%EF%BC%89%E4%B8%8B%E8%BD%BD%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC%E3%80%82TeamPass%E6%98%AF%E4%B8%80%E6%AC%BE%E5%BC%80%E6%BA%90%E5%AF%86%E7%A0%81%E5%AD%98%E5%82%A8%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%EF%BC%8C%E5%8F%AF%E9%83%A8%E7%BD%B2%E4%BA%8ELinux%E6%9C%8D%E5%8A%A1%E5%99%A8%E3%80%81%E5%85%B1%E4%BA%AB%E4%B8%BB%E6%9C%BA%E6%88%96Docker%E5%AE%B9%E5%99%A8%E4%B8%AD%EF%BC%8C%E6%97%A8%E5%9C%A8%E6%8F%90%E4%BE%9B%E5%AE%89%E5%85%A8%E7%9A%84%E5%AF%86%E7%A0%81%E7%AE%A1%E7%90%86%E3%80%81%E5%85%B1%E4%BA%AB%E4%B8%8E%E7%BB%84%E7%BB%87%E5%8A%9F%E8%83%BD%E3%80%82

核心功能与特性

TeamPass核心功能

• 密码安全存储：加密存储密码，确保数据安全
• 密码生成：支持多难度级别密码生成
• 团队协作：实现团队内密码共享，追踪密码访问、修改和删除记录
• 部门权限管理：支持多部门架构，部门用户组仅能访问对应权限的密码，可分配部门经理
• 身份集成：支持LDAP和OpenLDAP连接
• 知识库功能：加密存储密码及附件，提供额外安全层

镜像特性

• 零构建基础，首次运行自动拉取官方最新代码
• 支持独立部署或与MySQL容器联动
• 兼容默认Docker网络，可选自定义网络配置
• 支持Nginx反向代理与Let's Encrypt证书集成（非强制）

使用场景

• 团队密码集中管理与共享
• 企业多部门权限隔离的密码存储
• 需要本地部署的密码安全管理需求
• 需与LDAP/OpenLDAP集成的身份验证场景

使用方法与配置说明

前置准备

• 建议创建独立Docker网络（可选，默认网络亦可使用）
• MySQL配置建议：创建专用数据库用户（而非root），仅授予TeamPass数据库访问权限

部署方式

1. 独立部署（无MySQL容器）

bash
docker run --name mysubdomain.domain.com \
  --restart always \
  --publish-all -p 828:80 -p 428:443 \
  --hostname=mysubdomain.domain.com \
  -e VIRTUAL_HOST=mysubdomain.domain.com \
  -e LETSENCRYPT_EMAIL=somemail@somedomainmail.com \
  -e LETSENCRYPT_HOST=mysubdomain.domain.com \
  -d valterseu/teampass

参数说明：

• --name：容器名称（建议使用域名）
• --restart always：容器自动重启
• -p 828:80/-p 428:443：端口映射（主机端口:容器端口）
• --hostname：容器主机名（需与域名一致）
• 环境变量：VIRTUAL_HOST（域名）、LETSENCRYPT_EMAIL（证书通知***）、LETSENCRYPT_HOST（证书域名）

2. 与MySQL容器联动（docker-compose）

创建docker-compose.yml文件：

yaml
version: '2'

services:
  # MySQL容器
  mysql:
    image: mysql:latest
    restart: always
    command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci --default-authentication-plugin=mysql_native_password
    volumes:
      - /srv/docker/mysql:/var/lib/mysql  # 本地目录挂载（持久化数据库文件）
    environment:
      - MYSQL_ROOT_PASSWORD=ThisIsADemoPasswordNot@Real12454  # 替换为强密码

  # TeamPass容器
  teampass:
    image: valterseu/teampass
    restart: always
    command: --hostname=mysubdomain.domain.com  # 替换为实际域名
    ports:
      - 829:80
      - 429:443
    links:
      - mysql  # 依赖MySQL容器
    environment:
      - VIRTUAL_HOST=mysubdomain.domain.com  # 替换为实际域名
      - LETSENCRYPT_EMAIL=somemail@somedomainmail.com  # 替换为实际邮箱
      - LETSENCRYPT_HOST=mysubdomain.domain.com  # 替换为实际域名

启动命令：docker-compose up -d

环境变量说明

相关资源

• 镜像GitHub仓库：https://github.com/valterseu/TeamPass
• TeamPass官方GitHub：https://github.com/nilsteampassnet/TeamPass
• 教程视频：[***]