Configuração do Pure-Ftpd

abril-maio/05
AVISO:

· este documento explica a instalação do pure-ftpd para ser usado no sistema PVANET em
fase de desenvolvimento pela Divisão de Sistemas da CPD.

· às vezes usa-se pure-ftpd e às vezes pureftpd, sempre se tentou usar o padrão usado pelo
próprio software que às vezes usa, nos exemplos, um ou outro.

1. Obter o software no site: http://www.pureftpd.org

veja-se que há outros softwares importantes no site, tais como o admin e o user manager.

2. Pegar e ler a documentação:

ftp://ftp.pureftpd.org/pub/pure-ftpd/doc/readme.pdf

3. criar usuário principal e os dos domínios virtuais (a vantagem de criar usuários por domínio
virtual está em poder ter (se quiser) quotas pelo sistema operacional):

useradd -s /bin/false -d /var/pure-ftpd pure-ftpd

useradd -s /bin/false -d /var/pure-ftpd/pvanet pvanet

useradd -s /bin/false -d /var/pure-ftpd/ftp2 ftp2

4. remover os subdiretórios tmp criados no passo anterior (não precisa):

cd /var/pure-ftpd
rm -Rf tmp pvanet/tmp ftp2/tmp

5. criar o subdiretório dos arquivos de configuração:

mkdir /etc/pure-ftpd

6. fazer os links virtuais:

para cada IP precisa indicar qual subdiretório ele vai usar:

ln -s /var/pure-ftpd/pvanet /etc/pure-ftpd/200.131.233.147

ln -s /var/pure-ftpd/ftp2 /etc/pure-ftpd/200.131.233.148

7. instalar libmysql14-devel-4.1.11-1mdk.i586.rpm (Mandriva 10.2):

urpmi libmysql-devel

8. mudar para o subdiretório onde esta o fonte descompactado e rodar o seguinte configure:
./configure \
--with-altlog \
--with-language=brazilian-portuguese \
--with-mysql \
--with-peruserlimits \
--with-quotas \
--with-throttling \
--with-virtualchroot \
--with-virtualhost \
--with-privsep \
--without-humor \
--without-inetd

9. compilar e instalar:

make
make check
su
make install

10. copiar:

o arquivo de configuração pureftpd-mysql.conf (esta no subdiretório da compilação) para o

subdiretório /etc/pure-fptd e verificar que os campos estejam no mínimo como segue:

MÍNIMO:

MYSQLServer mysql.cpd.ufv.br
MYSQLPort 3306
MYSQLSocket /tmp/mysql.sock
MYSQLUser pureftpd
MYSQLPassword net-pva-ftp
MYSQLDatabase pureftpd
MYSQLCrypt cleartext
MYSQLGetPW SELECT Password FROM users WHERE User="\L"
MYSQLGetUID SELECT Uid FROM users WHERE User="\L"
MYSQLGetGID SELECT Gid FROM users WHERE User="\L"
MYSQLGetDir SELECT Dir FROM users WHERE User="\L"

COMO FICOU COM SERVIDORES VIRTUAIS (a versão final está no Anexo C):

MYSQLServer mysql.cpd.ufv.br
MYSQLPort 3306
MYSQLSocket /tmp/mysql.sock
MYSQLUser pureftpd
MYSQLPassword net-pva-ftp
MYSQLDatabase pureftpd
MYSQLCrypt cleartext
MYSQLGetPW SELECT Password FROM users WHERE User="\L" and IP="\I"
MYSQLGetUID SELECT Uid FROM users WHERE User="\L" and IP="\I"
MYSQLGetGID SELECT Gid FROM users WHERE User="\L" and IP="\I"
MYSQLGetDir SELECT Dir FROM users WHERE User="\L" and IP="\I"
MySQLGetQTAFS SELECT QuotaFiles FROM users WHERE User="\L" and IP="\I"
MySQLGetQTASZ SELECT QuotaSize FROM users WHERE User="\L" and IP="\I"

Observação: no arquivo de configuração os “\L”, “\I” etc são explicados.

11. copiar:

