feat: add README

This commit is contained in:
PorridgePi
2023-10-08 02:51:31 +08:00
parent bc85ea63ab
commit dd82b5bf67

30
README.md Normal file
View File

@@ -0,0 +1,30 @@
# DoH MobileConfig
Generates DoH (DNS-over-HTTPS) mobileconfig for iOS 14.0 or later and macOS 11.0 Big Sur or later
## Requirements
- Python 3
- Python Packages
- `httpx`
- `dnspython`
## Getting Started
- Install Requirements: `pip3 install httpx dnspython`
- For a demonstration using the sample configuration file, run: `python3 doh-mobileconfig.py -c config-sample.yaml`
- Copy `config-sample.yaml` to `config.yaml`: `cp config-sample.yaml config.yaml`
- Edit `config.yaml`
- Run: `python3 doh-mobileconfig.py`
## Usage
```
python3 doh-mobileconfig.py -h  ✔
usage: doh-mobileconfig.py [-h] [-p] [--suffix SUFFIX] [-c CONFIG]
options:
-h, --help show this help message and exit
-p, --print print formatted device information and URLs
--suffix SUFFIX sets a suffix to device information, defaults to '-wan'
-c CONFIG, --config CONFIG
specify custom location to config.yaml
```