You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Apr 30, 2025. It is now read-only.
Copy file name to clipboardExpand all lines: README.md
+23-4Lines changed: 23 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,14 +26,22 @@ root@af04d92d0b1e:/go# go get github.com/lflare/mdathome-golang
26
26
root@af04d92d0b1e:/go# go run github.com/lflare/mdathome-golang
27
27
```
28
28
29
+
## Common Problems
30
+
### Client is online but no requests / Client is pinging but no requests
31
+
32
+
One of the most common problems experienced by users is when they use this client, their client shows up on mangadex.network but never receives requests. The reason behind this problem, is that api.mangadex.network, while having an IPv6 AAAA address, does not actually accept IPv6 connections from clients.
33
+
34
+
To resolve, one can either override the reported address to the backend by modifying the `override_address_report` key with the intended IPv4 address. Alternatively, one can follow their OS-specific guide and disable IPv6 support entirely.
35
+
29
36
## Configuration
30
37
As with the official client, this client reads a configuration JSON file.
31
38
32
39
```json
33
40
{
34
41
"cache_directory": "cache/",
35
-
"client_port": 44300,
42
+
"client_port": 443,
36
43
"override_port_report": 0,
44
+
"override_address_report": "",
37
45
"client_secret": "",
38
46
"graceful_shutdown_in_seconds": 300,
39
47
"max_kilobits_per_second": 10000,
@@ -46,9 +54,11 @@ As with the official client, this client reads a configuration JSON file.
46
54
"allow_upstream_pooling": true,
47
55
"allow_visitor_refresh": false,
48
56
"enable_prometheus_metrics": false,
57
+
"maxmind_license_key": "",
49
58
"override_upstream": "",
50
-
"reject_invalid_tokens": false,
59
+
"reject_invalid_tokens": true,
51
60
"verify_image_integrity": false,
61
+
"low_memory_mode": false,
52
62
"log_level": "trace",
53
63
"max_log_size_in_mebibytes": 64,
54
64
"max_log_backups": 3,
@@ -62,12 +72,15 @@ As with the official client, this client reads a configuration JSON file.
62
72
#### - `cache_directory`
63
73
Allows configuration of where the cache will be stored at.
64
74
65
-
#### - `client_port` - Recommended `443`
75
+
#### - `client_port`
66
76
Allows configuration of whichever port the client will listen on.
67
77
68
78
#### - `override_port_report`
69
79
Allows overriding of reported port to backend. Defaults to `0` for disabled.
70
80
81
+
#### - `override_address_report`
82
+
Allows overriding of reported address to backend. Defaults to `""` for disabled.
83
+
71
84
#### - `client_secret`
72
85
Self-explanatory, this should be obtained from the [MangaDex@Home page](https://mangadex.org/md_at_home).
73
86
@@ -109,15 +122,21 @@ This setting controls if visitors should be allowed to force image refreshes thr
109
122
#### - `enable_prometheus_metrics`
110
123
This setting controls if client metrics should be published on the `/metrics` endpoint of your server. **Note:** All metrics are public and do not require authentication to access. If this does not strike you fancy, either submit a PR to change this behaviour, or disable it entirely.
111
124
125
+
#### - `maxmind_license_key`
126
+
This setting allows you to enable request geolocation support by supplying with a MaxMind API key. **Note:**`enable_prometheus_metrics` needs to be enabled as well for the appropriate geolocation metrics to show.
127
+
112
128
#### - `override_upstream` - Recommended empty.
113
129
This setting allows you to override the upstream server. If you are a normal MD@H user, this setting is not for you and should be left empty.
This setting controls if the cache server should reject all requests with missing or invalid security tokens. At present (2021/01/04), the official client does not enforce token verifications, and thus it is recommended to be off on this client as well.
117
133
118
134
#### - `verify_image_integrity`
119
135
This setting controls if images in cache should be verified with the checksum in the image name. This only applies to `/data/` images due to limitations with upstream.
120
136
137
+
#### - `low_memory_mode`
138
+
This setting controls if the client should work in low-memory mode by streaming directly from disk rather than to memory first before serving to clients. For smaller clients with faster disks (i.e. SSDs), this setting can be enabled experiementally. Otherwise, if your disk consists of rust spinning at 7200 RPM, stay far from this setting.
0 commit comments