gitwtfhub

wtf is sentry-tunnel?

aprilnea/sentry-tunnel — explained in plain English

Analysis updated 2026-08-08 · repo last pushed 2025-11-06

1RustAudience · developerComplexity · 2/5QuietSetup · moderate

TL;DR

A tool that routes error reports to Sentry through your own domain, bypassing ad-blockers and privacy extensions that block Sentry's servers. Built in Rust with Axum integration and a framework-agnostic core handler.

Mindmap

mindmap
  root((repo))
    What it does
      Routes errors past ad-blockers
      Forwards reports to Sentry
      Validates project IDs
    Tech stack
      Rust
      Axum web framework
      Modular core handler
    Use cases
      SaaS error monitoring
      Privacy extension users
      Bypass content blockers
    Audience
      Web app developers
      Product managers
      DevOps teams
    Security
      Allowed project IDs only
      Hostname validation
      Prevents open proxy abuse

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Route error reports through your own domain to bypass ad-blockers blocking Sentry

REASON 2

Prevent loss of error visibility for users with privacy extensions on SaaS dashboards

REASON 3

Securely proxy Sentry traffic with allowed project IDs and hostname validation

What's in the stack?

RustAxum

How it stacks up

aprilnea/sentry-tunnelabc3dz/mixxxabyo-software/ferro-stash
Stars111
LanguageRustRustRust
Last pushed2025-11-06
MaintenanceQuiet
Setup difficultymoderatemoderatemoderate
Complexity2/52/54/5
Audiencedevelopergeneralops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires a Rust web server (Axum recommended) and configuring your Sentry client-side SDK with a custom tunnel path on your domain.

Wtf does this do

Sentry Tunnel is a tool that helps your app keep reporting errors to Sentry even when users have ad-blockers or privacy extensions installed. Many ad-blockers block requests to Sentry's servers by default, which means you lose visibility into crashes and bugs that real users are experiencing. This project solves that by routing those error reports through your own domain instead, so they look like normal traffic to your site. When a user's browser would normally send an error report directly to Sentry, the tunnel intercepts it and forwards it along on your behalf. You configure it with your Sentry host and a list of allowed project IDs, and it handles the rest. On the client side, you just add one line to your Sentry configuration telling it to use a tunnel path on your domain. The tunnel checks that incoming requests are legitimate by validating the hostname and project IDs, so nobody can abuse your server to proxy traffic to random destinations. This is useful for teams running web apps who rely on Sentry for error monitoring but know their users have ad-blockers. For example, if you run a SaaS dashboard and a chunk of your users have privacy extensions installed, those users' errors may never reach Sentry without a tunnel like this. Product managers and developers who notice gaps in their error data often trace the problem back to content blockers, and this is a straightforward fix. The project is built in Rust and designed to integrate with Axum, a web framework, but it also offers a framework-agnostic core handler if you use something else. It is modular by design, so you can enable only the pieces you need. The security model is deliberate: by restricting which project IDs and hostnames are allowed, it prevents your server from becoming an open proxy that bad actors could exploit.

Yoink these prompts

Prompt 1
Help me set up sentry-tunnel with Axum, show me the server configuration code and how to specify my Sentry host and allowed project IDs
Prompt 2
I use a Rust web framework other than Axum. Show me how to use sentry-tunnel's framework-agnostic core handler in my existing server
Prompt 3
Walk me through the client-side Sentry configuration change needed to route error reports through my sentry-tunnel domain path

Frequently asked questions

wtf is sentry-tunnel?

A tool that routes error reports to Sentry through your own domain, bypassing ad-blockers and privacy extensions that block Sentry's servers. Built in Rust with Axum integration and a framework-agnostic core handler.

What language is sentry-tunnel written in?

Mainly Rust. The stack also includes Rust, Axum.

Is sentry-tunnel actively maintained?

Quiet — no commits in 6-12 months (last push 2025-11-06).

How hard is sentry-tunnel to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is sentry-tunnel for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.