From 644b5b74c16877f970ddcc43be23b211e913da4b Mon Sep 17 00:00:00 2001 From: jack Date: Sun, 22 Mar 2026 17:21:25 +0700 Subject: [PATCH] feat: add SnappyMail webmail and docker-mailserver with full send/receive MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add docker-mailserver (Postfix+Dovecot) with SSL via certbot+Cloudflare DNS-01 - Add SnappyMail webmail client at webmail.csrx.ru (port 8888) - Open UFW ports 25/465/587/993 on tools server - Create mail accounts: noreply@, admin@, jack@csrx.ru - Generate DKIM key and print DNS instructions on first run - Add Traefik route on main server proxying webmail → tools:8888 - Add all secrets to vault (mailserver passwords, snappymail admin) Co-Authored-By: Claude Sonnet 4.6 --- inventory/group_vars/all/main.yml | 2 + inventory/group_vars/all/vault.yml | 233 +++++++++--------- .../templates/traefik/dynamic/routes.yml.j2 | 13 + roles/tools/defaults/main.yml | 1 + roles/tools/tasks/main.yml | 9 + roles/tools/templates/docker-compose.yml.j2 | 28 +++ 6 files changed, 171 insertions(+), 115 deletions(-) diff --git a/inventory/group_vars/all/main.yml b/inventory/group_vars/all/main.yml index 8333dad..b993b91 100644 --- a/inventory/group_vars/all/main.yml +++ b/inventory/group_vars/all/main.yml @@ -13,6 +13,7 @@ domain_auth: "auth.{{ domain_base }}" domain_status: "status.{{ domain_base }}" domain_wiki: "wiki.{{ domain_base }}" domain_n8n: "n8n.{{ domain_base }}" +domain_webmail: "webmail.{{ domain_base }}" domain_mon: "mon.{{ domain_base }}" # Service paths @@ -48,6 +49,7 @@ outline_db_password: "{{ vault_outline_db_password }}" n8n_encryption_key: "{{ vault_n8n_encryption_key }}" n8n_jwt_secret: "{{ vault_n8n_jwt_secret }}" mailserver_noreply_password: "{{ vault_mailserver_noreply_password }}" +snappymail_admin_password: "{{ vault_snappymail_admin_password }}" mailserver_admin_password: "{{ vault_mailserver_admin_password }}" mailserver_jack_password: "{{ vault_mailserver_jack_password }}" # Server IPs (used for cross-server Traefik routing) diff --git a/inventory/group_vars/all/vault.yml b/inventory/group_vars/all/vault.yml index 46e8390..6a77f87 100644 --- a/inventory/group_vars/all/vault.yml +++ b/inventory/group_vars/all/vault.yml @@ -1,116 +1,119 @@ $ANSIBLE_VAULT;1.1;AES256 -33303531373535383332343237343432613333353066346231653031623364353166376631613330 -3938633033303861613365656532663262363861333030300a643763383932393436646236663538 -62623961383132326235623261626366313966636264373465656362633634326139616435346536 -6532613233366333620a626637316236316532643336316435643465353133303833303132636162 -33396238626539333163343033666438633735316338373665343163363766393630613235383666 -31373563366136633334353161396466386630656236646234326331326634313837353564333064 -65653934636431626335353534383731353432613266356437323834643239366238643739643064 -33376661613362316537376438303464393033303365356564363537323130343432666231353562 -38363133623335323162336139663536373834333535323730333433373562343238663237316663 -35393661656536356336313436393536663865336136623564383437636638386639343731623565 -62393763323635633263373863633238313838396365363639623835323538376362306435663561 -65613639393761303663646433353461646366356236303036333062613566363263363436336364 -30363538393335613037346466313030393835623638363064313033393763393734333430643564 -61613166633465333162396532633164656330613934333162663263396338636130336132643562 -33353235363861343062666264316435663563303263653463336465333939626233613633353961 -36646434366330343666656539376632626233363936623965613538323137613739383266663030 -37623763356432616638336634383262653234313834633636363434373137393030363637303337 -65616463666365663466383930626632343936323333633630363336303236653836666136363332 -64336336326237643839363964626635623035616633313961623237646233333339653734346264 -39396635396561343039326434616562636464383633656138356638383733373736336363306364 -33343162613931313763386538363638326563643961316637623036373938303765353466613237 -38346635383862386631343637333066633634326134633539633961313362343534316363616464 -63633633313633366630383638356130323166373631656330626336376562333233643538353935 -36303833326166323239653936626538336363323530666438633763313030356562343338323561 -64396238343865663463626538346561643866643363613862383136636534616364313434323964 -36303532306131376335323736396130343630643766666665636161393731333261303861346637 -66316337663731356632313137643633643365363038386463373831636134343831326432333861 -30666639666435343139306262636235323333393966626537313933376234623763333831643339 -62633934353766396537313766633834353366353661343539383437393365353564326665306637 -64356335303732313663613331393034366632306431383432643962346361323831333430313232 -38653036333232366532616236336237653061376433333137656537333531656566373830396230 -35326539396138393337653861393366373439616137356338313661313061323532633066376235 -32646333353864333837343837386235653162326563636537373766386136333136633738363831 -33613265633031633866623062633833336364333731636437643530643238396235643633323235 -35303939353165356464333435383537343833333230303862353036343634643132363763326433 -61643935373564386537306237636137386433326639336435343436353635383561393465666365 -64663231396263626563636630613861383065303365343135386531363634666631323632376434 -62393237373838643764346465616365653561386466353963643434653833663564323233326138 -37386534366233656263646263333931316362343838616163366366386331666234643463663933 -30643133393038383331376263343762643534346266363730356539373533383665393062653633 -61366332353531383931616437626439383833313964333536366465376563663063356134643536 -66376436356335646135613138343330323139303835383636643031343638323334333635323736 -61633932623566366464323563353462323633363033356230313062313731326663616632663034 -33383263343561656231313533633965643163396564656130646165613531663337643732363066 -65666635316235326332316536316535303166643939353032373338353866383238353530636230 -38616164636336626165366261326335313039353430336634616633333638666262656462303932 -36316661333533616438383831323164373336333832356362633136323166336635643364353332 -35303135643664373861666630363361386335366133613139626335323262643530373536336234 -66376433396166633762393763346362616462643831663230616531623639396631313234366264 -62663663626133646632343833613565613261313562303562386237346133346132613966323035 -64666262366434656566376462306133656435323333326434353266343562356636356438303836 -62373235393337616638343663316533633234646237383932346464373261343637313930353761 -62653037393434313765633331396330336563663362636639313134663461383966363333393064 -36656532613639333963353937343363316563353463346331656136386534336439393764376333 -64393238313363386561363935353166386430643566393939623937626265316239346662396365 -62343835393766343963383664373230626536343061363065326365343239366362393363383730 -37316330393162396631633062313634353830353331396462613832343737353135623735343439 -64323032623766353166323138623730616338336663646266366438653661373966383533313539 -30613262323030313766393233306331616265663732363437663738653066346463336136653335 -37343264316262383365376532323634636339343764366562363230303462303934316638343535 -33336266313065623130383562613562363131633561616364346262646364353930653532343637 -30633738333135623662666164633739383531313362336535353639626465336461626435316538 -38323966383934346661643834363366613262393536323433623038396536323939356565626537 -63323637643539656434333864313331356262636662653530336265626264396634363161376562 -65616432613133666261613464343263646535373662653364383934613437633338376635376563 -62313832646232626436626366356262326561633736356238383165353337633538646165373765 -65353630386531356335643937383534383965396464353830313034623761666635336439623233 -37363765333961353362633931663937666361613038326138333265343332626432626565306165 -39613838666330333865663530623138376534386133313838383531326637363164373139636362 -39623535346666326561656666316331633631616163366133623732313165303362613066616564 -37653966396561353563383138346636373061316436326663353233353965323661363934616365 -31653862353731346436393438396361376538383962646535616536653861623632333762666431 -61356436613836333263656163396531356630636631313036363135626531656435336533633738 -33626661396239396134633262363861303466613535326463666431623064643464356163376164 -31656134353861303866646438373839383531366535346466383165343337303037366664636238 -66333033646363333161386336373534623637303339376636653633666334646361336362666439 -34643835636537343966346337366439326638356630636539326535313063373935313263623464 -33633732643736373937393936373264313265353236373734386534613264623837613635343835 -66616630653232623636396430383864623231646165653038633737366366376462333333646562 -30623230613233346338306331303866663531643166356432333563343532626366353165303538 -38336666356239643936373637663537643635326532353630353164396361666338303935613230 -64303363323063313265646265663437393532646132623566656636363535343666656661386539 -37373638653835656162333737336266383638363665356335313866613639316234393334316336 -31633731343434303133303137646264356430386330326538353864663261353462326364376635 -35613037623635323837613838356435356239616135316236373065633731313938366433393933 -39323631393763386439623963386334393330366263363938386337356334353439633035646463 -31386333636265336333303132656364613739366363303265386435653633623665653662356333 -30373633643932313239313262363538656330643237633434303034323265636638326163646231 -32373363383661333137623835343764383964396262323330333833313938633438356636653563 -63316435386161643165643663303566383732323539633232383332373162396432383737306334 -38323833313462643537366231353738346535313765343534366634373366306461636234356239 -37383231613431323561393531386438656366613738353439366666373566663834633461386436 -31366533333865306334383636666162353637663933343438383733333635623339656161336332 -33633936666132313539363136656231653165376139626366373836383835303737646231396231 -32666230373139656431656463306334343639306662376331323564366637353961383834316635 -38313864323139383835373466393231666535343662633031373336656433323333396137616564 -32306430633535303731393833396264353364343763623632623332353233656266356538393136 -31633931353436343731313633313262313561646535373134353430623031666566616236643666 -63646430356562373035656331613439613136396264333962313333326362396531626232386263 -36313162626461363163663661343661623039383137616438383763633863383166633965316262 -61396636346464633061353630393561616338633438356165336465336633343333636332373134 -62613065646433396564393364613437316565393261613731366537623262376665636261373936 -35343864383331623633346530613032396637323261353030303765633537313761353037653235 -65363461356433373632623037646333383732306436613631623236396564363235626239333639 -61623135613538356539386535653665636635303966653230353465386234663038333933626665 -38646534363962353963616265653030363738373339633633316261653962626636663662346331 -37303936623566633931343538623166323865656136616335336363326431336533373934613737 -31626466376231366566373532393137326236626232646562626166353665316630346164363830 -64313564376433326635393438643530306638396461646632313465323364396466346161336335 -65323165613434633934373762353030323535316165353532643365633037636335656332386139 -32343462363637323133363030363962303661623738363062646161383534666131353633616365 -39353634666166396564386136343163613161363461396135623831636539393061343738653032 -65626539353161626436366566636334363333346631626638303965633434323936303966393461 -35303839663564313937303836636335326164643935333666633736366561326130326538316464 -663865383166653334373338386332323765 +30623734613733353435313365666533643366646439316363646561363135393030346536643133 +6265366262313032653361653330303038353738316135350a353735313436613034393962326233 +34373638656233386161373333656338386332306332616464316632653533343635666239363033 +3663653663316331610a326231316561333637356163343238616363383439613333333635633039 +30376463343366373431383162656139393362363763353438636662396439623836316561313663 +61363665623839656662663435306435656137666632353866393431636532656234653838343562 +62646634343430363939323632386332303465616361636438396231383130653531653839626364 +34663836656237613134366436323566383133613664356164633631343436336339346330636234 +66616536363163633365336438326464363839343033643063306430396366303564306332346338 +65396163343561626466303634626137323139666531393463346338646462393535356433643262 +32343265626339346631376662313432356535396539616361393233626365653431343134663539 +36313138653534323634313133353136663539653435313733636230396166343762306435633166 +33303130363161306538636331356266353036373139373163336265333037656433653464356262 +35646432646539333136643565323038303565643436363231386264373537613865636232393930 +38636261373364613962323431363037623636373932376439633136376437326432626562333135 +61373831626134353638666338396532626262343263653737616565366630323664636664366634 +61633064386463633631393263626166383335333463613563343031633363363735333839633562 +38386330383035393463313832323761613831666333383831316530663564373234393964643333 +32613938313365656331353537643038313138663461333639373062336531613465366431306430 +35386262393331396564646334643135623561396562666465666432396466636431343132313733 +38333236623163643536653233643839373238383061623339343935393139386164663736633137 +65386331303339656631376238333361666532346266316362353636653235646361663731393933 +66393133613337623965333763336230386232363434326438383462393933336133616333353863 +34636634393738373963353034616464656338633232303266353065636130636232396235376432 +62333530626331646638373339663831333866613463646332386630656535393836656163643763 +37303231643665323234383834393634343637383661636262653339636562616139343238653361 +39393430663436653433636434336561663632353539383437346531633836366237626331653966 +37306638333737653131303133343231373561323432386162326537353232613236396338303731 +33373635646131393832386435343463356331356537366437356666633136653164386133316462 +38636566636539666332393334613064323739353234393364663836343661636330336162363633 +63336135613536653662333839613736373833303464326637623561633561313561303731636437 +33626562626132323339363565306436656438383564333033633533363635663339363635393763 +61643231323065346533333538316161343563653062396165313463383633646366666563376539 +65333634623238326536393964303365383438666530326438353863616664366438373861666662 +64396635663631383339313939643032353336373834646566306337666239313761663938313337 +64633834386138356462343664323833333734666634343730356461383833656430336233636439 +36393030373438656161656362323764663432383139383661303630633461393135633861663664 +37393933613834303563303937633364646434643233656462333438623337363062663938653331 +34373035393263393730353332383836333438653566333561623362303962613337386537366662 +36393963353966303232323038386131303937383932663331313134323632613732313165363765 +64366666666538626261326132666365336634323661323436633336383032383662633565663437 +39373235393230626236346466363436616333363334636330356531393736623266636665396235 +30386265373031646638393032353233353936626637303436366633643164613064373436633463 +33386566363337663332323235633139326263633131323362633637383838613830313439373633 +33346532626163633333623539653438623866363262623932386631336336666138303764643232 +30396261383336306330656635626136383061376138666339383030653165336434383939313731 +63613463616166303761326537613835353063393762653365373939623639653531663638646264 +61643633656531346438376439636262646137643365333136353231333065393231633761373835 +38383638373439393334366665616532303730646266383331306463633132613563306330313731 +66303330623231653430333334346463313134373965366463366266636333343461356337366161 +37353733616562393262353935336666376530323464313635626336386238626564383561336536 +62356135316437643462326461383032613633623038636638393861396639373165396633613465 +64646631616437656631393030343637613035343734623633333964626334313763636536623762 +30393733636632363031613263653732383066663539396230386261653864356132333164666238 +38313531316532323934656239663634383938313763373038623062323765363431383635636666 +31343236333461663135313639643433663061396531313262626637343130613534646438616436 +64346163616439336239363862616139353635333036646530376137616333376130353962373732 +37356336326136326536376265383839633063626137313137313736343961346239646339303337 +39313730613434363764636561656435623961646536623334326561383230383037383364653739 +30313065393734623039663138663664653465393532386361346130366532623233343833303062 +37633164316136633535663665363731623638633462346434363930383661656561646531326464 +31653830393837353737626431303562386465353036653934353831613333373932663163653235 +63656466376565643431643463623139343664383763336464393431366463356163633734653435 +32303463363335633739313535383761666131663432313963633834663231386365623736356430 +61666638633137333231316431356466623738643339383262323939636334303865633739623661 +35376666353934633963623961323137613264373166363339653830383538633565363239626133 +64393533323835346665613933643638346233326330663761616130303631663238313730353661 +36323931333062663466333431333338303337656562373036616565663338643234643536383161 +37363739303162643561646237646134316538633465303936646231636235373163306534633963 +34393130666232383865326162303935663638616136333465646230663131373930363339353233 +37656636366339616333333730313837303137386539333162386238326337656433353236303935 +65623233626561333962333362356430336131303936643462633938393661623466363830393366 +32343264396537636663313834373664383137646438326434636366376536626332333036373134 +38353432383765326162663632383662363361643362656562333537633932653963646634383139 +36306634373632356566383232386566396163656664333431383032303236346362393033363264 +34653139366663356530356265346466643138303030363536653339303664613661383735373330 +37373363663863376139313835643434643966656366626139386433303764646663623261663461 +31386531616663653739656334616663353861646439636665383837363161656535323932396239 +38663163396661626161346539356561636666626238303936303932303638616666616430613039 +32326139383138666237623961626633353337643431313966653038373933393132363563613834 +62393839326661366533626535356261353033333933376532386234626364366566333736613063 +61336638363938303830353937353161303037303861356664643235653561343864376366393561 +31313562643936613631303365653031616131336161663037376438666233373830303265643534 +32373936396238366333343763376633303639626237313438323237353635396366343963346539 +30623566636561303632643334333937343732626430616562356133356338393561663061633966 +31373033316564373864623438323165383435623430343032663033313334393239353732373935 +33646664643337643335613438396632333638663864363034663639343137643565303863383464 +32383365396465376130613063626664343962343035363239636638373361653730656437323432 +39326131306538396338353461653938336235343937343866313863376337313761363633626161 +62316437333631616564653835336435303663626136383761663330366637323062643338313234 +65633730343739323636333332383730626537633966613965663032626130663562663134306239 +38313861626231313836356662623033633066626137643033323065383938616166633232623733 +63343632653131623366393066623162626234643131663163366564333165326165653039613963 +62373565323661356261643563353561343037323531373562626561656232373933393537333333 +31343034653464653263306264313038316266363834353365636664316164636631353266613362 +36363738633034386462653431363261323631666132643333656265643334663861326632373232 +62633337316263336231326534663462623332653236353938623239633862636236383538313732 +32613837653066663936313164326634356265613063623466316161336439663633306166616263 +66353061353863663339396632383262366562643366633233363036653738376461616233376266 +64306163626361616365326561336465303664663031363134313433623834396266653034303964 +33336536316166653731313363396462613566313434326566346535386237343262316662376130 +33383763643934623839326639353663316635306134356163383635313566643162633365613231 +64356533313061666565376165303739353531666336633761393064376531383064393934323638 +33623533653931636138373335373561313638656338613935333366643834646130373137663262 +36353436363532346364333134346339653539343662316632336163616238336635326133323735 +65643063303139616166313362323932343037643862656133663163616131613533653263613363 +39373664363164643865656165643936616432396334396561646362666333633962353432636635 +36643138613738643134343635353334306564393836636537303334383764666533646466626231 +32623866333461613535336132323964623266636635323363333065343532613862383430366562 +30613734316630623939366461316262343766383138633461363437383563616233616661373066 +63396462306266306638303463376431653561363563633463333763343434646639613539383736 +35363465323862333930306636376565623333323064333464393932653665343136363036646461 +65633963343732613237393066356634666238633233613264623936616434353934626664623630 +37666262343231313764333262616237623337663764323737336431326438386339386235313934 +36626330643931303534343433333231373230343363356337613663336561373034333834393031 +30363233303862633663356561303763626164356165623961363339326664633566653966323434 +61383833343465646361303035383465666131393933663164343935363639623435363334303339 +3736373365623164383034663836653165356564353563656265 diff --git a/roles/services/templates/traefik/dynamic/routes.yml.j2 b/roles/services/templates/traefik/dynamic/routes.yml.j2 index 4550de1..a7c6ea1 100644 --- a/roles/services/templates/traefik/dynamic/routes.yml.j2 +++ b/roles/services/templates/traefik/dynamic/routes.yml.j2 @@ -114,6 +114,14 @@ http: service: n8n middlewares: [rate-limit-strict] + webmail: + rule: "Host(`{{ domain_webmail }}`)" + entrypoints: [websecure] + tls: + certresolver: letsencrypt + service: webmail + middlewares: [rate-limit-default] + services: vaultwarden: loadBalancer: @@ -171,6 +179,11 @@ http: servers: - url: "http://{{ ip_tools }}:5678" + webmail: + loadBalancer: + servers: + - url: "http://{{ ip_tools }}:8888" + middlewares: # ── Security Headers (applied globally via entrypoint) ───────────────── security-headers: diff --git a/roles/tools/defaults/main.yml b/roles/tools/defaults/main.yml index acac4eb..39ca8dd 100644 --- a/roles/tools/defaults/main.yml +++ b/roles/tools/defaults/main.yml @@ -5,3 +5,4 @@ outline_db_image: "postgres:15-alpine" outline_redis_image: "redis:7-alpine" n8n_image: "n8nio/n8n:1.89.2" # https://hub.docker.com/r/n8nio/n8n/tags mailserver_image: "ghcr.io/docker-mailserver/docker-mailserver:14" # https://github.com/docker-mailserver/docker-mailserver/releases +snappymail_image: "djmaze/snappymail:latest" # https://hub.docker.com/r/djmaze/snappymail/tags diff --git a/roles/tools/tasks/main.yml b/roles/tools/tasks/main.yml index bcaf071..ec3c4a1 100644 --- a/roles/tools/tasks/main.yml +++ b/roles/tools/tasks/main.yml @@ -20,6 +20,14 @@ - mail-logs - config +- name: Create snappymail data directory + ansible.builtin.file: + path: "{{ tools_root }}/snappymail/data" + state: directory + owner: "{{ deploy_user }}" + group: "{{ deploy_group }}" + mode: "0750" + # ── TLS certificate for mail.csrx.ru (via certbot + Cloudflare DNS-01) ─────── - name: Install certbot and Cloudflare DNS plugin ansible.builtin.apt: @@ -106,6 +114,7 @@ - "{{ outline_redis_image }}" - "{{ n8n_image }}" - "{{ mailserver_image }}" + - "{{ snappymail_image }}" - name: Start tools stack community.docker.docker_compose_v2: diff --git a/roles/tools/templates/docker-compose.yml.j2 b/roles/tools/templates/docker-compose.yml.j2 index f5db474..c4fd609 100644 --- a/roles/tools/templates/docker-compose.yml.j2 +++ b/roles/tools/templates/docker-compose.yml.j2 @@ -15,6 +15,9 @@ networks: mail-internal: driver: bridge internal: true + webmail-internal: + driver: bridge + internal: true volumes: outline_db_data: @@ -169,3 +172,28 @@ services: options: max-size: "10m" max-file: "3" + + # ── SnappyMail webmail ─────────────────────────────────────────────────────── + snappymail: + image: {{ snappymail_image }} + container_name: snappymail + restart: unless-stopped + networks: + - webmail-internal + - front + ports: + - "{{ ip_tools }}:8888:8888" + volumes: + - {{ tools_root }}/snappymail/data:/var/lib/snappymail + environment: + - SNAPPYMAIL_ADMIN_PASSWORD={{ snappymail_admin_password }} + healthcheck: + test: ["CMD", "wget", "-qO-", "http://127.0.0.1:8888"] + interval: 30s + timeout: 5s + retries: 3 + logging: + driver: json-file + options: + max-size: "10m" + max-file: "3"