Skip to content

Commit c614b4f

Browse files
authored
fix: added a note regarding SSL & Documentation (Gozargah#1489)
* fix: added a note regarding SSL & Documentation * fix: added a note to access Marzban dashboard locally
1 parent c5d3263 commit c614b4f

File tree

4 files changed

+71
-5
lines changed

4 files changed

+71
-5
lines changed

README-fa.md

+17-2
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,7 @@
6666
- [امکانات](#امکانات)
6767
- [راهنمای نصب](#راهنمای-نصب)
6868
- [تنظیمات](#تنظیمات)
69+
- [داکیومنت](#داکیومنت)
6970
- [استفاده از API](#استفاده-از-api)
7071
- [پشتیبان گیری از مرزبان](#پشتیبان-گیری-از-مرزبان)
7172
- [ربات تلگرام](#ربات-تلگرام)
@@ -116,7 +117,7 @@ sudo bash -c "$(curl -sL https://github.com/Gozargah/Marzban-scripts/raw/master/
116117
sudo bash -c "$(curl -sL https://github.com/Gozargah/Marzban-scripts/raw/master/marzban.sh)" @ install --database mysql
117118
```
118119

119-
با دستور زیر مرزبان را با دیتابیس MariaD نصب کنید:
120+
با دستور زیر مرزبان را با دیتابیس MariaDB نصب کنید:
120121

121122
```bash
122123
sudo bash -c "$(curl -sL https://github.com/Gozargah/Marzban-scripts/raw/master/marzban.sh)" @ install --database mariadb
@@ -128,7 +129,18 @@ sudo bash -c "$(curl -sL https://github.com/Gozargah/Marzban-scripts/raw/master/
128129
- فایل های مرزبان در پوشه `/opt/marzban` قرار می‌گیرند
129130
- فایل تنظیمات در مسیر `/opt/marzban/.env` قرار می‌گیرد ([تنظیمات](#تنظیمات) را مشاهده کنید)
130131
- فایل های مهم (اطلاعات) مرزبان در مسیر `/usr/lib/marzban` قرار می‌گیرند
131-
- شما از طریق آدرس `http://YOUR_SERVER_IP:8000/dashboard/` می‌توانید وارد داشبورد مرزبان شوید (YOUR_SERVER_IP را با آیپی سرور خود عوض کنید)
132+
به دلایل امنیتی، داشبورد مرزبان از طریق آیپی قابل دسترسی نیست. بنابراین، باید برای دامنه خود [گواهی SSL](https://gozargah.github.io/marzban/fa/examples/issue-ssl-certificate) بگیرید و از طریق آدرس https://YOUR_DOMAIN:8000/dashboard/ وارد داشبورد مرزبان شوید (نام دامنه خود را جایگزین YOUR_DOMAIN کنید)
133+
- همچنین می‌توانید از فوروارد کردن پورت SSH برای دسترسی لوکال به داشبورد مرزبان بدون دامنه استفاده کنید. نام کاربری و آیپی سرور خود را جایگزین `user@serverip` کنید و دستور زیر را اجرا کنید:
134+
135+
```bash
136+
ssh -L 8000:localhost:8000 user@serverip
137+
```
138+
139+
در نهایت، می‌توانید لینک زیر را در مرورگر خود وارد کنید تا به داشبورد مرزبان دسترسی پیدا کنید:
140+
141+
http://localhost:8000/dashboard/
142+
143+
به محض بستن ترمینال SSH، دسترسی شما به داشبورد قطع خواهد شد. بنابراین، این روش تنها برای تست کردن توصیه می‌شود.
132144

133145
در مرحله بعد, باید یک ادمین سودو بسازید
134146

@@ -286,6 +298,9 @@ server {
286298
| فعال کردن کانفیگ سفارشی JSON فقط برای برنامه‌ی V2rayN (پیش‌فرض: `False`) | USE_CUSTOM_JSON_FOR_V2RAYN |
287299

288300

301+
# داکیومنت
302+
[داکیومنت مرزبان](https://gozargah.github.io/marzban) تمامی آموزش‌های ضروری برای شروع را فراهم می‌کند و در سه زبان فارسی، انگلیسی و روسی در دسترس است. این داکیومنت نیاز به تلاش زیادی دارد تا تمامی جنبه‌های پروژه را به طور کامل پوشش دهد. ما از کمک و همکاری شما برای بهبود آن استقبال و قدردانی می‌کنیم. می‌توانید در این صفحه [گیت‌هاب](https://github.com/Gozargah/gozargah.github.io) مشارکت کنید.
303+
289304
# استفاده از API
290305
مرزبان به توسعه دهندگانAPI REST ارائه می دهد. برای مشاهده اسناد API در قالب Swagger UI یا ReDoc، متغیر `DOCS=True` را در تنظیمات خود ست کنید و در مرورگر به مسیر `/docs` و `/redoc` بروید.
291306

README-ru.md

+17-1
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,7 @@
6666
- [Функции](#функции)
6767
- [Руководство по установке](#руководство-по-установке)
6868
- [Конфигурация](#конфигурация)
69+
- [документация](#документация)
6970
- [API](#api)
7071
- [Backup](#backup)
7172
- [Telegram Bot](#telegram-bot)
@@ -129,7 +130,18 @@ sudo bash -c "$(curl -sL https://github.com/Gozargah/Marzban-scripts/raw/master/
129130
- Файлы Marzban будут размещены по адресу `/opt/marzban`.
130131
- Файл конфигурации будет размещен по адресу `/opt/marzban/.env` (см. [Конфигурация](#конфигурация)).
131132
- Файлы с данными будут размещены по адресу `/var/lib/marzban`.
132-
- Вы можете получить доступ к панели управления, введя в адресной строке `http://YOUR_SERVER_IP:8000/dashboard/` (заменив YOUR_SERVER_IP на актуальный IP адрес вашего сервера).
133+
- По соображениям безопасности, панель управления Marzban недоступна через IP-адрес. Поэтому вам необходимо [получить SSL-сертификат](https://gozargah.github.io/marzban/ru/examples/issue-ssl-certificate) и получить доступ к панели управления Marzban, открыв веб-браузер и перейдя по адресу `https://YOUR_DOMAIN:8000/dashboard/` (замените YOUR_DOMAIN на ваш фактический домен).
134+
- Вы также можете использовать перенаправление портов SSH для локального доступа к панели управления Marzban без домена. Замените `user@serverip` на ваше фактическое имя пользователя SSH и IP-адрес сервера и выполните следующую команду:
135+
136+
```bash
137+
ssh -L 8000:localhost:8000 user@serverip
138+
```
139+
140+
Наконец, введите следующую ссылку в ваш браузер, чтобы получить доступ к панели управления Marzban:
141+
142+
http://localhost:8000/dashboard/
143+
144+
Вы потеряете доступ к панели управления, как только закроете терминал SSH. Поэтому этот метод рекомендуется использовать только для тестирования.
133145

134146
Далее, Вам нужно создать главного администратора для входа в панель управления Marzban, выполнив следующую команду:
135147

@@ -313,6 +325,10 @@ server {
313325
| USE_CUSTOM_JSON_FOR_STREISAND | Enable custom JSON config only for Streisand (default: `False`) |
314326
| USE_CUSTOM_JSON_FOR_V2RAYN | Enable custom JSON config only for V2rayN (default: `False`) |
315327

328+
# документация
329+
330+
[Документация Marzban](https://gozargah.github.io/marzban/ru/) предоставляет все необходимые руководства для начала работы и доступна на трех языках: фарси, английском и русском. Для полного охвата всех аспектов проекта требуется значительное количество усилий. Мы приветствуем и ценим ваш вклад в улучшение документации. Вы можете внести свой вклад в этот [репозиторий на GitHub](https://github.com/Gozargah/gozargah.github.io).
331+
316332
# API
317333

318334
Marzban предоставляет REST API, позволяющий разработчикам программно взаимодействовать с сервисами Marzban. Для просмотра документации по API в Swagger UI или ReDoc установите переменную `DOCS=True` и перейдите по ссылкам `/docs` и `/redoc`.

README-zh-cn.md

+17-1
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,7 @@
6666
- [特性](#特性)
6767
- [安装指南](#安装指南)
6868
- [配置](#配置)
69+
- [文档](#文档)
6970
- [如何使用 API](#如何使用-api)
7071
- [如何备份 Marzban](#如何备份-marzban)
7172
- [Telegram bot](#telegram-bot)
@@ -127,7 +128,18 @@ Once the installation is complete:
127128
- The Marzban files will be located at `/opt/marzban`
128129
- The configuration file can be found at `/opt/marzban/.env` (refer to [configurations](#configuration) section to see variables)
129130
- The data files will be placed at `/usr/lib/marzban`
130-
- You can access the Marzban dashboard by opening a web browser and navigating to `http://YOUR_SERVER_IP:8000/dashboard/` (replace YOUR_SERVER_IP with the actual IP address of your server)
131+
- For security reasons, the Marzban dashboard is not accessible via IP address. Therefore, you must [obtain SSL certificate](https://gozargah.github.io/marzban/en/examples/issue-ssl-certificate) and access your Marzban dashboard by opening a web browser and navigating to `https://YOUR_DOMAIN:8000/dashboard/` (replace YOUR_DOMAIN with your actual domain)
132+
- You can also use SSH port forwarding to access the Marzban dashboard locally without a domain. Replace `user@serverip` with your actual SSH username and server IP and Run the command below:
133+
134+
```bash
135+
ssh -L 8000:localhost:8000 user@serverip
136+
```
137+
138+
Finally, you can enter the following link in your browser to access your Marzban dashboard:
139+
140+
http://localhost:8000/dashboard/
141+
142+
You will lose access to the dashboard as soon as you close the SSH terminal. Therefore, this method is recommended only for testing purposes.
131143

132144
Next, you need to create a sudo admin for logging into the Marzban dashboard by the following command
133145

@@ -301,6 +313,10 @@ server {
301313
| USE_CUSTOM_JSON_FOR_V2RAYN | Enable custom JSON config only for V2rayN (default: `False`) |
302314

303315

316+
# 文档
317+
[Marzban 文档](https://gozargah.github.io/marzban) 提供了所有必要的入门指南,支持三种语言:波斯语、英语和俄语。要全面覆盖项目的各个方面,这些文档需要大量的工作。我们欢迎并感谢您的贡献,以帮助我们改进文档。您可以在这个 [GitHub 仓库](https://github.com/Gozargah/gozargah.github.io) 中进行贡献。
318+
319+
304320
# 如何使用 API
305321
Marzban 提供了 REST API,使开发人员能够以编程方式与 Marzban 服务进行交互。要在 Swagger UI 或 ReDoc 中查看 API 文档,设置配置变量 `DOCS=True`,然后导航到 `/docs``/redoc`
306322

README.md

+20-1
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,7 @@
6666
- [Features](#features)
6767
- [Installation guide](#installation-guide)
6868
- [Configuration](#configuration)
69+
- [Documentation](#documentation)
6970
- [API](#api)
7071
- [Backup](#backup)
7172
- [Telegram Bot](#telegram-bot)
@@ -130,7 +131,18 @@ Once the installation is complete:
130131
- The Marzban files will be located at `/opt/marzban`
131132
- The configuration file can be found at `/opt/marzban/.env` (refer to [configurations](#configuration) section to see variables)
132133
- The data files will be placed at `/var/lib/marzban`
133-
- You can access the Marzban dashboard by opening a web browser and navigating to `http://YOUR_SERVER_IP:8000/dashboard/` (replace YOUR_SERVER_IP with the actual IP address of your server)
134+
- For security reasons, the Marzban dashboard is not accessible via IP address. Therefore, you must [obtain SSL certificate](https://gozargah.github.io/marzban/en/examples/issue-ssl-certificate) and access your Marzban dashboard by opening a web browser and navigating to `https://YOUR_DOMAIN:8000/dashboard/` (replace YOUR_DOMAIN with your actual domain)
135+
- You can also use SSH port forwarding to access the Marzban dashboard locally without a domain. Replace `user@serverip` with your actual SSH username and server IP and Run the command below:
136+
137+
```bash
138+
ssh -L 8000:localhost:8000 user@serverip
139+
```
140+
141+
Finally, you can enter the following link in your browser to access your Marzban dashboard:
142+
143+
http://localhost:8000/dashboard/
144+
145+
You will lose access to the dashboard as soon as you close the SSH terminal. Therefore, this method is recommended only for testing purposes.
134146

135147
Next, you need to create a sudo admin for logging into the Marzban dashboard by the following command
136148

@@ -314,10 +326,17 @@ By default the app will be run on `http://localhost:8000/dashboard`. You can con
314326
| USE_CUSTOM_JSON_FOR_STREISAND | Enable custom JSON config only for Streisand (default: `False`) |
315327
| USE_CUSTOM_JSON_FOR_V2RAYN | Enable custom JSON config only for V2rayN (default: `False`) |
316328

329+
330+
# Documentation
331+
332+
The [Marzban Documentation](https://gozargah.github.io/marzban) provides all the essential guides to get you started, available in three languages: Farsi, English, and Russian. This documentation requires significant effort to cover all aspects of the project comprehensively. We welcome and appreciate your contributions to help us improve it. You can contribute on this [GitHub repository](https://github.com/Gozargah/gozargah.github.io).
333+
334+
317335
# API
318336

319337
Marzban provides a REST API that enables developers to interact with Marzban services programmatically. To view the API documentation in Swagger UI or ReDoc, set the configuration variable `DOCS=True` and navigate to the `/docs` and `/redoc`.
320338

339+
321340
# Backup
322341

323342
It's always a good idea to backup your Marzban files regularly to prevent data loss in case of system failures or accidental deletion. Here are the steps to backup Marzban:

0 commit comments

Comments
 (0)