PasarGuard-Node README

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

PasarGuard Node – Railway Deploy (No VPS needed)

Deploys PasarGuard Node (https://github.com/PasarGuard/node) as a second Railway service, with a self-signed certificate baked into the image at build time so no external server is required to obtain the "Server CA" for the panel.

Setup

  1. Push this folder to its own GitHub repo.
  2. In your Railway project, click + New → GitHub Repo → select this repo. (Use the same Railway project as your PasarGuard panel, as a second service.)
  3. In this new service's Variables tab, add:
    • API_KEY = a UUID you generate yourself (e.g. uuidgen or any UUID generator). Example: 6d183b56-361e-4f9b-be2d-c571cdebae23
  4. In this service's Settings → Networking, enable TCP Proxy and set the target port to 62050. Railway will give you a public host:port pair.
  5. Deploy. Once it's running, open this service's Console/Shell and run:
    cat /app/certs/ssl_cert.pem
    
    Copy the whole output (including the BEGIN/END lines).
  6. Go to your PasarGuard panel dashboard → Nodes → Add Node:
    • Address: the TCP proxy host (without the port)
    • Port: the TCP proxy port
    • API Key: the same UUID you set in step 3
    • Server CA: paste the certificate from step 5

PasarGuard-Node (x4gpanell/PasarGuard-Node)

Searching Database…

Что это?Этот репозиторий разворачивает «PasarGuard Node» (ноду для прокси-панели PasarGuard) как второй сервис Railway, с самоподписанным TLS-сертификатом, запечённым в Docker-образ на этапе сборки, так что вам не нужен отдельный VPS лишь ради Server CA для панели.
Это библиотека или просто шаблон развёртывания?Это шаблон развёртывания: Docker-образ плюс shell-скрипты, которые вы пушите в собственный репозиторий на GitHub и разворачиваете как сервис Railway, а не пакет, устанавливаемый в код.
Как запустить эту ноду?Запушьте эту папку в отдельный репозиторий на GitHub, создайте из него новый сервис Railway в том же проекте Railway, где ваша панель PasarGuard, задайте переменную APIKEY равной сгенерированному вами UUID, включите TCP Proxy на порту 62050 в настройках Networking этого сервиса и разверните.
Нужен VPS или достаточно Railway?Нужен аккаунт Railway и уже работающая панель PasarGuard (развёрнутая как первый сервис в том же проекте Railway); внешний VPS для TLS не требуется.
Какие шаги нельзя пропустить?Нужно вручную включить TCP Proxy и указать целевой порт 62050 в настройках Networking Railway, затем скопировать сгенерированный сертификат из консоли сервиса в поле «Server CA» панели — пропуск любого из этих шагов оставит ноду недоступной.
Что за панель PasarGuard, к которой подключается эта нода?Это отдельный сервис прокси-панели (развёрнутый как первый сервис Railway), в котором эта нода регистрируется, используя указанные ею Address, Port, API Key и Server CA.
Зачем запекать самоподписанный сертификат в образ вместо настоящего?Это позволяет ноде получить пригодный Server CA для панели, не арендуя и не настраивая внешний сервер с публичным доменом и настройкой TLS.
Для чего нужна переменная APIKEY?Это UUID, который вы генерируете сами и который служит общим секретом между панелью и этой нодой; он вводится и как переменная Railway, и как API Key при добавлении ноды в панели.
Creator
x4gpanell
Size
<0.1 MB
Stars
407
Updated
CommitSep 19
Age
2mo
Commits · 90 Days