Yggstack

https://github.com/yggdrasil-network/yggstack
Admin
Yggstack provides SOCKS5 proxy server and TCP port forwarder functionality, similar to a TOR router,...
Tokens:1,299
Snippets:19
Trust Score:9.1
License:LGPL-3.0
Update:3 months ago
Show doc for...
Tokens:
Raw
### Build Yggstack from source

Source: https://github.com/yggdrasil-network/yggstack/blob/develop/README.md

Commands to build the project from source, including cross-compilation examples.

```bash
./build
```

```bash
GOOS=windows ./build
```

```bash
GOOS=linux GOARCH=mipsle ./build
```

--------------------------------

### Run Yggstack SOCKS proxy

Source: https://github.com/yggdrasil-network/yggstack/blob/develop/README.md

Start a SOCKS proxy server using a configuration file, listening on a TCP port or UNIX socket.

```bash
./yggstack -useconffile /path/to/yggdrasil.conf -socks 127.0.0.1:1080
```

```bash
./yggstack -useconffile /path/to/yggdrasil.conf -socks /tmp/yggstack.sock
```

--------------------------------

### Run Yggstack standalone or auto-configured

Source: https://github.com/yggdrasil-network/yggstack/blob/develop/README.md

Run without proxy features or use auto-configuration mode with random keys.

```bash
./yggstack -useconffile /path/to/yggdrasil.conf
```

```bash
./yggstack -autoconf -socks 127.0.0.1:1080
```

--------------------------------

### Configure external DNS nameservers

Source: https://github.com/yggdrasil-network/yggstack/blob/develop/README.md

Set a DNS nameserver for Yggstack and test resolution with curl.

```bash
yggstack -useconffile /path/to/yggdrasil.conf -nameserver '[324:71e:281a:9ed3::53]:53' -socks 127.0.0.1:1080
```

```bash
curl -x socks5h://127.0.0.1:1080 http://web.mc.ygg
```

--------------------------------

### Expose local services to Yggdrasil

Source: https://github.com/yggdrasil-network/yggstack/blob/develop/README.md

Forward local TCP or UDP services to the Yggdrasil network.

```bash
./yggstack -useconffile /path/to/yggdrasil.conf -remote-tcp 80:127.0.0.1:8080
```

```bash
./yggstack -useconffile /path/to/yggdrasil.conf -remote-udp 53:127.0.0.1:53
```

--------------------------------

### Generate Yggstack configuration

Source: https://github.com/yggdrasil-network/yggstack/blob/develop/README.md

Generate static configuration files in HJSON or JSON format.

```bash
./yggstack -genconf > /path/to/yggdrasil.conf
```

```bash
./yggstack -genconf -json > /path/to/yggdrasil.conf
```

--------------------------------

### Access pk.ygg domains

Source: https://github.com/yggdrasil-network/yggstack/blob/develop/README.md

Use curl to access services via the built-in pk.ygg DNS resolver.

```bash
curl -x socks5h://127.0.0.1:1080 http://d40d4a7153cf288ea28f1865f6cfe95143a478b5c8c9e7cb002a0633d10a53eb.pk.ygg
```

--------------------------------

### Forward remote Yggdrasil ports locally

Source: https://github.com/yggdrasil-network/yggstack/blob/develop/README.md

Forward ports from a remote Yggdrasil node to the local machine.

```bash
./yggstack -useconffile /path/to/yggdrasil.conf -local-tcp 127.0.0.1:8080:<remote-yggdrasil-ipv6>:8080
./yggstack -useconffile /path/to/yggdrasil.conf -local-tcp [::1]:8080:<remote-yggdrasil-ipv6>:8080
```

```bash
./yggstack -useconffile /path/to/yggdrasil.conf -local-udp 127.0.0.1:5353:<remote-yggdrasil-ipv6>:53
./yggstack -useconffile /path/to/yggdrasil.conf -local-udp [::1]:5353:<remote-yggdrasil-ipv6>:53
```
Tokens:
Raw