Psiphon Conduit Manager

macOS Edition • v2.1.1

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

Quick Start • Security • Features • فارسی

---

Dashboard with real-time stats, Node IDs, and QR codes for rewards

---

⚡ Quick Start

1. Install Docker Desktop

Download from docker.com/products/docker-desktop

2. Install Conduit Manager

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

3. Run & Configure

~/conduit-manager/conduit-mac.sh

Press 7 → Set limits • Press 6 → Install • Press m → Open Menu Bar App

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

---

🛡️ Security

Your Mac is Fully Protected

Running Conduit in Docker provides complete isolation. The container:

• 🔒 Cannot access your files - Read-only filesystem
• 🌐 Cannot see your network - Isolated bridge network
• ⬇️ Has minimal privileges - All capabilities dropped
• 📊 Is resource-limited - CPU & RAM capped to your settings
• 🛑 Cannot make dangerous calls - Seccomp syscall filtering
• 🚫 Cannot escalate privileges - No root access possible
• ✅ Verified images - Docker image digest verification
• ✅ Safe updates - Content validation before install

Why Docker Instead of a Native App?

A regular macOS app runs directly on your system with access to your files, network, and other apps. If it has a bug or gets compromised, your entire system is at risk.

Docker creates an isolated sandbox:

Native App	Docker Container
❌ Full access to your files	✅ Cannot see your files
❌ Can see all network traffic	✅ Isolated network bridge
❌ Can install software	✅ Read-only filesystem
❌ Runs with your permissions	✅ Minimal privileges only
❌ May leave traces after uninstall	✅ Clean removal, no traces

Bottom line: Even if the Conduit software had a security vulnerability, it cannot escape the Docker sandbox to harm your Mac.

---

🖥️ Menu Bar & CLI

    

Menu Bar: Quick status  •  CLI: Full configuration

---

✨ Features

Feature	Description
Multi-Container	Run up to 5 Conduit nodes simultaneously
Dashboard	Full stats with Node IDs and QR codes
Menu Bar App	Native macOS status at a glance
Live Stats	Connected clients & traffic in real-time
QR Codes	Scan to claim rewards in Ryve app
Backup/Restore	Never lose your Node ID
Auto-Updates	One-click updates with verification

---

📦 Multi-Container

Run multiple nodes via Container Manager (option 9):

═══ CONTAINER MANAGER ═══

  NAME              STATUS     CLIENTS
  conduit-mac       Running    33
  conduit-mac-2     Running    13
  conduit-mac-3     Running    9

Each container has its own Node ID and rewards tracking.

---

❓ FAQ

Will updating lose my Node ID?

No. Your Node ID is in a Docker volume, preserved during updates.

How do I backup my Node ID?

Press b in CLI. Backups go to ~/.conduit-backups/

Is this safe?

Yes. Docker provides complete isolation. See Security.

---

🗑️ Uninstall

Press x in the CLI menu, or:

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

---

Credits

• Psiphon - Conduit project
• SamNet-dev/conduit-manager - Original script

---

نصب برای ایرانیان خارج از کشور

چرا Docker؟

برنامه‌های معمولی مستقیماً روی سیستم اجرا می‌شوند و به همه فایل‌ها دسترسی دارند. اما Docker یک "جعبه امن" ایجاد می‌کند - حتی اگر برنامه مشکل امنیتی داشته باشد، نمی‌تواند به سیستم شما آسیب برساند.

نصب

۱. Docker Desktop را نصب کنید

۲. در Terminal اجرا کنید:

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

۳. کلید 7 → 6 → m

---

#FreeIran 🕊️

Every node helps someone access the free internet

---

MIT License