o arquivo de configuração pure-ftpd.conf (esta no subdiretório configuration-file da compilação)

para /etc/pure-ftpd

DEVIDO AO TAMANHO do arquivo (após CONFIGURADO), o mesmo esta listado no anexo A,

sendo que as mudanças nos parâmetros feitas para esta instalação estão indicadas por “#LOCAL#”.

IMPORTANTE: a opção de compilação --with-privsep afetou tudo que se refere a “número

máximo de usuários/conexão” já que, devido à opção de compilação, os valores para estes
parâmetros devem ser configurados em dobro. Isto porque o sistema abrirá duas sessões por
usuário.

12. mudar as permissões dos arquivos de configuração:

cd /etc
chown -R pure-ftpd.pure-ftpd pure-ftpd
cd pure-ftpd
chmod o= pureftpd-mysql.conf (por causa da senha)

opcional:
chmod o= pure-ftpd.conf

13. criar base de dados, usuário, tabela no mysql.cpd.ufv.br

base de dados: pureftpd

usuário: pureftpd
senha: pva-net-ftp
tabela:

-- esta eh a tabela minima, veja que nao hah quotas o que serah
-- implementado via opcao na linha de comando

CREATE TABLE users (

User varchar(16) NOT NULL default '',
Password varchar(64) NOT NULL default '',
Uid varchar(16) NOT NULL default 'pure-ftpd',
Gid varchar(16) NOT NULL default 'pure-ftpd',
Dir varchar(128) NOT NULL default '',
PRIMARY KEY (User)
);

COMO FICOU NOSSA TABELA PARA FTPs VIRTUAIS:

Observação: o campo ID é necessário para não dar problemas com a superclasse, veja que o
User+IP tem que ser único.

use pureftpd;
CREATE TABLE users (
ID integer unsigned NOT NULL auto_increment,
User varchar(32) NOT NULL default '',
IP varchar(15) NOT NULL default 'nao-fornecido',
Password varchar(64) NOT NULL default '',
Uid varchar(16) NOT NULL default 'nao-fornecido',
Gid varchar(16) NOT NULL default 'nao-fornecido',
Dir varchar(128) NOT NULL default '/var/pure-ftpd',
QuotaFiles smallint unsigned NOT NULL default '1000',
QuotaSize smallint unsigned NOT NULL default '10',
MatriculaUFV varchar(14) NOT NULL default 'nao-fornecida',
PRIMARY KEY (ID),
UNIQUE KEY Usuario (User,IP)
) TYPE=MyISAM;

14. preparar a inicialização automática do sistema:

14.1. ativar o IP secundário em algum lugar:

em /etc/rc.d/init.d/rc.local colocar o seguinte comando:

ifconfig eth0:1 200.131.233.148

onde 200.131.233.148 corresponde ao segundo IP (IP virtual do servidor), sendo que

200.131.233.147 é o IP principal correspondendo ao servidor ftp.pvanet.ufv.br

14.2. alterar as tabelas de DNS para refletir os dois novos IPs:

ftp.pvanet.ufv.br deve ser um CNAME para eco.cpd.ufv.br

e ftp2.cpd.ufv.br deve ser um “IN A” para 200.131.233.148

14.3. criar o script para inicialização automática do pure-ftpd

por ser relativamente grande o script o mesmo consta do ANEXO B. O nome dado ao script
foi pure-ftpd.rc e foi colocado no subdiretório /etc/rc.d/init.d

utilizou-se a preparação da inicialização utilizando o chkconfig (ver inicio do script que

explica o que fizemos).

· PARA QUE o script inialize no boot:

cd /etc/rc.d/init.d
chmod ug+x pure-ftpd
chkconfig pure-ftpd reset

· PARA QUE o script funcione!:

 copiar do subdiretório da compilação o seguinte arquivo:
cp –p configuration-file/pure-config.pl /usr/local/sbin/
chmod ug+x /usr/local/sbin/pure-config.pl

e colorín colorado este cuento se ha acabado !

 ANEXO A
arquivo /etc/pure-ftpd/pure-ftpd.conf
############################################################
# #
# Arquivo de configuração para wrappers do pure-ftpd #
# #
############################################################

