Update Docs
This commit is contained in:
web@ppanel
+514
-1
@@ -1,2 +1,515 @@
|
||||
# macOS
|
||||
# 💻 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
|
||||
|
||||
|
||||
@@ -45,4 +45,4 @@ Starting from macOS 10.15, due to enhanced system security, you may receive "Dev
|
||||
|
||||
---
|
||||
|
||||
*Document Updated: 2024.11.17*
|
||||
> 📅 Last Updated: July 10, 2025 | ⚔️ Applicable Version: Clash Verge 1.7.7
|
||||
|
||||
+241
-28
@@ -1,45 +1,258 @@
|
||||
# ClashX Pro
|
||||
# 🛡️ ClashX Pro Configuration Guide
|
||||
|
||||
[ClashX Pro](https://clashxhub.com/apps/ClashXPro.dmg) is a modern macOS proxy tool that supports:
|
||||
## 📱 Software Overview
|
||||
|
||||
- Shadowsocks (SS)
|
||||
- V2Ray (VMess)
|
||||
- Trojan
|
||||
- HTTP/HTTPS
|
||||
- SOCKS5
|
||||
- SOCKS5 over TLS
|
||||
**ClashX Pro** is a powerful macOS proxy software designed specifically for Mac users as a modern network proxy tool. It features an intuitive user interface and rich functionality, supporting multiple proxy protocols to provide users with stable and efficient network proxy services.
|
||||
|
||||
## Download
|
||||
### ✨ Key Features
|
||||
|
||||
[Download Address 1](https://clashxhub.com/apps/ClashXPro.dmg)
|
||||
| Feature | Description |
|
||||
|---------|-------------|
|
||||
| 🔒 **Multi-Protocol Support** | Shadowsocks (SS), V2Ray (VMess), Trojan, HTTP/HTTPS, SOCKS5, SOCKS5 over TLS |
|
||||
| 🎯 **Smart Routing** | Rule-based traffic splitting, geo-location routing, domain matching, etc. |
|
||||
| 📊 **Real-time Monitoring** | Traffic statistics, connection monitoring, node latency testing |
|
||||
| 🔄 **Auto Update** | Subscription link auto-update for node information |
|
||||
| 🛠️ **Advanced Configuration** | Custom rules, proxy chains, load balancing, etc. |
|
||||
| 🖥️ **System Integration** | Native macOS design with system proxy settings support |
|
||||
|
||||
[Download Address 2](https://dl.haojichang.com/apps/ClashX_Pro/ClashXPro.dmg)
|
||||
### 🔧 System Requirements
|
||||
|
||||
[Download Address 3](https://krakenfiles.com/view/5RdlIY2HKL/file.html)
|
||||
| Item | Requirement |
|
||||
|------|-------------|
|
||||
| **Operating System** | macOS 10.15 or higher |
|
||||
| **Device Type** | MacBook, iMac, Mac Pro, Mac mini |
|
||||
| **Network Environment** | Stable internet connection |
|
||||
| **Storage Space** | At least 50MB available space |
|
||||
|
||||
## Requirements
|
||||
## 📥 Software Download
|
||||
|
||||
> ⚠️ System Requirements
|
||||
### 🌐 Official Download Links
|
||||
|
||||
- Operating System: macOS 10.5 or higher
|
||||
- Software Version: ClashX Pro for macOS
|
||||
- Compatible Devices: MacBook / iMac / Mac Pro
|
||||
| Download Source | Link | Notes |
|
||||
|----------------|------|-------|
|
||||
| **Official Site** | [ClashX Pro Official](https://clashxhub.com/apps/ClashXPro.dmg) | Recommended |
|
||||
| **Backup Address 1** | [Backup Download](https://dl.haojichang.com/apps/ClashX_Pro/ClashXPro.dmg) | Stable and reliable |
|
||||
| **Backup Address 2** | [KrakenFiles](https://krakenfiles.com/view/5RdlIY2HKL/file.html) | International server |
|
||||
|
||||
## Configuration Guide
|
||||
> 💡 **Download Tips**: We recommend downloading from the official address to ensure software security and feature completeness.
|
||||
|
||||
### 1. Software Installation
|
||||
## ⚙️ Detailed Configuration Tutorial
|
||||
|
||||
### 📋 Prerequisites
|
||||
|
||||
Before starting configuration, please ensure you have:
|
||||
|
||||
- ✅ Downloaded and installed ClashX Pro
|
||||
- ✅ Obtained a valid proxy service subscription link or configuration file
|
||||
- ✅ Verified normal network connectivity
|
||||
|
||||
### 🔧 Step One: Software Installation
|
||||
|
||||
#### 1.1 Download Installation Package
|
||||
|
||||
Obtain the ClashX Pro installation package from the download addresses above.
|
||||
|
||||
|
||||
|
||||
#### 1.2 Install Software
|
||||
|
||||
1. Double-click the downloaded `.dmg` file
|
||||
2. Drag ClashX Pro to the Applications folder
|
||||
3. Wait for installation to complete
|
||||
|
||||
|
||||
|
||||
#### 1.3 First Launch
|
||||
|
||||
1. Launch ClashX Pro from the Applications folder
|
||||
2. System may show security warning, click "Open"
|
||||
3. Software will display an icon in the menu bar
|
||||
|
||||
|
||||
|
||||
### 🌐 Step Two: Import Configuration
|
||||
|
||||
#### 2.1 Access Configuration Menu
|
||||
|
||||
1. Click the ClashX Pro icon in the menu bar
|
||||
2. Select "Config" option
|
||||
3. Enter configuration management interface
|
||||
|
||||
|
||||
|
||||
#### 2.2 Add Subscription Link
|
||||
|
||||
1. Click "Add" button in the configuration interface
|
||||
2. Select "Import from URL"
|
||||
3. Paste your subscription link
|
||||
|
||||
|
||||
|
||||
#### 2.3 Configuration Verification
|
||||
|
||||
1. Wait for configuration file download to complete
|
||||
2. System will automatically verify configuration file format
|
||||
3. Confirm configuration information is correct
|
||||
|
||||
|
||||
|
||||
#### 2.4 Enable Proxy
|
||||
|
||||
1. Select the newly imported configuration file
|
||||
2. Click "Set as System Proxy"
|
||||
3. Proxy service is now officially enabled
|
||||
|
||||
|
||||
|
||||
### 🚀 Step Three: Advanced Configuration
|
||||
|
||||
#### 3.1 Node Selection
|
||||
|
||||
- **Auto Select**: Let software automatically choose optimal node
|
||||
- **Manual Select**: Manually select specific node as needed
|
||||
- **Load Balancing**: Distribute traffic across multiple nodes
|
||||
|
||||
#### 3.2 Rule Configuration
|
||||
|
||||
- **Global Mode**: All traffic through proxy
|
||||
- **Rule Mode**: Traffic splitting according to preset rules
|
||||
- **Direct Mode**: No proxy usage
|
||||
|
||||
#### 3.3 Custom Rules
|
||||
|
||||
```yaml
|
||||
# Example rule configuration
|
||||
rules:
|
||||
- DOMAIN-SUFFIX,google.com,PROXY
|
||||
- DOMAIN-SUFFIX,github.com,PROXY
|
||||
- DOMAIN-KEYWORD,google,PROXY
|
||||
- GEOIP,CN,DIRECT
|
||||
```
|
||||
|
||||
## 📊 Feature Details
|
||||
|
||||
### 🔍 Real-time Monitoring
|
||||
|
||||
| Feature | Description |
|
||||
|---------|-------------|
|
||||
| **Traffic Statistics** | View real-time upload/download speed and cumulative traffic |
|
||||
| **Connection Monitoring** | Monitor current active connection count |
|
||||
| **Latency Testing** | Test response latency of various nodes |
|
||||
| **Log Viewing** | View detailed connection log information |
|
||||
|
||||
### 🛠️ Advanced Features
|
||||
|
||||
| Feature | Description |
|
||||
|---------|-------------|
|
||||
| **Auto Update** | Automatically update subscription configurations at scheduled intervals |
|
||||
| **Auto Start** | Automatically run when system starts |
|
||||
| **System Proxy** | Automatically configure system proxy settings |
|
||||
| **Rule Editing** | Customize traffic splitting rules |
|
||||
|
||||
## ❓ Frequently Asked Questions
|
||||
|
||||
### 🔧 Installation Issues
|
||||
|
||||
**Q: Software cannot install or launch?**
|
||||
|
||||
A: Solutions:
|
||||
|
||||
1. Check if macOS version meets requirements
|
||||
2. Allow app to run in "System Preferences" → "Security & Privacy"
|
||||
3. Try right-clicking app icon and select "Open"
|
||||
|
||||
**Q: Prompt "From unidentified developer"?**
|
||||
|
||||
A: Solution steps:
|
||||
|
||||
1. Hold Control key and click app icon
|
||||
2. Select "Open" from shortcut menu
|
||||
3. Click "Open" in the popup dialog
|
||||
|
||||
### 🌐 Connection Issues
|
||||
|
||||
**Q: Cannot connect after importing configuration?**
|
||||
|
||||
A: Checklist:
|
||||
|
||||
1. ✅ Confirm subscription link is valid and not expired
|
||||
2. ✅ Check network connection is normal
|
||||
3. ✅ Verify configuration file format is correct
|
||||
4. ✅ Try switching to different nodes
|
||||
|
||||
**Q: Slow speed or frequent disconnections?**
|
||||
|
||||
A: Optimization suggestions:
|
||||
|
||||
1. 🔄 Select nodes with lower latency
|
||||
2. 🎯 Adjust proxy mode (Rule/Global)
|
||||
3. 📊 Check local network conditions
|
||||
4. 🔧 Try different encryption protocols
|
||||
|
||||
### ⚙️ Configuration Issues
|
||||
|
||||
**Q: How to update subscription configuration?**
|
||||
|
||||
A: Update steps:
|
||||
|
||||
1. Click menu bar icon
|
||||
2. Select "Config" → "Update"
|
||||
3. Wait for configuration file to auto-update
|
||||
|
||||
**Q: How to backup configuration?**
|
||||
|
||||
A: Backup method:
|
||||
|
||||
1. Export current configuration file
|
||||
2. Save to a secure location
|
||||
3. Re-import when needed
|
||||
|
||||
## 💡 Best Practices
|
||||
|
||||
### 🎯 Usage Recommendations
|
||||
|
||||
1. **Choose Proxy Mode Wisely**
|
||||
- "Rule Mode" recommended for daily use
|
||||
- "Global Mode" for special needs
|
||||
- "Direct Mode" for debugging
|
||||
|
||||
2. **Regular Maintenance**
|
||||
- Update subscription configuration weekly
|
||||
- Clean log files regularly
|
||||
- Update software version timely
|
||||
|
||||
3. **Security Considerations**
|
||||
- Use trusted proxy service providers
|
||||
- Change passwords and configurations regularly
|
||||
- Avoid usage on public networks
|
||||
|
||||
### ⚡ Performance Optimization
|
||||
|
||||
| Optimization Item | Recommendation |
|
||||
|------------------|----------------|
|
||||
| **Node Selection** | Choose geographically closer nodes with lower latency |
|
||||
| **Connection Limit** | Adjust maximum connections according to needs |
|
||||
| **DNS Configuration** | Use reliable DNS servers |
|
||||
| **Cache Settings** | Adjust cache size appropriately |
|
||||
|
||||
## 🔗 Related Resources
|
||||
|
||||
### 📚 Official Documentation
|
||||
|
||||
- [ClashX Pro Official Website](https://clashxhub.com/)
|
||||
- [Clash Core Documentation](https://github.com/Dreamacro/clash)
|
||||
- [Configuration File Format Guide](https://github.com/Dreamacro/clash/wiki/configuration)
|
||||
|
||||
### 🛠️ Recommended Tools
|
||||
|
||||
- **Configuration Converter**: [Online Converter](https://acl4ssr.netlify.app/)
|
||||
- **Rule Subscription**: [ACL4SSR Rules](https://github.com/ACL4SSR/ACL4SSR)
|
||||
- **Node Testing**: Built-in latency testing functionality
|
||||
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
### 2. Import Configuration
|
||||
> � Last Updated: July 10, 2025 | 🛡️ Applicable Version: ClashX Pro 1.118.0
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
*Document Updated: 2024.11.17*
|
||||
*For questions or technical support, please refer to the FAQ section or contact relevant technical personnel.*
|
||||
|
||||
+133
-25
@@ -1,37 +1,145 @@
|
||||
# Surge for macOS
|
||||
# 🌊 Surge for macOS Professional Configuration Guide
|
||||
|
||||
[Surge for macOS](https://nssurge.com/buy_now) is a powerful macOS network utility that supports multiple proxy protocols:
|
||||
> 🚀 **Professional macOS Network Tool** | Powerful features, excellent performance, suitable for professional users
|
||||
|
||||
- Shadowsocks (SS)
|
||||
- V2Ray (VMess)
|
||||
- Trojan
|
||||
- HTTP/HTTPS
|
||||
- SOCKS5
|
||||
- Snell
|
||||
- SOCKS5 over TLS
|
||||
[Surge for macOS](https://nssurge.com/buy_now) is a powerful macOS network tool that provides rich network functionality and professional proxy solutions.
|
||||
|
||||
## Requirements
|
||||
## 📊 Supported Protocols Overview
|
||||
|
||||
> ⚠️ System Requirements
|
||||
| Protocol Type | Performance | Security | Recommendation |
|
||||
|---------------|-------------|----------|----------------|
|
||||
| 🔗 Shadowsocks (SS) | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
|
||||
| 🚀 V2Ray (VMess) | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
|
||||
| 🛡️ Trojan | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
|
||||
| 🌐 HTTP/HTTPS | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ |
|
||||
| 🔌 SOCKS5 | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ |
|
||||
| ⚡ Snell | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
|
||||
| 🔐 SOCKS5 over TLS | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
|
||||
|
||||
- Operating System: macOS 10.5 or higher
|
||||
- Software Version: Surge 3+ for macOS
|
||||
- Compatible Devices: MacBook / iMac / Mac Pro
|
||||
## 📋 Usage Requirements
|
||||
|
||||
> ⚠️ Important Notes
|
||||
### 🖥️ System Requirements
|
||||
|
||||
- Surge for macOS is a paid software, you need to purchase it yourself
|
||||
- This software is a professional software, we only provide basic usage tutorials, and cannot provide troubleshooting, advanced usage support, etc.
|
||||
| Item | Requirement | Description |
|
||||
|------|-------------|-------------|
|
||||
| **Operating System** | macOS 10.15+ | Latest version recommended |
|
||||
| **Software Version** | Surge 5.0+ | Supports latest protocols and features |
|
||||
| **Compatible Devices** | MacBook / iMac / Mac Pro | All Mac device series |
|
||||
| **Network Environment** | Stable network connection | Ensures configuration file download |
|
||||
|
||||
## Configuration Guide
|
||||
### ⚠️ Important Notes
|
||||
|
||||
### Import Configuration Steps
|
||||
> 💡 **Software Information**
|
||||
>
|
||||
> - Surge for macOS is a **paid professional software** that requires you to purchase a license
|
||||
> - The software is relatively expensive but powerful, suitable for professional users and developers
|
||||
> - Provides rich network debugging and analysis features
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
> 📖 **Technical Support**
|
||||
>
|
||||
> - We provide basic configuration tutorials and usage guidance
|
||||
> - For advanced feature support, we recommend consulting the official documentation
|
||||
> - For troubleshooting and technical issues, please contact official technical support
|
||||
|
||||
## 🚀 Quick Configuration Tutorial
|
||||
|
||||
### 📥 Detailed Configuration Import Steps
|
||||
|
||||
#### Step One: Launch Application
|
||||
|
||||
|
||||
|
||||
> Open the Surge for macOS application
|
||||
|
||||
#### Step Two: Access Configuration
|
||||
|
||||
|
||||
|
||||
> Click the configuration option in the menu bar
|
||||
|
||||
#### Step Three: Import Settings
|
||||
|
||||
|
||||
|
||||
> Select import configuration file or URL
|
||||
|
||||
#### Step Four: Confirm Configuration
|
||||
|
||||
|
||||
|
||||
> Verify configuration information and confirm import
|
||||
|
||||
#### Step Five: Activate Connection
|
||||
|
||||
|
||||
|
||||
> Enable proxy connection and start using
|
||||
|
||||
## 🔧 Advanced Features
|
||||
|
||||
### 🎯 Smart Traffic Splitting
|
||||
|
||||
- **Automatic Splitting Rules**: Automatically select optimal routes based on domain names and IPs
|
||||
- **Geo-location Routing**: Intelligently select nodes based on target server location
|
||||
- **Application Splitting**: Set different proxy policies for different applications
|
||||
|
||||
### 📊 Network Monitoring
|
||||
|
||||
- **Real-time Traffic Statistics**: Monitor network usage of each application
|
||||
- **Connection Quality Analysis**: Real-time display of network metrics like latency and packet loss
|
||||
- **Historical Data Recording**: Save network usage history for analysis
|
||||
|
||||
### 🛠️ Developer Features
|
||||
|
||||
- **HTTP/HTTPS Packet Capture**: Support HTTPS certificate installation and traffic analysis
|
||||
- **Custom Rules**: Support complex traffic splitting rule configuration
|
||||
- **Script Support**: JavaScript scripts for custom network behavior
|
||||
|
||||
## ❓ Frequently Asked Questions
|
||||
|
||||
### 💳 Purchase Related
|
||||
|
||||
**Q: How much does Surge for macOS cost?**
|
||||
|
||||
A: Surge for macOS is paid software. We recommend visiting the official website for the latest pricing information. Although the price is high, it's powerful and suitable for professional users.
|
||||
|
||||
**Q: Is there a trial version available?**
|
||||
|
||||
A: The software provides limited trial functionality. Please check the official website for specific trial policies.
|
||||
|
||||
### 🔧 Technical Issues
|
||||
|
||||
**Q: What to do if configuration import fails?**
|
||||
|
||||
A: Solutions:
|
||||
|
||||
1. Check if the configuration URL is correct
|
||||
2. Confirm network connection is normal
|
||||
3. Verify if the configuration file format complies with Surge specifications
|
||||
4. Try manually downloading the configuration file and then importing
|
||||
|
||||
**Q: How to update configuration?**
|
||||
|
||||
A: Click the "Update" button in the configuration management interface, or set automatic update intervals.
|
||||
|
||||
## 🎉 Feature Comparison
|
||||
|
||||
| Feature | Surge | Other Clients | Advantages |
|
||||
|---------|--------|--------------|------------|
|
||||
| **Protocol Support** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | Supports latest protocols |
|
||||
| **Traffic Splitting Rules** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | Professional rule engine |
|
||||
| **Network Debugging** | ⭐⭐⭐⭐⭐ | ⭐⭐ | Powerful packet capture functionality |
|
||||
| **Performance** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | Excellent performance optimization |
|
||||
| **Interface Design** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | Native macOS design |
|
||||
| **Price Barrier** | ⭐⭐ | ⭐⭐⭐⭐ | Relatively expensive |
|
||||
|
||||
## 📞 Getting Help
|
||||
|
||||
- 🌐 **Official Website**: [nssurge.com](https://nssurge.com)
|
||||
- 📚 **Official Documentation**: Detailed feature descriptions and configuration guides
|
||||
- 💬 **Community Support**: Active user community and technical exchanges
|
||||
- 📧 **Technical Support**: Professional technical support team
|
||||
|
||||
---
|
||||
*Document Updated: 2024.11.17*
|
||||
|
||||
> 📅 Last Updated: July 10, 2025 | 🌊 Applicable Version: Surge 5.9.0
|
||||
|
||||
Reference in New Issue
Block a user