ikaruswill/vaultwarden_ldap
ikaruswill
vaultwarden的LDAP连接器，用于从LDAP服务器同步用户并邀请至vaultwarden实例，支持多架构，基于buster:slim基础镜像。
下载次数: 0状态：社区镜像维护者：ikaruswill仓库类型：镜像最近更新：3 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
vaultwarden_ldap
镜像概述和主要用途
vaultwarden_ldap是https://github.com/dani-garcia/vaultwarden%E7%9A%84LDAP%E8%BF%9E%E6%8E%A5%E5%99%A8%EF%BC%8C%E5%9F%BA%E4%BA%8Ebuster:slim%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%94%AF%E6%8C%81%E5%A4%9A%E6%9E%B6%E6%9E%84%E3%80%82%E9%85%8D%E7%BD%AE%E5%90%8E%E8%BF%90%E8%A1%8C%E8%AF%A5%E5%B7%A5%E5%85%B7%EF%BC%8C%E5%8F%AF%E8%87%AA%E5%8A%A8%E4%BB%8ELDAP%E6%9C%8D%E5%8A%A1%E5%99%A8%E6%9F%A5%E6%89%BE%E7%94%A8%E6%88%B7%E5%B9%B6%E9%82%80%E8%AF%B7%E5%85%B6%E5%8A%A0%E5%85%A5vaultwarden%E5%AE%9E%E4%BE%8B%EF%BC%8C%E5%AE%9E%E7%8E%B0%E7%94%A8%E6%88%B7%E7%BB%9F%E4%B8%80%E7%AE%A1%E7%90%86%E3%80%82
核心功能和特性
- 多架构支持：适配多种硬件架构
- LDAP用户同步：自动从LDAP服务器检索用户并邀请至vaultwarden
- 灵活连接选项：支持LDAP、LDAPS及StartTLS连接方式
- 可配置同步策略：支持自定义同步间隔和单次/循环同步模式
- TOML配置：通过配置文件灵活设置vaultwarden和LDAP参数
使用场景和适用范围
适用于需要通过LDAP服务器集中管理vaultwarden用户的场景，如企业、组织内部等，实现用户账户的统一维护和自动同步。
详细使用方法和配置说明
部署
推荐使用Docker部署，参考仓库中的docker-compose.yml示例。若使用Docker Hub镜像而非本地构建，将配置中的build: .替换为image: vividboarder/vaultwarden_ldap。必须填充并挂载config.toml配置文件。
配置
配置通过TOML文件读取，默认路径为config.toml，可通过CONFIG_PATH环境变量指定自定义路径。配置项说明如下：
| 名称 | 类型 | 可选 | 描述 |
|---|---|---|---|
vaultwarden_url | String | 否 | vaultwarden的根URL，例如：https://vw.example.com |
vaultwarden_admin_token | String | 否 | 传递给vaultwarden的ADMIN_TOKEN值 |
vaultwarden_root_cert_file | String | 是 | 额外DER编码根证书路径，例如：root.cert。使用Docker时需参考docker-compose.yml配置暴露路径，默认为空 |
ldap_host | String | 否 | LDAP服务器主机名或IP地址 |
ldap_scheme | String | 是 | 连接协议方案（ldap或ldaps），根据SSL设置自动默认 |
ldap_ssl | Boolean | 是 | 是否使用SSL并通过ldaps连接，默认为false |
ldap_starttls | Boolean | 是 | 是否使用StartTLS连接 |
ldap_no_tls_verify | Boolean | 是 | 使用SSL时是否验证证书，默认为true |
ldap_port | Integer | 是 | LDAP服务器端口，根据SSL设置默认389（非SSL）或636（SSL） |
ldap_bind_dn | String | 否 | 连接LDAP的绑定用户DN，例如：cn=admin,dc=example,dc=org |
ldap_bind_password | String | 否 | 绑定用户的密码 |
ldap_search_base_dn | String | 否 | 搜索用户的基准DN，例如：dc=example,dc=org |
ldap_search_filter | String | 否 | 用户搜索过滤器，例如：(&(objectClass=*)(uid=*)) |
ldap_mail_field | String | 是 | 用户记录中存储电子邮件的字段，默认为mail |
ldap_sync_interval_seconds | Integer | 是 | 同步间隔秒数，默认为60 |
ldap_sync_loop | Boolean | 是 | 是否循环轮询同步（true）或单次同步（false），默认为true |
开发
仓库包含预定义的pre-commit规则。安装pre-commit后，运行make install-hooks配置提交钩子，或通过make check强制运行所有钩子。
对于不熟悉cargo的用户，可使用make目标执行常见任务：
- 运行调试版本：
make run-debug - 构建发布版本：
make release
测试
当前测试需手动执行，步骤如下：
-
启动vaultwarden和LDAP服务器：
bashdocker-compose up -d vaultwarden ldap ldap_admin -
访问http://localhost:8001%E7%9A%84LDAP%E7%AE%A1%E7%90%86%E9%97%A8%E6%88%B7%EF%BC%8C%E4%BD%BF%E7%94%A8%E9%BB%98%E8%AE%A4%E8%B4%A6%E6%88%B7%E7%99%BB%E5%BD%95%EF%BC%9A
- 用户名：
cn=admin,dc=example,dc=org - 密码：
admin
- 用户名：
-
创建测试用户：
- 展开
dc=example,dc=org导航树，选择"在此创建新条目" - 选择"通用：Posix组"，命名（如"Users"）并保存
- 选择"创建子对象"，选择"通用：用户账户"
- 填写用户名和组ID，保存后添加"Email"属性并输入测试***
- 展开
-
运行LDAP同步：
bashdocker-compose up ldap_sync
也可通过以下命令引导测试环境：
bashdocker-compose -f docker-compose.yml -f itest/docker-compose.itest.yml up --build
未来计划
- 完善日志功能
- 添加自动化测试
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 vaultwarden_ldap 镜像标签
docker pull docker.xuanyuan.run/ikaruswill/vaultwarden_ldap:<标签>
DockerHub 原生拉取命令
docker pull ikaruswill/vaultwarden_ldap:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"