Xray panel supporting multi-protocol multi-user expire day & traffic & ip limit (Vmess & Vless & Trojan & ShadowSocks & Wireguard)
Find a file
カン 545f5a3672 fix(database): prevent "database is locked" with WAL mode and single connection pool
SQLite's default DELETE journal mode combined with an unbounded GORM
connection pool allows multiple goroutines (XrayTrafficJob every 10s,
PeriodicResetJob hourly/daily, WebSocket tickers) to each obtain their
own connection and race for the write lock. When a long-running
transaction holds the lock longer than go-sqlite3's busy_timeout the
competing writer fails with "database is locked" (issue #3739).

Two changes to InitDB:
- Enable WAL journal mode (_journal_mode=WAL, _synchronous=NORMAL):
  readers no longer block writers, reducing the write-lock window.
  Restores the fix from PR #2645 that was accidentally reverted in
  the "revert group management" commit (d18a1a37).
- SetMaxOpenConns(1): serialises all GORM access through a single
  connection at the Go pool level so SQLite write-lock contention
  cannot occur regardless of transaction duration.

Add database/concurrent_test.go with two test functions:
- TestConcurrentWrites: behavioural proof — reproduces the root cause
  (two connections + short busy_timeout → "database is locked"), then
  proves SetMaxOpenConns(1) eliminates it by serialising at pool level.
- TestInitDBConcurrencyConfig: verifies InitDB applies both settings,
  completing the chain of proof that the production code path is fixed.

Closes #3739

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-29 15:41:30 +09:00
.github Bump Xray release to v26.4.25 2026-04-26 20:45:00 +02:00
.vscode DevTools 2025-10-02 01:47:12 +02:00
config v2.9.3 2026-04-27 15:31:32 +02:00
database fix(database): prevent "database is locked" with WAL mode and single connection pool 2026-04-29 15:41:30 +09:00
logger feat: add file logger support (#3575) 2025-10-09 17:39:29 +02:00
media donate: nowpayments 2025-09-18 20:14:10 +02:00
sub Minor changes 2026-04-27 15:02:43 +02:00
util fix windows build 2026-02-20 02:07:46 +01:00
web translate update 2026-04-28 19:17:11 +02:00
windows_files Update OpenSSL installer to version 3.6.0 2026-01-05 18:49:30 +01:00
xray SS: remove unsupported cipher method 2026-04-22 21:44:39 +02:00
.env.example fix: display of outbound traffic (#3604) 2025-12-23 15:43:25 +01:00
.gitignore Moved DB to same app folder on Windows (#3340) 2025-08-13 23:19:59 +02:00
CONTRIBUTING.md fix: display of outbound traffic (#3604) 2025-12-23 15:43:25 +01:00
docker-compose.yml fix: enhance WebSocket stability, resolve XHTTP configurations and fix UI loading shifts (#3997) 2026-04-19 21:01:00 +02:00
DockerEntrypoint.sh chore: X_UI_ENABLE_FAIL2BAN -> XUI_ENABLE_FAIL2BAN (#3030) 2025-05-22 08:21:23 +02:00
Dockerfile Bump Go to 1.26 2026-02-16 01:10:43 +01:00
DockerInit.sh Bump Xray release to v26.4.25 2026-04-26 20:45:00 +02:00
go.mod Bump Xray release to v26.4.25 2026-04-26 20:45:00 +02:00
go.sum Bump Xray release to v26.4.25 2026-04-26 20:45:00 +02:00
install.sh fix: enhance WebSocket stability, resolve XHTTP configurations and fix UI loading shifts (#3997) 2026-04-19 21:01:00 +02:00
LICENSE 3x-ui 2023-02-09 22:48:06 +03:30
main.go v2.9.3 2026-04-27 15:31:32 +02:00
README.ar_EG.md Readme: Remove custom GeoSite/GeoIP DAT section 2026-04-21 20:20:43 +02:00
README.es_ES.md Readme: Remove custom GeoSite/GeoIP DAT section 2026-04-21 20:20:43 +02:00
README.fa_IR.md Readme: Remove custom GeoSite/GeoIP DAT section 2026-04-21 20:20:43 +02:00
README.md Readme: Remove custom GeoSite/GeoIP DAT section 2026-04-21 20:20:43 +02:00
README.ru_RU.md Readme: Remove custom GeoSite/GeoIP DAT section 2026-04-21 20:20:43 +02:00
README.zh_CN.md Readme: Remove custom GeoSite/GeoIP DAT section 2026-04-21 20:20:43 +02:00
update.sh fix: enhance WebSocket stability, resolve XHTTP configurations and fix UI loading shifts (#3997) 2026-04-19 21:01:00 +02:00
x-ui.rc [feat] restart xray-core from cli #3825 2026-02-20 00:03:16 +01:00
x-ui.service.arch [feat] restart xray-core from cli #3825 2026-02-20 00:03:16 +01:00
x-ui.service.debian [feat] restart xray-core from cli #3825 2026-02-20 00:03:16 +01:00
x-ui.service.rhel [feat] restart xray-core from cli #3825 2026-02-20 00:03:16 +01:00
x-ui.sh x-ui.sh: install nftables alongside fail2ban in install_iplimit 2026-04-22 18:50:42 +03:00

English | فارسی | العربية | 中文 | Español | Русский

3x-ui

Release Build GO Version Downloads License Go Reference Go Report Card

3X-UI — advanced, open-source web-based control panel designed for managing Xray-core server. It offers a user-friendly interface for configuring and monitoring various VPN and proxy protocols.

Important

This project is only for personal usage, please do not use it for illegal purposes, and please do not use it in a production environment.

As an enhanced fork of the original X-UI project, 3X-UI provides improved stability, broader protocol support, and additional features.

Quick Start

bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)

For full documentation, please visit the project Wiki.

A Special Thanks to

Acknowledgment

  • Iran v2ray rules (License: GPL-3.0): Enhanced v2ray/xray and v2ray/xray-clients routing rules with built-in Iranian domains and a focus on security and adblocking.
  • Russia v2ray rules (License: GPL-3.0): This repository contains automatically updated V2Ray routing rules based on data on blocked domains and addresses in Russia.

Support project

If this project is helpful to you, you may wish to give it a🌟

Buy Me A Coffee
Crypto donation button by NOWPayments

Stargazers over Time

Stargazers over time