From 972514f279aa0dbdf08c79f9146aabbab5db8cf7 Mon Sep 17 00:00:00 2001 From: Kuzz007 Date: Sun, 26 Jul 2026 12:03:43 +0300 Subject: [PATCH] docs: add the stable install command to Quick Start in all READMEs v3.5.0-awg.1 is now tagged and promoted to Latest, so the plain no-argument install.sh command resolves to something real for the first time. Restructured Quick Start in all 7 READMEs to lead with it, followed by the explicit-version and dev-channel variants (matching upstream's own three-command Quick Start layout), replacing the now-outdated "this fork only ever publishes dev-latest" note. --- README.ar_EG.md | 14 +++++++++++++- README.es_ES.md | 14 +++++++++++++- README.fa_IR.md | 14 +++++++++++++- README.md | 14 +++++++++++++- README.ru_RU.md | 14 +++++++++++++- README.tr_TR.md | 14 +++++++++++++- README.zh_CN.md | 14 +++++++++++++- 7 files changed, 91 insertions(+), 7 deletions(-) diff --git a/README.ar_EG.md b/README.ar_EG.md index 1e8a35dcd..50e7efed9 100644 --- a/README.ar_EG.md +++ b/README.ar_EG.md @@ -78,11 +78,23 @@ ## البدء السريع +```bash +curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash +``` + +لتثبيت إصدار محدد، أضِف وسمه (مثل `v3.5.0-awg.1`): + +```bash +curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash -s v3.5.0-awg.1 +``` + +لتثبيت بنية **dev** المتجددة (أحدث إصدار أولي لكل التزام (commit) من `main`، وليس إصدارًا مستقرًا)، مرّر `dev`: + ```bash curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash -s dev ``` -تنشر هذه النسخة فقط الإصدار الأولي المتجدد **`dev-latest`** (يُعاد بناؤه تلقائيًا مع كل push إلى `main`) — لا يوجد بعد أي إصدار مستقر موسوم، لذا فإن `dev` هي القناة الوحيدة التي تشير حاليًا إلى أي شيء. +تُوسَم الإصدارات المستقرة الخاصة بهذه النسخة بـ `<إصدار الأساس في المشروع الأصلي>-awg.N` (مثل `v3.5.0-awg.1`، مبني فوق ما يسميه المشروع الأصلي `v3.5.0`) — أبدًا مجرد `vX.Y.Z` — حتى لا يُخلَط أبدًا بينها وبين إصدار حقيقي من MHSanaei/3x-ui بنفس الرقم. أثناء التثبيت، يتم إنشاء اسم مستخدم وكلمة مرور ومسار وصول عشوائية. بعد التثبيت، شغّل `x-ui` لفتح قائمة الإدارة، حيث يمكنك بدء/إيقاف الخدمة، وعرض أو إعادة تعيين بيانات تسجيل الدخول، وإدارة شهادات SSL، والمزيد. diff --git a/README.es_ES.md b/README.es_ES.md index a665bec59..c3bdcea24 100644 --- a/README.es_ES.md +++ b/README.es_ES.md @@ -78,11 +78,23 @@ Este fork se construyó para funcionar en los routers y servidores personales de ## Inicio Rápido +```bash +curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash +``` + +Para instalar una versión específica, añade su etiqueta (p. ej. `v3.5.0-awg.1`): + +```bash +curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash -s v3.5.0-awg.1 +``` + +Para instalar la compilación continua **dev** (el último prelanzamiento por commit desde `main`, no una versión estable), pasa `dev`: + ```bash curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash -s dev ``` -Este fork solo publica el prelanzamiento continuo **`dev-latest`** (reconstruido automáticamente con cada push a `main`) — todavía no existe ningún lanzamiento estable etiquetado, así que `dev` es el único canal que actualmente resuelve a algo. +Los lanzamientos estables propios de este fork se etiquetan como `-awg.N` (p. ej. `v3.5.0-awg.1`, construido sobre lo que upstream llama `v3.5.0`) — nunca un simple `vX.Y.Z` — para que nunca se confundan con un lanzamiento real de MHSanaei/3x-ui con el mismo número. Durante la instalación se generan un nombre de usuario, una contraseña y una ruta de acceso aleatorios. Tras la instalación, ejecuta `x-ui` para abrir el menú de gestión, donde puedes iniciar/detener el servicio, ver o restablecer tus credenciales de acceso, gestionar certificados SSL y mucho más. diff --git a/README.fa_IR.md b/README.fa_IR.md index 96f84e901..ba820117a 100644 --- a/README.fa_IR.md +++ b/README.fa_IR.md @@ -78,11 +78,23 @@ ## شروع سریع +```bash +curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash +``` + +برای نصب یک نسخه‌ی مشخص، تگ آن را اضافه کنید (مثلاً `v3.5.0-awg.1`): + +```bash +curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash -s v3.5.0-awg.1 +``` + +برای نصب بیلد غلتانِ **dev** (آخرین پیش‌انتشار بر اساس هر commit از `main`، نه یک نسخه‌ی پایدار)، مقدار `dev` را پاس بدهید: + ```bash curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash -s dev ``` -این فورک فقط پیش‌انتشار غلتانِ **`dev-latest`** را منتشر می‌کند (که به‌صورت خودکار با هر push به `main` دوباره ساخته می‌شود) — هنوز هیچ انتشار پایدارِ تگ‌گذاری‌شده‌ای وجود ندارد، پس `dev` تنها کانالی است که فعلاً به چیزی resolve می‌شود. +انتشارهای پایدار خودِ این فورک با تگ `<نسخه‌ی پایه‌ی آپستریم>-awg.N` مشخص می‌شوند (مثلاً `v3.5.0-awg.1`، ساخته‌شده روی چیزی که آپستریم آن را `v3.5.0` می‌نامد) — هرگز یک `vX.Y.Z` ساده نیست — تا هرگز با یک انتشار واقعی از MHSanaei/3x-ui با همان شماره اشتباه گرفته نشود. در حین نصب، یک نام کاربری، رمز عبور و مسیر دسترسی تصادفی تولید می‌شود. پس از نصب، دستور `x-ui` را اجرا کنید تا منوی مدیریت باز شود؛ در آنجا می‌توانید سرویس را شروع/متوقف کنید، اطلاعات ورود خود را ببینید یا بازنشانی کنید، گواهی‌های SSL را مدیریت کنید و کارهای دیگری انجام دهید. diff --git a/README.md b/README.md index 311d2c636..b89e1235f 100644 --- a/README.md +++ b/README.md @@ -78,11 +78,23 @@ This fork exists to run the author's own routers and servers; it isn't trying to ## Quick Start +```bash +curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash +``` + +To install a specific version, append its tag (e.g. `v3.5.0-awg.1`): + +```bash +curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash -s v3.5.0-awg.1 +``` + +To install the rolling **dev** build (latest per-commit pre-release from `main`, not a stable release), pass `dev`: + ```bash curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash -s dev ``` -This fork only ever publishes the rolling **`dev-latest`** pre-release (rebuilt automatically on every push to `main`) — there's no tagged stable release yet, so `dev` is the only channel that currently resolves to anything. +This fork's own stable releases are tagged `-awg.N` (e.g. `v3.5.0-awg.1`, built on top of what upstream calls `v3.5.0`) — never a bare `vX.Y.Z` — so they're never mistaken for a real upstream MHSanaei/3x-ui release of the same number. During installation a random username, password, and access path are generated. After installation, run `x-ui` to open the management menu, where you can start/stop the service, view or reset your login credentials, manage SSL certificates, and more. diff --git a/README.ru_RU.md b/README.ru_RU.md index e27200ee8..a756664b4 100644 --- a/README.ru_RU.md +++ b/README.ru_RU.md @@ -78,11 +78,23 @@ ## Быстрый старт +```bash +curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash +``` + +Чтобы установить конкретную версию, добавьте её тег (например, `v3.5.0-awg.1`): + +```bash +curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash -s v3.5.0-awg.1 +``` + +Чтобы установить скользящую сборку **dev** (последний пре-релиз по коммитам из `main`, не стабильный релиз), передайте `dev`: + ```bash curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash -s dev ``` -Этот форк пока публикует только скользящий пре-релиз **`dev-latest`** (пересобирается автоматически при каждом push в `main`) — стабильного релиза с тегом ещё нет, поэтому `dev` — единственный канал, который сейчас на что-то указывает. +Собственные стабильные релизы этого форка помечаются тегом `<базовая версия апстрима>-awg.N` (например, `v3.5.0-awg.1`, построен поверх того, что апстрим называет `v3.5.0`) — никогда просто `vX.Y.Z` — чтобы их нельзя было спутать с настоящим релизом MHSanaei/3x-ui того же номера. Во время установки генерируются случайные имя пользователя, пароль и путь доступа. После установки выполните `x-ui`, чтобы открыть меню управления, где можно запускать/останавливать сервис, просматривать или сбрасывать учётные данные для входа, управлять SSL-сертификатами и многое другое. diff --git a/README.tr_TR.md b/README.tr_TR.md index 38926a5d0..1136619f9 100644 --- a/README.tr_TR.md +++ b/README.tr_TR.md @@ -78,11 +78,23 @@ Bu fork, yazarının kendi yönlendiricileri ve kişisel sunucuları üzerinde ## Hızlı Başlangıç +```bash +curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash +``` + +Belirli bir sürümü kurmak için, etiketini (ör. `v3.5.0-awg.1`) ekleyin: + +```bash +curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash -s v3.5.0-awg.1 +``` + +Sürekli güncellenen **dev** sürümünü (kararlı bir sürüm değil; `main` dalından her commit'te oluşturulan en son ön sürüm) kurmak için `dev` değerini geçirin: + ```bash curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash -s dev ``` -Bu fork yalnızca sürekli güncellenen **`dev-latest`** ön sürümünü yayınlar (her `main` push'unda otomatik olarak yeniden derlenir) — henüz etiketlenmiş kararlı bir sürüm yoktur, bu yüzden şu anda gerçekten bir şeye karşılık gelen tek kanal `dev`'dir. +Bu fork'un kendi kararlı sürümleri `-awg.N` biçiminde etiketlenir (ör. `v3.5.0-awg.1`, upstream'in `v3.5.0` dediği sürümün üzerine inşa edilmiştir) — asla düz bir `vX.Y.Z` değil — böylece hiçbir zaman aynı numaraya sahip gerçek bir MHSanaei/3x-ui sürümüyle karıştırılmaz. Kurulum sırasında rastgele bir kullanıcı adı, şifre ve erişim yolu oluşturulur. Kurulumdan sonra, hizmeti başlatabileceğiniz/durdurabileceğiniz, giriş bilgilerinizi görüntüleyebileceğiniz veya sıfırlayabileceğiniz, SSL sertifikalarını yönetebileceğiniz ve çok daha fazlasını yapabileceğiniz yönetim menüsünü açmak için terminalde `x-ui` komutunu çalıştırın. diff --git a/README.zh_CN.md b/README.zh_CN.md index 6e0b10d7d..10f024c9a 100644 --- a/README.zh_CN.md +++ b/README.zh_CN.md @@ -78,11 +78,23 @@ ## 快速开始 +```bash +curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash +``` + +若要安装特定版本，请在命令后附加对应的标签（例如 `v3.5.0-awg.1`）： + +```bash +curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash -s v3.5.0-awg.1 +``` + +若要安装滚动更新的 **dev** 版本（来自 `main` 的最新逐次提交预发布版本，而非稳定版本），请传入 `dev`： + ```bash curl -fsSL https://raw.githubusercontent.com/Kuzz007/3x-ui/main/install.sh | bash -s dev ``` -本分支仅发布滚动更新的预发布版本 **`dev-latest`**（每次 push 到 `main` 都会自动重新构建）——目前还没有任何打标签的稳定版本，因此 `dev` 是当前唯一能解析到实际内容的渠道。 +本分支自己的稳定版本使用 `<上游基础版本>-awg.N` 的标签格式（例如 `v3.5.0-awg.1`，构建于上游所称的 `v3.5.0` 之上）——绝不会是单纯的 `vX.Y.Z`——这样就不会与 MHSanaei/3x-ui 官方相同编号的正式版本混淆。 安装过程中会生成随机的用户名、密码和访问路径。安装完成后，运行 `x-ui` 打开管理菜单，您可以在其中启动/停止服务、查看或重置登录凭据、管理 SSL 证书等。