MAILBRIDGE – ENKRATNA STREŽNIŠKA PRIPRAVA Ta paket je namenjen cPanel računu na tvojem lastnem Linux strežniku. Ne potrebuje Dockerja, Node.js, Pythona, Composerja ali baze podatkov. Vse spletne datoteke so v mapi poddomene. Zasebne nastavitve in stanja čarovnik sam ustvari v skriti mapi v domači mapi cPanel računa, zunaj webroota. ZA UPORABNIKA 1. V cPanel > Domains ustvari poddomeno z ločeno mapo. 2. Za poddomeno vključi HTTPS/AutoSSL in izberi PHP 8.2 ali novejši. 3. V File Manager naloži ZIP v mapo poddomene in izberi Extract. index.php, api.php in assets morajo biti neposredno v tej mapi. 4. Odpri https://tvoja-poddomena in vnesi kodo iz ločene NAMESTITEV.txt. 5. Nastavi skrbniško geslo in vpiši dovoljena IMAP-imena ali javne IP-naslove. 6. Če so zahteve pripravljene, preizkusi povezavo in poskusni pregled s testnima predaloma. Nato preveri dejanski prenos, mape, priponke in ponovitev. 7. Iz File Managerja izbriši naloženi ZIP. NAMESTITEV.txt ne nalagaj na splet. ČE ČAROVNIK POKAŽE MANJKAJOČO ZAHTEVO Preveri naslednje v WHM oziroma pri skrbniku strežnika: - PHP 8.2+ s funkcijami proc_open, proc_get_status, proc_terminate, DNS, OpenSSL, password_hash, sejami in dostopom do domače mape računa. - PHP CLI je običajno /opt/cpanel/ea-php84/root/usr/bin/php; čarovnik sam preizkusi različice ea-php82–85 in standardni lokaciji PHP. - /bin/sh in /usr/bin/nohup ter dovoljen zagon procesov v ozadju za ta račun. - Aktivna omejitev open_basedir mora dovoliti zasebno domačo mapo računa, sistemske programe in sistemske CA-certifikate. Ne izključuj zaščit za celoten strežnik; dostop prilagodi samo namenskemu računu. - Imapsync v /usr/local/bin/imapsync ali /usr/bin/imapsync, z njegovimi Perl moduli. Paket vsebuje izvirno skripto imapsync 2.314 v bin/imapsync; če so potrebni Perl moduli že nameščeni, uporabi to skripto samodejno. Samo kopiranje Perl skripte ne namesti njenih sistemskih odvisnosti. Uradna navodila za imapsync (izberi svoj Linux, npr. AlmaLinux/Rocky/RHEL): https://imapsync.lamiral.info/#install https://imapsync.lamiral.info/INSTALL.d/ Pravilne pakete lahko določimo po podatku o operacijskem sistemu. Ne izvajaj Debianovih apt ukazov na AlmaLinux/cPanel strežniku. V brskalnik ni vgrajen root terminal in aplikacija ne namešča sistemskih paketov. - Dovoljen izhodni DNS in povezave TCP 993 do dovoljenih javnih IMAP-strežnikov. - Veljavna sistemska shramba CA-certifikatov; preverjanja TLS ne izključuj. - Dovolj pomnilnika in procesnega časa za velikost predalov. PHP worker uporablja CLI, ne časa spletne zahteve. Omejitve računa/LVE/OS ga še vedno lahko prekinejo; v tem primeru aplikacija pokaže napako, ne lažnega uspeha. - Uporabi namenski cPanel račun, redne varnostne posodobitve in močno prijavo. Aplikacije v istem cPanel računu imajo običajno isti OS UID in s tem dostop do istih datotek/procesov. Pravice 0700 jih med seboj ne izolirajo. Ko urediš manjkajoče zahteve, v aplikaciji odpri Nastavitve > Preveri strežnik. Ponovno nalaganje ZIP-a ali ponovna namestitev nista potrebna. VARNOST IN OMEJITVE - En skrbnik in uporabniki za prenose; eno opravilo naenkrat. MFA ni vgrajen. - Poštna gesla potujejo prek HTTPS, anonimne procesne cevi in okolja imapsync. Ne zapisujejo se v nastavitve, opravila, dnevnike ali browser storage. - Skrbnik OS/root in drugi procesi istega uporabnika lahko dostopajo do RAM-a. Izklopi core dumps za ta račun; swap naj bo šifriran ali izključen. PHP sam ne more zagotoviti izbrisa vseh kopij nizov iz pomnilnika ali nastavitev OS. - Stanja vsebujejo imeni ali javna IP-naslova strežnikov, čas, status in števce. Shranjena so zunaj webroota; starejša od 24 ur se odstranijo ob naslednjem dostopu. - TLS 1.2/1.3 s preverjanjem CA in vnesenega imena oziroma IP-naslova. Brez plaintext, STARTTLS/143 ali zasebnih in rezerviranih naslovov. Domensko ime mora imeti javni DNS; neposredni javni IP mora biti naveden v certifikatu. - Uporabniško geslo/geslo za aplikacijo; OAuth ni implementiran. - Brez brisanja sporočil. Prekinitev ne razveljavi že kopirane pošte. - Ponovitev uporablja imapsyncova pravila prepoznavanja sporočil; obnašanje konkretnih ponudnikov preveri na testnih predalih. - Dnevniki web strežnika/WAF ne smejo zapisovati teles POST-zahtev. - Pred produkcijo preveri prenos na svojem strežniku. Lokalni testni procesi ne potrjujejo združljivosti vseh ponudnikov IMAP ali nastavitev cPanela. POSODOBITEV Ne prepisuj ali briši .installation.php in zasebne .mailbridge-* mape. Med posodobitvijo naj ne poteka nobeno opravilo. Varnostno kopiraj zasebne nastavitve; gesel poštnih predalov ni v njih. Novi install-key.php ne odklene že nameščene aplikacije in ne zamenja skrbniškega gesla. VARNOSTNA POSODOBITEV 2026-09-18 - Po posodobitvi se ponovno prijavi. Skrbnik uporablja admin in dosedanje geslo. - Apache/LiteSpeed mora izvajati priložene .htaccess (tudi skrite datoteke naloži). Zaprti morajo biti lib/, bin/, .installation.php, install-key.php, worker.php, ZIP-i, NAMESTITEV.txt in varnostne kopije. Nginx potrebuje enakovredna pravila. - PHP in CLI naj uporabljata podprto, varnostno posodobljeno različico, prav tako imapsync, Perl, IO::Socket::SSL in OpenSSL. Preveri dejanske različice v WHM. - Če uporabljaš povratni proxy/CDN, naj spletni strežnik prepozna izvorni IP samo od izrecno zaupanih proxyjev. PHP ne zaupa poljubnim X-Forwarded-For glavam; napačna nastavitev proxyja lahko vse uporabnike združi v isto omejitev. - Prijave: največ 10 poskusov na izvorni IP/IPv6-predpono v 15 minutah in 30 poskusov na uporabniško ime v 15 minutah. Več uporabnikov za istim NAT deli IP-omejitev. Za javno uporabo nastavi še omejitve prometa na WAF/proxyju. - Worker onemogoči core dump pred zagonom. Za spletni PHP, swap in kopije RAM-a mora ustrezno nastavitev zagotoviti skrbnik OS. - Po preverjanju zahtev preizkusi pravi prenos s testnima predaloma, napačnim geslom in zavrnitvijo neveljavnega certifikata. Ne izključuj preverjanja TLS.