README.fa_IR.md

[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)

<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>

[![Release](https://img.shields.io/github/v/release/mhsanaei/3x-ui.svg)](https://github.com/MHSanaei/3x-ui/releases)
[![Build](https://img.shields.io/github/actions/workflow/status/mhsanaei/3x-ui/release.yml.svg)](https://github.com/MHSanaei/3x-ui/actions)
[![GO Version](https://img.shields.io/github/go-mod/go-version/mhsanaei/3x-ui.svg)](#)
[![Downloads](https://img.shields.io/github/downloads/mhsanaei/3x-ui/total.svg)](https://github.com/MHSanaei/3x-ui/releases/latest)
[![License](https://img.shields.io/badge/license-GPL%20V3-blue.svg?longCache=true)](https://www.gnu.org/licenses/gpl-3.0.en.html)
[![Go Reference](https://pkg.go.dev/badge/github.com/mhsanaei/3x-ui/v3.svg)](https://pkg.go.dev/github.com/mhsanaei/3x-ui/v3)
[![Go Report Card](https://goreportcard.com/badge/github.com/mhsanaei/3x-ui/v3)](https://goreportcard.com/report/github.com/mhsanaei/3x-ui/v3)

**3X-UI** — یک پنل کنترل پیشرفته مبتنی بر وب با کد باز که برای مدیریت سرور Xray-core طراحی شده است. این پنل یک رابط کاربری آسان برای پیکربندی و نظارت بر پروتکل‌های مختلف VPN و پراکسی ارائه می‌دهد.

> [!IMPORTANT]
> این پروژه فقط برای استفاده شخصی و ارتباطات است، لطفاً از آن برای اهداف غیرقانونی استفاده نکنید، لطفاً از آن در محیط تولید استفاده نکنید.

به عنوان یک نسخه بهبود یافته از پروژه اصلی X-UI، 3X-UI پایداری بهتر، پشتیبانی گسترده‌تر از پروتکل‌ها و ویژگی‌های اضافی را ارائه می‌دهد.

## شروع سریع

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

برای مستندات کامل، لطفاً به [ویکی پروژه](https://github.com/MHSanaei/3x-ui/wiki) مراجعه کنید.

## تشکر ویژه از

- [alireza0](https://github.com/alireza0/)

## قدردانی

- [Iran v2ray rules](https://github.com/chocolate4u/Iran-v2ray-rules) (مجوز: **GPL-3.0**): _قوانین مسیریابی بهبود یافته v2ray/xray و v2ray/xray-clients با دامنه‌های ایرانی داخلی و تمرکز بر امنیت و مسدود کردن تبلیغات._
- [Russia v2ray rules](https://github.com/runetfreedom/russia-v2ray-rules-dat) (مجوز: **GPL-3.0**): _این مخزن شامل قوانین مسیریابی V2Ray به‌روزرسانی شده خودکار بر اساس داده‌های دامنه‌ها و آدرس‌های مسدود شده در روسیه است._

## پشتیبانی از پروژه

**اگر این پروژه برای شما مفید است، می‌توانید به آن یک**:star2: بدهید

<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>

## ستاره‌ها در طول زمان

[![Stargazers over time](https://starchart.cc/MHSanaei/3x-ui.svg?variant=adaptive)](https://starchart.cc/MHSanaei/3x-ui)
Readme: Remove custom GeoSite/GeoIP DAT section Remove the "Custom GeoSite / GeoIP DAT" section from the main README and all localized READMEs (ar_EG, es_ES, fa_IR, ru_RU, zh_CN). Also apply minor formatting cleanups: normalize language header spacing and remove trailing spaces from the Stargazers badge lines. 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)`
README: Persian 2025-02-03 20:30:42 +01: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>`

readme: Go Report Card,Go Reference 2025-09-19 10:29:34 +02:00			`[![Release](https://img.shields.io/github/v/release/mhsanaei/3x-ui.svg)](https://github.com/MHSanaei/3x-ui/releases)`
			`[![Build](https://img.shields.io/github/actions/workflow/status/mhsanaei/3x-ui/release.yml.svg)](https://github.com/MHSanaei/3x-ui/actions)`
			`[![GO Version](https://img.shields.io/github/go-mod/go-version/mhsanaei/3x-ui.svg)](#)`
			`[![Downloads](https://img.shields.io/github/downloads/mhsanaei/3x-ui/total.svg)](https://github.com/MHSanaei/3x-ui/releases/latest)`
			`[![License](https://img.shields.io/badge/license-GPL%20V3-blue.svg?longCache=true)](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			`[![Go Reference](https://pkg.go.dev/badge/github.com/mhsanaei/3x-ui/v3.svg)](https://pkg.go.dev/github.com/mhsanaei/3x-ui/v3)`
			`[![Go Report Card](https://goreportcard.com/badge/github.com/mhsanaei/3x-ui/v3)](https://goreportcard.com/report/github.com/mhsanaei/3x-ui/v3)`
README: Persian 2025-02-03 20:30:42 +01:00
chore: clean readme, add link to wiki (#3045) 2025-06-05 18:56:33 +07:00			`3X-UI — یک پنل کنترل پیشرفته مبتنی بر وب با کد باز که برای مدیریت سرور Xray-core طراحی شده است. این پنل یک رابط کاربری آسان برای پیکربندی و نظارت بر پروتکل‌های مختلف VPN و پراکسی ارائه می‌دهد.`
README: Persian 2025-02-03 20:30:42 +01:00
chore: clean readme, add link to wiki (#3045) 2025-06-05 18:56:33 +07:00			`> [!IMPORTANT]`
			`> این پروژه فقط برای استفاده شخصی و ارتباطات است، لطفاً از آن برای اهداف غیرقانونی استفاده نکنید، لطفاً از آن در محیط تولید استفاده نکنید.`
README: Persian 2025-02-03 20:30:42 +01:00
chore: clean readme, add link to wiki (#3045) 2025-06-05 18:56:33 +07:00			`به عنوان یک نسخه بهبود یافته از پروژه اصلی X-UI، 3X-UI پایداری بهتر، پشتیبانی گسترده‌تر از پروتکل‌ها و ویژگی‌های اضافی را ارائه می‌دهد.`
README: Persian 2025-02-03 20:30:42 +01:00
chore: clean readme, add link to wiki (#3045) 2025-06-05 18:56:33 +07:00			`## شروع سریع`
README: Persian 2025-02-03 20:30:42 +01:00
			```
chore: update the installation command (#3069) * install command had an extra $ at the first of the line * install command had an extra $ at the first of the line * install command had an extra $ at the first of the line * install command had an extra $ at the first of the line * install command had an extra $ at the first of the line * install command had an extra $ at the first of the line 2025-06-10 19:17:31 +03:30			`bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)`
README: Persian 2025-02-03 20:30:42 +01:00			```

chore: clean readme, add link to wiki (#3045) 2025-06-05 18:56:33 +07:00			`برای مستندات کامل، لطفاً به [ویکی پروژه](https://github.com/MHSanaei/3x-ui/wiki) مراجعه کنید.`
README: Persian 2025-02-03 20:30:42 +01:00
chore: clean readme, add link to wiki (#3045) 2025-06-05 18:56:33 +07:00			`## تشکر ویژه از`
README: Persian 2025-02-03 20:30:42 +01:00
chore: clean readme, add link to wiki (#3045) 2025-06-05 18:56:33 +07:00			`- [alireza0](https://github.com/alireza0/)`
README: Persian 2025-02-03 20:30:42 +01:00
chore: clean readme, add link to wiki (#3045) 2025-06-05 18:56:33 +07:00			`## قدردانی`
README: Persian 2025-02-03 20:30:42 +01:00
chore: clean readme, add link to wiki (#3045) 2025-06-05 18:56:33 +07:00			`- [Iran v2ray rules](https://github.com/chocolate4u/Iran-v2ray-rules) (مجوز: GPL-3.0): _قوانین مسیریابی بهبود یافته v2ray/xray و v2ray/xray-clients با دامنه‌های ایرانی داخلی و تمرکز بر امنیت و مسدود کردن تبلیغات._`
			`- [Russia v2ray rules](https://github.com/runetfreedom/russia-v2ray-rules-dat) (مجوز: GPL-3.0): _این مخزن شامل قوانین مسیریابی V2Ray به‌روزرسانی شده خودکار بر اساس داده‌های دامنه‌ها و آدرس‌های مسدود شده در روسیه است._`
README: Persian 2025-02-03 20:30:42 +01:00
chore: clean readme, add link to wiki (#3045) 2025-06-05 18:56:33 +07:00			`## پشتیبانی از پروژه`
README: Persian 2025-02-03 20:30:42 +01:00
chore: clean readme, add link to wiki (#3045) 2025-06-05 18:56:33 +07:00			`اگر این پروژه برای شما مفید است، می‌توانید به آن یک:star2: بدهید`
README: Persian 2025-02-03 20:30:42 +01:00
donate: nowpayments 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>`
README: Persian 2025-02-03 20:30:42 +01:00
chore: clean readme, add link to wiki (#3045) 2025-06-05 18:56:33 +07:00			`## ستاره‌ها در طول زمان`
README: Persian 2025-02-03 20:30:42 +01:00
Readme: Remove custom GeoSite/GeoIP DAT section Remove the "Custom GeoSite / GeoIP DAT" section from the main README and all localized READMEs (ar_EG, es_ES, fa_IR, ru_RU, zh_CN). Also apply minor formatting cleanups: normalize language header spacing and remove trailing spaces from the Stargazers badge lines. 2026-04-21 20:20:43 +02:00			`[![Stargazers over time](https://starchart.cc/MHSanaei/3x-ui.svg?variant=adaptive)](https://starchart.cc/MHSanaei/3x-ui)`