viossat/keeweb

viossat/keeweb

镜像概述和主要用途

viossat/keeweb 是基于 KeeWeb 的 Docker 镜像，提供免费的跨平台密码管理功能，兼容 KeePass 密码库格式。该镜像旨在简化 KeeWeb 的部署流程，支持通过 WebDAV 协议管理密码库文件，适用于需要便捷、安全地管理多平台密码的场景。

核心功能和特性

• 跨平台兼容：支持多操作系统，兼容 KeePass 密码库文件格式（.kdbx）。
• 轻量级基础：基于 Alpine Linux，镜像体积小，资源占用低。
• WebDAV 支持：内置 WebDAV 服务，可通过 WebDAV 协议访问和管理密码库文件。
• TLS 建议：镜像本身不提供 TLS 支持，生产环境中建议搭配反向代理（如 Nginx、Traefik）配置 HTTPS 加密。

使用场景和适用范围

• 个人密码管理：适用于个人用户跨设备（电脑、手机、平板）同步和管理密码。
• 小型团队协作：支持通过 WebDAV 共享密码库文件，适合小型团队共享少量敏感密码（需确保 WebDAV 访问权限控制）。
• 本地/私有部署：无需依赖第三方云服务，可在私有服务器或本地环境部署，增强数据隐私性。

使用方法和配置说明

基本要求

• Docker 环境（1.13+ 版本）。
• 如需 WebDAV 功能，需准备密码库文件（.kdbx）及存储目录。

基本使用（无 WebDAV）

通过以下命令启动容器，基本功能仅提供 KeeWeb 界面，密码库文件需手动导入/导出：

bash
docker run -d -p 80:80 viossat/keeweb

参数说明：

• -d：后台运行容器。
• -p 80:80：将容器内 80 端口映射到主机 80 端口，通过 http://主机IP 访问 KeeWeb 界面。

WebDAV 配置（推荐）

若需通过 WebDAV 存储和访问密码库文件，需挂载本地目录并配置 WebDAV 认证信息：

1. 准备密码库文件

将密码库文件（如 mypasswords.kdbx）存放至本地目录（如 /my/vault-files）。

2. 启动容器并配置 WebDAV

bash
docker run -d \
  -p 80:80 \
  -e WEBDAV_USERNAME=webdav \  # WebDAV 访问用户名
  -e WEBDAV_PASSWORD=secret \  # WebDAV 访问密码
  -v /my/vault-files:/usr/share/nginx/html/webdav \  # 挂载本地密码库目录到容器内 WebDAV 根目录
  viossat/keeweb

参数说明：

• -e WEBDAV_USERNAME：必填，WebDAV 服务的访问用户名。
• -e WEBDAV_PASSWORD：必填，WebDAV 服务的访问密码。
• -v /my/vault-files:/usr/share/nginx/html/webdav：将本地存储密码库文件的目录挂载到容器内 /usr/share/nginx/html/webdav（WebDAV 服务根目录），容器可通过该目录访问密码库文件。

3. 浏览器中配置 WebDAV 连接

1. 通过浏览器访问 http://主机IP 打开 KeeWeb 界面。
2. 点击界面中的 更多（More）按钮，选择 WebDAV 选项。
3. 输入 WebDAV 连接信息：
   • URL：http://主机IP/webdav/文件名.kdbx（如 http://192.168.1.100/webdav/mypasswords.kdbx）。
   • 用户名：步骤 2 中配置的 WEBDAV_USERNAME（如 webdav）。
   • 密码：步骤 2 中配置的 WEBDAV_PASSWORD（如 secret）。
4. 点击连接，即可通过 WebDAV 访问和管理密码库文件。

注意事项

• TLS 配置：镜像默认通过 HTTP 提供服务，生产环境中需通过反向代理（如 Nginx）配置 HTTPS，避免密码库文件传输过程中泄露。
• 数据持久化：WebDAV 模式下，本地挂载目录（如 /my/vault-files）需确保数据备份，防止容器删除导致密码库文件丢失。
• 权限控制：WebDAV 用户名/密码仅作基础认证，建议定期更换密码，避免未授权访问。