marzban-node README

The project's README from github.com/x4gpanell/marzban-node. As one markdown file: README.md.

🚀 Marzban-node روی Railway (روش PasarGuard-Node)

مثل PasarGuard-Node، این ریپو سورس Marzban-node را کپی نمی‌کند؛ Dockerfile در لحظه‌ی build از Gozargah/Marzban-node کلون می‌کند و سپس دو پچ کوچک (دقیقاً به سبک پچ‌های PasarGuard) رویش می‌زند تا با Railway سازگار شود:

  1. پورت گوش‌دادن را از $PORT (متغیری که Railway خودش تزریق می‌کند) می‌خواند.
  2. یک حالت REST بدون TLS اضافه می‌کند (SERVICE_TLS=false، پیش‌فرض) چون Railway خودش روی لبه‌ی شبکه TLS را ترمینیت می‌کند و نود از طریق شبکه‌ی خصوصی در دسترس پنل است؛ گواهی کلاینت هم در این حالت لازم نیست.

نصب

  1. این ریپو را Fork کنید.
  2. در Railway یک سرویس جدید از روی این ریپو بسازید.
  3. بعد از Deploy، آدرس (host) و پورت این سرویس روی Railway را در پنل Marzban، قسمت Node Settings، به‌عنوان یک نود جدید اضافه کنید.
  4. اگر ترجیح می‌دهید نود خودش TLS را مدیریت کند (حالت اصلی و امن‌تر upstream)، متغیرهای زیر را ست کنید:
    • SERVICE_TLS=true
    • SSL_CLIENT_CERT_FILE = مسیر گواهی کلاینتی که از پنل گرفته‌اید

به‌روزرسانی

چون سورس در build-time کلون می‌شود، کافیست دوباره روی Railway Deploy بزنید تا آخرین نسخه‌ی Marzban-node گرفته شود؛ نیازی به sync دستی فایل‌ها نیست.

marzban-node (x4gpanell/marzban-node)

Searching Database…

What is this?A Dockerfile that builds and deploys the 'Marzban-node' VPN node service on Railway, patching it at build time so it fits Railway's networking model instead of shipping a copied fork of the source.
Does this repo contain its own copy of the Marzban-node source code?No. The Dockerfile clones Gozargah/Marzban-node fresh at build time and applies two small patches (in the style of PasarGuard-Node) to make it Railway-compatible.
How do I deploy this on Railway?Fork the repo, create a new Railway service from it, then after deploy add the service's host and port to your Marzban panel under Node Settings as a new node.
Do I need an existing Marzban panel to use this node?Yes, you register the deployed node's host and port inside your existing Marzban panel's Node Settings; you also need a Railway account to host it.
Is TLS enabled by default between the panel and this node?No, by default it runs a non-TLS REST mode (SERVICETLS=false) because Railway terminates TLS at the edge and the node is only reachable over Railway's private network, so no client certificate is required; you can switch to the more secure upstream TLS mode by setting SERVICETLS=true and SSLCLIENTCERTFILE.
How do I update to the latest Marzban-node release?Since the source is cloned fresh at build time, just trigger a new Deploy on Railway and it rebuilds against the newest upstream Marzban-node code — no manual file syncing needed.
Can I deploy this somewhere other than Railway?The patches specifically rely on Railway's injected $PORT variable and its private-network TLS termination, so this image is built for Railway; running it elsewhere would mean recreating that environment or dropping the patches.
What is PasarGuard-Node, and why is it mentioned?PasarGuard-Node is the project whose patching approach this repo explicitly copies, applying the same style of small Railway-compatibility patches on top of the upstream Marzban-node source.
Creator
x4gpanell
Size
<0.1 MB
Stars
171
Updated
CommitAug 23
Age
1mo
Commits · 90 Days