⛓ UrNetwork v3.23 Fix

A high-performance, high-visibility fork of the UrNetwork Connect provider, based on the stable v3.23 engine. Tuned for professional providers managing large proxy lists, high throughput, and production-grade operations.

🆚 What this fork changes vs upstream

	Upstream	This fork
Control-plane dial visibility	Debug level 2 (silent)	INFO — one line per successful backend dial ([net][s]select, control-plane not relay traffic)
Initial contract size	16 KiB	Min 256 KiB (lowmem), 2 MiB (performance), tunable per profile
Proxy startup	All at once	Jittered stagger with live [pace] warmup, plus a shared adaptive rate limiter that bounds aggregate auth load on the API
Proxy changes	Restart required	Hot-reload via trigger file, zero downtime, with full added-proxy listing
Proxy source	Static file only	File and/or live URL feed, with scoped auto-cleanup
Error noise	Auth/contract errors spam logs	Rate-limited with suppressed counts
Fleet visibility	None	Hub dashboard — live Mbps, billable traffic, per-proxy drilldown
Performance profiles	None	Auto / Turbo V4 / Turbo V8 / Eco / Lowmem
Crash diagnostics	Journal-only, logs lost on restart	Disk-based critical event log + preserved RAM logs, panic hooks

---

🗺 Start Here

If you want to...	Go here
Install on a Linux host as a user-level service	Installation Guide
Run one Docker container	Docker Deployment
Run multiple containers on one host	Multi-Container Scaling
Choose profiles, turbo mode, or host tuning	Performance Tuning
Understand environment variables	Configuration Reference
Interpret provider logs	Log Message Reference
Monitor your fleet with the bandwidth hub dashboard	Hub Dashboard
Feed the provider a live proxy list URL	Proxy URL Sources

---

⚡ Quick Start

Choose your platform:

Platform	Install	Uninstall
🐧 Linux (systemd)	curl -fSsL https://dl.fullbars.xyz/install.sh | sh	curl -fSsL https://dl.fullbars.xyz/uninstall.sh | sh
🍎 macOS (launchd)	curl -fSsL https://dl.fullbars.xyz/install-mac.sh | sh	manual — see docs/Installation.md
🪟 Windows (PowerShell)	irm https://dl.fullbars.xyz/install-win.ps1 | iex	irm https://dl.fullbars.xyz/uninstall-win.ps1 | iex
🐋 Docker	docker pull ghcr.io/full-bars/urnetwork-3.23-fix:latest	docker rm -f <container> && docker rmi ghcr.io/full-bars/urnetwork-3.23-fix:latest

After installation, authenticate and start providing:

# Linux / macOS
urnetwork auth
urnet-tools proxy add ~/proxies.txt
urnet-tools proxy refresh
urnet-tools auto on

# Windows (PowerShell)
urnet-tools.ps1 auth
urnet-tools.ps1 proxy add ~/proxies.txt
urnet-tools.ps1 proxy refresh

🐋 Docker (Production-Ready)

Recommended for real deployments — includes auto-tuning, in-memory logs, persistent config, and bandwidth monitoring:

docker run -d \
  --name=urnetwork-provider \
  --pull=always \
  --restart=unless-stopped \
  --cap-add=NET_ADMIN \
  --cap-add=NET_RAW \
  --sysctl net.ipv4.ip_forward=1 \
  -e BUILD=jwt \
  -e URNETWORK_PROFILE=auto \
  -e URNETWORK_RAMLOGS=1 \
  -e ENABLE_VNSTAT=true \
  -e HOST_HOSTNAME=$(hostname) \
  -e PROXY_URL='https://example.com/your-proxy-list.txt' \
  -v urnetwork_config:/root/.urnetwork \
  -v urnetwork_vnstat:/var/lib/vnstat \
  -v /path/to/proxy.txt:/app/proxy.txt \
  -p 8080:8080 \
  -e URNETWORK_AUTH_CODE='YOUR_AUTH_CODE_HERE' \
  ghcr.io/full-bars/urnetwork-3.23-fix:latest

