vpopmail5.abw

相当优秀的 UNIX 进程管理工具

<p>&lt;H4&gt;</p>
<p>Vpasswd/cdb options&lt;/H4&gt;</p>
<p>&lt;H5&gt;--enable-ucspi-dir=dir Directory where the compiled ucspi package</p>
<p>is.&lt;/H5&gt;</p>
<p>&lt;DL&gt;</p>
<p>	&lt;DD&gt;Set the directory where the ucspi-tcp package is located. By</p>
<p>	default this is set to ../ucspi-tcp-0.84. Vpopmail uses headers in</p>
<p>	this directory and uses two .a files.&lt;/DD&gt;&lt;/DL&gt;</p>
<p>&lt;H4&gt;</p>
<p>Logging options&lt;/H4&gt;</p>
<p>&lt;H5&gt;--enable-logging=e|y|n Turn on (y) or off (n) logging to syslog</p>
<p>or (e) only log errors </p>
<p>&lt;/H5&gt;</p>
<p>&lt;DL&gt;</p>
<p>	&lt;DD&gt;Set the level of logging. By default it only logs pop</p>
<p>	authentication errors. You can turn off all logging by setting it to</p>
<p>	no. And you can log all pop authentications by setting it to yes.&lt;/DD&gt;&lt;/DL&gt;</p>
<p>&lt;H5&gt;</p>
<p>--enable-log-name=vpopmail set syslog name.&lt;/H5&gt;</p>
<p>&lt;DL&gt;</p>
<p>	&lt;DD&gt;Over ride the default vpopmail syslog name.&lt;/DD&gt;&lt;/DL&gt;</p>
<p>&lt;H4&gt;</p>
<p>User/group options&lt;/H4&gt;</p>
<p>&lt;H5&gt;--enable-vpopuser=vpopmail user vchkpw was installed as.&lt;/H5&gt;</p>
<p>&lt;DL&gt;</p>
<p>	&lt;DD&gt;If for some reason you want to install this package under a</p>
<p>	different user name, use this option.&lt;/DD&gt;&lt;/DL&gt;</p>
<p>&lt;H5&gt;</p>
<p>--enable-vpopgroup=vchkpw group vchkpw was installed as.&lt;/H5&gt;</p>
<p>&lt;DL&gt;</p>
<p>	&lt;DD&gt;If for some reason you want to install this package under a</p>
<p>	different group name, use this option.&lt;/DD&gt;&lt;/DL&gt;</p>
<p>&lt;H5&gt;</p>
<p>--enable-admin-email=email-address e-mail of system administrator.&lt;/H5&gt;</p>
<p>&lt;DL&gt;</p>
<p>	&lt;DD&gt;Override the default email administrator address.&lt;/DD&gt;&lt;/DL&gt;</p>
<p>&lt;H4&gt;</p>
<p>Directory and file location options&lt;/H4&gt;</p>
<p>&lt;H5&gt;--enable-tcpserver-file=/etc/tcp.smtp File where tcpserver -x</p>
<p>relay information is stored.&lt;/H5&gt;</p>
<p>&lt;DL&gt;</p>
<p>	&lt;DD&gt;Set the file name of your tcp.smtp file. By default the</p>
<p>	configure program looks in /etc and then in /etc/tcprules.d</p>
<p>	directories.&lt;/DD&gt;&lt;/DL&gt;</p>
<p>&lt;H5&gt;</p>
<p>--enable-qmaildir=dir directory where qmail is installed.&lt;/H5&gt;</p>
<p>&lt;DL&gt;</p>
<p>	&lt;DD&gt;If you installed qmail into a directory other than /var/qmail,</p>
<p>	use this option.&lt;/DD&gt;&lt;/DL&gt;</p>
<p>&lt;H5&gt;</p>
<p>--enable-tcprules-prog=/usr/local/bin/tcprules where is your tcprules</p>
<p>program.&lt;/H5&gt;</p>
<p>&lt;DL&gt;</p>
<p>	&lt;DD&gt;If you installed the tcprules program into a directory other</p>
<p>	than /usr/local/bin, use this option.&lt;/DD&gt;&lt;/DL&gt;</p>
<p>&lt;H5&gt;</p>
<p>--enable-apop-file=/etc/apop-secrets directory where apop secrerts</p>
<p>are stored.&lt;/H5&gt;</p>
<p>&lt;DL&gt;</p>
<p>	&lt;DD&gt;Over ride the default location of the apop-secrets file.&lt;/DD&gt;&lt;/DL&gt;</p>
<p>&lt;H4&gt;</p>
<p>Other options&lt;/H4&gt;</p>
<p>&lt;H5&gt;--enable-apop=y|n Enable or disable apop authentication. </p>
<p>&lt;/H5&gt;</p>
<p>&lt;DL&gt;</p>
<p>	&lt;DD&gt;Disable apop by setting this option to no. The default is yes</p>
<p>	(pop and apop).&lt;/DD&gt;&lt;/DL&gt;</p>
<p>&lt;H5&gt;</p>
<p>--enable-passwd=y|n Enable or disable /etc/passwd (or shadow)</p>
<p>authentication. </p>
<p>&lt;/H5&gt;</p>
<p>&lt;DL&gt;</p>
<p>	&lt;DD&gt;Over ride the automatic configuration. By default the</p>
<p>	configuration program will automatically detect if you are using</p>
<p>	passwd and shadow passwords. By setting this option to no, you will</p>
<p>	disable all /etc/passwd authentication.&lt;/DD&gt;&lt;/DL&gt;</p>
<p>&lt;H3&gt;</p>
<p>Qmail and Virtual domains&lt;/H3&gt;</p>
<p>&lt;P&gt;Qmail has an idea of email domains that are &amp;quot;local&amp;quot; and</p>
<p>&amp;quot;virtual&amp;quot;. Local domains are ones which primarily match</p>
<p>against /etc/passwd. Virtual domains match against domains listed in</p>
<p>the qmail control file &amp;quot;virtualdomains&amp;quot;. Vpopmail makes use</p>
<p>of the qmail users/assign file and virtualdomains file. The</p>
<p>users/assign file gets compiled into a users/cdb file. It is a hashed</p>
<p>database to speed searches for patterns. If a pattern is matched then</p>
<p>qmail delivers the email to the directory defined in the file using</p>
<p>the uid and gid which as also defined. Vpopmail makes use of this</p>
<p>method to have qmail deliver all virtual domain email as the single</p>
<p>uid/gid vpopmail/vchkpw. It also uses it to direct delivery to a</p>
<p>vpopmail/domains/&amp;lt;virtualdomain&amp;gt; directory.&lt;/P&gt;</p>
<p>&lt;P&gt;Once qmail-local gets the information from the users/assign file</p>
<p>it performs standard .qmail file processing in the directory. Normal</p>
<p>.qmail-&amp;lt;user&amp;gt; files can be used for forwarding, aliases or</p>
<p>invoking programs such as ezmlm. If no matches are found qmail-local</p>
<p>looks for a .qmail-default file. This is the last stage in</p>
<p>qmail-locals delivery mechansim. Vpopmail uses this file to invoke</p>
<p>the vdelivermail program. This program takes two parameters, the</p>
<p>first is not used (it is there for backward compatibility). The</p>
<p>second parameter is the default delivery if a virtual domain user can</p>
<p>not be found. Basicly, it can be a directory to deliver the email to,</p>
<p>an email address to forward the email to, the string</p>
<p>&amp;quot;bounce-no-mailbox&amp;quot; to bounce the mail back to the sender</p>
<p>or the string &amp;quot;delete&amp;quot; to drop/delete the mail.&lt;/P&gt;</p>
<p>&lt;P&gt;Once vdelivermail is started up, it uses the core vpopmail api</p>
<p>calls to check for a virtual domain user. If the user exists, the</p>
<p>email is delivered into their directory. If vpopmail was configured</p>
<p>for hard quotas (default is yes with 50Meg quota), then the size of</p>
<p>the users current email files in their Maildir/new and Maildir/cur</p>
<p>directories are counted. If the user is over quota the email is</p>
<p>bounced back to the user with a bounce message that can be</p>
<p>customized. If the message is 1Kbytes or smaller the email will</p>
<p>always be delivered. This is so system administration programs can</p>
<p>always get a message through to the user. </p>
<p>&lt;/P&gt;</p>
<p>&lt;H3&gt;Converting current user accounts&lt;/H3&gt;</p>
<p>&lt;P&gt;The vconvert program can convert email accounts from one format</p>
<p>into another format. Conversion can be between /etc/passwd, vpasswd</p>
<p>files, mysql (small version) and mysql (large version. </p>
<p>&lt;/P&gt;</p>
<p>&lt;P&gt;Most current vpopmail users would probably be interested in how to</p>
<p>convert current domains into mysql domains. To make it simple to</p>
<p>convert an entire machine to mysql, use the following command:</p>
<p>vconvert -c -s  This will go through all the domains in</p>
<p>~vpopmail/domains directory and read each vpasswd file and load the</p>
<p>contents into the vpopmail.vpopmail mysql table. The vpasswd file is</p>
<p>left untouched for safety. Vconvert can also be run against one or</p>
<p>more domains at a time. This is done by running the command as so:</p>
<p>vconvert \c \s domain1 domain2 ...&lt;/P&gt;</p>
<p>&lt;P&gt;To convert all users (except root and system accounts) into a</p>
<p>mysql domain run the following command: vconvert -e -s domain. This</p>
<p>reads all /etc/passwd accounts and creates mysql entries using their</p>
<p>passwords. The passwords can be in either /etc/passwd or /etc/shadow.</p>
<p>These passwords should work under vchkpw authentication program. </p>
<p>&lt;/P&gt;</p>
<p>&lt;H3&gt;Security and pop server under tcpserver&lt;/H3&gt;</p>
<p>&lt;P&gt;If all of your pop email accounts are under virtual domains, you</p>
<p>can increase the security of your pop server by running it under the</p>
<p>uid and gid of vpopmail/vchkpw using the tcpserver -u and -g options.&lt;/P&gt;</p>
<p>&lt;H3&gt;Commands&lt;/H3&gt;</p>
<p>&lt;P STYLE="margin-bottom: 0in"&gt;&lt;BR&gt;</p>
<p>&lt;/P&gt;</p>
<p>&lt;H3&gt;Quota's&lt;/H3&gt;</p>
<p>&lt;P STYLE="margin-bottom: 0in"&gt;&lt;BR&gt;</p>
<p>&lt;/P&gt;</p>
<p>&lt;H3&gt;Bouncing mail&lt;/H3&gt;</p>
<p>&lt;P STYLE="margin-bottom: 0in"&gt;&lt;BR&gt;</p>
<p>&lt;/P&gt;</p>
<p>&lt;H3&gt;&lt;a name="directorystructure"&gt;Directory structure&lt;/a&gt;&lt;/H3&gt;</p>
<p>&lt;H4&gt;Overall vpopmail directory structure&lt;/H4&gt;</p>
<p>&lt;P&gt;Vpopmail gets it's own home directory. Under this directory there</p>
<p>are the following:&lt;/P&gt;</p>
<p>&lt;DL&gt;</p>
<p>	&lt;DD&gt;bin - contains all the binaries&lt;/DD&gt;&lt;DD&gt;</p>
<p>	lib - contains the libvpopmail.a file&lt;/DD&gt;&lt;DD&gt;</p>
<p>	include - contains the C header files&lt;/DD&gt;&lt;DD&gt;</p>
<p>	users - for backward compatibility for people who mix /etc/passwd</p>
<p>	users with vpopmail users in one domain&lt;/DD&gt;&lt;DD&gt;</p>
<p>	domains - where all the virtual domains are kept.&lt;/DD&gt;&lt;/DL&gt;</p>
<p>&lt;H4&gt;</p>
<p>Virtual domain user directory structure&lt;/H4&gt;</p>
<p>&lt;P&gt;Vpopmail uses an adaptive directory structure based on a state</p>
<p>file &amp;quot;.dir-control&amp;quot; which is automatically managed by the</p>
<p>core vpopmail api functions &amp;quot;vadduser&amp;quot; and &amp;quot;vdeluser&amp;quot;.</p>
<p>For sites with 100 users or less, all user directories are stored in</p>
<p>the virtual domain directory. For sites that go above 100 users the</p>
<p>adaptive directory structure goes into effect. The basic idea is to</p>
<p>break up the user Maildir directories across multple directories and</p>
<p>sub directories so that there are never more than 100 user</p>
<p>directories in a single directory.&lt;/P&gt;</p>
<p>&lt;P&gt;The default directory setup allows for 62 directories in 3 levels</p>
<p>and 100 user directories per directory. The total number of user</p>
<p>directories is equal to 100 + (62 * 100) + (62 * 62 * 100) + (62 * 62</p>
<p>* 62 * 100) = over 24 million directories. This should be more than</p>
<p>sufficent for any site and probably goes beyond the technology of</p>
<p>directory structures. </p>
<p>&lt;/P&gt;</p>
<p>&lt;P&gt;If you are going to be storing large numbers of user directories,</p>
<p>make sure you set your file system to have a higher than normal</p>
<p>percentage of inodes. </p>
<p>&lt;/P&gt;</p>
<p>&lt;P&gt;Vpopmail will automatically create these directories and sub</p>
<p>directories as needed and populate each directory with up to 100 user</p>
<p>accounts. As soon as a directory reaches 100 users it will create the</p>