516 lines
13 KiB
Markdown
516 lines
13 KiB
Markdown
# 💻 macOS Client Configuration Guide
|
||
|
||
> 🍎 Professional proxy client configuration solutions for Mac users, covering detailed usage tutorials for both free open-source and commercial paid applications.
|
||
|
||
## 🌟 Recommended Clients
|
||
|
||
### 🆓 Free Open Source Applications
|
||
|
||
| Client | Type | Key Features | Rating | Tutorial |
|
||
|--------|------|--------------|--------|----------|
|
||
| [⚔️ Clash Verge](clash-verge.md) | Open Source | Modern interface, rich features | ⭐⭐⭐⭐⭐ | [Setup Guide](clash-verge.md) |
|
||
| [👑 ClashX Pro](clashx-pro.md) | Enhanced | Professional version based on ClashX | ⭐⭐⭐⭐ | [Setup Guide](clashx-pro.md) |
|
||
|
||
### 💰 Commercial Paid Applications
|
||
|
||
| Client | Price | Key Features | Rating | Tutorial |
|
||
|--------|-------|--------------|--------|----------|
|
||
| [🌊 Surge Pro](surge-pro.md) | $99.99 | Enterprise-grade features, professional tools | ⭐⭐⭐⭐⭐ | [Setup Guide](surge-pro.md) |
|
||
|
||
---
|
||
|
||
## 🎯 Selection Guide
|
||
|
||
### 🆕 New Users
|
||
|
||
#### Recommended: Clash Verge
|
||
|
||
- ✅ Completely free and open source
|
||
- ✅ Modern and beautiful interface
|
||
- ✅ Comprehensive and user-friendly features
|
||
- ✅ Active community support
|
||
- ✅ Regular updates and maintenance
|
||
- ✅ Native Apple Silicon support
|
||
|
||
### 🔧 Advanced Users
|
||
|
||
#### Recommended: ClashX Pro
|
||
|
||
- ✅ Based on mature ClashX foundation
|
||
- ✅ More powerful feature set
|
||
- ✅ Rich configuration options
|
||
- ✅ Optimized performance
|
||
- ✅ Professional debugging tools
|
||
- ✅ Extended protocol support
|
||
|
||
### 💼 Professional Users
|
||
|
||
#### Recommended: Surge Pro
|
||
|
||
- ✅ Industry benchmark product
|
||
- ✅ Most comprehensive feature set
|
||
- ✅ Enterprise-grade stability
|
||
- ✅ Professional technical support
|
||
- ✅ Advanced network analysis tools
|
||
- ❌ Premium pricing ($99.99)
|
||
|
||
---
|
||
|
||
## 📊 Feature Comparison
|
||
|
||
| Feature | Clash Verge | ClashX Pro | Surge Pro |
|
||
|---------|-------------|------------|-----------|
|
||
| 🏷️ **Price** | Free | Free | $99.99 |
|
||
| 🎨 **Interface Design** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ |
|
||
| 🚀 **Performance** | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
|
||
| 🔧 **Feature Richness** | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
|
||
| 🛡️ **Stability** | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
|
||
| 📚 **Learning Curve** | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
|
||
| 🔄 **Update Frequency** | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ |
|
||
|
||
## 🛠️ Protocol Support Matrix
|
||
|
||
| Protocol | Clash Verge | ClashX Pro | Surge Pro |
|
||
|----------|-------------|------------|-----------|
|
||
| 🔒 **Shadowsocks** | ✅ | ✅ | ✅ |
|
||
| 🌟 **VMess** | ✅ | ✅ | ✅ |
|
||
| 🛡️ **VLESS** | ✅ | ✅ | ❌ |
|
||
| 🗡️ **Trojan** | ✅ | ✅ | ✅ |
|
||
| 📡 **ShadowsocksR** | ❌ | ✅ | ❌ |
|
||
| 🌐 **HTTP/HTTPS** | ✅ | ✅ | ✅ |
|
||
| 🧦 **SOCKS** | ✅ | ✅ | ✅ |
|
||
| 🚀 **Hysteria** | ✅ | ✅ | ❌ |
|
||
| 🐚 **Snell** | ❌ | ❌ | ✅ |
|
||
|
||
---
|
||
|
||
## 🔧 System Requirements
|
||
|
||
### 📋 Minimum Configuration
|
||
|
||
- **Operating System**: macOS 10.12 Sierra and above
|
||
- **Processor**: Intel x64 or Apple Silicon (M1/M2/M3)
|
||
- **Memory**: 4GB RAM (8GB or more recommended)
|
||
- **Storage**: 200MB available space
|
||
- **Network**: Stable internet connection
|
||
- **Xcode Tools**: Command Line Tools (for some features)
|
||
|
||
### 🎯 Recommended Configuration
|
||
|
||
- **Operating System**: macOS 12 Monterey or later
|
||
- **Processor**: Apple Silicon M1/M2/M3 or Intel Core i5 and above
|
||
- **Memory**: 8GB RAM or more
|
||
- **Storage**: 1GB available space (for logs and cache)
|
||
- **Graphics**: Metal-compatible GPU (for UI acceleration)
|
||
- **Network**: Broadband connection with low latency
|
||
|
||
---
|
||
|
||
## 🍎 Apple Silicon Compatibility
|
||
|
||
### 🚀 Native Support Status
|
||
|
||
| Client | Intel (x86_64) | Apple Silicon (ARM64) | Rosetta 2 |
|
||
|--------|----------------|----------------------|-----------|
|
||
| **Clash Verge** | ✅ Native | ✅ Native | ✅ |
|
||
| **ClashX Pro** | ✅ Native | ✅ Native | ✅ |
|
||
| **Surge Pro** | ✅ Native | ✅ Native | ✅ |
|
||
|
||
### ⚡ Performance Considerations
|
||
|
||
#### Apple Silicon Benefits
|
||
|
||
- **Energy Efficiency**: Longer battery life on MacBooks
|
||
- **Performance**: Superior CPU and memory performance
|
||
- **Heat Management**: Lower thermal output
|
||
- **Integration**: Better macOS system integration
|
||
|
||
#### Intel Mac Considerations
|
||
|
||
- **Legacy Support**: Full compatibility with older software
|
||
- **x86_64 Optimization**: Mature optimization for Intel architecture
|
||
- **Bootcamp Support**: Windows dual-boot capabilities
|
||
- **Virtual Machines**: Better VM performance for x86 systems
|
||
|
||
---
|
||
|
||
## 🎯 Use Case Scenarios
|
||
|
||
### 📱 Daily Browsing & Work
|
||
|
||
**Best Choice**: Clash Verge
|
||
|
||
- Intuitive interface for daily use
|
||
- Automatic rule-based routing
|
||
- Low resource consumption
|
||
- Seamless macOS integration
|
||
|
||
### 🎮 Gaming & Streaming
|
||
|
||
**Best Choice**: ClashX Pro
|
||
|
||
- Game-optimized routing rules
|
||
- Low-latency connection modes
|
||
- Custom protocol support
|
||
- Real-time performance monitoring
|
||
|
||
### 💼 Professional Development
|
||
|
||
**Best Choice**: Surge Pro
|
||
|
||
- Advanced debugging capabilities
|
||
- Comprehensive network analysis
|
||
- MitM functionality for development
|
||
- Professional scripting support
|
||
|
||
### 🏢 Enterprise Deployment
|
||
|
||
**Best Choice**: Surge Pro
|
||
|
||
- Enterprise-grade stability
|
||
- Centralized management capabilities
|
||
- Detailed logging and monitoring
|
||
- Professional support services
|
||
|
||
---
|
||
|
||
## 📚 Quick Navigation
|
||
|
||
### 📖 Configuration Tutorials
|
||
|
||
- [⚔️ Clash Verge Modern Client](clash-verge.md)
|
||
- [👑 ClashX Pro Enhanced Version](clashx-pro.md)
|
||
- [🌊 Surge Pro Enterprise Solution](surge-pro.md)
|
||
|
||
### 🆘 Support Resources
|
||
|
||
- [❓ Common Issues & Solutions](#-common-issues)
|
||
- [🔧 Installation Guide](#-installation-guide)
|
||
- [🛡️ Security Configuration](#️-security-best-practices)
|
||
- [⚡ Performance Optimization](#-performance-optimization)
|
||
|
||
---
|
||
|
||
## 🔧 Installation Guide
|
||
|
||
### 📥 Installation Methods
|
||
|
||
#### App Store Installation (Surge Pro)
|
||
|
||
1. **Purchase & Download**
|
||
- Visit Mac App Store
|
||
- Search for "Surge 5"
|
||
- Purchase and install normally
|
||
|
||
2. **First Launch Setup**
|
||
- Grant network extension permissions
|
||
- Configure basic proxy settings
|
||
- Import initial configuration
|
||
|
||
#### Manual Installation (Open Source Apps)
|
||
|
||
1. **Download from Official Sources**
|
||
- Visit official GitHub releases
|
||
- Download appropriate architecture version
|
||
- Verify file integrity if checksums provided
|
||
|
||
2. **Installation Process**
|
||
```bash
|
||
# Extract downloaded archive
|
||
unzip clash-verge-macos.zip
|
||
|
||
# Move to Applications folder
|
||
mv "Clash Verge.app" /Applications/
|
||
|
||
# Grant execution permissions
|
||
xattr -cr "/Applications/Clash Verge.app"
|
||
```
|
||
|
||
3. **Security Permissions**
|
||
- System Preferences → Security & Privacy
|
||
- Allow application in "General" tab
|
||
- Grant network extension permissions
|
||
|
||
### 🛡️ macOS Security Considerations
|
||
|
||
#### Gatekeeper
|
||
|
||
```bash
|
||
# Remove quarantine attribute if needed
|
||
sudo xattr -r -d com.apple.quarantine "/Applications/App Name.app"
|
||
|
||
# Allow unsigned applications (not recommended)
|
||
sudo spctl --master-disable
|
||
```
|
||
|
||
#### System Integrity Protection (SIP)
|
||
|
||
- Most proxy clients work with SIP enabled
|
||
- Some advanced features may require SIP adjustments
|
||
- Only modify SIP if absolutely necessary
|
||
|
||
---
|
||
|
||
## ❓ Common Issues
|
||
|
||
### 🔧 Installation Problems
|
||
|
||
**Q: App won't open due to security restrictions?**
|
||
|
||
A: Solutions:
|
||
|
||
1. Right-click app → "Open" → Confirm
|
||
2. System Preferences → Security → "Open Anyway"
|
||
3. Remove quarantine attribute via Terminal
|
||
4. Check for code signing issues
|
||
|
||
**Q: Network extension won't load?**
|
||
|
||
A: Troubleshooting:
|
||
|
||
1. System Preferences → Network → Reset network settings
|
||
2. Clear network extension cache
|
||
3. Restart and try again
|
||
4. Check for conflicting VPN software
|
||
|
||
### 🌐 Connection Issues
|
||
|
||
**Q: Proxy doesn't work with specific applications?**
|
||
|
||
A: Solutions:
|
||
|
||
1. Configure application-specific proxy settings
|
||
2. Use system-wide proxy mode
|
||
3. Check for application proxy exclusions
|
||
4. Verify rule-based routing configuration
|
||
|
||
**Q: DNS resolution problems?**
|
||
|
||
A: Fixes:
|
||
|
||
1. Configure custom DNS servers
|
||
2. Clear DNS cache: `sudo dscacheutil -flushcache`
|
||
3. Reset network configuration
|
||
4. Check for DNS leaks
|
||
|
||
### 🍎 macOS-Specific Issues
|
||
|
||
**Q: App breaks after macOS update?**
|
||
|
||
A: Recovery steps:
|
||
|
||
1. Update to latest app version
|
||
2. Reconfigure network permissions
|
||
3. Reset network extension settings
|
||
4. Reinstall if necessary
|
||
|
||
---
|
||
|
||
## 🛡️ Security Best Practices
|
||
|
||
### 🔐 Application Security
|
||
|
||
#### Code Signing Verification
|
||
|
||
```bash
|
||
# Verify application signature
|
||
codesign --verify --verbose "/Applications/App Name.app"
|
||
|
||
# Check for valid certificate
|
||
spctl --assess --verbose "/Applications/App Name.app"
|
||
```
|
||
|
||
#### Permission Management
|
||
|
||
1. **Network Extensions**
|
||
- Grant only necessary permissions
|
||
- Regularly review granted permissions
|
||
- Monitor network activity
|
||
|
||
2. **File System Access**
|
||
- Limit configuration file access
|
||
- Use secure storage for credentials
|
||
- Regular permission audits
|
||
|
||
### 🛡️ Network Security
|
||
|
||
#### Traffic Analysis
|
||
|
||
1. **Built-in Monitoring**
|
||
- Use app's traffic monitoring features
|
||
- Monitor connection patterns
|
||
- Check for unusual activity
|
||
|
||
2. **System-Level Monitoring**
|
||
```bash
|
||
# Monitor network connections
|
||
sudo lsof -i
|
||
|
||
# Check active network interfaces
|
||
ifconfig
|
||
|
||
# Monitor real-time traffic
|
||
sudo tcpdump -i en0
|
||
```
|
||
|
||
#### DNS Security
|
||
|
||
1. **Secure DNS Configuration**
|
||
- Use trusted DNS providers
|
||
- Enable DNS over HTTPS/TLS
|
||
- Monitor DNS queries for leaks
|
||
|
||
2. **DNS Leak Prevention**
|
||
- Configure proper DNS routing
|
||
- Use VPN-aware DNS settings
|
||
- Regular DNS leak testing
|
||
|
||
---
|
||
|
||
## ⚡ Performance Optimization
|
||
|
||
### 🚀 System-Level Optimization
|
||
|
||
#### macOS Performance Settings
|
||
|
||
1. **Energy Saver Settings**
|
||
- Disable "Put hard disks to sleep"
|
||
- Prevent computer from sleeping automatically
|
||
- Optimize for performance over battery life
|
||
|
||
2. **Network Configuration**
|
||
```bash
|
||
# Optimize network buffer sizes
|
||
sudo sysctl -w net.inet.tcp.sendspace=65536
|
||
sudo sysctl -w net.inet.tcp.recvspace=65536
|
||
|
||
# Adjust connection limits
|
||
sudo sysctl -w kern.ipc.somaxconn=1024
|
||
```
|
||
|
||
#### Resource Management
|
||
|
||
1. **Memory Optimization**
|
||
- Monitor memory pressure
|
||
- Close unnecessary applications
|
||
- Configure appropriate cache sizes
|
||
|
||
2. **CPU Optimization**
|
||
- Use Activity Monitor to identify bottlenecks
|
||
- Adjust process priorities if needed
|
||
- Monitor thermal throttling
|
||
|
||
### 📊 Application-Specific Tuning
|
||
|
||
#### Connection Pool Settings
|
||
|
||
```yaml
|
||
# Example configuration for optimal performance
|
||
pool:
|
||
max-idle-connections: 100
|
||
max-connections-per-host: 10
|
||
keep-alive-timeout: 90s
|
||
connection-timeout: 30s
|
||
```
|
||
|
||
#### Rule Engine Optimization
|
||
|
||
1. **Rule Ordering**
|
||
- Place most frequently matched rules first
|
||
- Use efficient pattern matching
|
||
- Minimize regex usage where possible
|
||
|
||
2. **Caching Strategy**
|
||
- Enable DNS caching
|
||
- Configure appropriate cache TTL
|
||
- Use connection pooling
|
||
|
||
---
|
||
|
||
## 💡 Advanced Features
|
||
|
||
### 🎯 Automation & Integration
|
||
|
||
#### AppleScript Integration
|
||
|
||
```applescript
|
||
-- Example: Toggle proxy state
|
||
tell application "Clash Verge"
|
||
if (proxy state is enabled) then
|
||
disable proxy
|
||
else
|
||
enable proxy
|
||
end if
|
||
end tell
|
||
```
|
||
|
||
#### Shortcuts App Integration
|
||
|
||
1. **Create Automation Shortcuts**
|
||
- Location-based proxy switching
|
||
- Time-based configuration changes
|
||
- Network-aware rule activation
|
||
|
||
2. **Siri Integration**
|
||
- Voice commands for proxy control
|
||
- Status checking via voice
|
||
- Quick configuration switching
|
||
|
||
#### Command Line Tools
|
||
|
||
```bash
|
||
# Example CLI operations
|
||
clash-verge --config work.yaml --daemon
|
||
clash-verge --stop
|
||
clash-verge --status
|
||
```
|
||
|
||
### 📊 Monitoring & Analytics
|
||
|
||
#### Built-in Analytics
|
||
|
||
1. **Traffic Analysis**
|
||
- Real-time bandwidth monitoring
|
||
- Historical usage patterns
|
||
- Application-specific statistics
|
||
|
||
2. **Connection Quality**
|
||
- Latency monitoring
|
||
- Connection success rates
|
||
- Server performance metrics
|
||
|
||
#### External Monitoring Tools
|
||
|
||
```bash
|
||
# Network monitoring tools
|
||
brew install iftop
|
||
brew install nethogs
|
||
brew install bandwhich
|
||
|
||
# Usage examples
|
||
sudo iftop -i en0
|
||
sudo nethogs
|
||
bandwhich
|
||
```
|
||
|
||
---
|
||
|
||
## 🔗 Additional Resources
|
||
|
||
### 📚 Documentation Links
|
||
|
||
- [Apple Developer Network Extensions](https://developer.apple.com/documentation/networkextension)
|
||
- [macOS Security Documentation](https://support.apple.com/guide/security/)
|
||
- [macOS Network Configuration](https://support.apple.com/guide/system-preferences/network/)
|
||
|
||
### 💬 Community Support
|
||
|
||
- [ClashX GitHub Issues](https://github.com/yichengchen/clashX)
|
||
- [Clash Verge Discussions](https://github.com/zzzgydi/clash-verge)
|
||
- [Surge Community Forum](https://community.nssurge.com/)
|
||
|
||
---
|
||
|
||
> 📅 Last Updated: July 10, 2025 | 🍎 macOS 10.12+ | 💻 Intel/Apple Silicon | 🔄 Version: 3.0.0
|
||
|