lerx/webpam repository overview

This project includes a complete PAM based user management. Although it has been internationalized, the page template is developed based on Chinese.

Before installing, you need to know the following things:

1. The database is not included in this project. You need to build your own MySQL database.

2. According to your needs, you can handle your main applications by yourself. Such as vsftp, OpenVPN, and so on.

You need to prepare the following directories and files to run the system.

A local folder containing:

1.application.yaml

2.security(a file with only one UUID line, you can also enter a paragraph of characters in it.)

3.config (folder)

You can refer to the following source directory to create your own configuration folder.

https://gitee.com/lerx/webpam/tree/master/webpam/src/main/resources/config⁠

The purpose of this system development is to make it convenient for you to uniformly and centrally manage your authenticated users, such as FTP users, VPN users and so on.

Before using, you should know how to use PAM_ MySQL module to authenticate users of your application, such as FTP or VPN. You can search pam_mysql-0.7RC1 for learning and setting. Then, through webpam, you can easily operate user data in MySQL database, and query user login and application logs in webpam.

In the config folder, the user name and password with the highest permission to log in to the background are set in backadmin.properties. You should modify this configuration file immediately.

In practical application, it is found that the PAM MySQL module will find the problem of time offset when recording data. You can adjust according to the time zone of your location through the two options of time.zone.offset in the configuration file system.properties. For example, in Shanghai, - 8 can be used.

In addition, it should be noted that mailsrv.properties and smsrv.properties define the configuration of mail and SMS notifications. You should modify it according to your own situation. In the SMS module, only Tencent cloud SMS is developed. You should understand and query Tencent's official interface documents for specific details.

If you need to adjust the mail template, you should create a res/mail directory in the directory and modify your mail sending template by referring to the following contents.

https://gitee.com/lerx/webpam/tree/master/webpam/src/main/resources/⁠

Startup example:

docker run -it -p 18889:18889 --restart always --privileged=true -v /etc/localtime:/etc/localtime:ro -v /data/webpam:/home/webpam --env LC_ALL=zh_CN.UTF-8 --net mynet --name webpamtest lerx/webpam:1.0 /bin/bash

For more information, please visit the following website

https://gitee.com/lerx/webpam⁠

http://www.lerx.com/html/album/6/index.html⁠