Skip to content

polamgh/conduit-manager-mac

Repository files navigation

🌐 Psiphon Conduit Manager

macOS Edition

Help people in censored regions access the free internet.
Run a Psiphon Conduit proxy node on your Mac.

English · فارسی

macOS Docker Release


✨ Features

Feature Description
🖥️ Menu Bar App Native macOS app - Start/Stop with one click
📊 Live Stats See connected clients & traffic in real-time
🔒 Security Hardened Read-only filesystem, isolated network, seccomp
🐳 Docker Status Auto-detects if Docker is running
🌙 Dark Mode Works perfectly in light and dark mode
🎁 Rewards Easy QR code generation to claim node rewards

🚀 Quick Start

Step 1: Install Docker Desktop

Download from docker.com/products/docker-desktop

Step 2: Install Conduit Manager

curl -fsSL https://raw.githubusercontent.com/polamgh/conduit-manager-mac/main/install.sh | bash

Step 3: Run Setup

~/conduit-manager/conduit-mac.sh

Step 4: Configure

Step Press What it does
1️⃣ 7 Set your CPU & RAM limits
2️⃣ 6 Install the Conduit service
3️⃣ m Open the Menu Bar App

Done! Your node is now helping people access the free internet.


🖥️ Menu Bar App

The menu bar app gives you quick control without opening Terminal:

┌─────────────────────────────┐
│ ● Conduit: Running          │
│ Clients: 5 connected        │
│ Traffic: ↑ 1.2 GB  ↓ 3.4 GB │
├─────────────────────────────┤
│ ↻ Restart                   │
│ ■ Stop                      │
├─────────────────────────────┤
│ Open Terminal Manager...    │
│ Path: ~/conduit-manager/... │
├─────────────────────────────┤
│ Quit                        │
└─────────────────────────────┘

Menu Bar Icons

Icon Meaning
🌐 (filled) Conduit is running
🌐 (outline) Conduit is stopped
⚠️ (warning) Docker is not running

Start at Login

System Settings → General → Login Items → Add Conduit.app


⌨️ CLI Menu Options

╔═══════════════════════════════════════╗
║      PSIPHON CONDUIT MANAGER          ║
╚═══════════════════════════════════════╝

 Service
   1. ▶  Start / Restart
   2. ⏹  Stop Service
   3. 📊 Live Dashboard
   4. 📜 View Logs
   5. 🩺 Health Check

 Configuration
   6. ⚙  Reconfigure
   7. 📈 Resource Limits
   8. 🔒 Security Settings
   9. 🆔 Node Identity
   c. 🎁 Claim Rewards

 Backup & Maintenance
   b. 💾 Backup Key
   r. 📥 Restore Key
   u. 🔄 Check for Updates
   x. 🗑  Uninstall

 Menu Bar App
   m. 🖥  Open Menu Bar App

   0. 🚪 Exit

🔒 Security

Your Mac is fully protected:

Protection What it means
📁 Read-only filesystem Container can't write to your disk
🌐 Isolated network No access to your local network
⬇️ Dropped capabilities Minimal Linux privileges
📊 Resource limits CPU & RAM are capped
🛡️ Seccomp filtering Dangerous syscalls blocked

🗑️ Uninstall

Easy way: Press x in the CLI menu

Manual way:

docker stop conduit-mac && docker rm conduit-mac
docker volume rm conduit-data
docker network rm conduit-network
rm -rf ~/conduit-manager ~/.conduit-*

🚀 نصب سریع

مرحله ۱: نصب Docker Desktop

از docker.com/products/docker-desktop دانلود کنید

مرحله ۲: نصب Conduit Manager

curl -fsSL https://raw.githubusercontent.com/polamgh/conduit-manager-mac/main/install.sh | bash

مرحله ۳: اجرای برنامه

~/conduit-manager/conduit-mac.sh

مرحله ۴: پیکربندی

مرحله کلید توضیح
۱ 7 تنظیم محدودیت CPU و RAM
۲ 6 نصب سرویس Conduit
۳ m باز کردن برنامه Menu Bar

تمام! نود شما اکنون فعال است و به دیگران کمک می‌کند.


🖥️ برنامه Menu Bar

کنترل سریع بدون نیاز به Terminal:

┌─────────────────────────────┐
│ ● Conduit: Running          │  ← وضعیت
│ Clients: 5 connected        │  ← تعداد کاربران
│ Traffic: ↑ 1.2 GB  ↓ 3.4 GB │  ← ترافیک
├─────────────────────────────┤
│ ↻ Restart                   │  ← ریستارت
│ ■ Stop                      │  ← توقف
└─────────────────────────────┘

آیکون‌های Menu Bar

آیکون معنی
🌐 (پر) Conduit در حال اجراست
🌐 (خالی) Conduit متوقف است
⚠️ (هشدار) Docker اجرا نیست

🔒 امنیت

مک شما کاملاً محافظت شده است:

محافظت توضیح
📁 فایل‌سیستم فقط‌خواندنی کانتینر نمی‌تواند روی دیسک بنویسد
🌐 شبکه ایزوله دسترسی به شبکه محلی ندارد
⬇️ امتیازات محدود حداقل دسترسی‌های لینوکس
📊 محدودیت منابع CPU و RAM محدود شده

🗑️ حذف برنامه

روش آسان: در منوی CLI کلید x را بزنید

روش دستی:

docker stop conduit-mac && docker rm conduit-mac
docker volume rm conduit-data
docker network rm conduit-network
rm -rf ~/conduit-manager ~/.conduit-*

🙏 Credits

📄 License

MIT

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •