Artifact
3b91b4e83f0a17626cffa67e5683f82e07e6d7eb76b4650e37bfe3530dcc503e:
0000: 23 20 73 6d 74 70 32 74 67 0a 0a 53 4d 54 50 2d # smtp2tg..SMTP-
0010: 74 6f 2d 54 65 6c 65 67 72 61 6d 20 67 61 74 65 to-Telegram gate
0020: 77 61 79 2e 20 52 65 63 65 69 76 65 73 20 65 6d way. Receives em
0030: 61 69 6c 73 20 76 69 61 20 53 4d 54 50 20 61 6e ails via SMTP an
0040: 64 20 66 6f 72 77 61 72 64 73 20 74 68 65 6d 20 d forwards them
0050: 74 6f 20 54 65 6c 65 67 72 61 6d 20 63 68 61 74 to Telegram chat
0060: 73 2e 0a 0a 2d 2d 2d 0a 0a 23 23 20 49 6e 73 74 s...---..## Inst
0070: 61 6c 6c 61 74 69 6f 6e 0a 0a 23 23 23 20 46 72 allation..### Fr
0080: 6f 6d 20 73 6f 75 72 63 65 0a 60 60 60 62 61 73 om source.```bas
0090: 68 0a 67 69 74 20 63 6c 6f 6e 65 20 68 74 74 70 h.git clone http
00a0: 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6b s://github.com/k
00b0: 77 6f 72 72 2f 73 6d 74 70 32 74 67 0a 63 64 20 worr/smtp2tg.cd
00c0: 73 6d 74 70 32 74 67 0a 63 61 72 67 6f 20 62 75 smtp2tg.cargo bu
00d0: 69 6c 64 20 2d 2d 72 65 6c 65 61 73 65 0a 60 60 ild --release.``
00e0: 60 0a 0a 23 23 20 43 6f 6e 66 69 67 75 72 61 74 `..## Configurat
00f0: 69 6f 6e 0a 0a 31 2e 20 43 72 65 61 74 65 20 60 ion..1. Create `
0100: 73 6d 74 70 32 74 67 2e 74 6f 6d 6c 60 20 28 73 smtp2tg.toml` (s
0110: 65 65 20 60 73 6d 74 70 32 74 67 2e 74 6f 6d 6c ee `smtp2tg.toml
0120: 2e 65 78 61 6d 70 6c 65 60 20 66 6f 72 20 72 65 .example` for re
0130: 66 65 72 65 6e 63 65 29 2e 0a 32 2e 20 47 65 74 ference)..2. Get
0140: 20 61 20 54 65 6c 65 67 72 61 6d 20 42 6f 74 20 a Telegram Bot
0150: 54 6f 6b 65 6e 20 66 72 6f 6d 20 5b 40 42 6f 74 Token from [@Bot
0160: 46 61 74 68 65 72 5d 28 68 74 74 70 73 3a 2f 2f Father](https://
0170: 74 2e 6d 65 2f 42 6f 74 46 61 74 68 65 72 29 2e t.me/BotFather).
0180: 0a 33 2e 20 47 65 74 20 79 6f 75 72 20 63 68 61 .3. Get your cha
0190: 74 20 49 44 20 28 75 73 65 20 5b 40 67 65 74 69 t ID (use [@geti
01a0: 64 73 62 6f 74 5d 28 68 74 74 70 73 3a 2f 2f 74 dsbot](https://t
01b0: 2e 6d 65 2f 67 65 74 69 64 73 62 6f 74 29 20 6f .me/getidsbot) o
01c0: 72 20 64 65 62 75 67 20 6d 6f 64 65 20 69 6e 20 r debug mode in
01d0: 54 65 6c 65 67 72 61 6d 20 63 6c 69 65 6e 74 29 Telegram client)
01e0: 2e 0a 0a 23 23 23 20 45 78 61 6d 70 6c 65 20 63 ...### Example c
01f0: 6f 6e 66 69 67 75 72 61 74 69 6f 6e 0a 60 60 60 onfiguration.```
0200: 74 6f 6d 6c 0a 61 70 69 5f 6b 65 79 20 3d 20 22 toml.api_key = "
0210: 72 65 70 6c 61 63 65 2d 77 69 74 68 2d 79 6f 75 replace-with-you
0220: 72 2d 74 65 6c 65 67 72 61 6d 2d 62 6f 74 2d 74 r-telegram-bot-t
0230: 6f 6b 65 6e 22 0a 61 70 69 5f 67 61 74 65 77 61 oken".api_gatewa
0240: 79 20 3d 20 22 68 74 74 70 73 3a 2f 2f 61 70 69 y = "https://api
0250: 2e 74 65 6c 65 67 72 61 6d 2e 6f 72 67 22 0a 6c .telegram.org".l
0260: 69 73 74 65 6e 5f 6f 6e 20 3d 20 22 31 32 37 2e isten_on = "127.
0270: 30 2e 30 2e 31 3a 31 30 32 35 22 0a 75 6e 6b 6e 0.0.1:1025".unkn
0280: 6f 77 6e 20 3d 20 22 72 65 6c 61 79 22 0a 66 69 own = "relay".fi
0290: 65 6c 64 73 20 3d 20 5b 22 64 61 74 65 22 2c 20 elds = ["date",
02a0: 22 66 72 6f 6d 22 2c 20 22 73 75 62 6a 65 63 74 "from", "subject
02b0: 22 5d 0a 64 6f 6d 61 69 6e 73 20 3d 20 5b 22 65 "].domains = ["e
02c0: 78 61 6d 70 6c 65 2e 63 6f 6d 22 2c 20 22 6c 6f xample.com", "lo
02d0: 63 61 6c 68 6f 73 74 22 5d 0a 0a 64 65 66 61 75 calhost"]..defau
02e0: 6c 74 20 3d 20 30 0a 0a 5b 72 65 63 69 70 69 65 lt = 0..[recipie
02f0: 6e 74 73 5d 0a 22 61 64 6d 69 6e 40 65 78 61 6d nts]."admin@exam
0300: 70 6c 65 2e 63 6f 6d 22 20 3d 20 31 32 33 34 35 ple.com" = 12345
0310: 36 37 38 0a 22 61 6c 65 72 74 73 40 65 78 61 6d 678."alerts@exam
0320: 70 6c 65 2e 63 6f 6d 22 20 3d 20 2d 31 30 30 31 ple.com" = -1001
0330: 32 33 34 35 36 37 38 0a 60 60 60 0a 0a 54 6f 20 2345678.```..To
0340: 63 61 74 63 68 20 62 6f 75 6e 63 65 73 20 28 73 catch bounces (s
0350: 6f 20 74 68 65 79 20 77 6f 75 6c 64 6e 27 74 20 o they wouldn't
0360: 73 74 75 63 6b 20 69 6e 20 75 70 70 65 72 20 6d stuck in upper m
0370: 61 69 6c 20 73 65 72 76 65 72 29 20 6d 61 6b 65 ail server) make
0380: 20 73 75 72 65 20 73 65 6e 64 65 72 0a 65 6e 76 sure sender.env
0390: 65 6c 6f 70 65 20 61 64 64 72 65 73 73 20 69 73 elope address is
03a0: 20 72 65 61 6c 20 61 73 20 72 65 71 75 69 72 65 real as require
03b0: 64 20 62 79 20 6d 61 69 6c 20 6c 69 62 72 61 72 d by mail librar
03c0: 79 20 28 61 63 74 75 61 6c 6c 79 20 6e 6f 74 20 y (actually not
03d0: 73 75 72 65 20 77 68 65 74 68 65 72 0a 74 68 69 sure whether.thi
03e0: 73 20 61 70 70 6c 69 65 73 20 74 6f 20 6d 61 69 s applies to mai
03f0: 6c 69 6e 29 2e 20 46 6f 72 20 65 78 61 6d 70 6c lin). For exampl
0400: 65 20 50 6f 73 74 66 69 78 20 68 61 73 20 74 6f e Postfix has to
0410: 20 62 65 20 74 77 65 61 6b 65 64 20 6c 69 6b 65 be tweaked like
0420: 20 74 68 69 73 3a 0a 0a 24 63 6f 6e 66 69 67 5f this:..$config_
0430: 64 69 72 65 63 74 6f 72 79 2f 6d 61 69 6e 2e 63 directory/main.c
0440: 66 3a 0a 09 73 6d 74 70 5f 67 65 6e 65 72 69 63 f:..smtp_generic
0450: 5f 6d 61 70 73 20 3d 20 68 61 73 68 3a 24 63 6f _maps = hash:$co
0460: 6e 66 69 67 5f 64 69 72 65 63 74 6f 72 79 2f 67 nfig_directory/g
0470: 65 6e 65 72 69 63 0a 0a 24 63 6f 6e 66 69 67 5f eneric..$config_
0480: 64 69 72 65 63 74 6f 72 79 2f 67 65 6e 65 72 69 directory/generi
0490: 63 3a 0a 09 22 22 09 70 6f 73 74 6d 61 73 74 65 c:.."".postmaste
04a0: 72 40 65 78 61 6d 70 6c 65 2e 63 6f 6d 0a 09 3c r@example.com..<
04b0: 3e 09 70 6f 73 74 6d 61 73 74 65 72 40 65 78 61 >.postmaster@exa
04c0: 6d 70 6c 65 2e 63 6f 6d 0a 0a 41 63 74 75 61 6c mple.com..Actual
04d0: 6c 79 20 6e 6f 74 20 73 75 72 65 20 77 68 69 63 ly not sure whic
04e0: 68 20 6f 6e 65 20 77 6f 72 6b 73 2e 2e 2e 0a 0a h one works.....
04f0: 2d 2d 2d 0a 0a 23 23 20 55 73 61 67 65 0a 0a 23 ---..## Usage..#
0500: 23 23 20 52 75 6e 0a 60 60 60 62 61 73 68 0a 2e ## Run.```bash..
0510: 2f 73 6d 74 70 32 74 67 20 2d 63 20 2f 70 61 74 /smtp2tg -c /pat
0520: 68 2f 74 6f 2f 73 6d 74 70 32 74 67 2e 74 6f 6d h/to/smtp2tg.tom
0530: 6c 0a 60 60 60 0a 0a 23 23 23 20 43 4c 49 20 61 l.```..### CLI a
0540: 72 67 75 6d 65 6e 74 73 0a 0a 7c 20 41 72 67 75 rguments..| Argu
0550: 6d 65 6e 74 20 20 20 20 20 20 7c 20 44 65 73 63 ment | Desc
0560: 72 69 70 74 69 6f 6e 20 20 20 20 20 20 20 20 20 ription
0570: 20 20 20 20 20 20 7c 20 45 78 61 6d 70 6c 65 20 | Example
0580: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 0a |.
0590: 7c 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |---------------
05a0: 7c 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |---------------
05b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 7c 2d 2d 2d ------------|---
05c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
05d0: 2d 2d 2d 2d 7c 0a 7c 20 60 2d 68 60 2c 20 60 2d ----|.| `-h`, `-
05e0: 2d 68 65 6c 70 60 20 7c 20 53 68 6f 77 20 68 65 -help` | Show he
05f0: 6c 70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 lp
0600: 20 20 20 7c 20 60 73 6d 74 70 32 74 67 20 2d 2d | `smtp2tg --
0610: 68 65 6c 70 60 20 20 20 20 20 20 7c 0a 7c 20 60 help` |.| `
0620: 2d 63 60 2c 20 60 2d 2d 63 6f 6e 66 69 67 60 20 -c`, `--config`
0630: 7c 20 50 61 74 68 20 74 6f 20 63 6f 6e 66 69 67 | Path to config
0640: 20 66 69 6c 65 20 20 20 20 20 7c 20 60 73 6d 74 file | `smt
0650: 70 32 74 67 20 2d 63 20 63 6f 6e 66 69 67 2e 74 p2tg -c config.t
0660: 6f 6d 6c 60 20 7c 0a 0a 2d 2d 2d 0a 0a 23 23 20 oml` |..---..##
0670: 53 65 63 75 72 69 74 79 0a 0a 23 23 23 20 49 6d Security..### Im
0680: 70 6f 72 74 61 6e 74 0a 2d 20 2a 2a 52 65 63 6f portant.- **Reco
0690: 6d 6d 65 6e 64 65 64 20 75 73 61 67 65 2a 2a 3a mmended usage**:
06a0: 20 52 75 6e 20 6f 6e 20 60 31 32 37 2e 30 2e 30 Run on `127.0.0
06b0: 2e 31 60 20 28 6c 6f 63 61 6c 68 6f 73 74 29 20 .1` (localhost)
06c0: 6f 6e 6c 79 2e 0a 2d 20 49 66 20 65 78 70 6f 73 only..- If expos
06d0: 69 6e 67 20 74 6f 20 61 20 6e 65 74 77 6f 72 6b ing to a network
06e0: 3a 0a 20 20 2d 20 2a 2a 52 65 73 74 72 69 63 74 :. - **Restrict
06f0: 20 70 6f 72 74 20 61 63 63 65 73 73 2a 2a 20 76 port access** v
0700: 69 61 20 66 69 72 65 77 61 6c 6c 2e 0a 20 20 2d ia firewall.. -
0710: 20 2a 2a 55 73 65 20 54 4c 53 2a 2a 20 28 65 2e **Use TLS** (e.
0720: 67 2e 2c 20 76 69 61 20 60 73 74 75 6e 6e 65 6c g., via `stunnel
0730: 60 20 6f 72 20 60 6e 67 69 6e 78 60 29 2e 0a 20 ` or `nginx`)..
0740: 20 2d 20 2a 2a 49 6d 70 6c 65 6d 65 6e 74 20 61 - **Implement a
0750: 75 74 68 65 6e 74 69 63 61 74 69 6f 6e 2a 2a 20 uthentication**
0760: 28 74 68 69 73 20 73 6f 66 74 77 61 72 65 20 64 (this software d
0770: 6f 65 73 20 6e 6f 74 20 70 72 6f 76 69 64 65 20 oes not provide
0780: 69 74 29 2e 0a 0a 23 23 23 20 43 6f 6e 66 69 67 it)...### Config
0790: 20 66 69 6c 65 20 70 65 72 6d 69 73 73 69 6f 6e file permission
07a0: 73 0a 53 65 74 20 66 69 6c 65 20 70 65 72 6d 69 s.Set file permi
07b0: 73 73 69 6f 6e 73 20 74 6f 20 60 30 36 30 30 60 ssions to `0600`
07c0: 20 28 6f 77 6e 65 72 20 72 65 61 64 2f 77 72 69 (owner read/wri
07d0: 74 65 20 6f 6e 6c 79 29 3a 0a 60 60 60 62 61 73 te only):.```bas
07e0: 68 0a 63 68 6d 6f 64 20 36 30 30 20 73 6d 74 70 h.chmod 600 smtp
07f0: 32 74 67 2e 74 6f 6d 6c 0a 60 60 60 0a 0a 2d 2d 2tg.toml.```..--
0800: 2d 0a 23 23 20 48 6f 77 20 69 74 20 77 6f 72 6b -.## How it work
0810: 73 0a 31 2e 20 41 20 63 6c 69 65 6e 74 20 28 65 s.1. A client (e
0820: 2e 67 2e 2c 20 50 6f 73 74 66 69 78 29 20 73 65 .g., Postfix) se
0830: 6e 64 73 20 61 6e 20 65 6d 61 69 6c 20 74 6f 20 nds an email to
0840: 60 6c 69 73 74 65 6e 5f 6f 6e 60 20 28 65 2e 67 `listen_on` (e.g
0850: 2e 2c 20 60 31 32 37 2e 30 2e 30 2e 31 3a 31 30 ., `127.0.0.1:10
0860: 32 35 60 29 2e 0a 32 2e 20 73 6d 74 70 32 74 67 25`)..2. smtp2tg
0870: 20 70 61 72 73 65 73 20 74 68 65 20 65 6d 61 69 parses the emai
0880: 6c 20 61 6e 64 20 63 6f 6e 76 65 72 74 73 20 69 l and converts i
0890: 74 20 74 6f 20 61 20 54 65 6c 65 67 72 61 6d 20 t to a Telegram
08a0: 6d 65 73 73 61 67 65 2e 0a 33 2e 20 54 68 65 20 message..3. The
08b0: 6d 65 73 73 61 67 65 20 69 73 20 73 65 6e 74 20 message is sent
08c0: 74 6f 20 74 68 65 20 73 70 65 63 69 66 69 65 64 to the specified
08d0: 20 63 68 61 74 20 28 6f 72 20 60 64 65 66 61 75 chat (or `defau
08e0: 6c 74 60 20 69 66 20 61 64 64 72 65 73 73 20 69 lt` if address i
08f0: 73 20 75 6e 6b 6e 6f 77 6e 29 2e 0a 0a 23 23 23 s unknown)...###
0900: 20 45 78 61 6d 70 6c 65 3a 20 45 6d 61 69 6c 20 Example: Email
0910: e2 86 92 20 54 65 6c 65 67 72 61 6d 0a 2a 2a 49 → Telegram.**I
0920: 6e 63 6f 6d 69 6e 67 20 65 6d 61 69 6c 3a 2a 2a ncoming email:**
0930: 0a 60 60 60 74 65 78 74 0a 46 72 6f 6d 3a 20 75 .```text.From: u
0940: 73 65 72 40 65 78 61 6d 70 6c 65 2e 63 6f 6d 0a ser@example.com.
0950: 54 6f 3a 20 61 64 6d 69 6e 40 65 78 61 6d 70 6c To: admin@exampl
0960: 65 2e 63 6f 6d 0a 53 75 62 6a 65 63 74 3a 20 54 e.com.Subject: T
0970: 65 73 74 0a 0a 48 65 6c 6c 6f 2c 20 77 6f 72 6c est..Hello, worl
0980: 64 21 0a 60 60 60 0a 0a 2a 2a 54 65 6c 65 67 72 d!.```..**Telegr
0990: 61 6d 20 6d 65 73 73 61 67 65 3a 2a 2a 0a 60 60 am message:**.``
09a0: 60 68 74 6d 6c 0a 3c 62 6c 6f 63 6b 71 75 6f 74 `html.<blockquot
09b0: 65 20 65 78 70 61 6e 64 61 62 6c 65 3e 0a 3c 75 e expandable>.<u
09c0: 3e 3c 69 3e 53 75 62 6a 65 63 74 3a 3c 2f 69 3e ><i>Subject:</i>
09d0: 3c 2f 75 3e e2 80 83 3c 63 6f 64 65 3e 54 65 73 </u> <code>Tes
09e0: 74 3c 2f 63 6f 64 65 3e 0a 3c 75 3e 3c 69 3e 46 t</code>.<u><i>F
09f0: 72 6f 6d 3a 3c 2f 69 3e 3c 2f 75 3e e2 80 83 3c rom:</i></u> <
0a00: 63 6f 64 65 3e 75 73 65 72 40 65 78 61 6d 70 6c code>user@exampl
0a10: 65 2e 63 6f 6d 3c 2f 63 6f 64 65 3e 0a 3c 75 3e e.com</code>.<u>
0a20: 3c 69 3e 44 61 74 65 3a 3c 2f 69 3e 3c 2f 75 3e <i>Date:</i></u>
0a30: e2 80 83 3c 63 6f 64 65 3e 4d 6f 6e 2c 20 30 31 <code>Mon, 01
0a40: 20 4a 61 6e 20 32 30 32 34 20 31 32 3a 30 30 3a Jan 2024 12:00:
0a50: 30 30 20 2b 30 30 30 30 3c 2f 63 6f 64 65 3e 0a 00 +0000</code>.
0a60: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 70 </blockquote>.<p
0a70: 72 65 3e 48 65 6c 6c 6f 2c 20 77 6f 72 6c 64 21 re>Hello, world!
0a80: 3c 2f 70 72 65 3e 0a 60 60 60 0a 0a 2d 2d 2d 0a </pre>.```..---.
0a90: 23 23 20 4c 69 6e 6b 73 0a 2d 20 2a 2a 4f 72 69 ## Links.- **Ori
0aa0: 67 69 6e 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 ginal repository
0ab0: 2a 2a 3a 20 5b 68 74 74 70 3a 2f 2f 66 73 2e 62 **: [http://fs.b
0ac0: 31 74 2e 6e 61 6d 65 2f 73 6d 74 70 32 74 67 5d 1t.name/smtp2tg]
0ad0: 28 68 74 74 70 3a 2f 2f 66 73 2e 62 31 74 2e 6e (http://fs.b1t.n
0ae0: 61 6d 65 2f 73 6d 74 70 32 74 67 29 0a 2d 20 2a ame/smtp2tg).- *
0af0: 2a 47 69 74 48 75 62 20 4d 69 72 72 6f 72 2a 2a *GitHub Mirror**
0b00: 3a 20 5b 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 : [https://githu
0b10: 62 2e 63 6f 6d 2f 6b 77 6f 72 72 2f 73 6d 74 70 b.com/kworr/smtp
0b20: 32 74 67 5d 28 68 74 74 70 73 3a 2f 2f 67 69 74 2tg](https://git
0b30: 68 75 62 2e 63 6f 6d 2f 6b 77 6f 72 72 2f 73 6d hub.com/kworr/sm
0b40: 74 70 32 74 67 29 0a tp2tg).