# as palavras chaves forma retiradas do pure-config.pl

# modo de execucao:
# /usr/local/sbin/pure-config.pl /etc/pure-ftpd/pure-ftpd.conf

# Please don't forget to have a look at documentation at

# http://www.pureftpd.org/documentation.shtml for a complete list of
# options.

#LOCAL - inicio#

# IMPORTANTE
# limites de conexao/usuarios devem ser "contados em dobro" jah que
# compilamos o servidor com --with-privsep que abre 2 sessoes por
# conexao.

# pode ser necessario se os browses nao enxergarem os arquivos:

#NATmode yes
AllowDotFiles no

#LOCAL - fim#

# Cage in every user in his home directory

ChrootEveryone yes

# If the previous option is set to "no", members of the following group

# won't be caged. Others will be. If you don't want chroot()ing anyone,
# just comment out ChrootEveryone and TrustedGID.

# TrustedGID 100

# Turn on compatibility hacks for broken clients

#LOCAL#BrokenClientsCompatibility no
BrokenClientsCompatibility yes

# Maximum number of simultaneous users

#LOCAL#MaxClientsNumber 50
MaxClientsNumber 200

# Fork in background

Daemonize yes

# Maximum number of sim clients with the same IP address

#LOCAL#MaxClientsPerIP 8
MaxClientsPerIP 60

# If you want to log all client commands, set this to "yes".

# This directive can be duplicated to also log server responses.

VerboseLog no

# List dot-files even when the client doesn't send "-a".

#LOCAL#DisplayDotFiles yes
DisplayDotFiles no

# Don't allow authenticated users - have a public anonymous FTP only.

AnonymousOnly no

# Disallow anonymous connections. Only allow authenticated users.

#LOCAL#NoAnonymous no
NoAnonymous yes

# Syslog facility (auth, authpriv, daemon, ftp, security, user, local*)

# The default facility is "ftp". "none" disables logging.

SyslogFacility ftp

# Display fortune cookies

# FortunesFile /usr/share/fortune/zippy

# Don't resolve host names in log files. Logs are less verbose, but
# it uses less bandwidth. Set this to "yes" on very busy servers or
# if you don't have a working DNS.

#LOCAL#DontResolve yes
DontResolve no

# Maximum idle time in minutes (default = 15 minutes)

#LOCAL#MaxIdleTime 15
MaxIdleTime 7

# LDAP configuration file (see README.LDAP)

# LDAPConfigFile /etc/pureftpd-ldap.conf

# MySQL configuration file (see README.MySQL)

#LOCAL## MySQLConfigFile /etc/pureftpd-mysql.conf

MySQLConfigFile /etc/pure-ftpd/pureftpd-mysql.conf

# Postgres configuration file (see README.PGSQL)

# PGSQLConfigFile /etc/pureftpd-pgsql.conf

# PureDB user database (see README.Virtual-Users)

# PureDB /etc/pureftpd.pdb

# Path to pure-authd socket (see README.Authentication-Modules)

# ExtAuth /var/run/ftpd.sock

# If you want to enable PAM authentication, uncomment the following line

# PAMAuthentication yes
# If you want simple Unix (/etc/passwd) authentication, uncomment this

# UnixAuthentication yes

# Please note that LDAPConfigFile, MySQLConfigFile, PAMAuthentication and

# UnixAuthentication can be used only once, but they can be combined
# together. For instance, if you use MySQLConfigFile, then UnixAuthentication,
# the SQL server will be asked. If the SQL authentication fails because the
# user wasn't found, another try # will be done with /etc/passwd and
# /etc/shadow. If the SQL authentication fails because the password was wrong,
# the authentication chain stops here. Authentication methods are chained in
# the order they are given.

# 'ls' recursion limits. The first argument is the maximum number of

# files to be displayed. The second one is the max subdirectories depth

#LOCAL#LimitRecursion 2000 8

# Are anonymous users allowed to create new directories ?

AnonymousCanCreateDirs no

# If the system is more loaded than the following value,

