Skip to content

dix.su — documentation

dix.su is a platform for publishing local services to the internet via a WebSocket tunnel — no static IP, no port forwarding required. Works on any internet-connected device.

your laptop / server / phone
        │  localhost:3000
        └─ device_client ──WSS──► proxy.dix.su ──► myslug.dix.su
                                                       │
                                               any browser in the world

Quick navigation

For platform developers

Document Contents
Architecture Stack, containers, repository, data flow
Modules Per-service breakdown with file maps
Features & Gaps What's implemented, what's not — start here
Deployment Workflow, initial setup, secrets, backups
Security Threat model, anti-abuse, incidents
Billing Plans, Smart Billing, payment providers
Scaling From a single VPS to a large platform
Capacity How many users the current server handles

Physical devices — shopdix.su

Document Audience
Technical Overview Developer: architecture, API, DB
User Guide Buyer: activation, management, FAQ
Vendor Guide Seller: firmware, QR codes, testing

How-to guides

Guide Description
Custom Domains Your own domain for the tunnel: DNS, SSL, diagnostics
TCP Tunnels Commands for SSH / RDP / VNC / databases
OAuth Providers Add Google, GitHub, VK, and others
Frontend Editing Where templates live, how to add a page
Internationalization i18n, GDPR, go-to-market strategy
Lemon Squeezy International card payments

FAQ

Document Description
FAQ Questions and answers — source of truth for the /faq page on the site

dix.su in 30 seconds

  1. Sign up → get myslug.dix.su
  2. Download device_client and run: device_client myslug mytoken 3000
  3. Your localhost:3000 is now live at https://myslug.dix.su

Plans: SIMPLE (free, 10 GB/mo) → VIP → PRO → PERS. Details — Billing & Plans.

Ready-made devices: buy a pre-configured device at shopdix.su — plug it in and the tunnel starts automatically. Details — Devices.

Repository

Monorepo gitlab.com:dixsu/infra, branch prod. SSH deploy to a single VPS, no CI/CD. Details — Deployment.