Skip to content

Latest commit

 

History

History
138 lines (104 loc) · 5.78 KB

README.md

File metadata and controls

138 lines (104 loc) · 5.78 KB
Raw

ProFTPd Admin

Graphical User Interface for ProFTPd with MySQL and sqlite3 support

© 2004 The Netherlands, Lex Brugman [email protected]
© 2012 Christian Beer [email protected]
© 2015 Ricardo Padilha [email protected]

Published under the GPLv2 License (see LICENSE for details)

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2, as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, download from http://www.gnu.org/licenses/gpl-2.0.txt

Information about ProFTPd Admin

This GUI for ProFTPd was written to support a basic user management feature when using the SQL module. Originally written by Lex Brugmann in 2004 it was updated by Christian Beer in 2012 to support the latest PHP version.

There is no build-in security, so you have to protect the directory with something else, like Apache Basic Authentication.

It's possible to use either of SHA1 and pbkdf2 with either of MySQL/MariaDB and sqlite3. pbkdf2 is supported since ProFTPd 1.3.5.

You can look at some screenshots to see if this is the tool you need.

To-Do

  • add postgresql support (#26)
  • Add default user settings to groups so it is easier to create a new user with default values (#28)
  • Email new users with password (#35)

Upgrade

If you want to upgrade the hashing algorithm you have to change all passwords after changing the configs (both ProFTPd and ProFTPd Admin).

Installation

Using MySQL and SHA1

  1. Install ProFTPd with MySQL support
    • Debian: apt-get install proftpd-mod-mysql
    • Gentoo: USE="mysql" emerge proftpd
  2. Create a MySQL database (use something like phpMyAdmin for this), for example: "proftpd".
  3. Use tables.sql to populate the database (you can use phpMyAdmin for this).
  4. Add the following to your proftpd.conf and sql.conf (edit to your needs):
CreateHome              on 775
AuthOrder               mod_sql.c

SQLBackend              mysql
SQLEngine               on
SQLPasswordEngine       on
SQLAuthenticate         on
SQLAuthTypes            SHA1

SQLConnectInfo          database@localhost username password
SQLUserInfo             users userid passwd uid gid homedir shell
SQLGroupInfo            groups groupname gid members
SQLUserWhereClause      "disabled != 1"
SQLLog PASS             updatecount
SQLNamedQuery           updatecount UPDATE "login_count=login_count+1, last_login=now() WHERE userid='%u'" users

 # Used to track xfer traffic per user (without invoking a quota)
SQLLog RETR             bytes-out-count
SQLNamedQuery           bytes-out-count UPDATE "bytes_out_used=bytes_out_used+%b WHERE userid='%u'" users
SQLLog RETR             files-out-count
SQLNamedQuery           files-out-count UPDATE "files_out_used=files_out_used+1 WHERE userid='%u'" users

SQLLog STOR             bytes-in-count
SQLNamedQuery           bytes-in-count UPDATE "bytes_in_used=bytes_in_used+%b WHERE userid='%u'" users
SQLLog STOR             files-in-count
SQLNamedQuery           files-in-count UPDATE "files_in_used=files_in_used+1 WHERE userid='%u'" users
  1. Extract all files to your webspace (into a subdirectory like "proftpdadmin").
  2. Secure access to this directory (for example: create a .htaccess file if using apache)
  3. Edit the configs/config_example.php file to your needs and rename it to config.php.
  4. Start ProFTPd.
  5. Go to http://yourwebspace/proftpdadmin/ and start using it!

Using sqlite3 and pbkdf2

  1. Install ProFTPd with sqlite3 support
  2. Use tables-sqlite3.sql to create an sqlite3 database: sqlite3 auth.sqlite3 < tables-sqlite3.sql
  3. Add the following to your proftpd.conf and sql.conf (edit to your needs):
CreateHome              on 775
AuthOrder               mod_sql.c

SQLBackend              sqlite3
SQLEngine               on
SQLPasswordEngine       on
SQLAuthenticate         on
SQLAuthTypes            pbkdf2
SQLPasswordPBKDF2       sha1 5000 20
SQLPasswordUserSalt     name Prepend
SQLPasswordEncoding     hex

SQLConnectInfo          /path/to/auth.sqlite3
SQLUserInfo             users userid passwd uid gid homedir shell
SQLGroupInfo            groups groupname gid members
SQLUserWhereClause      "disabled != 1"
SQLLog PASS             updatecount
SQLNamedQuery           updatecount UPDATE "login_count=login_count+1, last_login=now() WHERE userid='%u'" users

 # Used to track xfer traffic per user (without invoking a quota)
SQLLog RETR             bytes-out-count
SQLNamedQuery           bytes-out-count UPDATE "bytes_out_used=bytes_out_used+%b WHERE userid='%u'" users
SQLLog RETR             files-out-count
SQLNamedQuery           files-out-count UPDATE "files_out_used=files_out_used+1 WHERE userid='%u'" users

SQLLog STOR             bytes-in-count
SQLNamedQuery           bytes-in-count UPDATE "bytes_in_used=bytes_in_used+%b WHERE userid='%u'" users
SQLLog STOR             files-in-count
SQLNamedQuery           files-in-count UPDATE "files_in_used=files_in_used+1 WHERE userid='%u'" users
  1. Extract all files to your webspace (into a subdirectory like "proftpdadmin").
  2. Secure access to this directory (for example: create a .htaccess file if using apache)
  3. Edit the configs/config_example.php file to your needs and rename it to config.php.
  4. Start ProFTPd.
  5. Go to http://yourwebspace/proftpdadmin/ and start using it!

Thanks / Links

Lex Brugman for initiating this project
Justin Vincent for the ezSQL library
Ricardo Padilha for implementing sqlite3, pbkdf2 and bootstrap support