# anonymous users aren't allowed to download.

MaxLoad 4

# Port range for passive connections replies. - for firewalling.

# PassivePortRange 30000 50000

# Force an IP address in PASV/EPSV/SPSV replies. - for NAT.

# Symbolic host names are also accepted for gateways with dynamic IP
# addresses.

# ForcePassiveIP 192.168.0.1

# Upload/download ratio for anonymous users.

# AnonymousRatio 1 10
# Upload/download ratio for all users.
# This directive superscedes the previous one.

# UserRatio 1 10

# Disallow downloading of files owned by "ftp", ie.

# files that were uploaded but not validated by a local admin.

AntiWarez yes

# IP address/port to listen to (default=all IP and port 21).

# Bind 127.0.0.1,21

# Maximum bandwidth for anonymous users in KB/s

# AnonymousBandwidth 8

# Maximum bandwidth for *all* users (including anonymous) in KB/s

# Use AnonymousBandwidth *or* UserBandwidth, both makes no sense.

# UserBandwidth 8

# File creation mask. <umask for files>:<umask for dirs> .

# 177:077 if you feel paranoid.

Umask 133:022

# Minimum UID for an authenticated user to log in.

MinUID 100

# Allow FXP transfers for authenticated users.

AllowUserFXP no
# Allow anonymous FXP for anonymous and non-anonymous users.

AllowAnonymousFXP no

# Users can't delete/write files beginning with a dot ('.')

# even if they own them. If TrustedGID is enabled, this group
# will have access to dot-files, though.

ProhibitDotFilesWrite no

# Prohibit *reading* of files beginning with a dot (.history, .ssh...)

ProhibitDotFilesRead no

# Never overwrite files. When a file whoose name already exist is uploaded,
# it get automatically renamed to file.1, file.2, file.3, ...

AutoRename no

# Disallow anonymous users to upload new files (no = upload is allowed)

#LOCAL#AnonymousCantUpload no
AnonymousCantUpload yes

# Only connections to this specific IP address are allowed to be

# non-anonymous. You can use this directive to open several public IPs for
# anonymous FTP, and keep a private firewalled IP for remote administration.
# You can also only allow a non-routable local IP (like 10.x.x.x) to
# authenticate, and keep a public anon-only FTP server on another IP.

#TrustedIP 10.1.1.1

# If you want to add the PID to every logged line, uncomment the following
# line.

#LOCAL##LogPID yes
LogPID yes

# Create an additional log file with transfers logged in a Apache-like format :

# fw.c9x.org - jedi [13/Dec/1975:19:36:39] "GET /ftp/linux.tar.bz2" 200 21809338
# This log file can then be processed by www traffic analyzers.

# AltLog clf:/var/log/pureftpd.log

# Create an additional log file with transfers logged in a format optimized

# for statistic reports.

#LOCAL## AltLog stats:/var/log/pureftpd.log

AltLog stats:/var/log/pure-ftpd/pureftpd.log

# Create an additional log file with transfers logged in the standard W3C
# format (compatible with most commercial log analyzers)

# AltLog w3c:/var/log/pureftpd.log

# Disallow the CHMOD command. Users can't change perms of their files.

#LOCAL##NoChmod yes
NoChmod yes

# Allow users to resume and upload files, but *NOT* to delete them.

#KeepAllFiles yes

# Automatically create home directories if they are missing

#LOCAL#CreateHomeDir yes
CreateHomeDir yes

# Enable virtual quotas. The first number is the max number of files.
# The second number is the max size of megabytes.
# So 1000:10 limits every user to 1000 files and 10 Mb.

#Quota 1000:10

# If your pure-ftpd has been compiled with standalone support, you can change
# the location of the pid file. The default is /var/run/pure-ftpd.pid

#PIDFile /var/run/pure-ftpd.pid
# If your pure-ftpd has been compiled with pure-uploadscript support,
# this will make pure-ftpd write info about new uploads to
# /var/run/pure-ftpd.upload.pipe so pure-uploadscript can read it and
# spawn a script to handle the upload.

#CallUploadScript yes

# This option is useful with servers where anonymous upload is

