Skip to content

dnstt-xyz/slipstream-socks-deploy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 

Repository files navigation

Slipstream + SOCKS Deploy

One-liner installer for 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

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

# 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:

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:

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

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.

About

Simple script to setup the slipstream + socks tunnel

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages