Skip to content
This repository was archived by the owner on Apr 30, 2025. It is now read-only.

Commit f83cbeb

Browse files
committed
Updated README.md with more up-to-date instructions
1 parent 075b784 commit f83cbeb

File tree

2 files changed

+24
-4
lines changed

2 files changed

+24
-4
lines changed

CHANGELOG.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
88
### Added
99

1010
### Changed
11+
- [2021-02-13] Updated README.md with more up-to-date instructions by [@lflare].
1112

1213
### Deprecated
1314

README.md

Lines changed: 23 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -26,14 +26,22 @@ root@af04d92d0b1e:/go# go get github.com/lflare/mdathome-golang
2626
root@af04d92d0b1e:/go# go run github.com/lflare/mdathome-golang
2727
```
2828

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+
2936
## Configuration
3037
As with the official client, this client reads a configuration JSON file.
3138

3239
```json
3340
{
3441
"cache_directory": "cache/",
35-
"client_port": 44300,
42+
"client_port": 443,
3643
"override_port_report": 0,
44+
"override_address_report": "",
3745
"client_secret": "",
3846
"graceful_shutdown_in_seconds": 300,
3947
"max_kilobits_per_second": 10000,
@@ -46,9 +54,11 @@ As with the official client, this client reads a configuration JSON file.
4654
"allow_upstream_pooling": true,
4755
"allow_visitor_refresh": false,
4856
"enable_prometheus_metrics": false,
57+
"maxmind_license_key": "",
4958
"override_upstream": "",
50-
"reject_invalid_tokens": false,
59+
"reject_invalid_tokens": true,
5160
"verify_image_integrity": false,
61+
"low_memory_mode": false,
5262
"log_level": "trace",
5363
"max_log_size_in_mebibytes": 64,
5464
"max_log_backups": 3,
@@ -62,12 +72,15 @@ As with the official client, this client reads a configuration JSON file.
6272
#### - `cache_directory`
6373
Allows configuration of where the cache will be stored at.
6474

65-
#### - `client_port` - Recommended `443`
75+
#### - `client_port`
6676
Allows configuration of whichever port the client will listen on.
6777

6878
#### - `override_port_report`
6979
Allows overriding of reported port to backend. Defaults to `0` for disabled.
7080

81+
#### - `override_address_report`
82+
Allows overriding of reported address to backend. Defaults to `""` for disabled.
83+
7184
#### - `client_secret`
7285
Self-explanatory, this should be obtained from the [MangaDex@Home page](https://mangadex.org/md_at_home).
7386

@@ -109,15 +122,21 @@ This setting controls if visitors should be allowed to force image refreshes thr
109122
#### - `enable_prometheus_metrics`
110123
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.
111124

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+
112128
#### - `override_upstream` - Recommended empty.
113129
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.
114130

115-
#### - `reject_invalid_tokens` - Recommended `no`
131+
#### - `reject_invalid_tokens` - Recommended `yes`
116132
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.
117133

118134
#### - `verify_image_integrity`
119135
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.
120136

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.
139+
121140
***
122141
### Log Settings
123142
#### - `log_level`

0 commit comments

Comments
 (0)