mirror of
https://gitlab.com/ric_harvey/MailHog.git
synced 2024-12-17 18:07:16 +00:00
54 lines
1.8 KiB
Markdown
54 lines
1.8 KiB
Markdown
|
Introduction to Jim
|
||
|
|
===================
|
||
|
|
|
||
|
|
Jim is the MailHog Chaos Monkey, inspired by Netflix.
|
||
|
|
|
||
|
|
You can invite Jim to the party using the `invite-jim` flag:
|
||
|
|
|
||
|
|
MailHog -invite-jim
|
||
|
|
|
||
|
|
With Jim around, things aren't going to work how you expect.
|
||
|
|
|
||
|
|
### What can Jim do?
|
||
|
|
|
||
|
|
* Reject connections
|
||
|
|
* Rate limit connections
|
||
|
|
* Reject authentication
|
||
|
|
* Reject senders
|
||
|
|
* Reject recipients
|
||
|
|
|
||
|
|
It does this randomly, but within defined parameters.
|
||
|
|
|
||
|
|
You can control these using the following command line flags:
|
||
|
|
|
||
|
|
| Flag | Default | Description
|
||
|
|
| --------------------- | ------- | ----
|
||
|
|
| -invite-jim | false | Set to true to invite Jim
|
||
|
|
| -jim-disconnect | 0.005 | Chance of randomly disconnecting a session
|
||
|
|
| -jim-accept | 0.99 | Chance of accepting an incoming connection
|
||
|
|
| -jim-linkspeed-affect | 0.1 | Chance of applying a rate limit
|
||
|
|
| -jim-linkspeed-min | 1024 | Minimum link speed (in bytes per second)
|
||
|
|
| -jim-linkspeed-max | 10240 | Maximum link speed (in bytes per second)
|
||
|
|
| -jim-reject-sender | 0.05 | Chance of rejecting a MAIL FROM command
|
||
|
|
| -jim-reject-recipient | 0.05 | Chance of rejecting a RCPT TO command
|
||
|
|
| -jim-reject-auth | 0.05 | Chance of rejecting an AUTH command
|
||
|
|
|
||
|
|
If you enable Jim, you enable all parts. To disable individual parts, set the chance
|
||
|
|
of it happening to 0, e.g. to disable connection rate limiting:
|
||
|
|
|
||
|
|
MailHog -invite-jim -jim-linkspeed-affect=0
|
||
|
|
|
||
|
|
### Examples
|
||
|
|
|
||
|
|
Always rate limit to 1 byte per second:
|
||
|
|
|
||
|
|
MailHog -invite-jim -jim-linkspeed-affect=1 -jim-linkspeed-max=1 -jim-linkspeed-min=1
|
||
|
|
|
||
|
|
Disconnect clients after approximately 5 commands:
|
||
|
|
|
||
|
|
MailHog -invite-jim -jim-disconnect=0.2
|
||
|
|
|
||
|
|
Simulate a mobile connection (at 10-100kbps) for 10% of clients:
|
||
|
|
|
||
|
|
MailHog -invite-jim -jim-linkspeed-affect=0.1 -jim-linkspeed-min=1250 -jim-linkspeed-max=12500
|