# allowed. As /var/ftp is in /var, it save some space and protect
# the log files. When the partition is more that X percent full,
# new uploads are disallowed.

#LOCAL#MaxDiskUsage 99
MaxDiskUsage 95

# Set to 'yes' if you don't want your users to rename files.

#NoRename yes

# Be 'customer proof' : workaround against common customer mistakes like

# 'chmod 0 public_html', that are valid, but that could cause ignorant
# customers to lock their files, and then keep your technical support busy
# with silly issues. If you're sure all your users have some basic Unix
# knowledge, this feature is useless. If you're a hosting service, enable it.

CustomerProof yes

# Per-user concurrency limits. It will only work if the FTP server has
# been compiled with --with-peruserlimits (and this is the case on
# most binary distributions) .
# The format is : <max sessions per user>:<max anonymous sessions>
# For instance, 3:20 means that the same authenticated user can have 3 active
# sessions max. And there are 20 anonymous sessions max.

#LOCAL## PerUserLimits 3:20

#LOCAL# lembrar que precisa mínimo "2:" para limitar a 1 login por
#LOCAL# usuário se compilado com –with-privsep
PerUserLimits 2:30

# When a file is uploaded and there is already a previous version of the file
# with the same name, the old file will neither get removed nor truncated.
# Upload will take place in a temporary file and once the upload is complete,
# the switch to the new version will be atomic. For instance, when a large PHP
# script is being uploaded, the web server will still serve the old version and
# immediatly switch to the new one as soon as the full file will have been
# transfered. This option is incompatible with virtual quotas.

# NoTruncate yes

# This option can accept three values :

# 0 : disable SSL/TLS encryption layer (default).
# 1 : accept both traditional and encrypted sessions.
# 2 : refuse connections that don't use SSL/TLS security mechanisms,
# including anonymous sessions.
# Do _not_ uncomment this blindly. Be sure that :
# 1) Your server has been compiled with SSL/TLS support (--with-tls),
# 2) A valid certificate is in place,
# 3) Only compatible clients will log in.

# TLS 1

# Listen only to IPv4 addresses in standalone mode (ie. disable IPv6)

# By default, both IPv4 and IPv6 are enabled.

# IPV4Only yes

# Listen only to IPv6 addresses in standalone mode (ie. disable IPv4)

# By default, both IPv4 and IPv6 are enabled.

# IPV6Only yes
 ANEXO B
arquivo /etc/rc.d/init.d/pure-ftpd.rc
#!/bin/sh
#
# Start/stop/restart the pureftp server:
# OBTIDO em abr/05 via:
# http://www.vivaolinux.com.br/scripts/verFonte.php?codigo= (continua o link)
# 1015&arquivo=build_pureftpd.sh
#
# MODIFICADO: Dojai - abr/05 para ter chkconfig (igual ao proftpd), apontar
# corretamente para os arquivos e mini correcoes.
#
# chkconfig: 345 85 15
# description: servidor de ftp pure-ftpd que permite o uso de banco \
# de dados, servidores virtuais etc.

ftpd_start() {
#LOCAL#/usr/sbin/pure-config.pl /etc/pure-ftpd.conf
/usr/local/sbin/pure-config.pl /etc/pure-ftpd/pure-ftpd.conf
}

ftpd_stop() {
killall pure-ftpd
}

ftpd_restart() {
ftpd_stop
sleep 1
ftpd_start
}

#LOCAL#case "\$1" in
case "$1" in
'start')
ftpd_start
;;
'stop')
ftpd_stop
;;
'restart')
ftpd_restart
;;
*)
#LOCAL#echo "usage \$0 start|stop|restart"
echo "usage $0 start|stop|restart"
esac
 ANEXO C
arquivo /etc/pure-ftpd/pureftpd-mysql.conf
##############################################
# #
# Sample Pure-FTPd Mysql configuration file. #
# See README.MySQL for explanations. #
# #
##############################################

# Optional : MySQL server name or IP. Don't define this for unix sockets.

#LOCAL## MYSQLServer 127.0.0.1

