KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #open-source #ai #claude-code #codex #developer-tools #dsh-plugin #ai-agent #mcp #deepseek-harness

slipstream-socks-deploy

★ 31 Open GitHub ↗

Simple script to setup the slipstream + socks tunnel

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Slipstream + SOCKS Deploy

One-liner installer for [slipstream-rust](https://github.com/Mygod/slipstream-rust) DNS tunnel server with a Dante SOCKS5 proxy backend on Ubuntu.

## What it does

- Builds and installs `slipstream-server` from source (pinned to a tested commit)
- Sets up Dante as a local SOCKS5 proxy on `127.0.0.1:1080`
- Creates systemd services for both
- Handles `systemd-resolved` conflicts on port 53
- Prints DNS records you need to configure

## Architecture

```
Client App (SOCKS5) --> slipstream-client:7000 --> DNS queries --> slipstream-server:53 --> Dante:1080 --> Internet
```

## Quick Install

```bash
curl -sSL https://raw.githubusercontent.com/dnstt-xyz/slipstream-socks-deploy/main/install.sh | bash -s -- --domain t.example.com
```

Replace `t.example.com` with your tunnel domain.

## Usage

```bash
# Install
bash install.sh --domain t.example.com

# Custom ports
bash install.sh --domain t.example.com --dns-port 53 --socks-port 1080

# Uninstall
bash install.sh --uninstall
```

### Options

| Flag | Default | Description |
|------|---------|-------------|
| `--domain` | (required) | DNS tunnel domain |
| `--dns-port` | `53` | DNS listen port |
| `--socks-port` | `1080` | Dante SOCKS port (localhost) |
| `--install-dir` | `/opt/slipstream-rust` | Install directory |
| `--uninstall` | | Remove everything |

## DNS Setup

After install, the script prints the records you need. For a domain like `t.dnstt.xyz`:

| Type | Name | Value |
|------|------|-------|
| A | `ns` | `<your-server-ip>` |
| NS | `t` | `ns.dnstt.xyz` |

## Client

On your local machine, build and run the slipstream client:

```bash
git clone --recursive https://github.com/Mygod/slipstream-rust.git
cd slipstream-rust
cargo build --release -p slipstream-client

./target/release/slipstream-client \
    --tcp-listen-port 7000 \
    --domain t.example.com
```

Then use `127.0.0.1:7000` as a SOCKS5 proxy:

```bash
curl -x socks5h://127.0.0.1:7000 http://ifconfig.me
```

## Requirements

- Ubuntu 20.04+ (server)
- Root access
- A domain with DNS you control

## Management

```bash
systemctl status slipstream    # check tunnel server
systemctl status danted        # check SOCKS proxy
journalctl -fu slipstream      # follow server logs
```

## License

The install script is provided as-is. slipstream-rust is licensed under [Apache-2.0](https://github.com/Mygod/slipstream-rust/blob/main/LICENSE).

slipstream-socks-deploy

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README