️ PasarGuard
Unified & Censorship-Resistant Proxy Management Solution
---
فارسی
/
简体中文
/
Русский
## Table of Contents
> **Quick Navigation** - Jump to any section below
- [ Overview](#-overview)
- [ Why using PasarGuard?](#-why-using-pasarguard)
- [✨ Features](#-features)
- [ Installation guide](#-installation-guide)
- [ Documentation](#-documentation)
- [ Donation](#-donation)
---
# Overview
> **What is PasarGuard?**
PasarGuard is a powerful proxy management tool that offers an intuitive and efficient interface for handling hundreds of proxy accounts. Built with Python and React.js it combines performance, scalability, and ease of use to simplify large-scale proxy management. It supports both [Xray-core](https://github.com/XTLS/Xray-core) and [WireGuard](https://www.wireguard.com/) for maximum performance.
---
## Why using PasarGuard?
> **Simple, Powerful, Reliable**
PasarGuard is a user-friendly, feature-rich, and reliable proxy management tool. It allows you to create and manage multiple proxies for your users without the need for complex configuration. With its built-in web interface, you can easily monitor activity, modify settings, and control user access limits — all from one convenient dashboard.
---
### ✨ Features
---
# Installation guide
> **Quick Start** - Get PasarGuard running in minutes
### For a quick setup, use the following commands based on your preferred database.
---
**TimescaleDB (Recommended):**
```bash
sudo bash -c "$(curl -fsSL https://github.com/PasarGuard/scripts/raw/main/pasarguard.sh)" @ install --database timescaledb
```
**SQLite:**
```bash
sudo bash -c "$(curl -fsSL https://github.com/PasarGuard/scripts/raw/main/pasarguard.sh)" @ install
```
**MySQL:**
```bash
sudo bash -c "$(curl -fsSL https://github.com/PasarGuard/scripts/raw/main/pasarguard.sh)" @ install --database mysql
```
**MariaDB:**
```bash
sudo bash -c "$(curl -fsSL https://github.com/PasarGuard/scripts/raw/main/pasarguard.sh)" @ install --database mariadb
```
**PostgreSQL:**
```bash
sudo bash -c "$(curl -fsSL https://github.com/PasarGuard/scripts/raw/main/pasarguard.sh)" @ install --database postgresql
```
### After installation:
---
```bash
ssh -L 8000:localhost:8000 user@serverip
```
Then access: `http://localhost:8000/dashboard/`
> ⚠️ **Testing only** - You'll lose access when you close the SSH terminal.
### Next Steps:
```bash
# Generate a one-time setup key for owner account setup
pasarguard cli generate-temp-key
# Use the key on the dashboard login page to create the owner account
# Get help
pasarguard --help
```
# Documentation
> **Contributing:** Help improve documentation on [GitHub](https://github.com/PasarGuard/PasarGuard.github.io)
---
# Donation
---
Made with ❤️ for Internet freedom