shatinz
3a57ebffe7
# Pull Request: Connection Reporting System & Improvements for Restricted Networks
...
## Description
This PR introduces a comprehensive **Connection Reporting System** designed to improve the reliability and monitoring of connections, specifically tailored for environments with restricted internet access (e.g., active censorship, GFW).
### Key Changes
1. **New Reporting API (`/report`)**:
* Added `ReportController` and `ReportService` to handle incoming connection reports.
* Endpoint receives data such as `Latency`, `Success` status, `Protocol`, and Client Interface details.
* Data is persisted to the database via the new `ConnectionReport` model.
2. **Subscription Link Updates**:
* Modified `subService` to append a `reportUrl` parameter to generated subscription links (VLESS, VMess, etc.).
* This allows compatible clients to automatically discover the reporting endpoint and send feedback.
3. **Database Integration**:
* Added `ConnectionReport` schema to `database/model` and registered it in `database/db.go` for auto-migration.
## Why is this helpful for Restricted Internet Locations?
In regions with heavy internet censorship, connection stability is volatile.
* **Dynamic Reporting Endpoint**: The `reportUrl` parameter embedded in the subscription link explicitly tells the client *where* to send connection data.
* **Bypassing Blocking**: By decoupling the reporting URL from the node address, clients can ensure diagnostic data reaches the panel even if specific node IPs are being interfered with (assuming the panel itself is reachable).
* **Real-time Network Intelligence**: This mechanism enables the panel to aggregate "ground truth" data from clients inside the restricted network (e.g., latency, accessibility of specific protocols), allowing admins to react faster to blocking events.
* **Protocol Performance Tracking**: Allows comparison of different protocols (Reality vs. VLESS+TLS vs. Trojan) based on real-world latency and success rates from actual users.
* **Rapid Troubleshooting**: Administrators can see connection quality trends and rotate IPs/domains proactively when success rates drop, minimizing downtime for users.
## Technical Details
* **API Endpoint**: `POST /report`
* **Payload Format**: JSON containing `SystemInfo` (Interface), `ConnectionQuality` (Latency, Success), and `ProtocolInfo`.
* **Security**: Reports are tied to valid client request contexts (implementation detail: ensure endpoint is rate-limited or authenticated if necessary, though currently designed for open reporting from valid sub links).
## How to Test
1. Update the panel.
2. Generate a subscription link.
3. Observe the `reportUrl` parameter in the link.
4. Simulate a client POST to the report URL and verify the entry in the `ConnectionReports` table.
2026-02-04 13:30:00 +03:30
MHSanaei
06c49b92f8
v2.8.9
Release 3X-UI / build (386) (push) Waiting to run
Release 3X-UI / build (amd64) (push) Waiting to run
Release 3X-UI / build (arm64) (push) Waiting to run
Release 3X-UI / build (armv5) (push) Waiting to run
Release 3X-UI / build (armv6) (push) Waiting to run
Release 3X-UI / build (armv7) (push) Waiting to run
Release 3X-UI / build (s390x) (push) Waiting to run
Release 3X-UI / Build for Windows (push) Waiting to run
2026-02-01 04:05:02 +01:00
MHSanaei
d8c783a296
v2.8.8
Release 3X-UI / build (386) (push) Has been cancelled
Release 3X-UI / build (amd64) (push) Has been cancelled
Release 3X-UI / build (arm64) (push) Has been cancelled
Release 3X-UI / build (armv5) (push) Has been cancelled
Release 3X-UI / build (armv6) (push) Has been cancelled
Release 3X-UI / build (armv7) (push) Has been cancelled
Release 3X-UI / build (s390x) (push) Has been cancelled
Release 3X-UI / Build for Windows (push) Has been cancelled
2026-01-18 18:01:58 +01:00
MHSanaei
7b0a3929ff
v2.8.7
Release 3X-UI / build (386) (push) Has been cancelled
Release 3X-UI / build (amd64) (push) Has been cancelled
Release 3X-UI / build (arm64) (push) Has been cancelled
Release 3X-UI / build (armv5) (push) Has been cancelled
Release 3X-UI / build (armv6) (push) Has been cancelled
Release 3X-UI / build (armv7) (push) Has been cancelled
Release 3X-UI / build (s390x) (push) Has been cancelled
Release 3X-UI / Build for Windows (push) Has been cancelled
2026-01-05 19:00:36 +01:00
MHSanaei
e69a31dd59
v2.8.6
2026-01-03 06:44:39 +01:00
mhsanaei
01d4a7488d
v2.8.5
Release 3X-UI / build (386) (push) Has been cancelled
Release 3X-UI / build (amd64) (push) Has been cancelled
Release 3X-UI / build (arm64) (push) Has been cancelled
Release 3X-UI / build (armv5) (push) Has been cancelled
Release 3X-UI / build (armv6) (push) Has been cancelled
Release 3X-UI / build (armv7) (push) Has been cancelled
Release 3X-UI / build (s390x) (push) Has been cancelled
Release 3X-UI / Build for Windows (push) Has been cancelled
2025-10-15 11:40:40 +02:00
mhsanaei
104526aab2
v2.8.4
Release 3X-UI / build (386) (push) Waiting to run
Release 3X-UI / build (amd64) (push) Waiting to run
Release 3X-UI / build (arm64) (push) Waiting to run
Release 3X-UI / build (armv5) (push) Waiting to run
Release 3X-UI / build (armv6) (push) Waiting to run
Release 3X-UI / build (armv7) (push) Waiting to run
Release 3X-UI / build (s390x) (push) Waiting to run
Release 3X-UI / Build for Windows (push) Waiting to run
2025-09-24 11:47:43 +02:00
mhsanaei
020bc9d77c
v2.8.3
2025-09-21 21:20:45 +02:00
mhsanaei
0ffd27c0aa
v2.8.2
Release 3X-UI / build (386) (push) Waiting to run
Release 3X-UI / build (amd64) (push) Waiting to run
Release 3X-UI / build (arm64) (push) Waiting to run
Release 3X-UI / build (armv5) (push) Waiting to run
Release 3X-UI / build (armv6) (push) Waiting to run
Release 3X-UI / build (armv7) (push) Waiting to run
Release 3X-UI / build (s390x) (push) Waiting to run
Release 3X-UI / Build for Windows (push) Waiting to run
2025-09-19 00:22:15 +02:00
mhsanaei
3764ece26c
v2.8.1
2025-09-17 13:51:41 +02:00
mhsanaei
5408a2f82c
v2.8.0
2025-09-14 22:09:36 +02:00
mhsanaei
b1ea8005e4
v2.7.0
2025-09-10 08:43:46 +02:00
mhsanaei
7b039d219e
v2.6.8
2025-09-08 00:29:30 +02:00
mhsanaei
2750f46c01
v2.6.7
Release 3X-UI / build (386) (push) Waiting to run
Release 3X-UI / build (amd64) (push) Waiting to run
Release 3X-UI / build (arm64) (push) Waiting to run
Release 3X-UI / build (armv5) (push) Waiting to run
Release 3X-UI / build (armv6) (push) Waiting to run
Release 3X-UI / build (armv7) (push) Waiting to run
Release 3X-UI / build (s390x) (push) Waiting to run
2025-08-30 16:05:33 +02:00
mhsanaei
4d02756e1e
v2.6.6
Release 3X-UI / build (386) (push) Waiting to run
Release 3X-UI / build (amd64) (push) Waiting to run
Release 3X-UI / build (arm64) (push) Waiting to run
Release 3X-UI / build (armv5) (push) Waiting to run
Release 3X-UI / build (armv6) (push) Waiting to run
Release 3X-UI / build (armv7) (push) Waiting to run
Release 3X-UI / build (s390x) (push) Waiting to run
2025-08-08 20:52:04 +02:00
mhsanaei
4b03e9d919
v2.6.5
2025-08-04 19:12:37 +02:00
mhsanaei
73a5722cca
v2.6.3
Release 3X-UI / build (386) (push) Waiting to run
Release 3X-UI / build (amd64) (push) Waiting to run
Release 3X-UI / build (arm64) (push) Waiting to run
Release 3X-UI / build (armv5) (push) Waiting to run
Release 3X-UI / build (armv6) (push) Waiting to run
Release 3X-UI / build (armv7) (push) Waiting to run
Release 3X-UI / build (s390x) (push) Waiting to run
2025-08-03 12:22:28 +02:00
mhsanaei
b7164805f8
v2.6.2
Release 3X-UI / build (386) (push) Has been cancelled
Release 3X-UI / build (amd64) (push) Has been cancelled
Release 3X-UI / build (arm64) (push) Has been cancelled
Release 3X-UI / build (armv5) (push) Has been cancelled
Release 3X-UI / build (armv6) (push) Has been cancelled
Release 3X-UI / build (armv7) (push) Has been cancelled
Release 3X-UI / build (s390x) (push) Has been cancelled
2025-07-06 20:58:10 +02:00
mhsanaei
c81c27073c
v2.6.1
Release 3X-UI / build (386) (push) Has been cancelled
Release 3X-UI / build (amd64) (push) Has been cancelled
Release 3X-UI / build (arm64) (push) Has been cancelled
Release 3X-UI / build (armv5) (push) Has been cancelled
Release 3X-UI / build (armv6) (push) Has been cancelled
Release 3X-UI / build (armv7) (push) Has been cancelled
Release 3X-UI / build (s390x) (push) Has been cancelled
2025-07-02 11:28:24 +02:00
mhsanaei
ef625c75d8
v2.6.0
Release 3X-UI / build (386) (push) Waiting to run
Release 3X-UI / build (amd64) (push) Waiting to run
Release 3X-UI / build (arm64) (push) Waiting to run
Release 3X-UI / build (armv5) (push) Waiting to run
Release 3X-UI / build (armv6) (push) Waiting to run
Release 3X-UI / build (armv7) (push) Waiting to run
Release 3X-UI / build (s390x) (push) Waiting to run
2025-05-16 14:26:20 +02:00
mhsanaei
3d54e33051
v2.5.8
Build and Release 3X-UI / build (386) (push) Has been cancelled
Build and Release 3X-UI / build (amd64) (push) Has been cancelled
Build and Release 3X-UI / build (arm64) (push) Has been cancelled
Build and Release 3X-UI / build (armv5) (push) Has been cancelled
Build and Release 3X-UI / build (armv6) (push) Has been cancelled
Build and Release 3X-UI / build (armv7) (push) Has been cancelled
Build and Release 3X-UI / build (s390x) (push) Has been cancelled
2025-04-30 11:24:06 +02:00
mhsanaei
236dddf482
v2.5.7
2025-04-11 12:11:39 +02:00
mhsanaei
2ffde55f8f
v2.5.6 - Happy Nowruz
2025-03-20 10:54:54 +01:00
mhsanaei
1893c3814d
v2.5.5
2025-03-10 14:33:58 +01:00
mhsanaei
d6d05a9b4d
v2.5.4
2025-03-05 15:42:51 +01:00
mhsanaei
31e1581d6b
v2.5.3
2025-02-25 18:43:29 +01:00
mhsanaei
49bfff9fa5
v2.5.2
2025-02-04 11:38:57 +01:00
mhsanaei
94d651fc93
v2.5.1
2025-02-03 17:40:33 +01:00
mhsanaei
3be204f272
v2.5.0
2025-01-28 00:09:20 +01:00
MHSanaei
195effd177
v2.4.11
2024-12-27 21:49:45 +01:00
mhsanaei
8e81008cdc
v2.4.10
2024-12-19 10:54:17 +01:00
MHSanaei
0abd0be725
v2.4.9
2024-12-16 10:13:40 +01:00
mhsanaei
e0bbacf013
v2.4.8
2024-11-21 18:12:19 +03:30
mhsanaei
f497a8dbcc
v2.4.7
2024-11-14 19:36:10 +03:30
mhsanaei
7abb092211
v2.4.6
2024-10-31 09:54:53 +01:00
mhsanaei
e6020850fc
v2.4.5
2024-10-17 12:27:13 +02:00
MHSanaei
5f8c8f4525
v2.4.4
2024-10-11 10:19:53 +02:00
mhsanaei
80cfbefd75
v2.4.3
2024-10-01 09:41:12 +02:00
mhsanaei
43713fbdf8
v2.4.2
2024-09-24 15:15:29 +02:00
mhsanaei
77edea5419
v2.4.1
2024-09-16 17:30:53 +02:00
mhsanaei
575234ac37
v2.4.0
2024-09-09 10:42:20 +02:00
mhsanaei
5c390341fb
v2.3.15
2024-09-05 12:06:16 +02:00
mhsanaei
f0165c1ad8
v2.3.14
2024-08-30 10:28:01 +02:00
mhsanaei
a6000f22a2
v2.3.13
2024-08-11 12:43:47 +02:00
mhsanaei
7b8ef98846
v2.3.12
2024-08-06 21:18:48 +02:00
mhsanaei
4cd89f4379
v2.3.11
2024-07-29 13:17:55 +02:00
mhsanaei
0630642849
v2.3.10
2024-07-22 00:14:48 +02:00
mhsanaei
9de8b4acaf
v2.3.9
2024-07-17 13:51:11 +02:00
mhsanaei
96e43fa195
v2.3.8
2024-07-08 23:48:01 +02:00
mhsanaei
86586b7e8f
v2.3.7
2024-07-01 23:54:12 +02:00