Update README.es_ES.md

This commit is contained in:
itboyhan1 2025-05-28 21:22:13 +08:00 committed by GitHub
parent 4a649a1b97
commit eae6539702
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -7,7 +7,7 @@
</picture> </picture>
</p> </p>
**یک پنل وب پیشرفته • ساخته شده بر پایه Xray Core** **Un Panel Web Avanzado • Construido sobre Xray Core**
[![](https://img.shields.io/github/v/release/itboyhan1/3x-ui-xdsb.svg)](https://github.com/itboyhan1/3x-ui-xdsb/releases) [![](https://img.shields.io/github/v/release/itboyhan1/3x-ui-xdsb.svg)](https://github.com/itboyhan1/3x-ui-xdsb/releases)
[![](https://img.shields.io/github/actions/workflow/status/itboyhan1/3x-ui-xdsb/release.yml.svg)](#) [![](https://img.shields.io/github/actions/workflow/status/itboyhan1/3x-ui-xdsb/release.yml.svg)](#)
@ -15,9 +15,9 @@
[![Downloads](https://img.shields.io/github/downloads/itboyhan1/3x-ui-xdsb/total.svg)](#) [![Downloads](https://img.shields.io/github/downloads/itboyhan1/3x-ui-xdsb/total.svg)](#)
[![License](https://img.shields.io/badge/license-GPL%20V3-blue.svg?longCache=true)](https://www.gnu.org/licenses/gpl-3.0.en.html) [![License](https://img.shields.io/badge/license-GPL%20V3-blue.svg?longCache=true)](https://www.gnu.org/licenses/gpl-3.0.en.html)
> **سلب مسئولیت:** این پروژه صرفاً برای اهداف آموزشی و تحقیقاتی است. استفاده از آن برای مقاصد غیرقانونی یا در محیط‌های عملیاتی ممنوع است. > **Descargo de responsabilidad:** Este proyecto es solo para aprendizaje personal y comunicación, por favor no lo uses con fines ilegales, por favor no lo uses en un entorno de producción
**اگر این پروژه برای شما مفید بوده، می‌توانید با دادن یک**:star2: از آن حمایت کنید. **Si este proyecto te es útil, podrías considerar darle una**:star2:
<p align="left"> <p align="left">
<a href="https://buymeacoffee.com/mhsanaei" target="_blank"> <a href="https://buymeacoffee.com/mhsanaei" target="_blank">
@ -29,42 +29,42 @@
- MATIC (polygon): `0x41C9548675D044c6Bfb425786C765bc37427256A` - MATIC (polygon): `0x41C9548675D044c6Bfb425786C765bc37427256A`
- LTC (Litecoin): `ltc1q2ach7x6d2zq0n4l0t4zl7d7xe2s6fs7a3vspwv` - LTC (Litecoin): `ltc1q2ach7x6d2zq0n4l0t4zl7d7xe2s6fs7a3vspwv`
## نصب و ارتقا ## Instalar y Actualizar
``` ```
bash <(curl -Ls https://raw.githubusercontent.com/itboyhan1/3x-ui-xdsb/refs/tags/v2.6.0/install.sh) bash <(curl -Ls https://raw.githubusercontent.com/itboyhan1/3x-ui-xdsb/refs/tags/v2.6.0/install.sh)
``` ```
## نصب نسخه‌های قدیمی (توصیه نمی‌شود) ## Instalar versión antigua (no recomendamos)
برای نصب نسخه خاصی از دستور زیر استفاده کنید. مثال برای نسخه `v1.7.9`: Para instalar la versión deseada, utiliza el siguiente comando de instalación. Por ejemplo, ver `v1.7.9`:
``` ```
VERSION=v1.7.9 && bash <(curl -Ls "https://raw.githubusercontent.com/itboyhan1/3x-ui-xdsb/$VERSION/install.sh") $VERSION VERSION=v1.7.9 && bash <(curl -Ls "https://raw.githubusercontent.com/itboyhan1/3x-ui-xdsb/$VERSION/install.sh") $VERSION
``` ```
## گواهی SSL ## Certificado SSL
<details> <details>
<summary>جزئیات گواهی SSL</summary> <summary>Haga clic para ver los detalles del certificado SSL</summary>
### ACME ### ACME
برای مدیریت گواهی‌های SSL با استفاده از ACME: Para gestionar certificados SSL utilizando ACME:
1. اطمینان حاصل کنید دامنه شما به درستی به سرور متصل است. 1. Asegúrate de que tu dominio esté correctamente resuelto al servidor.
2. دستور `x-ui` را در ترمینال اجرا کرده و گزینه `مدیریت گواهی SSL` را انتخاب کنید. 2. Ejecuta el comando `x-ui` en la terminal y elige `Gestión de Certificados SSL`.
3. گزینه‌های زیر نمایش داده می‌شوند: 3. Se te presentarán las siguientes opciones:
- **دریافت SSL:** دریافت گواهی SSL - **Get SSL:** Obtener certificados SSL.
- **لغو:** لغو گواهی‌های موجود - **Revoke:** Revocar certificados SSL existentes.
- **تمدید اجباری:** تمدید اجباری گواهی‌ها - **Force Renew:** Forzar la renovación de certificados SSL.
- **نمایش دامنه‌های موجود:** نمایش تمام دامنه‌های دارای گواهی - **Show Existing Domains:** Mostrar todos los certificados de dominio disponibles en el servidor.
- **تنظیم مسیر گواهی برای پنل:** تنظیم مسیر گواهی برای دامنه شما - **Set Certificate Paths for the Panel:** Especificar el certificado para tu dominio que será utilizado por el panel.
### Certbot ### Certbot
نصب و استفاده از Certbot: Para instalar y usar Certbot:
```sh ```sh
apt-get install certbot -y apt-get install certbot -y
@ -74,34 +74,34 @@ certbot renew --dry-run
### Cloudflare ### Cloudflare
اسکریپت داخلی برای دریافت گواهی SSL از Cloudflare. نیازمند: El script de gestión incluye una aplicación de certificado SSL integrada para Cloudflare. Para usar este script para solicitar un certificado, necesitas lo siguiente:
- ایمیل ثبت‌شده در Cloudflare - Correo electrónico registrado en Cloudflare
- کلید API جهانی Cloudflare - Clave API Global de Cloudflare
- دامنه باید از طریق Cloudflare به سرور متصل باشد - El nombre de dominio debe estar resuelto al servidor actual a través de Cloudflare
**دریافت کلید API جهانی Cloudflare:** **Cómo obtener la Clave API Global de Cloudflare:**
1. دستور `x-ui` را اجرا و گزینه `گواهی SSL کلادفلر` را انتخاب کنید. 1. Ejecuta el comando `x-ui` en la terminal y elige `Certificado SSL de Cloudflare`.
2. به لینک [Cloudflare API Tokens](https://dash.cloudflare.com/profile/api-tokens) مراجعه کنید. 2. Visita el enlace: [Tokens de API de Cloudflare](https://dash.cloudflare.com/profile/api-tokens).
3. روی "View Global API Key" کلیک کنید: 3. Haz clic en "Ver Clave API Global" (consulta la captura de pantalla a continuación):
![](media/APIKey1.PNG) ![](media/APIKey1.PNG)
4. پس از احراز هویت، کلید API نمایش داده می‌شود: 4. Es posible que necesites volver a autenticar tu cuenta. Después de eso, se mostrará la Clave API (consulta la captura de pantalla a continuación):
![](media/APIKey2.png) ![](media/APIKey2.png)
در هنگام استفاده، نام دامنه، ایمیل و کلید API را وارد کنید: Al utilizarlo, simplemente ingresa tu `nombre de dominio`, `correo electrónico` y `CLAVE API`. El diagrama es el siguiente:
![](media/DetailEnter.png) ![](media/DetailEnter.png)
</details> </details>
## نصب دستی و ارتقا ## Instalación y Actualización Manual
<details> <details>
<summary>جزئیات نصب دستی</summary> <summary>Haz clic para más detalles de la instalación manual</summary>
#### استفاده #### Uso
1. دریافت آخرین نسخه از سرور: 1. Para descargar la última versión del paquete comprimido directamente en tu servidor, ejecuta el siguiente comando:
```sh ```sh
ARCH=$(uname -m) ARCH=$(uname -m)
@ -112,14 +112,14 @@ case "${ARCH}" in
armv7* | armv7) XUI_ARCH="armv7" ;; armv7* | armv7) XUI_ARCH="armv7" ;;
armv6* | armv6) XUI_ARCH="armv6" ;; armv6* | armv6) XUI_ARCH="armv6" ;;
armv5* | armv5) XUI_ARCH="armv5" ;; armv5* | armv5) XUI_ARCH="armv5" ;;
s390x) echo 's390x' ;;
*) XUI_ARCH="amd64" ;; *) XUI_ARCH="amd64" ;;
esac esac
wget https://github.com/itboyhan1/3x-ui-xdsb/releases/latest/download/x-ui-linux-${XUI_ARCH}.tar.gz wget https://github.com/itboyhan1/3x-ui-xdsb/releases/latest/download/x-ui-linux-${XUI_ARCH}.tar.gz
``` ```
2. نصب یا ارتقا: 2. Una vez que se haya descargado el paquete comprimido, ejecuta los siguientes comandos para instalar o actualizar x-ui:
```sh ```sh
ARCH=$(uname -m) ARCH=$(uname -m)
@ -130,7 +130,6 @@ case "${ARCH}" in
armv7* | armv7) XUI_ARCH="armv7" ;; armv7* | armv7) XUI_ARCH="armv7" ;;
armv6* | armv6) XUI_ARCH="armv6" ;; armv6* | armv6) XUI_ARCH="armv6" ;;
armv5* | armv5) XUI_ARCH="armv5" ;; armv5* | armv5) XUI_ARCH="armv5" ;;
s390x) echo 's390x' ;;
*) XUI_ARCH="amd64" ;; *) XUI_ARCH="amd64" ;;
esac esac
@ -148,33 +147,33 @@ systemctl restart x-ui
</details> </details>
## نصب با Docker ## Instalar con Docker
<details> <details>
<summary>جزئیات Docker</summary> <summary>Haz clic para más detalles del Docker</summary>
#### استفاده #### Uso
1. **نصب Docker:** 1. Instala Docker:
```sh ```sh
bash <(curl -sSL https://get.docker.com) bash <(curl -sSL https://get.docker.com)
``` ```
2. **کلون پروژه:** 2. Clona el Repositorio del Proyecto:
```sh ```sh
git clone https://github.com/itboyhan1/3x-ui-xdsb.git git clone https://github.com/itboyhan1/3x-ui-xdsb.git
cd 3x-ui cd 3x-ui
``` ```
3. **راه‌اندازی سرویس:** 3. Inicia el Servicio
```sh ```sh
docker compose up -d docker compose up -d
``` ```
یا O tambien
```sh ```sh
docker run -itd \ docker run -itd \
@ -187,31 +186,31 @@ systemctl restart x-ui
ghcr.io/itboyhan1/3x-ui-xdsb:latest ghcr.io/itboyhan1/3x-ui-xdsb:latest
``` ```
4. **به‌روزرسانی:** actualizar a la última versión
```sh ```sh
cd 3x-ui cd 3x-ui
docker compose down docker compose down
docker compose pull 3x-ui docker compose pull 3x-ui
docker compose up -d docker compose up -d
``` ```
5. **حذف:** eliminar 3x-ui de docker
```sh ```sh
docker stop 3x-ui docker stop 3x-ui
docker rm 3x-ui docker rm 3x-ui
cd -- cd --
rm -r 3x-ui rm -r 3x-ui
``` ```
</details> </details>
## تنظیمات Nginx ## Configuración de Nginx
<details> <details>
<summary>پیکربندی Reverse Proxy</summary> <summary>Haga clic aquí para configurar el proxy inverso</summary>
#### Nginx Reverse Proxy #### Proxy inverso Nginx
```nginx ```nginx
location / { location / {
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
@ -225,9 +224,9 @@ location / {
} }
``` ```
#### مسیر فرعی در Nginx #### Nginx sub-path
- اطمینان حاصل کنید "URI Path" در تنظیمات پنل یکسان باشد. - EAsegúrese de que la "Ruta Raíz de la URL del Panel" en la configuración del panel `/sub` es la misma.
- `url` در تنظیمات پنل باید با `/` پایان یابد. - El `url` en la configuración del panel debe terminar con `/`.
```nginx ```nginx
location /sub { location /sub {
@ -243,7 +242,7 @@ location /sub {
``` ```
</details> </details>
## سیستم‌عامل‌های توصیه شده ## SO Recomendados
- Ubuntu 22.04+ - Ubuntu 22.04+
- Debian 12+ - Debian 12+
@ -262,136 +261,147 @@ location /sub {
- Virtuozzo Linux 8+ - Virtuozzo Linux 8+
- Windows x64 - Windows x64
## معماری‌ها و دستگاه‌های پشتیبانی شده ## Arquitecturas y Dispositivos Compatibles
<details> <details>
<summary>جزئیات معماری‌ها و دستگاه‌ها</summary> <summary>Haz clic para detalles de arquitecturas y dispositivos compatibles</summary>
- **amd64**: معماری استاندارد برای کامپیوترهای شخصی و سرورها Nuestra plataforma ofrece compatibilidad con una amplia gama de arquitecturas y dispositivos, garantizando flexibilidad en diversos entornos informáticos. A continuación se presentan las principales arquitecturas que admitimos:
- **x86 / i386**: سیستم‌های دسکتاپ و لپ‌تاپ
- **armv8 / arm64 / aarch64**: دستگاه‌های موبایل و embedded مانند Raspberry Pi 4 - **amd64**: Esta arquitectura predominante es la estándar para computadoras personales y servidores, y admite la mayoría de los sistemas operativos modernos sin problemas.
- **armv7 / arm / arm32**: دستگاه‌های قدیمی مانند Orange Pi Zero
- **armv6 / arm / arm32**: دستگاه‌های بسیار قدیمی مانند Raspberry Pi 1 - **x86 / i386**: Ampliamente adoptada en computadoras de escritorio y portátiles, esta arquitectura cuenta con un amplio soporte de numerosos sistemas operativos y aplicaciones, incluidos, entre otros, Windows, macOS y sistemas Linux.
- **armv5 / arm / arm32**: سیستم‌های embedded قدیمی
- **s390x**: کامپیوترهای IBM mainframe - **armv8 / arm64 / aarch64**: Diseñada para dispositivos móviles y embebidos contemporáneos, como teléfonos inteligentes y tabletas, esta arquitectura está ejemplificada por dispositivos como Raspberry Pi 4, Raspberry Pi 3, Raspberry Pi Zero 2/Zero 2 W, Orange Pi 3 LTS, entre otros.
- **armv7 / arm / arm32**: Sirve como arquitectura para dispositivos móviles y embebidos más antiguos, y sigue siendo ampliamente utilizada en dispositivos como Orange Pi Zero LTS, Orange Pi PC Plus, Raspberry Pi 2, entre otros.
- **armv6 / arm / arm32**: Orientada a dispositivos embebidos muy antiguos, esta arquitectura, aunque menos común, todavía se utiliza. Dispositivos como Raspberry Pi 1, Raspberry Pi Zero/Zero W, dependen de esta arquitectura.
- **armv5 / arm / arm32**: Una arquitectura más antigua asociada principalmente con sistemas embebidos tempranos, es menos común hoy en día pero aún puede encontrarse en dispositivos heredados como versiones antiguas de Raspberry Pi y algunos teléfonos inteligentes más antiguos.
</details> </details>
## زبان‌های پشتیبانی شده ## Idiomas
- انگلیسی - Arabic (Árabe)
- فارسی - English (inglés)
- چینی سنتی - Persian (persa)
- چینی ساده‌شده - Traditional Chinese (chino tradicional)
- ژاپنی - Simplified Chinese (chino simplificado)
- روسی - Japanese (japonés)
- ویتنامی - Russian (ruso)
- اسپانیایی - Vietnamese (vietnamita)
- اندونزیایی - Spanish (español)
- اوکراینی - Indonesian (indonesio)
- ترکی - Ukrainian (ucraniano)
- پرتغالی (برزیل) - Turkish (turco)
- Português (Brazil) (portugués (Brasil))
## ویژگی‌ها
- مانیتورینگ وضعیت سیستم ## Características
- جستجو در بین inboundها و کلاینت‌ها
- تم تاریک/روشن
- پشتیبانی از چند کاربر و پروتکل
- پروتکل‌های VMESS، VLESS، Trojan، Shadowsocks، Dokodemo-door، Socks، HTTP، WireGuard
- پشتیبانی از XTLS شامل RPRX-Direct، Vision، REALITY
- آمار ترافیک، محدودیت ترافیک، محدودیت زمانی
- تنظیمات سفارشی Xray
- پشتیبانی از HTTPS برای پنل
- دریافت خودکار گواهی SSL
- مسیرهای API اصلاح شده
- پشتیبانی از تغییر تنظیمات از طریق پنل
- امکان export/import دیتابیس
## تنظیمات پیش‌فرض پنل - Monitoreo del Estado del Sistema
- Búsqueda dentro de todas las reglas de entrada y clientes
- Tema Oscuro/Claro
- Soporta multiusuario y multiprotocolo
- Soporta protocolos, incluyendo VMess, VLESS, Trojan, Shadowsocks, Dokodemo-door, Socks, HTTP, wireguard
- Soporta Protocolos nativos XTLS, incluyendo RPRX-Direct, Visión, REALITY
- Estadísticas de tráfico, límite de tráfico, límite de tiempo de vencimiento
- Plantillas de configuración de Xray personalizables
- Soporta acceso HTTPS al panel (dominio proporcionado por uno mismo + certificado SSL)
- Soporta la solicitud y renovación automática de certificados SSL con un clic
- Para elementos de configuración más avanzados, consulta el panel
- Corrige rutas de API (la configuración del usuario se creará con la API)
- Soporta cambiar las configuraciones por diferentes elementos proporcionados en el panel.
- Soporta exportar/importar base de datos desde el panel
## Configuración Predeterminada del Panel
<details> <details>
<summary>جزئیات تنظیمات پیش‌فرض</summary> <summary>Haz clic para ver los detalles de la configuración predeterminada</summary>
### نام کاربری، رمز عبور، پورت و مسیر وب ### Nombre de usuario, Contraseña, Puerto y Ruta Base Web
در صورت عدم تغییر، این موارد به صورت تصادفی ایجاد می‌شوند (به جز Docker). Si elige no modificar estas configuraciones, se generarán aleatoriamente (esto no se aplica a Docker).
**تنظیمات پیش‌فرض Docker:** **Configuraciones predeterminadas para Docker:**
- **نام کاربری:** admin - **Nombre de usuario:** admin
- **رمز عبور:** admin - **Contraseña:** admin
- **پورت:** 2053 - **Puerto:** 2053
### مدیریت دیتابیس: ### Gestión de la Base de Datos:
امکان Backup و Restore دیتابیس از طریق پنل. Puedes realizar copias de seguridad y restauraciones de la base de datos directamente desde el panel.
- **مسیر دیتابیس:** - **Ruta de la Base de Datos:**
- `/etc/x-ui/x-ui.db` - `/etc/x-ui/x-ui.db`
### مسیر پایه وب ### Ruta Base Web
1. **بازنشانی مسیر:** 1. **Restablecer la Ruta Base Web:**
- اجرای دستور `x-ui` - Abre tu terminal.
- انتخاب گزینه `Reset Web Base Path` - Ejecuta el comando `x-ui`.
- Selecciona la opción `Restablecer la Ruta Base Web`.
2. **ساخت یا تنظیم مسیر:** 2. **Generar o Personalizar la Ruta:**
- مسیر به صورت تصادفی ساخته شده یا قابل تنظیم است - La ruta se generará aleatoriamente, o puedes ingresar una ruta personalizada.
3. **مشاهده تنظیمات فعلی:** 3. **Ver Configuración Actual:**
- استفاده از دستور `x-ui settings` یا `View Current Settings` در `x-ui` - Para ver tu configuración actual, utiliza el comando `x-ui settings` en el terminal o selecciona `Ver Configuración Actual` en `x-ui`.
**توصیه امنیتی:** ### Recomendación de Seguridad:
- استفاده از مسیرهای طولانی و تصادفی برای افزایش امنیت - Para mayor seguridad, utiliza una palabra larga y aleatoria en la estructura de tu URL.
**مثال:** **Ejemplos:**
- `http://ip:port/*webbasepath*/panel` - `http://ip:port/*webbasepath*/panel`
- `http://domain:port/*webbasepath*/panel` - `http://domain:port/*webbasepath*/panel`
</details> </details>
## پیکربندی WARP ## Configuración de WARP
<details> <details>
<summary>جزئیات WARP</summary> <summary>Haz clic para ver los detalles de la configuración de WARP</summary>
#### استفاده #### Uso
**برای نسخه‌های `v2.1.0` و جدیدتر:** **Para versiones `v2.1.0` y posteriores:**
WARP به صورت داخلی پشتیبانی می‌شود. تنها نیاز به فعال‌سازی در پنل است. WARP está integrado, no se requiere instalación adicional. Simplemente habilita la configuración necesaria en el panel.
</details> </details>
## محدودیت IP ## Límite de IP
<details> <details>
<summary>جزئیات محدودیت IP</summary> <summary>Haz clic para ver los detalles del límite de IP</summary>
#### استفاده #### Uso
**توجه:** محدودیت IP در صورت استفاده از IP Tunnel کار نمی‌کند. **Nota:** El Límite de IP no funcionará correctamente cuando uses Túnel IP.
- **تا نسخه `v1.6.1`:** - **Para versiones hasta `v1.6.1`:**
- محدودیت IP به صورت داخلی در پنل وجود دارد - El límite de IP está integrado en el panel.
**برای نسخه‌های `v1.7.0` و جدیدتر:** **Para versiones `v1.7.0` y posteriores:**
برای فعال‌سازی نیاز به نصب `fail2ban` است: Para habilitar la funcionalidad de límite de IP, necesitas instalar `fail2ban` y los archivos requeridos siguiendo estos pasos:
1. اجرای دستور `x-ui` و انتخاب `مدیریت محدودیت IP` 1. Ejecuta el comando `x-ui` en el terminal, luego elige `Gestión de Límite de IP`.
2. گزینه‌های موجود: 2. Verás las siguientes opciones:
- **تغییر مدت زمان Ban** - **Cambiar la Duración del Bloqueo:** Ajustar la duración de los bloqueos.
- **حذف تمام Banها** - **Desbloquear a Todos:** Levantar todos los bloqueos actuales.
- **مشاهده لاگ‌ها** - **Revisar los Registros:** Revisar los registros.
- **وضعیت Fail2ban** - **Estado de Fail2ban:** Verificar el estado de `fail2ban`.
- **راه‌اندازی مجدد Fail2ban** - **Reiniciar Fail2ban:** Reiniciar el servicio `fail2ban`.
- **حذف Fail2ban** - **Desinstalar Fail2ban:** Desinstalar Fail2ban con la configuración.
3. تنظیم مسیر `Access log` در پنل به `./access.log` و ذخیره و راه‌اندازی مجدد Xray 3. Agrega una ruta para el registro de acceso en el panel configurando `Xray Configs/log/Access log` a `./access.log`, luego guarda y reinicia Xray.
- **قبل از نسخه `v2.1.3`:** - **Para versiones anteriores a `v2.1.3`:**
- تنظیم دستی `access.log` در تنظیمات Xray: - Necesitas configurar manualmente la ruta del registro de acceso en tu configuración de Xray:
```sh ```sh
"log": { "log": {
@ -401,101 +411,132 @@ WARP به صورت داخلی پشتیبانی می‌شود. تنها نیاز
}, },
``` ```
- **از نسخه `v2.1.3`:** - **Para versiones `v2.1.3` y posteriores:**
- امکان تنظیم `access.log` از طریق پنل - Hay una opción para configurar `access.log` directamente desde el panel.
</details> </details>
## ربات تلگرام ## Bot de Telegram
<details> <details>
<summary>جزئیات ربات تلگرام</summary> <summary>Haz clic para más detalles del bot de Telegram</summary>
#### استفاده #### Uso
ربات تلگرام برای اطلاع‌رسانی ترافیک، ورود به پنل، Backup دیتابیس و ... استفاده می‌شود. نیازمند تنظیم: El panel web admite tráfico diario, inicio de sesión en el panel, copia de seguridad de la base de datos, estado del sistema, información del cliente y otras notificaciones y funciones a través del Bot de Telegram. Para usar el bot, debes establecer los parámetros relacionados con el bot en el panel, que incluyen:
- توکن تلگرام - Token de Telegram
- Chat ID ادمین‌ها - ID de chat de administrador(es)
- زمان اطلاع‌رسانی (Cron syntax) - Hora de Notificación (en sintaxis cron)
- اطلاع‌رسانی انقضا - Notificación de Fecha de Caducidad
- اطلاع‌رسانی ترافیک - Notificación de Capacidad de Tráfico
- Backup دیتابیس - Copia de seguridad de la base de datos
- اطلاع‌رسانی مصرف CPU - Notificación de Carga de CPU
**سینتکس نمونه:**
- `30 \* \* \* \* \*` - اطلاع در ثانیه 30 هر دقیقه **Sintaxis de referencia:**
- `@hourly` - هر ساعت
- `@daily` - هر روز
### ویژگی‌های ربات - `30 \* \* \* \* \*` - Notifica a los 30s de cada punto
- `0 \*/10 \* \* \* \*` - Notifica en el primer segundo de cada 10 minutos
- `@hourly` - Notificación por hora
- `@daily` - Notificación diaria (00:00 de la mañana)
- `@weekly` - Notificación semanal
- `@every 8h` - Notifica cada 8 horas
- گزارش دوره‌ای ### Funcionalidades del Bot de Telegram
- اطلاع ورود به پنل
- اطلاع مصرف CPU
- اطلاع پیش‌از موعد انقضا و ترافیک
- گزارش ترافیک کلاینت‌ها
- منوی مبتنی بر دستور
- جستجوی کلاینت بر اساس ایمیل
- بررسی inboundها
- بررسی وضعیت سرور
- دریافت Backup
- چندزبانه
### راه‌اندازی ربات - Reporte periódico
- Notificación de inicio de sesión
- Notificación de umbral de CPU
- Umbral de Notificación para Fecha de Caducidad y Tráfico para informar con anticipación
- Soporte para menú de reporte de cliente si el nombre de usuario de Telegram del cliente se agrega a las configuraciones de usuario
- Soporte para reporte de tráfico de Telegram buscado con UUID (VMESS/VLESS) o Contraseña (TROJAN) - anónimamente
- Bot basado en menú
- Buscar cliente por correo electrónico (solo administrador)
- Ver todas las Entradas
- Ver estado del servidor
- Ver clientes agotados
- Recibir copia de seguridad bajo demanda y en informes periódicos
- Bot multilingüe
- شروع [Botfather](https://t.me/BotFather) در تلگرام: ### Configuración del Bot de Telegram
- Inicia [Botfather](https://t.me/BotFather) en tu cuenta de Telegram:
![Botfather](./media/botfather.png) ![Botfather](./media/botfather.png)
- ساخت ربات جدید با دستور /newbot: - Crea un nuevo bot usando el comando /newbot: Te hará 2 preguntas, Un nombre y un nombre de usuario para tu bot. Ten en cuenta que el nombre de usuario debe terminar con la palabra "bot".
![Create new bot](./media/newbot.png) ![Create new bot](./media/newbot.png)
- شروع ربات ساخته شده: - Inicia el bot que acabas de crear. Puedes encontrar el enlace a tu bot aquí.
![token](./media/token.png) ![token](./media/token.png)
- تنظیمات پنل: - Ingresa a tu panel y configura los ajustes del bot de Telegram como se muestra a continuación:
![Panel Config](./media/panel-bot-config.png) ![Panel Config](./media/panel-bot-config.png)
وارد کردن توکن و Chat ID (دریافت از [این ربات](https://t.me/useridinfobot)): Ingresa el token de tu bot en el campo de entrada número 3.
Ingresa el ID de chat de usuario en el campo de entrada número 4. Las cuentas de Telegram con esta ID serán los administradores del bot. (Puedes ingresar más de uno, solo sepáralos con ,)
- ¿Cómo obtener el ID de chat de Telegram? Usa este [bot](https://t.me/useridinfobot), Inicia el bot y te dará el ID de chat del usuario de Telegram.
![User ID](./media/user-id.png) ![User ID](./media/user-id.png)
</details> </details>
## مسیرهای API ## Rutas de API
<details> <details>
<summary>جزئیات API</summary> <summary>Haz clic para más detalles de las rutas de API</summary>
#### استفاده #### Uso
- [مستندات API](https://www.postman.com/hsanaei/3x-ui/collection/q1l5l0u/3x-ui) - [Documentación de API](https://www.postman.com/hsanaei/3x-ui/collection/q1l5l0u/3x-ui)
- `/login` با `POST` داده کاربر: `{username: '', password: ''}` - `/login` con `POST` datos de usuario: `{username: '', password: ''}` para iniciar sesión
- `/panel/api/inbounds` base para las siguientes acciones:
| Method | مسیر | عملکرد | | Método | Ruta | Acción |
| :----: | ---------------------------------- | ------------------------------------------- | | :----: | ---------------------------------- | --------------------------------------------------------- |
| `GET` | `"/list"` | دریافت تمام inboundها | | `GET` | `"/list"` | Obtener todas los Entradas |
| `GET` | `"/get/:id"` | دریافت inbound بر اساس id | | `GET` | `"/get/:id"` | Obtener Entrada con inbound.id |
| `POST` | `"/add"` | افزودن inbound | | `GET` | `"/getClientTraffics/:email"` | Obtener Tráficos del Cliente con email |
| `POST` | `"/del/:id"` | حذف inbound | | `GET` | `"/createbackup"` | El bot de Telegram envía copia de seguridad a los admins |
| `POST` | `"/add"` | Agregar Entrada |
| `POST` | `"/del/:id"` | Eliminar Entrada |
| `POST` | `"/update/:id"` | Actualizar Entrada |
| `POST` | `"/clientIps/:email"` | Dirección IP del Cliente |
| `POST` | `"/clearClientIps/:email"` | Borrar Dirección IP del Cliente |
| `POST` | `"/addClient"` | Agregar Cliente a la Entrada |
| `POST` | `"/:id/delClient/:clientId"` | Eliminar Cliente por clientId\* |
| `POST` | `"/updateClient/:clientId"` | Actualizar Cliente por clientId\* |
| `POST` | `"/:id/resetClientTraffic/:email"` | Restablecer Tráfico del Cliente |
| `POST` | `"/resetAllTraffics"` | Restablecer tráfico de todos las Entradas |
| `POST` | `"/resetAllClientTraffics/:id"` | Restablecer tráfico de todos los clientes en una Entrada |
| `POST` | `"/delDepletedClients/:id"` | Eliminar clientes agotados de la entrada (-1: todos) |
| `POST` | `"/onlines"` | Obtener usuarios en línea (lista de correos electrónicos) |
\*- El campo `clientId` debe llenarse por:
- `client.id` para VMESS y VLESS
- `client.password` para TROJAN
- `client.email` para Shadowsocks
- [<img src="https://run.pstmn.io/button.svg" alt="Run In Postman" style="width: 128px; height: 32px;">](https://app.getpostman.com/run-collection/5146551-dda3cab3-0e33-485f-96f9-d4262f437ac5?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D5146551-dda3cab3-0e33-485f-96f9-d4262f437ac5%26entityType%3Dcollection%26workspaceId%3Dd64f609f-485a-4951-9b8f-876b3f917124) - [<img src="https://run.pstmn.io/button.svg" alt="Run In Postman" style="width: 128px; height: 32px;">](https://app.getpostman.com/run-collection/5146551-dda3cab3-0e33-485f-96f9-d4262f437ac5?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D5146551-dda3cab3-0e33-485f-96f9-d4262f437ac5%26entityType%3Dcollection%26workspaceId%3Dd64f609f-485a-4951-9b8f-876b3f917124)
</details> </details>
## متغیرهای محیطی ## Variables de Entorno
<details> <details>
<summary>جزئیات متغیرها</summary> <summary>Haz clic para más detalles de las variables de entorno</summary>
#### استفاده #### Uso
| متغیر | نوع | پیش‌فرض | | Variable | Tipo | Predeterminado |
| ------------- | :--------------------------------------------: | :------------ | | -------------- | :--------------------------------------------: | :------------- |
| XUI_LOG_LEVEL | `"debug"` \| `"info"` \| `"warn"` \| `"error"` | `"info"` | | XUI_LOG_LEVEL | `"debug"` \| `"info"` \| `"warn"` \| `"error"` | `"info"` |
| XUI_DEBUG | `boolean` | `false` | | XUI_DEBUG | `boolean` | `false` |
| XUI_BIN_FOLDER| `string` | `"bin"` | | XUI_BIN_FOLDER | `string` | `"bin"` |
| XUI_DB_FOLDER | `string` | `"/etc/x-ui"` |
| XUI_LOG_FOLDER | `string` | `"/var/log"` |
مثال: Ejemplo:
```sh ```sh
XUI_BIN_FOLDER="bin" XUI_DB_FOLDER="/etc/x-ui" go build main.go XUI_BIN_FOLDER="bin" XUI_DB_FOLDER="/etc/x-ui" go build main.go
@ -503,7 +544,7 @@ XUI_BIN_FOLDER="bin" XUI_DB_FOLDER="/etc/x-ui" go build main.go
</details> </details>
## پیش‌نمایش ## Vista previa
<picture> <picture>
<source media="(prefers-color-scheme: dark)" srcset="./media/01-overview-dark.png"> <source media="(prefers-color-scheme: dark)" srcset="./media/01-overview-dark.png">
@ -513,16 +554,36 @@ XUI_BIN_FOLDER="bin" XUI_DB_FOLDER="/etc/x-ui" go build main.go
<source media="(prefers-color-scheme: dark)" srcset="./media/02-inbounds-dark.png"> <source media="(prefers-color-scheme: dark)" srcset="./media/02-inbounds-dark.png">
<img alt="3x-ui" src="./media/02-inbounds-light.png"> <img alt="3x-ui" src="./media/02-inbounds-light.png">
</picture> </picture>
<picture>
<source media="(prefers-color-scheme: dark)" srcset="./media/03-add-inbound-dark.png">
<img alt="3x-ui" src="./media/03-add-inbound-light.png">
</picture>
<picture>
<source media="(prefers-color-scheme: dark)" srcset="./media/04-add-client-dark.png">
<img alt="3x-ui" src="./media/04-add-client-light.png">
</picture>
<picture>
<source media="(prefers-color-scheme: dark)" srcset="./media/05-settings-dark.png">
<img alt="3x-ui" src="./media/05-settings-light.png">
</picture>
<picture>
<source media="(prefers-color-scheme: dark)" srcset="./media/06-configs-dark.png">
<img alt="3x-ui" src="./media/06-configs-light.png">
</picture>
<picture>
<source media="(prefers-color-scheme: dark)" srcset="./media/07-bot-dark.png">
<img alt="3x-ui" src="./media/07-bot-light.png">
</picture>
## قدردانی ویژه از ## Un agradecimiento especial a
- [alireza0](https://github.com/alireza0/) - [alireza0](https://github.com/alireza0/)
## تشکر و قدردانی ## Reconocimientos
- [Iran v2ray rules](https://github.com/chocolate4u/Iran-v2ray-rules) (مجوز: **GPL-3.0**) - [Iran v2ray rules](https://github.com/chocolate4u/Iran-v2ray-rules) (Licencia: **GPL-3.0**): _Reglas de enrutamiento mejoradas de v2ray/xray y v2ray/xray-clients con dominios iraníes integrados y un enfoque en seguridad y bloqueo de anuncios._
- [Russia v2ray rules](https://github.com/runetfreedom/russia-v2ray-rules-dat) (مجوز: **GPL-3.0**) - [Russia v2ray rules](https://github.com/runetfreedom/russia-v2ray-rules-dat) (License: **GPL-3.0**): _Este repositorio contiene reglas de enrutamiento de V2Ray actualizadas automáticamente basadas en datos de dominios y direcciones bloqueados en Rusia._
## Stargazers over Time ## Estrellas a lo largo del tiempo
[![Stargazers over time](https://starchart.cc/MHSanaei/3x-ui.svg?variant=adaptive)](https://starchart.cc/MHSanaei/3x-ui) [![Stargazers over time](https://starchart.cc/MHSanaei/3x-ui.svg?variant=adaptive)](https://starchart.cc/MHSanaei/3x-ui)