Key env vars:

• URNETWORK_PROFILE=auto — Auto-tunes based on available RAM (balanced, lowmem, etc.)
• URNETWORK_RAMLOGS=1 — In-memory logging for fast diagnostics (view with docker exec urnetwork-provider logs)
• URNETWORK_AUTH_CODE — Your JWT token (single-use on first run; saved to volume)
• PROXY_URL — Optional live proxy list URL (comma-separated for multiple), additive with the mounted proxy.txt. See Proxy URL Sources.

See Docker Deployment for Docker Compose, email/password auth, Watchtower, multi-container, and advanced options.

Note

Docker shortcuts — urnet-tools commands work via docker exec (same as bare-metal):

• docker exec -it urfix urnet-tools proxy health
• docker exec -it urfix urnet-tools logs
• docker exec -it urfix urnet-tools status
• docker exec -it urfix urnet-tools session save /root/.urnetwork/backup.urnsession

---

🔧 Common Operations

Command	Use this when...
urnetwork auth	You need to log in or refresh your identity manually
urnet-tools proxy traffic	You want to see active clients, bandwidth, and Max Age per proxy
urnet-tools proxy health	You need to see which proxies are DEAD vs DEGRADED vs UP
urnet-tools logs	You want to stream the current RAMLOGS buffer
urnet-tools optimize	You just added many proxies and need to tune kernel ulimits
urnet-tools proxy summary	You want a single-pane fleet overview -- sources, health, URL cache status
urnet-tools proxy refresh	You updated your proxy list and want the node to reload live
urnet-tools hot-restart on/off	Toggle client JWT reuse across restarts (on by default; off sets URNETWORK_HOT_RESTART=0)
urnet-tools session save <file>	Export identity+proxy state as encrypted bundle (cross-machine transfer)
urnet-tools session load <file>	Import identity+proxy state, then restart
urnet-tools report <url>	You want to set or change the hub report URL without restarting
urnet-tools report	You want to check which URL the provider is currently reporting to

Tip

~/proxies.txt and /home/user/proxies.txt are both valid path formats.

---

📡 Fleet Dashboard

Monitor your entire fleet in real time. The hub aggregates bandwidth reports from all nodes and renders a live HTML dashboard with traffic rates, billable accounting, per-proxy drilldown, and auto-refresh.

# Run the hub (Linux, via urnet-tools — recommended)
urnet-tools hub install

# Or run it in Docker (Windows / Mac / any host)
docker build -f hub/Dockerfile -t urnetwork-hub .
docker run -d --name urnetwork-hub -p 8080:8080 -v hubdata:/data urnetwork-hub

# Point each provider at it
URNETWORK_REPORT_URL=http://HUB_IP:8080

See Hub Setup for installation and Hub Dashboard for full feature details.

---

💡 Recommended Defaults

• Use the Linux installer for a host-managed systemd service
• Use Docker if you prefer containers — both are fully documented
• Leave profile on auto unless you have a specific reason to override
• Mount /root/.urnetwork as a persistent volume in Docker deployments
• Run urnet-tools optimize after adding a large proxy list, or when the System Auditor flags kernel limits

---

📚 Documentation

In-repo:

• Installation
• Docker Deployment
• Multi-Container Scaling
• Configuration Reference
• Proxy Management & Hot-Reload
• High-Volume Performance Tuning
• Hub Setup
• Hub Dashboard
• Changelog

Wiki:

• Log Message Reference
• Proxy Hot-Reload internals
• CI and Release Process
• Project Structure

---

🏗 Build Info

• Base engine: UrNetwork v3.23
• Language: Go 1.25, compiled on Alpine
• Images: Multi-arch linux/amd64 + linux/arm64, darwin/amd64 + darwin/arm64 via GitHub Actions → GHCR
• Bridge-friendly: runs on standard Docker bridge networks, no --network host required

---

Warning

This is a private, custom modification for professional provider use. Not affiliated with the official UrNetwork project.