Tato příručka vysvětluje, jak nainstalovat webovou aplikaci RoundCube na server Debian Wheezy se systémem ISPConfig a Apache2 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 Apache2 jako webový server na vašem serveru ISPConfig 3; tento tutoriál nebude fungovat pro nginx. 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)).
RoundCube bude nakonfigurován tak, aby k němu bylo možné přistupovat z každého vhost přes alias /webmail (např. http://www.example.com/webmail).
Pokud již používáte jinou webovou aplikaci, jako je SquirrelMail, ujistěte se, že jste ji úplně zakázali nebo alespoň alias /webmail. Pokud jste nainstalovali SquirrelMail jako balíček Debianu, můžete alias najít v /etc/apache2/conf.d/squirrelmail.conf; buď zakomentujte alias, abyste deaktivovali alias /webmail, nebo zakomentujte celý soubor a úplně deaktivujte SquirrelMail. Poté nezapomeňte restartovat Apache.
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 otevřete /etc/apache2/conf.d/roundcube...
vi /etc/apache2/conf.d/roundcube
... a přidejte řádek Alias /webmail /var/lib/roundcube. Kromě toho přidejte konfiguraci PHP do sekce
# Those aliases do not work properly with several hosts on your apache server # Uncomment them to use it or adapt them to your configuration Alias /roundcube/program/js/tiny_mce/ /usr/share/tinymce/www/ Alias /roundcube /var/lib/roundcube Alias /webmail /var/lib/roundcube # Access to tinymce files <Directory "/usr/share/tinymce/www/"> Options Indexes MultiViews FollowSymLinks AllowOverride None Order allow,deny allow from all </Directory> <Directory /var/lib/roundcube/> Options +FollowSymLinks DirectoryIndex index.php <IfModule mod_php5.c> AddType application/x-httpd-php .php php_flag magic_quotes_gpc Off php_flag track_vars On php_flag register_globals Off php_value include_path .:/usr/share/php </IfModule> # This is needed to parse /var/lib/roundcube/.htaccess. See its # content before setting AllowOverride to None. AllowOverride All order allow,deny allow from all </Directory> # Protecting basic directories: <Directory /var/lib/roundcube/config> Options -FollowSymLinks AllowOverride None </Directory> <Directory /var/lib/roundcube/temp> Options -FollowSymLinks AllowOverride None Order allow,deny Deny from all </Directory> <Directory /var/lib/roundcube/logs> Options -FollowSymLinks AllowOverride None Order allow,deny Deny from all </Directory> |
Poté restartujte Apache:
/etc/init.d/apache2 restart
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_* /var/lib/roundcube/plugins
cd /var/lib/roundcube/plugins
mv ispconfig3_account/config/config.inc.php.dist ispconfig3_account/config/config.inc.php
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/