Initial release: Psiphon Conduit Manager v1.0.0

README.md

@@ -0,0 +1,212 @@
+# Conduit Manager
+
+A powerful management tool for deploying and managing Psiphon Conduit nodes on Linux servers. Help users access the open internet during network restrictions.
+
+## Quick Install
+
+```bash
+curl -sL https://raw.githubusercontent.com/SamNet-dev/conduit-manager/main/conduit.sh | sudo bash
+```
+
+Or download and run manually:
+
+```bash
+wget https://raw.githubusercontent.com/SamNet-dev/conduit-manager/main/conduit.sh
+sudo bash conduit.sh
+```
+
+## Features
+
+- **One-Click Deployment** - Automatically installs Docker and configures everything
+- **Multi-Distro Support** - Works on Ubuntu, Debian, CentOS, Fedora, Arch, Alpine, openSUSE
+- **Auto-Start on Boot** - Supports systemd, OpenRC, and SysVinit
+- **Live Monitoring** - Real-time connection stats with CPU/RAM monitoring
+- **Easy Management** - Powerful CLI commands or interactive menu
+- **Complete Uninstall** - Clean removal of all components
+
+## Supported Distributions
+
+| Family | Distributions |
+|--------|---------------|
+| Debian | Ubuntu, Debian, Linux Mint, Pop!_OS, Kali, Raspbian |
+| RHEL | CentOS, Fedora, Rocky Linux, AlmaLinux, Amazon Linux |
+| Arch | Arch Linux, Manjaro, EndeavourOS |
+| SUSE | openSUSE Leap, openSUSE Tumbleweed |
+| Alpine | Alpine Linux |
+
+## CLI Reference
+
+After installation, use the `conduit` command:
+
+### Status & Monitoring
+```bash
+conduit status       # Show current status and resource usage
+conduit stats        # View live statistics (real-time)
+conduit logs         # View raw Docker logs
+```
+
+### Container Management
+```bash
+conduit start        # Start the Conduit container
+conduit stop         # Stop the Conduit container
+conduit restart      # Restart the Conduit container
+```
+
+### Configuration
+```bash
+conduit settings     # Change max-clients and bandwidth
+conduit menu         # Open interactive management menu
+```
+
+### Maintenance
+```bash
+conduit uninstall    # Remove all components
+conduit help         # Show help message
+```
+
+## Configuration Options
+
+| Option | Default | Range | Description |
+|--------|---------|-------|-------------|
+| `max-clients` | 200 | 1-1000 | Maximum concurrent proxy clients |
+| `bandwidth` | 5 | 1-40 | Bandwidth limit per peer (Mbps) |
+
+**Recommended values based on server RAM:**
+
+| RAM | Max Clients |
+|-----|-------------|
+| 8GB+ | 1000 |
+| 4-8GB | 700 |
+| 2-4GB | 400 |
+| <2GB | 200 |
+
+## Installation Options
+
+```bash
+# Standard install
+sudo bash conduit.sh
+
+# Force reinstall
+sudo bash conduit.sh --reinstall
+
+# Uninstall everything
+sudo bash conduit.sh --uninstall
+
+# Show help
+sudo bash conduit.sh --help
+```
+
+## Requirements
+
+- Linux server (any supported distribution)
+- Root/sudo access
+- Internet connection
+- Minimum 512MB RAM (1GB+ recommended)
+
+## How It Works
+
+1. **Detection** - Identifies your Linux distribution and init system
+2. **Docker Setup** - Installs Docker if not present
+3. **Container Deployment** - Pulls and runs the official Psiphon Conduit image
+4. **Auto-Start Configuration** - Sets up systemd/OpenRC/SysVinit service
+5. **CLI Installation** - Creates the `conduit` management command
+
+---
+
+<div dir="rtl">
+
+# راهنمای فارسی - مدیریت کاندوییت
+
+ابزار قدرتمند برای راه‌اندازی و مدیریت نود سایفون کاندوییت روی سرورهای لینوکس.
+
+## نصب سریع
+
+دستور زیر را در ترمینال سرور اجرا کنید:
+
+```bash
+curl -sL https://raw.githubusercontent.com/SamNet-dev/conduit-manager/main/conduit.sh | sudo bash
+```
+
+یا دانلود و اجرای دستی:
+
+```bash
+wget https://raw.githubusercontent.com/SamNet-dev/conduit-manager/main/conduit.sh
+sudo bash conduit.sh
+```
+
+## ویژگی‌ها
+
+- **نصب با یک کلیک** - داکر و تمام موارد مورد نیاز به صورت خودکار نصب می‌شود
+- **پشتیبانی از توزیع‌های مختلف** - اوبونتو، دبیان، سنت‌اواس، فدورا، آرچ، آلپاین
+- **راه‌اندازی خودکار** - پس از ریستارت سرور، سرویس به صورت خودکار اجرا می‌شود
+- **مانیتورینگ زنده** - نمایش تعداد کاربران متصل و مصرف منابع
+- **مدیریت آسان** - دستورات قدرتمند CLI یا منوی تعاملی
+- **حذف کامل** - پاکسازی تمام فایل‌ها و تنظیمات
+
+## دستورات CLI
+
+### وضعیت و مانیتورینگ
+```bash
+conduit status       # نمایش وضعیت و مصرف منابع
+conduit stats        # آمار زنده (لحظه‌ای)
+conduit logs         # لاگ‌های داکر
+```
+
+### مدیریت کانتینر
+```bash
+conduit start        # شروع کانتینر
+conduit stop         # توقف کانتینر
+conduit restart      # ریستارت کانتینر
+```
+
+### پیکربندی
+```bash
+conduit settings     # تغییر تنظیمات
+conduit menu         # منوی تعاملی
+```
+
+### نگهداری
+```bash
+conduit uninstall    # حذف کامل
+conduit help         # راهنما
+```
+
+## تنظیمات
+
+| گزینه | پیش‌فرض | محدوده | توضیحات |
+|-------|---------|--------|---------|
+| `max-clients` | 200 | 1-1000 | حداکثر کاربران همزمان |
+| `bandwidth` | 5 | 1-40 | محدودیت پهنای باند (Mbps) |
+
+**مقادیر پیشنهادی:**
+
+| رم سرور | حداکثر کاربران |
+|---------|----------------|
+| +8 گیگ | 1000 |
+| 4-8 گیگ | 700 |
+| 2-4 گیگ | 400 |
+| زیر 2 گیگ | 200 |
+
+## پیش‌نیازها
+
+- سرور لینوکس
+- دسترسی root یا sudo
+- اتصال اینترنت
+- حداقل 512 مگابایت رم
+
+</div>
+
+---
+
+## License
+
+MIT License
+
+## Contributing
+
+Pull requests welcome. For major changes, open an issue first.
+
+## Links
+
+- [Psiphon](https://psiphon.ca/)
+- [Psiphon Conduit](https://github.com/Psiphon-Inc/conduit)