https://github.com/archef2000/iodine-docker
Iodine VPN over DNS server/client in docker
https://github.com/archef2000/iodine-docker
Last synced: about 1 year ago
JSON representation
Iodine VPN over DNS server/client in docker
- Host: GitHub
- URL: https://github.com/archef2000/iodine-docker
- Owner: archef2000
- Created: 2023-08-13T17:44:08.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-08-13T19:21:07.000Z (almost 3 years ago)
- Last Synced: 2025-02-01T05:14:10.678Z (over 1 year ago)
- Language: Shell
- Size: 11.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# iodine
Iodine VPN over DNS server/client in docker
## Docker run/compose
### docker-compose
```yaml
services:
iodine:
image: archef2000/iodine:latest
container_name: iodine
privileged: true
cap_add:
- NET_ADMIN
- SYS_MODULE
sysctls:
- net.ipv4.ip_forward=1
- net.ipv4.conf.all.src_valid_mark=1
ports:
- 53:53/udp
devices:
- /dev/net/tun:/dev/net/tun
environment:
- PASSWORD=***
- DOMAIN=srv.test.com
restart: unless-stopped
```
### docker-run
```bash
docker run --name iodine --privileged \
--cap-add NET_ADMIN --cap-add SYS_MODULE \
--sysctls net.ipv4.ip_forward=1 --sysctls net.ipv4.conf.all.src_valid_mark=1 \
--port 53:53/udp -e PASSWORD=*** -e DOMAIN=srv.test.com --restart unless-stopped \
archef2000/iodine:latest
```
## Config
### Universal
| Variable | Function |
| -------- | -------- |
| PASSWORD | Password for authentication |
| DOMAIN | The domain the iodine server is reachable at |
### Server
| Variable | Function |
| -------- | -------- |
| MTU | The MTU of the vpn interface |
| DEV_TUNNEL | Specify tunnel interface |
| LOG_LEVEL | Set debug log level to 0, 1 or 2 |
| FORWARD_DEST | Destination to forward to other |
| NETWORK | Subnet of VPN tunnel default `10.0.0.1` |
### Client
| Variable | Function |
| -------- | -------- |
| FORCE_DNS_TUNNEL | Ski raw connection mode default `false` |
| MAX_INTERVAL | Between requests to server |
| LAZY_MODE | Lower response time when enabled |
| DNS_SERVER | What DNS server to send the requests to default `8.8.8.8` |
| HOSTNAME_SIZE | Max hostname size |
| DNS_TYPE | What DNS request type to use default autodetected |