Skip to content

unblocked/chissl

Repository files navigation

chiSSL

Modern HTTPS reverse tunnels with live traffic capture and a simple dashboard.

Dashboard Overview

Docs

https://unblocked.github.io/chissl/

Highlights

  • On-demand HTTPS reverse tunnels
  • Live request/response capture with searchable history
  • Mock and proxy listeners for development and testing
  • Multicast tunnels (fan-out to multiple targets)
  • Role-based access (admin and user), API tokens, optional SSO
  • SQLite by default; PostgreSQL supported
  • REST API and web dashboard

Quick start

Server (automatic TLS via domain):

./chissl server -v \
  --tls-domain tunnel.mydomain.com \
  --auth admin:REPLACE_THIS_WITH_A_PASSWORD \
  --dashboard

Notes:

  • Ensure the domain points to this server’s public IP
  • The dashboard will be available at https://tunnel.mydomain.com/dashboard
  • You can alternatively supply your own certs using --tls-key/--tls-cert

Client

Single mapping:

chissl client --auth user:pass https://tunnel.mydomain.com \
  "8080->80"

Multiple mappings:

chissl client --auth user:pass https://tunnel.mydomain.com \
  "8080->80" "8443->443:myapp.local" "9000:0.0.0.0->9000"

Client profile (YAML)

Place a yaml file at $HOME/.chissl/profile.yaml (or pass --profile). Example:

server: "https://tunnel.mydomain.com"
auth: "user:pass"
remotes:
  - "8080->80"
  - "8443->443:myapp.local"
keepalive: 30s
verbose: true

This lets you manage tunnel settings locally without repeating flags.

Documentation

Install

  • macOS/Linux via Homebrew (client):
# (Optional) if you get a conflict with the old version 
brew uninstall chissl

# add the tap 
brew tap unblocked/chissl https://github.com/unblocked/chissl

# Install chiSSL client 
brew install unblocked/chissl/chissl
  • Server (Linux) one-liner:
bash <(curl -fsSL https://raw.githubusercontent.com/unblocked/chissl/v2.0/server_installer.sh) FQDN_HERE [port] [admin_password]

This will install the chissl server binary and start it with:

./chissl server -v \
  --tls-domain FQDN_HERE \
  --auth ADMIN_USER:PASSWORD_SUPPLIED_BY_USER \
  --dashboard
go build ./...

Features (overview)

  • Dashboard: manage tunnels, listeners, and view live captures
  • Listeners: mock endpoints or proxy to upstreams; optional TLS termination
  • Multicast: fan-out to multiple destinations with centralized control
  • Security: admin/user roles, API tokens, rate limits and login backoff
  • Database: SQLite by default; PostgreSQL for persistence and scale

Support

Please open issues and feature requests here: https://github.com/unblocked/chissl/issues


Copyright © NextChapter Software

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •