{"id":42638182,"url":"https://github.com/samnet-dev/conduit-manager","last_synced_at":"2026-01-31T08:00:57.999Z","repository":{"id":334375473,"uuid":"1141187807","full_name":"SamNet-dev/conduit-manager","owner":"SamNet-dev","description":"A powerful, one-click management tool for Psiphon Conduit nodes. Simplifies deployment, automation, and real-time monitoring on any Linux distribution","archived":false,"fork":false,"pushed_at":"2026-01-30T21:48:49.000Z","size":642,"stargazers_count":177,"open_issues_count":3,"forks_count":24,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-01-30T21:54:08.535Z","etag":null,"topics":["conduit","conduit-backend","conduit-platform","psiphon","psiphon3","vpn-server"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SamNet-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-24T12:14:15.000Z","updated_at":"2026-01-30T21:38:06.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/SamNet-dev/conduit-manager","commit_stats":null,"previous_names":["samnet-dev/conduit-manager"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/SamNet-dev/conduit-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamNet-dev%2Fconduit-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamNet-dev%2Fconduit-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamNet-dev%2Fconduit-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamNet-dev%2Fconduit-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SamNet-dev","download_url":"https://codeload.github.com/SamNet-dev/conduit-manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamNet-dev%2Fconduit-manager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28934612,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T07:49:44.436Z","status":"ssl_error","status_checked_at":"2026-01-31T07:49:34.274Z","response_time":128,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["conduit","conduit-backend","conduit-platform","psiphon","psiphon3","vpn-server"],"created_at":"2026-01-29T06:02:03.278Z","updated_at":"2026-01-31T08:00:57.966Z","avatar_url":"https://github.com/SamNet-dev.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Conduit Manager\n\n```\n  ██████╗ ██████╗ ███╗   ██╗██████╗ ██╗   ██╗██╗████████╗\n ██╔════╝██╔═══██╗████╗  ██║██╔══██╗██║   ██║██║╚══██╔══╝\n ██║     ██║   ██║██╔██╗ ██║██║  ██║██║   ██║██║   ██║\n ██║     ██║   ██║██║╚██╗██║██║  ██║██║   ██║██║   ██║\n ╚██████╗╚██████╔╝██║ ╚████║██████╔╝╚██████╔╝██║   ██║\n  ╚═════╝ ╚═════╝ ╚═╝  ╚═══╝╚═════╝  ╚═════╝ ╚═╝   ╚═╝\n                      M A N A G E R\n```\n\n![Version](https://img.shields.io/badge/version-1.1-blue)\n![License](https://img.shields.io/badge/license-MIT-green)\n![Platform](https://img.shields.io/badge/platform-Linux-orange)\n![Docker](https://img.shields.io/badge/Docker-Required-2496ED?logo=docker\u0026logoColor=white)\n![Bash](https://img.shields.io/badge/Bash-Script-4EAA25?logo=gnubash\u0026logoColor=white)\n\nA powerful management tool for deploying and managing Psiphon Conduit nodes on Linux servers. Help users access the open internet during network restrictions.\n\n## Quick Install\n\n```bash\ncurl -sL https://raw.githubusercontent.com/SamNet-dev/conduit-manager/main/conduit.sh | sudo bash\n```\n\nOr download and run manually:\n\n```bash\nwget https://raw.githubusercontent.com/SamNet-dev/conduit-manager/main/conduit.sh\nsudo bash conduit.sh\n```\n\n## What's New in v1.1\n\n- **Multi-Container Support** — Run up to 5 Conduit containers on a single server for higher throughput\n- **Background Traffic Tracker** — Continuous tcpdump-based tracker service with per-country GeoIP stats\n- **Advanced Stats Page** — Live dashboard with top countries by peers, download, upload, and unique IPs (bar charts, auto-refresh)\n- **Live Dashboard Overhaul** — Side-by-side active clients and top upload by country with real-time bars\n- **Per-Container Settings** — Configure max-clients and bandwidth individually for each container\n- **Container Manager** — Add or remove containers on the fly with auto-refreshing status view\n- **Smart Install** — Detects CPU cores and RAM, recommends container count for your hardware\n- **Info \u0026 Help Hub** — Multi-page guide covering the tracker, stats, containers, privacy, and about\n- **Service Auto-Recovery** — Automatically restarts failed conduit.service on script launch\n- **Seamless Upgrade** — Existing v1.0.x users can run the new script without reinstalling; old containers are recognized automatically\n\n## Features\n\n- **One-Click Deployment** — Automatically installs Docker and configures everything\n- **Multi-Container Scaling** — Run 1–5 containers to maximize your server's capacity\n- **Multi-Distro Support** — Works on Ubuntu, Debian, CentOS, Fedora, Arch, Alpine, openSUSE\n- **Auto-Start on Boot** — Supports systemd, OpenRC, and SysVinit\n- **Live Dashboard** — Real-time connection stats with CPU/RAM monitoring and per-country client breakdown\n- **Advanced Stats** — Top countries by connected peers, download, upload, and unique IPs with bar charts\n- **Live Peer Traffic** — Real-time traffic table by country with speed, total bytes, and IP/client counts\n- **Background Tracker** — Continuous traffic monitoring via systemd service with GeoIP resolution\n- **Per-Container Settings** — Configure max-clients and bandwidth per container\n- **Easy Management** — Powerful CLI commands or interactive menu\n- **Backup \u0026 Restore** — Backup and restore your node identity keys\n- **Health Checks** — Comprehensive diagnostics for troubleshooting\n- **Info \u0026 Help** — Built-in multi-page guide explaining how everything works\n- **Complete Uninstall** — Clean removal of all components\n\n## Supported Distributions\n\n| Family | Distributions |\n|--------|---------------|\n| Debian | Ubuntu, Debian, Linux Mint, Pop!_OS, Kali, Raspbian |\n| RHEL | CentOS, Fedora, Rocky Linux, AlmaLinux, Amazon Linux |\n| Arch | Arch Linux, Manjaro, EndeavourOS |\n| SUSE | openSUSE Leap, openSUSE Tumbleweed |\n| Alpine | Alpine Linux |\n\n## CLI Reference\n\nAfter installation, use the `conduit` command:\n\n### Status \u0026 Monitoring\n```bash\nconduit status       # Show current status and resource usage\nconduit stats        # View live statistics (real-time dashboard)\nconduit logs         # View raw Docker logs\nconduit health       # Run health check diagnostics\nconduit peers        # Live peer traffic by country (GeoIP)\n```\n\n### Container Management\n```bash\nconduit start        # Start all Conduit containers\nconduit stop         # Stop all Conduit containers\nconduit restart      # Restart all Conduit containers\nconduit update       # Update to the latest Conduit image\n```\n\n### Configuration\n```bash\nconduit settings     # Change max-clients and bandwidth per container\nconduit menu         # Open interactive management menu\n```\n\n### Backup \u0026 Restore\n```bash\nconduit backup       # Backup your node identity keys\nconduit restore      # Restore node identity from backup\n```\n\n### Maintenance\n```bash\nconduit uninstall    # Remove all components\nconduit version      # Show version information\nconduit help         # Show help message\n```\n\n## Interactive Menu\n\nThe interactive menu (`conduit menu`) provides access to all features:\n\n| Option | Description |\n|--------|-------------|\n| **1** | View status dashboard — real-time stats with active clients and top upload by country |\n| **2** | Live connection stats — streaming stats from Docker logs |\n| **3** | View logs — raw Docker log output |\n| **4** | Live peers by country — per-country traffic table with speed and client counts |\n| **5** | Start Conduit |\n| **6** | Stop Conduit |\n| **7** | Restart Conduit |\n| **8** | Update Conduit image |\n| **9** | Settings \u0026 Tools — max-clients, bandwidth, backup, restore, health check, uninstall |\n| **c** | Manage containers — add or remove containers (up to 5) |\n| **a** | Advanced stats — top 5 charts for peers, download, upload, unique IPs |\n| **i** | Info \u0026 Help — multi-page guide with tracker, stats, containers, privacy, about |\n| **0** | Exit |\n\n## Configuration Options\n\n| Option | Default | Range | Description |\n|--------|---------|-------|-------------|\n| `max-clients` | 200 | 1–1000 | Maximum concurrent proxy clients per container |\n| `bandwidth` | 5 | 1–40, -1 | Bandwidth limit per peer (Mbps). Use -1 for unlimited. |\n\n**Recommended values based on server hardware:**\n\n| CPU Cores | RAM | Recommended Containers | Max Clients (per container) |\n|-----------|-----|------------------------|-----------------------------|\n| 1 Core | \u003c 1 GB | 1 | 100 |\n| 2 Cores | 2 GB | 1–2 | 200 |\n| 4 Cores | 4 GB+ | 2–3 | 400 |\n| 8+ Cores | 8 GB+ | 3–5 | 800 |\n\n## Installation Options\n\n```bash\n# Standard install\nsudo bash conduit.sh\n\n# Force reinstall\nsudo bash conduit.sh --reinstall\n\n# Uninstall everything\nsudo bash conduit.sh --uninstall\n\n# Show help\nsudo bash conduit.sh --help\n```\n\n## Upgrading from v1.0.x\n\nJust run the new script. When prompted, select **\"Open management menu\"** — your existing container is recognized automatically. No reinstall needed. The background tracker service starts when you next start/restart from the menu.\n\n## Requirements\n\n- Linux server (any supported distribution)\n- Root/sudo access\n- Internet connection\n- Minimum 512MB RAM (1GB+ recommended for multi-container)\n\n## How It Works\n\n1. **Detection** — Identifies your Linux distribution and init system\n2. **Docker Setup** — Installs Docker if not present\n3. **Hardware Check** — Detects CPU/RAM and recommends container count\n4. **Container Deployment** — Pulls and runs the official Psiphon Conduit image\n5. **Auto-Start Configuration** — Sets up systemd/OpenRC/SysVinit service\n6. **Tracker Service** — Starts background traffic tracker with GeoIP resolution\n7. **CLI Installation** — Creates the `conduit` management command\n\n## Security\n\n- **Secure Backups**: Node identity keys are stored with restricted permissions (600)\n- **No Telemetry**: The manager collects no data and sends nothing externally\n- **Local Tracking Only**: Traffic stats are stored locally and never transmitted\n\n---\n\n\u003cdiv dir=\"rtl\"\u003e\n\n# راهنمای فارسی - مدیریت کاندوییت\n\nابزار قدرتمند برای راه‌اندازی و مدیریت نود سایفون کاندوییت روی سرورهای لینوکس. به کاربران کمک کنید تا در زمان محدودیت‌های اینترنتی به اینترنت آزاد دسترسی داشته باشند.\n\n## نصب سریع\n\nدستور زیر را در ترمینال سرور اجرا کنید:\n\n```bash\ncurl -sL https://raw.githubusercontent.com/SamNet-dev/conduit-manager/main/conduit.sh | sudo bash\n```\n\nیا دانلود و اجرای دستی:\n\n```bash\nwget https://raw.githubusercontent.com/SamNet-dev/conduit-manager/main/conduit.sh\nsudo bash conduit.sh\n```\n\n## تازه‌های نسخه 1.1\n\n- **پشتیبانی از چند کانتینر** — اجرای تا ۵ کانتینر روی یک سرور برای ظرفیت بیشتر\n- **ردیاب ترافیک پس‌زمینه** — سرویس ردیابی مداوم با آمار جغرافیایی به تفکیک کشور\n- **صفحه آمار پیشرفته** — داشبورد زنده با نمودار میله‌ای برای برترین کشورها\n- **داشبورد بازطراحی شده** — نمایش کلاینت‌های فعال و آپلود برتر به تفکیک کشور\n- **تنظیمات هر کانتینر** — پیکربندی جداگانه حداکثر کاربران و پهنای باند\n- **مدیریت کانتینرها** — اضافه یا حذف کانتینر به صورت آنی\n- **نصب هوشمند** — تشخیص CPU و RAM و پیشنهاد تعداد کانتینر مناسب\n- **بخش راهنما** — راهنمای چندصفحه‌ای شامل ردیاب، آمار، کانتینرها، حریم خصوصی و درباره ما\n- **بازیابی خودکار سرویس** — ریستارت خودکار سرویس در صورت خرابی\n- **ارتقا بدون نصب مجدد** — کاربران نسخه قبلی بدون نیاز به نصب مجدد می‌توانند آپدیت کنند\n\n## ویژگی‌ها\n\n- **نصب با یک کلیک** — داکر و تمام موارد مورد نیاز به صورت خودکار نصب می‌شود\n- **مقیاس‌پذیری چند کانتینره** — اجرای ۱ تا ۵ کانتینر برای حداکثر استفاده از سرور\n- **پشتیبانی از توزیع‌های مختلف** — اوبونتو، دبیان، سنت‌اواس، فدورا، آرچ، آلپاین\n- **راه‌اندازی خودکار** — پس از ریستارت سرور، سرویس به صورت خودکار اجرا می‌شود\n- **داشبورد زنده** — نمایش لحظه‌ای وضعیت، تعداد کاربران، مصرف CPU و RAM\n- **آمار پیشرفته** — نمودار میله‌ای برترین کشورها بر اساس اتصال، دانلود، آپلود و IP\n- **مانیتورینگ ترافیک** — جدول لحظه‌ای ترافیک بر اساس کشور با سرعت و تعداد کلاینت\n- **ردیاب پس‌زمینه** — سرویس ردیابی مداوم ترافیک با تشخیص جغرافیایی\n- **تنظیمات هر کانتینر** — پیکربندی حداکثر کاربران و پهنای باند برای هر کانتینر\n- **مدیریت آسان** — دستورات قدرتمند CLI یا منوی تعاملی\n- **پشتیبان‌گیری و بازیابی** — پشتیبان‌گیری و بازیابی کلیدهای هویت نود\n- **بررسی سلامت** — تشخیص جامع برای عیب‌یابی\n- **راهنما و اطلاعات** — راهنمای چندصفحه‌ای داخلی\n- **حذف کامل** — پاکسازی تمام فایل‌ها و تنظیمات\n\n## دستورات CLI\n\n### وضعیت و مانیتورینگ\n```bash\nconduit status       # نمایش وضعیت و مصرف منابع\nconduit stats        # داشبورد زنده (لحظه‌ای)\nconduit logs         # لاگ‌های داکر\nconduit health       # بررسی سلامت سیستم\nconduit peers        # ترافیک بر اساس کشور (GeoIP)\n```\n\n### مدیریت کانتینر\n```bash\nconduit start        # شروع تمام کانتینرها\nconduit stop         # توقف تمام کانتینرها\nconduit restart      # ریستارت تمام کانتینرها\nconduit update       # به‌روزرسانی به آخرین نسخه\n```\n\n### پیکربندی\n```bash\nconduit settings     # تغییر تنظیمات هر کانتینر\nconduit menu         # منوی تعاملی\n```\n\n### پشتیبان‌گیری و بازیابی\n```bash\nconduit backup       # پشتیبان‌گیری از کلیدهای نود\nconduit restore      # بازیابی کلیدهای نود از پشتیبان\n```\n\n### نگهداری\n```bash\nconduit uninstall    # حذف کامل\nconduit version      # نمایش نسخه\nconduit help         # راهنما\n```\n\n## منوی تعاملی\n\n| گزینه | توضیحات |\n|-------|---------|\n| **1** | داشبورد وضعیت — آمار لحظه‌ای با کلاینت‌های فعال و آپلود برتر |\n| **2** | آمار زنده اتصال — استریم آمار از لاگ داکر |\n| **3** | مشاهده لاگ — خروجی لاگ داکر |\n| **4** | ترافیک زنده به تفکیک کشور — جدول ترافیک با سرعت و تعداد کلاینت |\n| **5** | شروع کاندوییت |\n| **6** | توقف کاندوییت |\n| **7** | ریستارت کاندوییت |\n| **8** | به‌روزرسانی ایمیج |\n| **9** | تنظیمات و ابزارها — پهنای باند، پشتیبان‌گیری، بازیابی، بررسی سلامت، حذف نصب |\n| **c** | مدیریت کانتینرها — اضافه یا حذف (تا ۵) |\n| **a** | آمار پیشرفته — نمودار برترین کشورها |\n| **i** | راهنما — توضیحات ردیاب، آمار، کانتینرها، حریم خصوصی |\n| **0** | خروج |\n\n## تنظیمات\n\n| گزینه | پیش‌فرض | محدوده | توضیحات |\n|-------|---------|--------|---------|\n| `max-clients` | 200 | ۱–۱۰۰۰ | حداکثر کاربران همزمان برای هر کانتینر |\n| `bandwidth` | 5 | ۱–۴۰ یا ۱- | محدودیت پهنای باند (Mbps). برای نامحدود ۱- وارد کنید. |\n\n**مقادیر پیشنهادی بر اساس سخت‌افزار سرور:**\n\n| پردازنده | رم | کانتینر پیشنهادی | حداکثر کاربران (هر کانتینر) |\n|----------|-----|-------------------|----------------------------|\n| ۱ هسته | کمتر از ۱ گیگ | ۱ | ۱۰۰ |\n| ۲ هسته | ۲ گیگ | ۱–۲ | ۲۰۰ |\n| ۴ هسته | ۴ گیگ+ | ۲–۳ | ۴۰۰ |\n| ۸+ هسته | ۸ گیگ+ | ۳–۵ | ۸۰۰ |\n\n## ارتقا از نسخه 1.0.x\n\nفقط اسکریپت جدید را اجرا کنید. وقتی سوال پرسیده شد، گزینه **«Open management menu»** را انتخاب کنید. کانتینر موجود شما به صورت خودکار شناسایی می‌شود. نیازی به نصب مجدد نیست.\n\n## پیش‌نیازها\n\n- سرور لینوکس\n- دسترسی root یا sudo\n- اتصال اینترنت\n- حداقل ۵۱۲ مگابایت رم (۱ گیگ+ برای چند کانتینر پیشنهاد می‌شود)\n\n## نحوه عملکرد\n\n1. **تشخیص** — شناسایی توزیع لینوکس و سیستم init\n2. **نصب داکر** — در صورت نبود، داکر نصب می‌شود\n3. **بررسی سخت‌افزار** — تشخیص CPU و RAM و پیشنهاد تعداد کانتینر\n4. **راه‌اندازی کانتینر** — دانلود و اجرای ایمیج رسمی سایفون\n5. **پیکربندی سرویس** — تنظیم سرویس خودکار (systemd/OpenRC/SysVinit)\n6. **سرویس ردیاب** — شروع ردیاب ترافیک پس‌زمینه\n7. **نصب CLI** — ایجاد دستور مدیریت `conduit`\n\n## امنیت\n\n- **پشتیبان‌گیری امن**: کلیدهای هویت نود با دسترسی محدود (600) ذخیره می‌شوند\n- **بدون تلمتری**: هیچ داده‌ای جمع‌آوری یا ارسال نمی‌شود\n- **ردیابی محلی**: آمار ترافیک فقط به صورت محلی ذخیره شده و هرگز ارسال نمی‌شود\n\n\u003c/div\u003e\n\n---\n\n## License\n\nMIT License\n\n## Contributing\n\nPull requests welcome. For major changes, open an issue first.\n\n## Links\n\n- [Psiphon](https://psiphon.ca/)\n- [Psiphon Conduit](https://github.com/Psiphon-Inc/conduit)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamnet-dev%2Fconduit-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamnet-dev%2Fconduit-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamnet-dev%2Fconduit-manager/lists"}