📄 vpopmail.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN"><HTML><HEAD> <TITLE></TITLE> <META NAME="GENERATOR" CONTENT="StarOffice/5.1 (Linux)"> <META NAME="AUTHOR" CONTENT=" "> <META NAME="CREATED" CONTENT="19991117;8432800"> <META NAME="CHANGEDBY" CONTENT=" "> <META NAME="CHANGED" CONTENT="19991127;11073500"></HEAD><BODY><H2 ALIGN=CENTER>vpopmail Adminstration Guide</H2><H3 ALIGN=CENTER>by Ken Jones</H3><DL> <DD STYLE="text-align: center">http://www.inter7.com/vpopmail</DD></DL><P STYLE="margin-bottom: 0in"><BR></P><H3>Quick Install Guide</H3><P>To quickly install vpopmail</P><DL> <DD>unpack vpopmail distribution</DD><DD> add vchkpw group</DD><DD> add vpopmail user with vchkpw group</DD><DD> ./configure</DD><DD> make</DD><DD> make install-strip</DD><DD STYLE="margin-bottom: 0.2in"> <BR><BR> </DD></DL><P>You are now ready to add virtual domains and virtual users. Seevadddomain and vadduser. You also need to modify your pop serverstartup line to use the vchkpw program for authentication.</P><H3>Setting up all email to be virtual</H3><P>We recommend that all domains be setup as virtualdomains. </P><H3>Configuration options</H3><H4>Most used options</H4><H5>--enable-roaming-users=n|y Enable or disable open relay after popauthentication. Default is no</H5><DL> <DD>Setting this to yes means that the clients IP address is added to the list of IP's that are allowed to relay through the smtp server after they authenticate with pop. A cronjob program, clearopensmtp, clears out any IP's that were authenticated over 3 hours ago. This option requires you run the smtp server with tcpserver and the -x /etc/tcp.smtp.cdb option (or where ever you put your tcp.smtp.cdb file).</DD></DL><H5>--enable-hardquota=#|n Set and Enable hard quota or n for no quota</H5><DL> <DD>Set's the default hard quota limit for each pop account. The default is 50 megs. Any incoming mail which would take the user over their hard quota limit is bounced with a message. This message can be customized. </DD><DD> If you wish to turn off quotas set this option to NOQUOTA, i.e. --enable-hardquota=NOQUOTA</DD></DL><H5>--enable-default-domain=name Default domain name, default is null.</H5><DL> <DD>We recommend you run all your email as virtual domains. You can pick one domain to be the default. If you have just one domain set it with this option. The default domain name users can authenticate with just their user name, and don't need to use <user>%<virtualdomain>. </DD></DL><H5>--enable-ip-alias-domains=y|n enable virutal domain lookup viareverse ip address lookup for virtual domains. </H5><DL> <DD>By default, ever domain uses name based virtual domains. That is: users must supply their domain name in their pop name. i.e. <user>%<virtualdomain>. This can be overridden for one domain using the --enable-default-domain option.</DD><DD> <BR> </DD><DD> Vpopmail also supports IP based virtual domains. If this option is turned on, and the user does not supply %<virtualdomain> then a reverse IP lookup is done on the server IP address that the client connected to. If the servers IP address resolves to a domain name, then vpopmail uses that name as the domain. For example:</DD><DD> <BR> </DD><DD> IP w.x.y.z resolves to test.com. User sets their pop server ip to w.x.y.z and connects. Vpopmail gets the connection, checks the IP of the SERVER side of the connection. Does a reverse IP lookup and obtains test.com. User sends joe as their pop user name. Vpopmail uses test.com as the domain. </DD><DD> <BR> </DD><DD> You can mix and match name and ip based virtual domains.</DD></DL><H5>--enable-relay-clear-minutes=360 expire time for roaming users afterpop authentication.</H5><DL> <DD>If --enable-roamin-users=y is set then this option sets how long clearopensmtp should keep IP's in the list. The default is 3 hours.</DD></DL><H4>Mysql options</H4><H4>--enable-mysql=n|y use mysql, default is no</H4><DL> <DD>Enable using mysql authentication. </DD><DD> <BR> </DD><DD> NOTE: be sure to edit vmysql.h and set the mysql server name/ip, mysql user and mysql users password. This user must have the ability to create a database vpopmail and create tables within that database.</DD></DL><H4>--enable-sqlincdir= Directory where sql include files are.</H4><DL> <DD>Set the directory where the mysql include files are. By default it is set to /usr/local/mysql. </DD></DL><H4>--enable-sqllibdir=/usr/lib/mysql Directory where sql libs are.</H4><DL> <DD>Set the directory where the mysql libmysqlclient.a file is. By default it looks in /usr/lib/mysql</DD></DL><H4>--enable-sqllibs=mysqlclient libraries for sql linking.</H4><DL> <DD>Set the library to link in. By default this is libmysqlclient.a. </DD></DL><H4>--enable-large-site=n|y Default is no, tune for large numbers ofusers per domain</H4><DL> <DD>By default vpopmail puts all domain information in one table - vpopmail. This is the most efficent method for sites most sites. If you are running one site with a very large number of users, you may want to set this option to be yes. If set to yes, vpopmail will create a table for each virtual domain. The main difference is that the domain name is not stored in the database since the table contains the domains name. For sites with 500,000+ users it can save significant disk space. However, for sites with large numbers of virtual domains it can decrease mysql system performance.</DD></DL><H4>Vpasswd/cdb options</H4><H5>--enable-ucspi-dir=dir Directory where the compiled ucspi packageis.</H5><DL> <DD>Set the directory where the ucspi-tcp package is located. By default this is set to ../ucspi-tcp-0.84. Vpopmail uses headers in this directory and uses two .a files.</DD></DL><H4>Logging options</H4><H5>--enable-logging=e|y|n Turn on (y) or off (n) logging to syslogor (e) only log errors </H5><DL> <DD>Set the level of logging. By default it only logs pop authentication errors. You can turn off all logging by setting it to no. And you can log all pop authentications by setting it to yes.</DD></DL><H5>--enable-log-name=vpopmail set syslog name.</H5><DL> <DD>Over ride the default vpopmail syslog name.</DD></DL><H4>User/group options</H4><H5>--enable-vpopuser=vpopmail user vchkpw was installed as.</H5><DL> <DD>If for some reason you want to install this package under a different user name, use this option.</DD></DL><H5>--enable-vpopgroup=vchkpw group vchkpw was installed as.</H5><DL> <DD>If for some reason you want to install this package under a different group name, use this option.</DD></DL><H5>--enable-admin-email=email-address e-mail of system administrator.</H5><DL> <DD>Override the default email administrator address.</DD></DL><H4>Directory and file location options</H4><H5>--enable-tcpserver-file=/etc/tcp.smtp File where tcpserver -xrelay information is stored.</H5><DL> <DD>Set the file name of your tcp.smtp file. By default the configure program looks in /etc and then in /etc/tcprules.d directories.</DD></DL><H5>--enable-qmaildir=dir directory where qmail is installed.</H5><DL> <DD>If you installed qmail into a directory other than /var/qmail, use this option.</DD></DL><H5>--enable-tcprules-prog=/usr/local/bin/tcprules where is your tcprulesprogram.</H5><DL> <DD>If you installed the tcprules program into a directory other than /usr/local/bin, use this option.</DD></DL><H5>--enable-apop-file=/etc/apop-secrets directory where apop secrertsare stored.</H5><DL> <DD>Over ride the default location of the apop-secrets file.</DD></DL><H4>Other options</H4><H5>--enable-apop=y|n Enable or disable apop authentication. </H5><DL> <DD>Disable apop by setting this option to no. The default is yes (pop and apop).</DD></DL><H5>--enable-passwd=y|n Enable or disable /etc/passwd (or shadow)authentication. </H5><DL> <DD>Over ride the automatic configuration. By default the configuration program will automatically detect if you are using passwd and shadow passwords. By setting this option to no, you will disable all /etc/passwd authentication.</DD></DL><H3>Qmail and Virtual domains</H3><P>Qmail has an idea of email domains that are "local" and"virtual". Local domains are ones which primarily matchagainst /etc/passwd. Virtual domains match against domains listed inthe qmail control file "virtualdomains". Vpopmail makes useof the qmail users/assign file and virtualdomains file. Theusers/assign file gets compiled into a users/cdb file. It is a hasheddatabase to speed searches for patterns. If a pattern is matched thenqmail delivers the email to the directory defined in the file usingthe uid and gid which as also defined. Vpopmail makes use of thismethod to have qmail deliver all virtual domain email as the singleuid/gid vpopmail/vchkpw. It also uses it to direct delivery to avpopmail/domains/<virtualdomain> directory.</P><P>Once qmail-local gets the information from the users/assign fileit performs standard .qmail file processing in the directory. Normal.qmail-<user> files can be used for forwarding, aliases orinvoking programs such as ezmlm. If no matches are found qmail-locallooks for a .qmail-default file. This is the last stage inqmail-locals delivery mechansim. Vpopmail uses this file to invokethe vdelivermail program. This program takes two parameters, thefirst is not used (it is there for backward compatibility). Thesecond parameter is the default delivery if a virtual domain user cannot be found. Basicly, it can be a directory to deliver the email to,an email address to forward the email to, the string"bounce-no-mailbox" to bounce the mail back to the senderor the string "delete" to drop/delete the mail.</P><P>Once vdelivermail is started up, it uses the core vpopmail apicalls to check for a virtual domain user. If the user exists, theemail is delivered into their directory. If vpopmail was configuredfor hard quotas (default is yes with 50Meg quota), then the size ofthe users current email files in their Maildir/new and Maildir/curdirectories are counted. If the user is over quota the email isbounced back to the user with a bounce message that can becustomized. If the message is 1Kbytes or smaller the email willalways be delivered. This is so system administration programs canalways get a message through to the user. </P><H3>Converting current user accounts</H3><P>The vconvert program can convert email accounts from one formatinto another format. Conversion can be between /etc/passwd, vpasswd⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -