Repository navigation
Releases
Releases · deadboyccc/BurrowRs
burrowrs v1.0.1
Fixed
- A full proxy could take everyone down with it. The default
MAX_CONNECTIONS(10000)
let telemt accept more connections than its default 512 MiB memory limit can hold: a load
test measured 70-75 KiB per connection, so it would run out of memory at about 7,000 and
the kernel would kill it, dropping every user at once. The default is now 5000, andup
anddoctorwarn whenMAX_CONNECTIONSneeds more thanTELEMT_MEMORY_LIMIT(budget:
96 KiB per connection), with the value that fits. Within the limit, telemt refuses the
extra connections instead.
Added
- Measured capacity in docs/OPERATIONS.md: on a
1 vCPU, 1 GB server, 3,000 active connections were held at once (219 MiB, 17% CPU), and
1,000 round trips ran at 313/s. - Moving from Burrow without changing a
single link, as done on a live server.
burrowrs v1.0.0
First release. burrowrs is Burrow 1.2.0 rewritten on
a Rust proxy engine, telemt 3.5.17, with per-user
secrets. The disguise, the hardened containers, the installer, the CLI and the test suites
come from Burrow; the proxy, the access model and everything they touch are new. Digby the
mole came along, in a rust-orange scarf with a cog on it.
Added
- telemt as the proxy: FakeTLS only (classic and
ddmodes off), unrecognised
connections masked to the decoy website (unknown_sni_action = "mask"), the decoy's real
certificate sizes mirrored in handshakes (tls_emulation), strict config parsing. The
official image is pinned by digest and runs unmodified, as uid 65534 on a read-only root. - Two access modes (
ACCESS_MODE):shared(default): one secret and one link for everyone, as in Burrow.users: a name and a secret per user, kept inusers.tsv(0600).SECRETbecomes the
operator's ownowneruser, which the health checks use.
burrowrs user:add,list,show,link,share,renew,set,disable,
enable,rotate,remove. Per-user limits: expiry (--days,--until,--forever),
data quota (--quota, binary units), quota resets (--period daily|weekly|monthly, UTC)
and simultaneous IP addresses (--ips). Defaults come fromUSER_DEFAULT_DAYS
(30),USER_DEFAULT_QUOTA,USER_DEFAULT_PERIODandUSER_DEFAULT_IPS(3).- Changes without restarts: users live in
users.toml, included by telemt's main
config and picked up by telemt's own file watcher, so adding, changing, disabling or removing a user (and
rotate) disconnects no one else. Disabling a user closes their open connections. Each change waits until telemt's
API confirms it runs the new user list. - Live usage:
user listanduser showread connections, connected IPs, traffic and
quota use from telemt's control API, which is read-only and reachable only from inside
the proxy's network namespace (the on-demandtools-apicontainer). - Quota usage survives restarts in the
telemt-datavolume. - Sponsored channel:
AD_TAG(from @MTProxybot) switches telemt to Telegram's middle
proxies with the server's public address. init --access,deploy --access,try --users, and the installer'sBURROWRS_ACCESS.- New settings:
ACCESS_MODE,AD_TAG,USER_DEFAULT_*,MAX_CONNECTIONS,
TELEMT_MEMORY_LIMIT,LOG_LEVEL. doctorasks the running proxy whether it is ready and whether Telegram answers through
it.
Changed (compared with Burrow)
- The secret is a plain 16-byte key. Links still carry the FakeTLS form (
ee+ key +
hex of the domain), so changing the domain keeps every secret;config setwarns that
links change instead. rotatereloads instead of restarting. The old link stops working at once.- Logging:
LOG_LEVEL(defaultsilent, telemt's warnings and errors) replaces
DEBUG. Successful connections are never logged; refused ones are, with the user name
and sometimes the client's IP. Links never reach the logs: thetelemt::linkslog target
is switched off, and telemt's per-IP observation feature (beobachten) is disabled. - Default network
10.204.47.0/28(decoy10.204.47.10), so burrowrs can run next to
Burrow. statusreads telemt's metrics: connections and users connected now, traffic, accepted
and invalid connections, failed Telegram dials, uptime.
Removed (compared with Burrow)
- mtg-only features: IP block and allow lists (
BLOCKLIST_*,ALLOWLIST_URLS,
LOCAL_BLOCKLIST,LOCAL_ALLOWLIST), traffic-shape mimicry (DOPPELGANGER_URLS),
SOCKS5 upstreams (UPSTREAM_PROXIES),DNS_RESOLVER,PREFER_IP,TIME_SKEW(telemt
allows ±2 minutes),ANTI_REPLAY_SIZE,IDLE_TIMEOUT, the Go memory limit, and
mtg doctor. CONCURRENCYandMTG_MEMORY_LIMITare nowMAX_CONNECTIONSandTELEMT_MEMORY_LIMIT.
Verified
- On 2026-11-18 a local
./burrowrs trypassed all 8 smoke checks: FakeTLS handshake, a
Telegramreq_pq_multi→resPQround trip, replay refused, a 10-minute clock skew
refused, a wrong secret gets the decoy, the real website over TLS, plain HTTP answered,
metrics on loopback only. - In per-user mode, added users worked at once, and a disabled user, an expired user and a
1 KiB quota were enforced live, without restarting the proxy container.