MYSQLServer mysql.cpd.ufv.br

# Optional : MySQL port. Don't define this if a local unix socket is used.

# MYSQLPort 3306

# Optional : define the location of mysql.sock if the server runs on this host.

MYSQLSocket /tmp/mysql.sock

# Mandatory : user to bind the server as.

#LOCAL#MYSQLUser root
MYSQLUser pureftpd

# Mandatory : user password. You must have a password.

#LOCAL#MYSQLPassword rootpw
MYSQLPassword net-pva-ftp

# Mandatory : database to open.

MYSQLDatabase pureftpd

# Mandatory : how passwords are stored

# Valid values are : "cleartext", "crypt", "md5" and "password"
# ("password" = MySQL password() function)
# You can also use "any" to try "crypt", "md5" *and* "password"

MYSQLCrypt cleartext

# In the following directives, parts of the strings are replaced at

# run-time before performing queries :
#
# \L is replaced by the login of the user trying to authenticate.
# \I is replaced by the IP address the user connected to.
# \P is replaced by the port number the user connected to.
# \R is replaced by the IP address the user connected from.
# \D is replaced by the remote IP address, as a long decimal number.
#
# Very complex queries can be performed using these substitution strings,
# especially for virtual hosting.

# Query to execute in order to fetch the password

#LOCAL#MYSQLGetPW SELECT Password FROM users WHERE User="\L"

MYSQLGetPW SELECT Password FROM users WHERE User="\L" and IP="\I"

# Query to execute in order to fetch the system user name or uid

#LOCAL#MYSQLGetUID SELECT Uid FROM users WHERE User="\L"

MYSQLGetUID SELECT Uid FROM users WHERE User="\L" and IP="\I"

# Optional : default UID - if set this overrides MYSQLGetUID

#MYSQLDefaultUID 1000

# Query to execute in order to fetch the system user group or gid

#LOCAL#MYSQLGetGID SELECT Gid FROM users WHERE User="\L"

MYSQLGetGID SELECT Gid FROM users WHERE User="\L" and IP="\I"

# Optional : default GID - if set this overrides MYSQLGetGID

#MYSQLDefaultGID 1000

# Query to execute in order to fetch the home directory

#LOCAL#MYSQLGetDir SELECT Dir FROM users WHERE User="\L"

MYSQLGetDir SELECT Dir FROM users WHERE User="\L" and IP="\I"

# Optional : query to get the maximal number of files

# Pure-FTPd must have been compiled with virtual quotas support.

#LOCAL## MySQLGetQTAFS SELECT QuotaFiles FROM users WHERE User="\L"

MySQLGetQTAFS SELECT QuotaFiles FROM users WHERE User="\L" and IP="\I"

# Optional : query to get the maximal disk usage (virtual quotas)

# The number should be in Megabytes.
# Pure-FTPd must have been compiled with virtual quotas support.
#LOCAL## MySQLGetQTASZ SELECT QuotaSize FROM users WHERE User="\L"
MySQLGetQTASZ SELECT QuotaSize FROM users WHERE User="\L" and IP="\I"

# Optional : ratios. The server has to be compiled with ratio support.

# MySQLGetRatioUL SELECT ULRatio FROM users WHERE User="\L"

# MySQLGetRatioDL SELECT DLRatio FROM users WHERE User="\L"

# Optional : bandwidth throttling.

# The server has to be compiled with throttling support.
# Values are in KB/s .

# MySQLGetBandwidthUL SELECT ULBandwidth FROM users WHERE User="\L"

# MySQLGetBandwidthDL SELECT DLBandwidth FROM users WHERE User="\L"

# Enable ~ expansion. NEVER ENABLE THIS BLINDLY UNLESS :

# 1) You know what you are doing.
# 2) Real and virtual users match.

# MySQLForceTildeExpansion 1

# If you upgraded your tables to transactionnal tables (Gemini,

# BerkeleyDB, Innobase...), you can enable SQL transactions to
# avoid races. Leave this commented if you are using the
# traditionnal MyIsam databases or old (< 3.23.x) MySQL versions.

# MySQLTransactions On