本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com
linuxserver/ldap-auth是由LinuxServer.io团队开发的Docker镜像,基于nginx-ldap-auth项目。该镜像用于对Nginx代理的受保护资源进行用户认证,包含两个核心组件:与LDAP认证服务器通信的守护进程(ldap-auth),以及基于用户凭据生成认证Cookie的Web服务器守护进程。支持轻量级目录访问协议(LDAP)认证服务器,包括OpenLDAP和Microsoft Windows Active Directory 2003/2012。
/ldaplogin和/login路径,避免与反向代理应用的/login路径冲突该镜像通过Docker manifest支持多平台,拉取lscr.io/linuxserver/ldap-auth:latest即可自动获取对应架构的镜像,也可通过标签指定特定架构:
| 架构 | 支持情况 | 标签格式 |
|---|---|---|
| x86-64 | ✅ | amd64-<version tag> |
| arm64 | ✅ | arm64v8-<version tag> |
/ldaplogin和/login,避免与反向代理应用的内部认证路径冲突--- services: ldap-auth: image: lscr.io/linuxserver/ldap-auth:latest container_name: ldap-auth environment: - PUID=1000 - PGID=1000 - TZ=Etc/UTC - FERNETKEY= #可选 - CERTFILE= #可选 - KEYFILE= #可选 ports: - 8888:8888 - 9000:9000 restart: unless-stopped
docker run -d \ --name=ldap-auth \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Etc/UTC \ -e FERNETKEY= `#可选` \ -e CERTFILE= `#可选` \ -e KEYFILE= `#可选` \ -p 8888:8888 \ -p 9000:9000 \ --restart unless-stopped \ lscr.io/linuxserver/ldap-auth:latest
| 参数 | 功能 |
|---|---|
-p 8888:8888 | ldap auth守护进程端口 |
-p 9000:9000 | ldap登录页面Web服务器端口 |
-e PUID=1000 | 用户ID(必填)- 详见用户/组ID说明 |
-e PGID=1000 | 组ID(必填)- 详见用户/组ID说明 |
-e TZ=Etc/UTC | 时区设置,参考时区列表(必填) |
-e FERNETKEY= | 可选,自定义有效的fernet密钥(仅在容器频繁重建或多节点部署时需要,避免认证失效) |
-e CERTFILE= | 可选,指向证书文件路径以启用HTTPS |
-e KEYFILE= | 可选,指向与CERTFILE对应的私钥文件路径 |
--read-only=true | 以只读文件系统运行容器,详见文档 |
--user=1000:1000 | 以非root用户运行容器,详见文档 |
可通过FILE__前缀从文件加载环境变量,例如:
-e FILE__MYVAR=/run/secrets/mysecretvariable
可通过-e UMASK=022覆盖默认umask设置,详见umask说明。
使用卷(-v参数)时,可通过指定PUID(用户ID)和PGID(组ID)避免主机与容器间的权限问题。确保主机卷目录所有者与指定的PUID/PGID一致。可通过id your_user命令获取当前用户的ID:
id your_user
示例输出:
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)
容器运行时Shell访问:
docker exec -it ldap-auth /bin/bash
实时监控容器日志:
docker logs -f ldap-auth
容器版本查询:
docker inspect -f '{{ index .Config.Labels "build_version" }}' ldap-auth
镜像版本查询:
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/ldap-auth:latest
更新镜像:
docker-compose pull ldap-auth
更新容器:
docker-compose up -d ldap-auth
清理旧镜像:
docker image prune
更新镜像:
docker pull lscr.io/linuxserver/ldap-auth:latest
停止并删除容器:
docker stop ldap-auth && docker rm ldap-auth
使用原参数重新创建容器(配置将通过卷保留)
git clone [***] cd docker-ldap-auth docker build \ --no-cache \ --pull \ -t lscr.io/linuxserver/ldap-auth:latest .
ARM架构构建需先注册qemu-static:
docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset
然后使用对应架构的Dockerfile(如-f Dockerfile.aarch64)。
legacy-cgi,修复fernet密钥存储X-Ldap-DisableReferrals禁用引用CERTFILE和KEYFILE变量未设置时的bug/ldaplogin免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录方式配置轩辕镜像加速服务,包含7个详细步骤
在 Linux 系统上配置轩辕镜像源,支持主流发行版
在 Docker Desktop 中配置轩辕镜像加速,适用于桌面系统
在 Docker Compose 中使用轩辕镜像加速,支持容器编排
在 k8s 中配置 containerd 使用轩辕镜像加速
在宝塔面板中配置轩辕镜像加速,提升服务器管理效率
在 Synology 群晖NAS系统中配置轩辕镜像加速
在飞牛fnOS系统中配置轩辕镜像加速
在极空间NAS中配置轩辕镜像加速
在爱快ikuai系统中配置轩辕镜像加速
在绿联NAS系统中配置轩辕镜像加速
在威联通NAS系统中配置轩辕镜像加速
在 Podman 中配置轩辕镜像加速,支持多系统
配置轩辕镜像加速9大主流镜像仓库,包含详细配置步骤
无需登录即可使用轩辕镜像加速服务,更加便捷高效
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429