Používání webové pošty RoundCube s ISPConfig 3 na Debian Wheezy (nginx)
Tato příručka vysvětluje, jak nainstalovat webovou aplikaci RoundCube na server Debian Wheezy se systémem ISPConfig a nginx a jak povolit zásuvné moduly ISPConfig 3 pro RoundCube, aby uživatelé mohli provádět akce, jako je změna jejich e-mailových hesel z RoundCube. Roundcube webmail je vícejazyčný IMAP klient založený na prohlížeči s uživatelským rozhraním podobným aplikaci; přichází s funkcemi, jako je podpora MIME, adresář, manipulace se složkami, vyhledávání zpráv a kontrola pravopisu.
Neposkytuji žádnou záruku, že to pro vás bude fungovat!
1 předběžná poznámka
Tento tutoriál předpokládá, že používáte nginx jako webový server na vašem serveru ISPConfig 3; tento tutoriál nebude fungovat pro Apache. Chystám se nainstalovat RoundCube z repozitářů Debian Wheezy - je to poměrně aktuální verze (0.7.2.9 vs 0.9.1 (aktuální stabilní verze)).
Ukážu, jak nakonfigurovat vhost pro RoundCube tak, aby k němu bylo možné přistupovat přes alias /webmail (např. http://www.example.com/webmail).
2 Vytvoření vzdáleného uživatele v ISPConfig
Zásuvné moduly ISPConfig 3 pro RoundCube fungují prostřednictvím vzdáleného API ISPConfig. K použití tohoto API potřebujeme vzdáleného uživatele. Chcete-li vytvořit takového uživatele, přejděte do nabídky Systém> Správa uživatelů> Vzdálení uživatelé a klikněte na tlačítko Přidat nového uživatele:
Zadejte uživatelské jméno a heslo pro uživatele...
... a povolte následující funkce:
- Funkce serveru
- Klientské funkce
- Uživatelské funkce pošty
- Funkce e-mailového aliasu
- Uživatelské funkce filtru nevyžádané pošty
- Funkce zásad filtru nevyžádané pošty
- Funkce načítání pošty
- Funkce bílé listiny filtru nevyžádané pošty
- Funkce černé listiny filtru nevyžádané pošty
- Funkce uživatelského filtru pošty
Poté klikněte na Uložit.
3 Instalace RoundCube
RoundCube můžeme nainstalovat následovně:
apt-get install roundcube roundcube-plugins roundcube-plugins-extra
Uvidíte následující otázky:
Konfigurovat databázi pro roundcube pomocí dbconfig-common? <-- Ano
Typ databáze, kterou použije roundcube:<-- mysql
Heslo administrátora databáze:<-- yourrootsqlpassword (heslo uživatele root MySQL)
Aplikace MySQL heslo pro roundcube:<-- roundcubesqlpassword
Potvrzení hesla:<-- roundcubesqlpassword
Tím se vytvoří databáze MySQL s názvem roundcube s uživatelem MySQL roundcube a heslem roundcubesqlpassword.
Dále přejděte na svůj web v ISPConfig. Na kartě Možnosti uvidíte pole Direktivy nginx:
Vyplňte následující direktivy a klikněte na Uložit (nezáleží na tom, zda máte pro tento vhost povoleno PHP nebo ne, protože tento fragment kódu používá výchozí PHP systému, které běží pod uživatelskými a skupinovými www-data, což je důležité, protože je nainstalován RoundCube mimo kořen dokumentu vhost - ve /var/lib/roundcube):
client_max_body_size 100M;
location /roundcube {
root /var/lib/;
index index.php index.html index.htm;
location ~ (.+\.php)$ {
try_files $uri =404;
include /etc/nginx/fastcgi_params;
# To access SquirrelMail, the default user (like www-data on Debian/Ubuntu) must be used
#fastcgi_pass 127.0.0.1:9000;
fastcgi_pass unix:/var/run/php5-fpm.sock;
fastcgi_index index.php;
fastcgi_intercept_errors on;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_buffer_size 128k;
fastcgi_buffers 256 4k;
fastcgi_busy_buffers_size 256k;
fastcgi_temp_file_write_size 256k;
}
location ~* /.svn/ {
deny all;
}
location ~* /README|INSTALL|LICENSE|SQL|bin|CHANGELOG$ {
deny all;
}
}
location /webmail {
rewrite ^ /roundcube last;
} |
S touto konfigurací bude RoundCube přístupný pod adresami URL http://www.example.com/webmail a http://www.example.com/roundcube.
4 Konfigurace RoundCube
Otevřete /etc/roundcube/main.inc.php...
vi /etc/roundcube/main.inc.php
... a nastavte $rcmail_config['default_host'] ='localhost'; (nebo název hostitele nebo IP adresa vašeho poštovního serveru, pokud je na vzdáleném počítači):
[...] $rcmail_config['default_host'] = 'localhost'; [...] |
V opačném případě bude RoundCube před každým přihlášením vyžadovat jméno hostitele, což by mohlo přetížit vaše uživatele – chceme vám používání co nejvíce usnadnit.
Dále nainstalujte pluginy ISPConfig 3 pro RoundCube:
cd /tmp
git clone https://github.com/w2c/ispconfig3_roundcube.git
cd /tmp/ispconfig3_roundcube/
mv ispconfig3_* /usr/share/roundcube/
cd /usr/share/roundcube/
mv ispconfig3_account/config/config.inc.php.dist ispconfig3_account/config/config.inc.php
ln -s /usr/share/roundcube/ispconfig3_* /var/lib/roundcube/plugins/
Otevřete ispconfig3_account/config/config.inc.php...
vi ispconfig3_account/config/config.inc.php
... a vyplňte přihlašovací údaje vašeho vzdáleného uživatele ISPConfig a URL vzdáleného API - moje instalace ISPConfig běží na https://192.168.0.100:8080, takže URL vzdáleného API je https://192.168 .0.100:8080/remote/:
<?php $rcmail_config['identity_limit'] = false; $rcmail_config['remote_soap_user'] = 'roundcube'; $rcmail_config['remote_soap_pass'] = 'Sw0wlytlRt3MY'; $rcmail_config['soap_url'] = 'https://192.168.0.100:8080/remote/'; ?> |
Nakonec znovu otevřete /etc/roundcube/main.inc.php...
vi /etc/roundcube/main.inc.php
... a povolit plugin jquerui plus pluginy ISPConfig 3...
[...]
// ----------------------------------
// PLUGINS
// ----------------------------------
// List of active plugins (in plugins/ directory)
//$rcmail_config['plugins'] = array();
$rcmail_config['plugins'] = array("jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter");
[...] |
... a změňte vzhled z výchozího na klasický (jinak nebudou zásuvné moduly ISPConfig 3 fungovat):
[...] // skin name: folder from skins/ $rcmail_config['skin'] = 'classic'; [...] |
A je to; nyní můžete přistupovat k RoundCube pod aliasem /webmail (např. www.example.com/webmail). Přihlaste se pomocí e-mailové adresy a hesla e-mailového účtu vytvořeného prostřednictvím ISPConfig:
Takto vypadá RoundCube:
V části Nastavení> Účet můžete použít pluginy ISPconfig 3 pro RoundCube k úpravě nastavení, například...
... můžete nastavit nové heslo pro svůj e-mailový účet bez použití ISPConfig:
5 odkazů
- RoundCube:http://roundcube.net/
- Pluginy ISPConfig 3 pro RoundCube:https://github.com/w2c/ispconfig3_roundcube
- ISPConfig:http://www.ispconfig.org/
- Debian:http://www.debian.org/