feat: add SnappyMail webmail and docker-mailserver with full send/receive

- 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 <noreply@anthropic.com>
2026-03-22 17:21:25 +07:00 · 2026-03-22 17:21:25 +07:00 · 644b5b74c1
commit 644b5b74c1
parent 26c0df851e
6 changed files with 171 additions and 115 deletions
--- 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)
--- 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
--- 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:
--- 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
--- 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:
--- 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"