2026-04-21 20:20:43 +02:00
[English ](/README.md ) | [فارسی ](/README.fa_IR.md ) | [العربية ](/README.ar_EG.md ) | [中文 ](/README.zh_CN.md ) | [Español ](/README.es_ES.md ) | [Русский ](/README.ru_RU.md )
2024-03-31 08:35:36 -05:00
2024-11-21 11:18:30 -06:00
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="./media/3x-ui-dark.png">
<img alt="3x-ui" src="./media/3x-ui-light.png">
</picture>
</p>
2024-03-31 08:35:36 -05:00
2025-09-19 10:29:34 +02:00
[](https://github.com/MHSanaei/3x-ui/releases)
[](https://github.com/MHSanaei/3x-ui/actions)
[](#)
[](https://github.com/MHSanaei/3x-ui/releases/latest)
[](https://www.gnu.org/licenses/gpl-3.0.en.html)
feat(nodes): traffic-writer queue, full-mirror sync, WS event fixes
- Traffic-writer single-consumer queue (web/service/traffic_writer.go)
serialises every DB write that touches up/down/all_time/last_online
(AddTraffic, SetRemoteTraffic, Reset*, UpdateClientTrafficByEmail) so
overlapping goroutines can no longer clobber each other's column-scoped
Updates with a stale tx.Save.
- DB pool: WAL + busy_timeout=10s + synchronous=NORMAL + _txlock=
immediate, MaxOpenConns=8 / MaxIdleConns=4. The immediate-tx PRAGMA
fixes residual "database is locked [0ms]" cases where deferred-tx
writer-upgrade conflicts bypass busy_timeout.
- SetRemoteTraffic full-mirrors node-authoritative state into central:
settings JSON, remark, listen, port, total, expiry, all_time, enable,
plus per-client total/expiry/reset/all_time. Inbounds and
client_traffics rows present on node but missing from central are
created; rows missing from snap are deleted (with cascading
client_traffics removal).
- NodeTrafficSyncJob detects structural changes from the mirror and
broadcasts invalidate(inbounds) so open central UIs re-fetch via REST
on node-side add/del/edit without manual refresh.
- XrayTrafficJob broadcasts invalidate(inbounds) when auto-disable flips
client_traffics.enable so the per-client toggle reflects depletion
without manual refresh.
- Frontend: inbounds page now subscribes to the BroadcastInbounds 'inbounds'
WS event (full-list pushes from add/del/update controllers were silently
dropped). Fixes invalidate payload field (dataType -> type). Restart-
panel modal switched from Promise-wrap to onOk-only so Cancel actually
cancels.
- Node files trimmed of stale prose-comments; cron cadence dropped
10s -> 5s to match the inbounds page UX.
- README badges and Go module path bumped v2 -> v3 to match module rename.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-10 16:25:23 +02:00
[](https://pkg.go.dev/github.com/mhsanaei/3x-ui/v3)
[](https://goreportcard.com/report/github.com/mhsanaei/3x-ui/v3)
2024-03-31 08:35:36 -05:00
2025-06-05 18:56:33 +07:00
**3X-UI** — panel de control avanzado basado en web de código abierto diseñado para gestionar el servidor Xray-core. Ofrece una interfaz fácil de usar para configurar y monitorear varios protocolos VPN y proxy.
2024-03-31 08:35:36 -05:00
2025-06-05 18:56:33 +07:00
> [!IMPORTANT]
> Este proyecto es solo para uso personal y comunicación, por favor no lo use para fines ilegales, por favor no lo use en un entorno de producción.
2024-03-31 08:35:36 -05:00
2025-06-05 18:56:33 +07:00
Como una versión mejorada del proyecto X-UI original, 3X-UI proporciona mayor estabilidad, soporte más amplio de protocolos y características adicionales.
2024-03-31 08:35:36 -05:00
2025-06-05 18:56:33 +07:00
## Inicio Rápido
2024-03-31 08:35:36 -05:00
```
2025-06-10 19:17:31 +03:30
bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)
2024-03-31 08:35:36 -05:00
```
2025-06-05 18:56:33 +07:00
Para documentación completa, visita la [Wiki del proyecto ](https://github.com/MHSanaei/3x-ui/wiki ).
2024-03-31 08:35:36 -05:00
2025-06-05 18:56:33 +07:00
## Un Agradecimiento Especial a
2024-03-31 08:35:36 -05:00
2025-06-05 18:56:33 +07:00
- [alireza0 ](https://github.com/alireza0/ )
2024-03-31 08:35:36 -05:00
2025-06-05 18:56:33 +07:00
## Reconocimientos
2024-03-31 08:35:36 -05:00
2025-06-05 18:56:33 +07:00
- [Iran v2ray rules ](https://github.com/chocolate4u/Iran-v2ray-rules ) (Licencia: **GPL-3.0 ** ): _ Reglas de enrutamiento mejoradas para v2ray/xray y v2ray/xray-clients con dominios iraníes incorporados y un enfoque en seguridad y bloqueo de anuncios. _
- [Russia v2ray rules ](https://github.com/runetfreedom/russia-v2ray-rules-dat ) (Licencia: **GPL-3.0 ** ): _ Este repositorio contiene reglas de enrutamiento V2Ray actualizadas automáticamente basadas en datos de dominios y direcciones bloqueadas en Rusia. _
2024-03-31 08:35:36 -05:00
2026-05-14 16:54:52 +03:00
## Herramientas de la Comunidad
Herramientas e integraciones construidas por la comunidad alrededor de 3x-ui.
- [terraform-provider-3x-ui ](https://github.com/batonogov/terraform-provider-threexui ) (Licencia: **MIT ** ): _ Gestiona inbounds, clientes, configuración del panel y configuración de Xray como código con Terraform / OpenTofu. _
2025-06-05 18:56:33 +07:00
## Apoyar el Proyecto
2024-03-31 08:35:36 -05:00
2025-06-05 18:56:33 +07:00
**Si este proyecto te es útil, puedes darle una**:star2:
2024-03-31 08:35:36 -05:00
2025-09-18 20:08:56 +02:00
<a href="https://www.buymeacoffee.com/MHSanaei" target="_blank">
<img src="./media/default-yellow.png" alt="Buy Me A Coffee" style="height: 70px !important;width: 277px !important;" >
</a>
</br>
<a href="https://nowpayments.io/donation/hsanaei" target="_blank" rel="noreferrer noopener">
<img src="./media/donation-button-black.svg" alt="Crypto donation button by NOWPayments">
</a>
2024-03-31 08:35:36 -05:00
2025-06-05 18:56:33 +07:00
## Estrellas a lo Largo del Tiempo
2024-03-31 08:35:36 -05:00
2026-04-21 20:20:43 +02:00
[](https://starchart.cc/MHSanaei/3x-ui)