在Open WebUI里配LDAP登录,关键要区分两件事:一是Open WebUI主动向Active Directory查询,二是Open WebUI把登录交给一个身份中间件、由中间件去对接AD。官方主线版本通常不直接暴露LDAP配置项,更常见的做法是让Open WebUI走OIDC,中间加一层Authelia、Keycloak或Lldap。你要先确认自己跑的镜像版本是否带LDAP相关环境变量或配置项;如果没有,就不要在Open WebUI内部硬找LDAP开关,而是按OIDC中间件这条路线走。
先确认容器到AD的网络路径
不管走哪种方案,Open WebUI容器必须能访问AD的LDAP端口(通常389或636)。这一步没打通,后面所有配置都是空转。先看运行Open WebUI的宿主机能不能解析AD域名,然后进入容器内部检查端口连通性:
docker exec -it open-webui sh
# 容器内执行,确认域名解析和端口可达
nc -zv ad.example.com 389
openssl s_client -connect ad.example.com:636 -brief 2>&1 | head -20
执行位置是Open WebUI容器内,不是宿主机。用途是区分问题出在“网络不可达”还是“bind账号配置错误”。如果容器内没有nc或openssl,就用docker exec启动临时工具容器、加入同一网络再测试。风险边界是:有些自定义网络启用了内部DNS,容器内解析依赖Docker的DNS配置,不要拿宿主机的/etc/hosts结果当容器内结论。
按资源情况选择LDAP接入方式
如果你跑的是带LDAP支持的Open WebUI分支,配置重心放在LDAP服务器地址、bind DN和搜索路径上,通常需要你提供:AD域名、一个只读查询账号(例如cn=svc_ldap_read,ou=services,dc=ad,dc=example,dc=com)、用户搜索根、以及用户唯一标识属性(sAMAccountName或userPrincipalName,取其一,不要混)。验证方式不是只看登录页,而是先用一个已知AD账号做LDAP查询,确认查询结果里存在该用户。
如果走OIDC中间件路线,配置重心变成“Open WebUI信任哪个OIDC发码方”。以Authelia为例,你需要在Open WebUI的环境变量里指定OIDC端点地址、客户端ID和密钥,并把auth方法设为openid:
# docker-compose 中 Open WebUI 服务环境变量示意
AUTH_METHOD=openid
OIDC_CLIENT_ID=openwebui
OIDC_CLIENT_SECRET=改成你的客户端密钥
OIDC_ISSUER=https://authelia.example.com
OIDC_REDIRECT_URI=https://openwebui.example.com/oauth2/callback
这段配置里最容易被忽略的是OIDC_REDIRECT_URI,它必须和Authelia中登记的Open WebUI回调地址完全一致,包括协议和端口,否则OIDC握手能发起、但回调时会被拒。配置完成后,验证主线是:浏览器访问Open WebUI登录页 → 跳转到Authelia → 输入AD账号密码 → 跳回Open WebUI并建立会话。只要这一步通了,LDAP细节是否完美其实由Authelia承担,不必在Open WebUI侧再排查AD属性。
用最小操作验证LDAP查询本身
无论选哪条路线,都要单独验证“查询账号能不能读到所需用户属性”。可以在容器内用ldapsearch做一次只读查询,使用安全连接时需注意证书信任问题:
ldapsearch -H ldaps://ad.example.com:636 \
-D "cn=svc_ldap_read,ou=services,dc=ad,dc=example,dc=com" \
-w "你的密码" \
-b "ou=users,dc=ad,dc=example,dc=com" \
"(sAMAccountName=目标用户)" \
sAMAccountName displayName mail
这里的关键参数是baseDN和filter。执行后用返回的条目核对两件事:目标用户能查到,属性里有你在Open WebUI需要的name或email。很多登录失败是因为查询账号权限不足、只能验证登录但不能读取成员关系,或者filter把用户排除在外。需要注意,ldapsearch只解决“读得到”的问题,不解决“Open WebUI会话建立后为何立即登出”的问题,后者通常和OIDC属性映射或回调状态有关。
失败时按顺序回退
建议按“开放范围从小到大”的顺序排查,而不是一上来就改防火墙。先确认AD侧是否允许来自容器IP的LDAP查询,再看查询账号密码是否过期,最后看回调地址是否一致。临时验证网络时可以用docker run `--rm` `--network` 你的OpenWebUI网络拉起一个小工具镜像测试,不要改动Open WebUI容器本身的网络模式。如果OIDC方案反复失败,先在配置里关闭OIDC、让Open WebUI回到本地账号登录,确认业务可用后再继续调LDAP。回退时保留一份当前能用的compose文件和LDAP查询记录,方便逐项对比。
最后要确认一点:AD在容器网络里通常不要求额外开新端口,但这不意味着Open WebUI容器网络能自动发现AD域控。如果你改了LDAP配置后仍连不上,优先检查AD域控防火墙是否限制了来源IP,而不是反复重开Open WebUI容器。把“容器内可查询AD”作为门槛,过了这一步再谈登录跳转。