一个基于 PHP 的 Web 界面,用于管理 LDAP 用户帐户和自助更改密码。
Note: This project was previously known as ldap-user-manager. If you're looking for the ldap-user-manager project, you're in the right place - it's now called Luminary!
A web-based interface for managing LDAP user accounts and groups, with self-service password management and multi-factor authentication support.
Luminary is a web application designed to simplify LDAP directory management through an intuitive web interface. It's built to work seamlessly with OpenLDAP and runs as a Docker container, making it easy to deploy alongside LDAP servers like osixia/openldap.
This project complements openvpn-server-ldap-otp by providing a user-friendly way for administrators to manage accounts and for users to self-enrol in multi-factor authentication.
This example shows how to run Luminary for testing, using osixia/openldap:
docker run \
--detach \
--name openldap \
--hostname openldap \
-p 389:389 \
-e LDAP_ORGANISATION="Example Ltd" \
-e LDAP_DOMAIN="example.com" \
-e LDAP_ADMIN_PASSWORD="admin_password" \
-e LDAP_TLS_VERIFY_CLIENT="never" \
-e LDAP_RFC2307BIS_SCHEMA="true" \
osixia/openldap:latestNote: if you want to enable MFA support then follow the quick set-up guide for ldap-totp-schema which provides instructions for running the osixia/openldap container with support for the TOTP schema (which stores MFA information in LDAP).
docker run \
--detach \
--name luminary \
-p 8080:80 \
-p 8443:443 \
-e SERVER_HOSTNAME="localhost" \
-e LDAP_URI="ldap://openldap:389" \
-e LDAP_BASE_DN="dc=example,dc=com" \
-e LDAP_REQUIRE_STARTTLS="true" \
-e LDAP_ADMIN_BIND_DN="cn=admin,dc=example,dc=com" \
-e LDAP_ADMIN_BIND_PWD="admin_password" \
-e LDAP_IGNORE_CERT_ERRORS="true" \
--link openldap:openldap \
wheelybird/luminary:v2.2.1Visit https://localhost:8443/setup (accept the self-signed certificate warning) and follow the wizard to:
Once setup is complete, you can log in at https://localhost:8443 with your admin credentials.
Luminary is configured entirely through environment variables. The main categories are:
| Documentation | Description |
|---|---|
| Configuration reference | Complete list of all environment variables with descriptions and defaults |
| Multi-factor authentication | Setting up and using MFA/TOTP authentication |
| Advanced topics | HTTPS certificates, custom attributes, email setup, and more |
The following environment variables are required:
LDAP_URI - LDAP server URI (e.g., ldap://ldap.example.com)LDAP_BASE_DN - Base DN for your organisation (e.g., dc=example,dc=com)LDAP_ADMIN_BIND_DN - DN of the admin user (e.g., cn=admin,dc=example,dc=com)LDAP_ADMIN_BIND_PWD - Password for the admin userAll other settings have sensible defaults. For example, the admin group defaults to admins and can be changed with LDAP_ADMINS_GROUP.
For sensitive values like passwords, you can use Docker secrets or mounted files. Append _FILE to any variable name and point it to a file containing the value:
-e LDAP_ADMIN_BIND_PWD_FILE=/run/secrets/ldap_admin_passwordLuminary includes comprehensive MFA support with LDAP-backed TOTP (Time-based One-Time Passwords):
For detailed setup instructions, see the MFA documentation.
This project is designed to work alongside openvpn-server-ldap-otp:
Together, these projects provide a complete, centralised authentication solution.
This is an open-source project. Contributions, bug reports, and feature requests are welcome via GitHub issues and pull requests.
git clone https://github.com/wheelybird/luminary.git
cd luminary
docker build -t luminary .This project is licensed under the MIT Licence. See the LICENCE file for details.
暂无开放 Issues,或尚未同步最近议题。