[Power by FreeBSD]
顏國雄 2001/08/11 初
Open WebMail
2004/05/23 修改 

1. 簡介

Open WebMail 是一個由 Neomail version 1.14 發展而來的 webmail,經由幾年的發展,目前的功能愈來愈多,效能上也提供很多,它詳細的功能可以在 Open WebMail 總站中查看:

http://turtle.ee.ncku.edu.tw/openwebmail/

2. 安裝 Open WebMail

2.1. 以 packages 安裝

下面介紹如何以 packages 來安裝 openwebmail-2.10 (版本序號自行更改)。

安裝前要注意,因為 openwebmail package 檔案預設會安裝到 /usr/local/www/cgi-bin 和 /usr/local/www/data 中,所以,如果 apache 的設定檔已經修改了 DocumentRoot 和 ScriptAlias 的設定,要注意路徑問題。

執行下面指令 (packages URL 自行調整):

pkg_add -v ftp://ftp.tku.edu.tw/OS/FreeBSD/packages/packages-stable/All/openwebmail-2.10.tgz


如果安裝成功,預設應該會多了下面兩個目錄:

/usr/local/www/cgi-bin/openwebmail
/usr/local/www/data/openwebmail


2.2. 安裝失敗的檢查

FreeBSD 以 packages 安裝軟體如果失敗,多半是少安裝相依的 packages

下面是在安裝成功的機器上利用 pkg_info 列出需安裝的相依 packages 供參考:

pkg_info -r openwebmail-2.10

Information for openwebmail-2.10:
Depends on:
Dependency: libiconv-1.9.1_1
Dependency: p5-Authen-SASL-2.04
Dependency: p5-MIME-Base64-2.20
Dependency: p5-File-Spec-0.82
Dependency: p5-CGI.pm-2.97,1
Dependency: p5-CGI-SpeedyCGI-2.21_3
Dependency: p5-Net-1.12,1
Dependency: p5-Text-Iconv-1.2_1

所以,如果 openwebmail-2.10 安裝失敗時可以檢查上面的清單,看看到底少了哪個 packages


3. Open WebMail 安裝後的首次設定

如果登入 Open WebMaill 時出現下面的訊息:

Open WebMail ERROR

無法開啟 /usr/local/www/cgi-bin/openwebmail/etc/sessions! (No such file or directory)

或是:

Open WebMail ERROR

無法開啟 /usr/local/www/cgi-bin/openwebmail/etc/sessions/xxxx*-session-0.742660565767437! (Permission denied)

 

表示沒有在 /usr/local/www/cgi-bin/openwebmail/etc 中建立好 sessions 的目錄,或是權限沒設定好,可以執行下面的指令:

cd /usr/local/www/cgi-bin/openwebmail/etc
mkdir sessions
chown root:mail sessions
chmod 770 sessions

上面的錯誤訊息已經是 FAQ,在 Open WebMaill 的 faq.txt 中已有說明囉!!


4. 如何排除執行時的錯誤


因為 Open WebMail 是 apache 下的 CGI ,發生錯誤時當然是要先查看一下 apache 的 error log
馬上執行下面指令,看看最後幾行:

tail /var/log/httpd-errors.log

如果還是無法由 apache 的 error log 看出問題的所在,先看一下Open WebMail的 readme.txtfaq.txt
說明文件安裝時即已置入 /usr/local/www/data/openwebmail

所以假設 server 叫 mail.x.y.z 文件的網址應該是:

http://mail.x.y.z/openwebmail/

不然也可連回 Open WebMail 的總站查看:

http://turtle.ee.ncku.edu.tw/openwebmail/

如果該安裝的配合套件都安裝了,大部份都是檔案的權限有問題, FAQ 中寫得很詳細,絕對值得一看。

 

5.所有人透過 POP3 收別台主機上的信件

假設 openwebmail 是在 www.test.tp.edu.tw 而使用者的信件卻在 mail.test.tp.edu.tw 為了讓所有的使用者可以透過 openwebmail 以 POP3 來收 mail.test.tp.edu.tw 上的信件,我們可以修改在 www.tp.edu.tw 主機上的 OpenWebmail 的設定檔 etc/openwebmail.conf ,在裡面加入下面的設定:

domainnames mail.test.tp.edu.tw
auth_module auth_pop3.pl
pop3_authserver mail.test.tp.edu.tw
pop3_authport 110
getmail_from_pop3_authserver yes
use_syshomedir no
use_homedirspools yes
frombook_for_realname_only yes
default_realname none

設定說明:

  • domainnames:設定使用者寄信時,電子郵件地址小老鼠(@)右邊的 domainnames 預設值。如果不設定,以前面例子來說,會是 www.test.tp.edu.tw ,這樣,別人的回信會寄錯地址。
  • auth_module :告訴 OpenWebmail 以 auth_pop3.pl 來做使用者認證。
  • pop3_authserver:指定 POP3 主機是哪一台。
  • getmail_from_pop3_authserver:這個要設為 yes ,不然,使用者看不到在 POP3 server 上的信件。
  • use_syshomedir:以本機系統直接認證時,OpenWebmail 直接將資料儲存在該使用者位在 home 的個人目錄下,但是,透過本方式來收信,OpenWebmail 會以 web server 設定的身份來當使用者,一般都是 nobody:nobdy 或是 www:www ,所以不能讓 OpenWebmail 使用 syshomedir,因此,我們設定 user_syshomedir 為 no ,它會為每個使用者自動建立一個目錄 (預設是放在 OpenWebmail 的 etc/users 中,例如:gsyan 登入時,它會自動產生 cgi-bin/openwebmail/etc/users/gsyan )。
  • use_homedirspools:理由類似前項說明,我們無法使用預設的 mail spool ,所以本選項設為 yes ,讓 OpenWebmail 將郵件儲存在為使用者自動產生的虛擬 home 中。
  • frombook_for_realname_only:本選項設為 yes 的目的是,只讓使用修改寄件人地址的真實姓名部份,郵件地址則不可修改。
  • default_realname:配合前項設定,將預設的真實姓名設為 none ,也就是設為空的值,不然它會被設為跑 web server 的帳號的 realname 。

Q:當我們使用 use_syshomedir no 時如何設定使用者的虛擬 homedir ?

A:預設是在 openwebmail 的 etc/users ,我們可以依下列方法修改:

    1. 在 openwebmail.conf 中設定 ow_usersdir
    2. 例如:要讓使用者放在 /home/webmail 中則,加入下面這行

      ow_usersdir /home/webmail

    3. 建立前項所設定的目錄,以前例來說就執行:
    4. mkdir /home/webmail

附註:

  • 使用這種方式要注意 ow_usersdir 所在 partition 的空間夠不夠。
  • openwebmail.conf 的相關設定可以參考 cgi-bin/openwebmail/etc/openwebmail.conf.help
  • 本部份目前在 openwebmail-2.30 上測試成功。



 


 基礎: 書籤 - 簡介 - 安裝 - Slices - Unix基礎 - 基本指令 - 首次登入 - 目錄架構
 系統: 核心編譯 - 系統升級 - Packages - Ports - PicoBSD - Quota
 網路: 服務管理 - WWW - FTP - MAIL - DNS - Samba - NFS - DHCP - webmin - IMP - OpenWebmail
 其它: Backup - UPS - 系統安全 - ipfw&natd - 撥接服務 - 計時制ADSL - 雜記 - FAQ

北市文山區力行國小顏國雄