S-VPN/ppanel-tutorial
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update Docs

Browse Source
This commit is contained in:
web@ppanel
2025-07-10 11:25:31 +00:00
parent 553a738fce
commit f04ec14e07
42 changed files with 10729 additions and 866 deletions
Download Patch File Download Diff File Expand all files Collapse all files
en-US/ios-ipados/README.md
+377 -1
View File
@@ -1,2 +1,378 @@
# iOS / iPadOS
# 📱 iOS / iPadOS Client Configuration Guide
> 🍎 Comprehensive proxy client configuration tutorials for iPhone and iPad users, covering detailed usage methods for both free and premium applications.
## 🌟 Recommended Clients
### 💎 Premium Quality Applications
| Application | Price | Key Features | Rating | Tutorial |
|-------------|-------|--------------|--------|----------|
| [🚀 Shadowrocket](shadowrocket.md) | $2.99 | Lightweight, stable, comprehensive features | ⭐⭐⭐⭐⭐ | [Setup Guide](shadowrocket.md) |
| [⚡ Quantumult X](quantumultx.md) | $7.99 | Most powerful, highly customizable | ⭐⭐⭐⭐⭐ | [Setup Guide](quantumultx.md) |
| [🌊 Surge](surge.md) | $49.99 | Enterprise-grade functionality | ⭐⭐⭐⭐ | [Setup Guide](surge.md) |
### 🆓 Free Alternatives
| Application | Type | Features | Rating | Tutorial |
|-------------|------|----------|--------|----------|
| [📦 sing-box](sing-box.md) | Open Source | Emerging client, powerful features | ⭐⭐⭐⭐ | [Setup Guide](sing-box.md) |
| [🎯 Quantumult](quantumult.md) | Basic Version | Simplified feature set | ⭐⭐⭐ | [Setup Guide](quantumult.md) |
---
## 🎯 Selection Recommendations
### 🆕 Beginner Users
#### Recommended: Shadowrocket
- ✅ Affordable price ($2.99)
- ✅ Clean and intuitive interface
- ✅ Sufficient features with good stability
- ✅ Strong community support
- ✅ Excellent value for money
- ✅ Regular updates and maintenance
### 🔧 Advanced Users
#### Recommended: Quantumult X
- ✅ Most powerful feature set
- ✅ Highly customizable configuration
- ✅ JavaScript scripting support
- ✅ Active development and maintenance
- ✅ Advanced rule engine
- ✅ Professional debugging tools
### 💼 Enterprise Users
#### Recommended: Surge
- ✅ Enterprise-grade stability
- ✅ Professional network tools
- ✅ Detailed network analysis
- ✅ Long-term technical support
- ✅ MitM functionality
- ✅ Network debugging capabilities
### 💰 Budget-Conscious Users
#### Recommended: sing-box
- ✅ Completely free and open source
- ✅ Continuously improving features
- ✅ Excellent performance
- ✅ Latest protocol support
- ✅ Cross-platform compatibility
- ✅ Active development community
---
## 📋 Feature Comparison
| Feature | Shadowrocket | Quantumult X | Surge | sing-box |
|---------|--------------|--------------|-------|----------|
| 🏷️ **Price** | $2.99 | $7.99 | $49.99 | Free |
| 🔧 **Ease of Use** | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐ |
| 🚀 **Performance** | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| 📊 **Feature Richness** | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| 🛡️ **Stability** | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| 🎨 **Interface Design** | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐ |
## 🛠️ Protocol Support Matrix
| Protocol | Shadowrocket | Quantumult X | Surge | sing-box |
|----------|--------------|--------------|-------|----------|
| 🔒 **Shadowsocks** | ✅ | ✅ | ✅ | ✅ |
| 🌟 **VMess** | ✅ | ✅ | ✅ | ✅ |
| 🛡️ **VLESS** | ✅ | ✅ | ❌ | ✅ |
| 🗡️ **Trojan** | ✅ | ✅ | ✅ | ✅ |
| 📡 **ShadowsocksR** | ✅ | ✅ | ❌ | ❌ |
| 🌐 **HTTP/HTTPS** | ✅ | ✅ | ✅ | ✅ |
| 🧦 **SOCKS** | ✅ | ✅ | ✅ | ✅ |
| 🚀 **Hysteria** | ✅ | ✅ | ❌ | ✅ |
---
## ⚠️ Important Notices
### 🏪 About App Store Availability
> **Important Information**
>
> - These applications are **not available in mainland China App Store**
> - Requires **non-mainland China Apple ID**
> - Recommended regions: US, Hong Kong, Japan, etc.
> - Purchase and download require international payment methods
### 🔑 Obtaining Apple ID
**Recommended Methods:**
#### 1. Self-Registration
- Visit [appleid.apple.com](https://appleid.apple.com)
- Create account with international address
- Use valid international payment method
- Verify with phone number from target region
#### 2. Purchase Ready-Made Account
- Buy from trusted vendors
- Ensure account has valid payment method
- Check account region and currency
- Verify account security status
#### 3. Family Sharing
- Join international family sharing group
- Share purchases with family members
- Split costs among group members
- Maintain individual account security
### 💡 Usage Tips
#### 📱 Account Management
- **App Store Only**: Only sign in to App Store for downloads
- **Keep iCloud Separate**: Don't change system iCloud account
- **Security First**: Use strong passwords and 2FA
- **Regular Updates**: Keep apps updated for security
#### 🔄 Account Switching
```bash
Settings → App Store → Sign Out → Sign In with International Account
```
#### 🛡️ Security Considerations
- **Download Only**: Switch back to original account after download
- **Backup Data**: Regular backup before account changes
- **Privacy Settings**: Review app permissions regularly
- **Network Security**: Use apps only with trusted configurations
---
## 🎯 Use Case Recommendations
### 📱 Daily Browsing & Social Media
**Best Choice**: Shadowrocket
- Simple and reliable for everyday use
- Good performance with social media apps
- Affordable one-time purchase
- Minimal battery impact
### 🎮 Gaming & Streaming
**Best Choice**: Quantumult X
- Advanced routing for gaming optimization
- Custom rules for streaming services
- Real-time connection monitoring
- Performance tuning capabilities
### 💼 Professional & Enterprise
**Best Choice**: Surge
- Enterprise-grade stability and features
- Detailed network analysis tools
- Professional debugging capabilities
- Long-term support and updates
### 🎓 Learning & Development
**Best Choice**: sing-box
- Open source for learning purposes
- Modern architecture and protocols
- Active development community
- Cross-platform compatibility
---
## 📚 Quick Navigation
### 📖 Configuration Tutorials
- [🚀 Shadowrocket Setup Guide](shadowrocket.md)
- [⚡ Quantumult X Configuration](quantumultx.md)
- [🌊 Surge Enterprise Guide](surge.md)
- [📦 sing-box Modern Client](sing-box.md)
- [🎯 Quantumult Basic Setup](quantumult.md)
### 🆘 Support Resources
- [❓ Common Issues & Solutions](#-common-issues)
- [🔧 Troubleshooting Guide](#-troubleshooting)
- [🛡️ Security Best Practices](#️-security-best-practices)
- [⚡ Performance Optimization](#-advanced-tips)
---
## ❓ Common Issues
### 🔧 App Store Issues
**Q: Can't find apps in App Store?**
A: Solutions:
1. Ensure you're signed in with international Apple ID
2. Check account region settings
3. Verify App Store region matches account
4. Clear App Store cache and restart
**Q: Payment declined during purchase?**
A: Troubleshooting:
1. Verify payment method is valid for the region
2. Ensure sufficient funds/credit available
3. Try different payment methods
4. Contact Apple Support if issues persist
### 📱 Application Issues
**Q: App crashes after installation?**
A: Solutions:
1. Restart device after installation
2. Check iOS version compatibility
3. Free up device storage space
4. Reinstall app if problems continue
**Q: Can't import configuration?**
A: Check:
1. Configuration file format is correct
2. URL is accessible and valid
3. Network connection is stable
4. App has necessary permissions
---
## 🔧 Troubleshooting
### 🔍 Connection Problems
#### Step-by-Step Diagnosis
1. **Verify Configuration**
- Check server details accuracy
- Confirm protocol settings
- Validate authentication credentials
2. **Test Network Connectivity**
- Try different WiFi/cellular networks
- Check if servers are accessible
- Test with different devices
3. **App-Specific Checks**
- Update to latest app version
- Clear app cache and data
- Restart app completely
### ⚡ Performance Optimization
#### Speed Enhancement Tips
1. **Server Selection**
- Choose geographically closer servers
- Test multiple servers for best performance
- Consider paid premium servers
2. **Configuration Tuning**
- Adjust connection protocols
- Optimize routing rules
- Fine-tune timeout settings
3. **Device Optimization**
- Close unnecessary background apps
- Ensure sufficient available storage
- Keep iOS updated to latest version
---
## 🛡️ Security Best Practices
### 🔐 Configuration Security
#### Safe Configuration Practices
1. **Trusted Sources Only**
- Use configurations from reputable providers
- Verify configuration authenticity
- Avoid sharing sensitive configurations
2. **Regular Security Audits**
- Review active connections periodically
- Monitor data usage patterns
- Check for unusual network activity
3. **Privacy Protection**
- Enable kill switch features when available
- Use DNS over HTTPS
- Disable unnecessary logging
### 🛡️ Device & Account Security
#### Account Protection
- **Two-Factor Authentication**: Enable 2FA on Apple ID
- **Strong Passwords**: Use unique, complex passwords
- **Regular Reviews**: Monitor account activity regularly
- **Secure Networks**: Avoid configuration on public WiFi
#### App Security
- **App Permissions**: Review and limit unnecessary permissions
- **Regular Updates**: Keep apps updated for security patches
- **Backup Configurations**: Secure backup of important configs
- **Clean Uninstall**: Properly remove unused apps and configs
---
## 💡 Advanced Tips
### 🎯 Power User Features
#### Automation & Scripting
- **Quantumult X**: JavaScript automation scripts
- **Surge**: Advanced rule scripting capabilities
- **Shortcuts Integration**: iOS Shortcuts app integration
- **Schedule Automation**: Time-based connection rules
#### Network Analysis
- **Connection Monitoring**: Real-time connection analysis
- **Traffic Statistics**: Detailed usage analytics
- **Performance Metrics**: Latency and speed monitoring
- **Debug Logging**: Advanced troubleshooting tools
### 📊 Optimization Strategies
#### Battery Life Optimization
1. **Efficient Protocols**: Choose lightweight protocols
2. **Smart Routing**: Minimize unnecessary proxy usage
3. **Background Settings**: Optimize background refresh
4. **Connection Pooling**: Reuse connections when possible
#### Data Usage Management
1. **Compression**: Enable data compression when available
2. **Route Optimization**: Direct routing for local content
3. **Usage Monitoring**: Track and limit data consumption
4. **Quality Settings**: Adjust streaming quality settings
---
> 📅 Last Updated: July 10, 2025 | 🍎 iOS 14.0+ | 📱 iPadOS 14.0+ | 🔄 Version: 3.0.0
en-US/ios-ipados/quantumult.md
+271 -27
View File
@@ -1,40 +1,284 @@
# Quantumult - Classic Network Tool
# 🎯 Quantumult - Classic Minimalist Proxy Tool
Quantumult is the classic version of Quantumult X, providing stable and reliable basic functionality.
![Quantumult](quantumult.png)
## Features
> 🌟 Quantumult is the classic version of Quantumult X, beloved by users for its simple and stable design philosophy and reliable basic functionality, making it an ideal choice for entry-level users.
- Support for major protocols: SS, SSR, VMess, Trojan
- Basic routing functionality
- Simple policy group configuration
- Stable performance
- Low memory footprint
## ✨ Product Features
## Basic Information
### 🎯 Core Advantages
- **System Requirements**: iOS 9.0 or later
- **Compatible Devices**: iPhone / iPad
- 🎨 **Clean Interface**: Minimalist design with intuitive operation
- 🛡️ **Stable & Reliable**: Time-tested stable kernel
- 💰 **Affordable Price**: More economical compared to Quantumult X
- ⚡ **Lightweight**: Low resource consumption, smooth operation
- 🔧 **Easy to Use**: Simple functions, suitable for beginners
> ⚠️ **Notes**
>
> - This app is not available in the mainland China App Store
> - Requires non-mainland China Apple ID for download
### 🔗 Protocol Support
> ⚠️ **Important Notice**
| Protocol Type | Support Status | Use Case |
|---------------|----------------|----------|
| 🔒 Shadowsocks (SS) | ✅ | Classic encryption protocol |
| 🔓 ShadowsocksR (SSR) | ✅ | Enhanced protocol |
| 🌟 VMess (V2Ray) | ✅ | Modern protocol |
| 🛡️ Trojan | ✅ | TLS camouflaged traffic |
| 🧦 SOCKS5 | ✅ | Universal proxy protocol |
- Please note that Quantumult for iOS is a paid software, you need to purchase it yourself
- For this software, we do not provide rule configurations, scripts, or advanced usage methods. Due to the limited experience and knowledge of our customer service, we can only provide you with basic tutorials for importing subscriptions and opening proxies. Advanced usage methods require you to search for relevant materials and learn independently. We cannot provide assistance at this time, please understand.
### 🛠️ Feature Highlights
## Usage Guide
- 📊 **Basic Traffic Splitting**: Support for simple rule-based routing
- 🎛️ **Policy Groups**: Basic policy group configuration
- 📈 **Traffic Statistics**: Real-time network usage monitoring
- 🔄 **Auto Switching**: Automatic switching when nodes fail
- 🎯 **Latency Testing**: Check server response times
### Import Configuration
### 📱 System Requirements
- **Minimum Version**: iOS 9.0 or higher
- **Recommended Version**: iOS 12.0 and above
- **Compatible Devices**: iPhone / iPad / iPod Touch
- **Storage Requirement**: About 30MB available space
- **Memory Requirement**: Supports 1GB RAM devices
![Image 1](Quantumult-01.png)
![Image 2](Quantumult-02.png)
![Image 3](Quantumult-03.png)
![Image 4](Quantumult-04.png)
![Image 5](Quantumult-05.png)
![Image 6](Quantumult-06.png)
---
Last updated: 2024.11.17
## 📥 Download & Purchase
### 🏪 App Store Information
> ⚠️ **Important Reminder**
>
> - **Not available** in China mainland App Store
> - Requires **non-China mainland Apple ID**
> - Recommend using US, Hong Kong, or other region accounts
#### 💰 Price Reference
| Region | Price | Notes |
|--------|-------|-------|
| 🇺🇸 US | $4.99 | Recommended purchase |
| 🇭🇰 Hong Kong | HK$38 | Convenient payment |
| 🇯🇵 Japan | ¥610 | Exchange rate advantage |
### 🆚 Version Comparison
| Feature Comparison | Quantumult | Quantumult X |
|-------------------|------------|--------------|
| 🏷️ **Price** | $4.99 | $7.99 |
| 🎨 **Interface Complexity** | ⭐⭐ | ⭐⭐⭐⭐⭐ |
| 🔧 **Feature Richness** | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| 📚 **Learning Curve** | ⭐ | ⭐⭐⭐⭐ |
| 🎯 **Target Users** | Beginners | Advanced users |
| 📜 **Script Support** | ❌ | ✅ |
| 🛠️ **Custom Rules** | Basic | Advanced |
---
## ⚠️ Usage Notes
### 💰 Paid Software Notice
> ⚠️ **Important Notice**
>
> - Quantumult is **paid software** that requires you to purchase it yourself
> - Please purchase through **legitimate channels** to support continuous development
> - Price is more affordable compared to Quantumult X, suitable for budget-conscious users
### 📚 Technical Support Scope
> 📋 **Service Description**
>
> - ✅ **Basic Configuration**: Subscription import and connection tutorials provided
> - ✅ **Common Issues**: Basic usage questions answered
> - ❌ **Advanced Rules**: Complex rule configuration not provided
> - ❌ **Script Functions**: This version doesn't support script functionality
> - ❌ **Advanced Tutorials**: Users need to learn and research independently
---
## 🚀 Usage Tutorial
### 📋 Prerequisites
Before starting configuration, please ensure:
- ✅ Quantumult purchased and installed from App Store
- ✅ Valid server subscription link available
- ✅ Device network connection is normal
### 🛠️ Configuration Steps
#### 🔗 Subscription Import Process
##### Step 1: Launch Application
Open Quantumult and enter the main interface:
![Application Main Interface](Quantumult-01.png)
> 💡 First launch will request VPN permission, please select "Allow"
##### Step 2: Enter Settings
Click the "Settings" tab at the bottom:
![Settings Interface](Quantumult-02.png)
##### Step 3: Add Subscription
Find "Servers" option and click to enter:
![Server Settings](Quantumult-03.png)
##### Step 4: Import Link
Click the "+" icon in the top right corner, select "Server Subscription":
![Add Subscription](Quantumult-04.png)
##### Step 5: Paste Link
Enter subscription link and click "Save":
![Enter Subscription Link](Quantumult-05.png)
##### Step 6: Start Connection
Return to main interface, select node and enable connection:
![Start Connection](Quantumult-06.png)
---
## 🎛️ Basic Settings
### ⚙️ Proxy Modes
- **Global Mode**: All traffic through proxy
- **Rule Mode**: Smart traffic splitting based on rules
- **Direct Mode**: All traffic direct connection
### 📊 Node Management
- **Manual Selection**: User manually selects server
- **Auto Selection**: Automatically select optimal node based on latency
- **Load Balancing**: Traffic distributed across multiple nodes
### 🔄 Update Management
- **Manual Update**: Manually refresh subscription for latest nodes
- **Auto Update**: Set scheduled automatic subscription updates
- **Update Frequency**: Recommend updating once daily
---
## ❓ Frequently Asked Questions
### 🔧 Connection Issues
**Q: Unable to connect to server?**
A: Please check:
- Subscription link is correct and valid
- Selected node is available
- Local network connection is normal
- VPN permission has been granted
**Q: Connection speed is slow?**
A: Optimization suggestions:
- Try switching to other server nodes
- Select servers with lower latency
- Check local network quality
- Avoid peak network usage times
### 📱 Application Issues
**Q: Application crashes frequently?**
A: Solutions:
- Restart device
- Reinstall application
- Check iOS version compatibility
- Clear device storage space
**Q: Subscription import failed?**
A: Troubleshooting steps:
- Confirm subscription link format is correct
- Check network connection status
- Try manually adding single node
- Contact service provider for confirmation
---
## 🔗 Related Resources
### 📚 Learning Materials
- 🏠 [Quantumult Official Page](https://apps.apple.com/app/quantumult/id1252015438)
- 📖 [iOS Proxy Tutorial Collection](https://github.com/shadowsocks/shadowsocks-iOS)
- 💬 [User Community](https://t.me/quantumult)
### 🛠️ Useful Tools
- 🔧 [Configuration Generator](https://www.configcat.com/)
- 📊 [Network Testing Tool](https://fast.com/)
- 🎯 [Node Speed Test Tool](https://www.speedtest.net/)
### 🆙 Upgrade Recommendations
If you need more powerful features, consider upgrading to:
- 🚀 **Quantumult X**: Most comprehensive features, supports scripts
- 🌊 **Surge**: Enterprise-level stability
- 🚀 **Shadowrocket**: Lightweight with excellent value
---
## 💡 Usage Tips
### ⚡ Performance Optimization
1. **Choose Nodes Wisely**: Select servers with low latency and good stability
2. **Update Subscriptions Regularly**: Keep node list current
3. **Avoid Frequent Switching**: Use single node stably, avoid frequent switching
### 🛡️ Security Recommendations
1. **Genuine Purchase**: Buy through official channels to ensure software security
2. **Subscription Security**: Only use trusted service providers
3. **Privacy Protection**: Pay attention to personal information and usage habit protection
---
## 🎯 Summary & Evaluation
### ✅ Advantages
- 💰 **Affordable Price**: $3 cheaper than Quantumult X
- 🎨 **Clean Interface**: Simple operation, easy to get started
- 🛡️ **Stable & Reliable**: Basic functions stable with few issues
- ⚡ **Good Performance**: Low resource consumption, smooth operation
### ❌ Limitations
- 🔧 **Limited Features**: Fewer features compared to Quantumult X
- 📜 **No Script Support**: Doesn't support JavaScript scripts
- 🎛️ **Limited Customization**: Fewer advanced configuration options
- 🔄 **Slower Updates**: New feature updates not as frequent as Quantumult X
### 🎯 Target Users
- 🆕 **Beginners**: First-time users of iOS proxy tools
- 💰 **Budget-Conscious**: Want to save on purchase costs
- 🎨 **Simplicity Lovers**: Prefer simple and intuitive interfaces
- 🛡️ **Stability Priority**: Value stability over feature richness
---
> 📅 Last Updated: July 10, 2025 | 🎯 Applicable Version: Quantumult 2.2.1
en-US/ios-ipados/quantumultx.md
+308 -31
View File
@@ -1,52 +1,329 @@
# Quantumult X - Advanced Network Tool Platform
# ⚡ Quantumult X - Professional Network Tool Platform
Quantumult X is a feature-rich network tool platform offering powerful customization capabilities and extensive functionality.
> 🚀 Quantumult X is the most powerful proxy tool on iOS platform, renowned for its high customizability, rich script support, and professional-grade features, making it the top choice for advanced users.
## Features
## ✨ Product Highlights
- Multi-protocol support: SS, SSR, VMess, Trojan
- Highly customizable routing system
- Powerful rewrite capabilities
- JavaScript scripting support
- Dynamic policy group switching
- Gallery feature support
### 🎯 Core Advantages
## Basic Information
- 🔧 **Highly Customizable**: Almost all functions can be custom configured
- 📜 **Script Support**: Powerful JavaScript scripting engine
- 🎨 **Gallery Ecosystem**: Rich community resources and configurations
- 🛡️ **Comprehensive Features**: Covers all aspects of network proxying
- 📊 **Detailed Statistics**: Complete network monitoring and analysis functionality
- **System Requirements**: iOS 13.0 or later
### 🔗 Protocol Support
| Protocol Type | Support Status | Advanced Features |
|---------------|----------------|-------------------|
| 🔒 Shadowsocks (SS) | ✅ | Full encryption algorithm support |
| 🔓 ShadowsocksR (SSR) | ✅ | Complete obfuscation support |
| 🌟 VMess (V2Ray) | ✅ | Multiple transport protocols |
| ⚡ VLESS | ✅ | Latest protocol support |
| 🛡️ Trojan | ✅ | Perfect TLS camouflage |
| 🚀 Hysteria | ✅ | QUIC high-speed transmission |
| 🌊 TUIC | ✅ | Next-generation protocol |
| 🧦 SOCKS5 | ✅ | Complete proxy support |
### 🛠️ Professional Features
| Feature Category | Specific Functions | Description |
|------------------|-------------------|-------------|
| 📋 **Traffic Splitting** | Domain/IP/GeoIP rules | Precise traffic routing |
| 🔄 **Policy Groups** | Auto-select/Load balance/Failover | Smart node management |
| 📜 **Script Engine** | JavaScript support | Unlimited extension possibilities |
| 🎭 **Rewrite Functions** | URL/Header rewriting | Powerful content modification |
| 📊 **Network Tools** | MitM/DNS/TCP Fast Open | Professional network analysis |
| 🎨 **Gallery** | Community configs/Script library | Rich ecosystem resources |
### 📱 System Requirements
- **Minimum Version**: iOS 13.0 or higher
- **Recommended Version**: iOS 15.0 and above
- **Compatible Devices**: iPhone / iPad
- **Storage Requirement**: About 200MB available space
- **Memory Requirement**: 4GB RAM or above recommended
> ⚠️ **Notes**
---
## 📥 Download & Purchase
### 🏪 App Store Purchase
> ⚠️ **Purchase Reminder**
>
> - This app is not available in the mainland China App Store
> - Requires non-mainland China Apple ID for download
> - **Not available** in China mainland App Store
> - Requires **non-China mainland Apple ID**
> - Relatively expensive price, but most comprehensive features
#### 💰 Price Information
| Region | Price | Notes |
|--------|-------|-------|
| 🇺🇸 US | $7.99 | Most commonly used region |
| 🇭🇰 Hong Kong | HK$62 | Convenient payment |
| 🇯🇵 Japan | ¥1,000 | Exchange rate consideration |
| 🇸🇬 Singapore | S$10.98 | Alternative region |
### 🆚 Version Comparison
Detailed comparison with other clients:
| Feature | Quantumult X | Surge | Shadowrocket | Quantumult |
|---------|--------------|-------|--------------|------------|
| 🏷️ **Price** | $7.99 | $49.99 | $2.99 | $4.99 |
| 📜 **Script Support** | ✅ Complete | ✅ Complete | ✅ Basic | ❌ |
| 🎨 **Customization** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
| 📚 **Learning Curve** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐ | ⭐ |
| 🎯 **Target Users** | Advanced users | Professional users | General users | Beginners |
| 🌟 **Community** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
---
## ⚠️ Usage Notes
### 💰 Paid Software Notice
> ⚠️ **Important Notice**
>
> - Quantumult X is **paid software** requiring you to purchase it yourself
> - Price is **$7.99**, among the more expensive proxy apps on iOS
> - Recommend confirming need for advanced features before purchase to avoid waste
- Please note that Quantumult X for iOS is a paid software, you need to purchase it yourself
- For this software, we do not provide rule configurations, scripts, or advanced usage methods. Due to the limited experience and knowledge of our customer service, we can only provide you with basic tutorials for importing subscriptions and opening proxies. Advanced usage methods require you to search for relevant materials and learn independently. We cannot provide assistance at this time, please understand.
### 📚 Technical Support Scope
## Usage Guide
> 📋 **Service Description**
>
> - ✅ **Basic Configuration**: Subscription import and basic connection tutorials provided
> - ✅ **Common Issues**: Basic usage questions answered
> - ❌ **Advanced Rules**: Complex rules and script configuration not provided
> - ❌ **Script Writing**: JavaScript script writing guidance not provided
> - ❌ **Gallery Configurations**: Third-party configuration support not provided
> - 💡 **Learning Suggestion**: Recommend learning advanced features through official documentation and community
### Import Configuration
![Image 1](QuantumultX-01.png)
![Image 2](QuantumultX-02.png)
![Image 3](QuantumultX-03.png)
![Image 4](QuantumultX-04.png)
![Image 5](QuantumultX-05.png)
![Image 6](QuantumultX-06.png)
![Image 7](QuantumultX-07.png)
---
### Custom Policies
## 🚀 Usage Tutorial
### 📋 Prerequisites
Before starting, please ensure:
- ✅ Quantumult X purchased and installed from App Store
- ✅ Valid server subscription link available
- ✅ Basic understanding of networking concepts
- ✅ Time and patience to learn advanced features
### 🛠️ Basic Configuration
#### 🔗 Subscription Import Tutorial
##### Step 1: Launch Application
Open Quantumult X and enter the main interface:
![Application Main Interface](QuantumultX-01.png)
> 💡 First launch requires basic setup configuration, please complete following the wizard
##### Step 2: Enter Settings
Click the "Settings" icon in the bottom right corner:
![Settings Entry](QuantumultX-02.png)
##### Step 3: Add Subscription
Find "Nodes" option and click to enter subscription management:
![Node Settings](QuantumultX-03.png)
##### Step 4: Subscription Configuration
Click the "+" icon in the top right corner, select "Subscription":
![Add Subscription](QuantumultX-04.png)
##### Step 5: Enter Information
Fill in subscription name and link address:
![Enter Subscription Information](QuantumultX-05.png)
##### Step 6: Confirm Save
Check information is correct, then click "OK" to save:
![Confirm Save](QuantumultX-06.png)
##### Step 7: Start Connection
Return to main interface, select node and enable proxy:
![Start Connection](QuantumultX-07.png)
![Image 8](QuantumultX-08.png)
---
### Update Configuration
### 🎛️ Policy Configuration
#### 🔄 Custom Policy Groups
Configure smart policy groups for automatic node selection:
![Policy Group Configuration](QuantumultX-08.png)
> 🎯 **Policy Type Description**
>
> - **Auto Select**: Automatically choose optimal node based on latency
> - **Load Balance**: Traffic distributed evenly across multiple nodes
> - **Failover**: Automatically switch to backup node when primary fails
> - **Manual Select**: User manually specifies which node to use
![Image 9](QuantumultX-09.png)
---
Last updated: 2024.11.17
### 🔄 Subscription Management
#### 📱 Update Configuration
Regularly update subscriptions to get latest node information:
![Update Configuration](QuantumultX-09.png)
> 💡 **Update Recommendations**
>
> - Recommend updating subscription once daily
> - Supports background automatic updates
> - Can set update time intervals
---
## 🎯 Advanced Features
### 📜 JavaScript Scripting
- **Custom Scripts**: Write custom JavaScript for advanced functionality
- **Community Scripts**: Rich collection of community-contributed scripts
- **Gallery Integration**: Easy script installation through Gallery feature
### 🎭 Rewrite & MitM
- **URL Rewriting**: Modify request URLs and responses
- **Header Modification**: Custom HTTP headers
- **HTTPS Decryption**: Man-in-the-middle for HTTPS traffic analysis
### 🔧 Advanced Routing
- **GeoIP Rules**: Route traffic based on geographical location
- **Domain Rules**: Precise domain-based routing
- **IP Rules**: Route based on IP addresses and CIDR blocks
---
## ❓ Frequently Asked Questions
### 🔧 Configuration Issues
**Q: Subscription import failed?**
A: Troubleshooting steps:
- Verify subscription link format is correct
- Check network connectivity
- Try manual node addition
- Contact service provider for verification
**Q: Scripts not working?**
A: Common solutions:
- Enable JavaScript engine in settings
- Check script syntax errors
- Verify script compatibility with current version
- Consult script documentation
### 📱 Performance Issues
**Q: High battery consumption?**
A: Optimization tips:
- Disable unnecessary scripts
- Reduce update frequency
- Use appropriate policy groups
- Close unused advanced features
**Q: Slow connection speeds?**
A: Performance optimization:
- Select geographically closer nodes
- Use load balancing policies
- Optimize rule configurations
- Check local network quality
---
## 🔗 Related Resources
### 📚 Official Resources
- 🏠 [Quantumult X Official Page](https://apps.apple.com/app/quantumult-x/id1443988620)
- 📖 [Official Documentation](https://github.com/crossutility/Quantumult-X)
- 💬 [Official Telegram](https://t.me/QuantumultXApp)
### 🌟 Community Resources
- 🎨 [Gallery Configurations](https://github.com/KOP-XIAO/QuantumultX)
- 📜 [Script Collection](https://github.com/chavyleung/scripts)
- 🔧 [Configuration Examples](https://github.com/GeQ1an/Rules)
### 🛠️ Tools & Utilities
- 🔧 [Configuration Converter](https://acl4ssr.netlify.app/)
- 📊 [Network Testing](https://fast.com/)
- 🎯 [Rule Generator](https://github.com/Loyalsoldier/geoip)
---
## 💡 Usage Tips
### ⚡ Performance Optimization
1. **Efficient Policy Setup**: Use appropriate policy groups for different scenarios
2. **Script Management**: Only enable necessary scripts to conserve resources
3. **Regular Maintenance**: Update subscriptions and configurations regularly
### 🛡️ Security Best Practices
1. **Trusted Sources**: Only use scripts and configurations from trusted sources
2. **MitM Caution**: Be careful when enabling HTTPS decryption
3. **Privacy Protection**: Review and understand script permissions
---
## 🎯 Summary & Evaluation
### ✅ Advantages
- 🔧 **Ultimate Customization**: Most customizable iOS proxy app
- 📜 **Powerful Scripting**: JavaScript support for unlimited possibilities
- 🎨 **Rich Ecosystem**: Vibrant community with abundant resources
- 🛡️ **Professional Features**: Enterprise-grade functionality
### ❌ Considerations
- 💰 **High Price**: Most expensive among iOS proxy apps
- 📚 **Steep Learning Curve**: Requires significant time investment to master
- 🔧 **Complexity**: May be overwhelming for casual users
- 📱 **Resource Usage**: Higher battery and memory consumption
### 🎯 Recommended For
- 🚀 **Power Users**: Those who need maximum customization
- 💻 **Developers**: Users comfortable with scripting and configuration
- 🔧 **Network Enthusiasts**: Those who enjoy tweaking and optimizing
- 🎯 **Advanced Features**: Users requiring enterprise-grade functionality
---
> 📅 Last Updated: July 10, 2025 | ⚡ Applicable Version: Quantumult X 1.4.1
en-US/ios-ipados/shadowrocket.md
+236 -22
View File
@@ -1,33 +1,247 @@
# Shadowrocket - Lightweight Network Tool
# 🚀 Shadowrocket - Classic Little Rocket
Shadowrocket is a lightweight yet powerful network tool known for its simple interface and stable performance.
![Shadowrocket](shadowrocket.png)
## Features
> 🎯 Shadowrocket (Little Rocket) is the most popular lightweight proxy tool on iOS platform, beloved by users for its clean interface, stable performance, and affordable price.
- Multi-protocol support: SS, SSR, V2Ray, Xray, Trojan
- Clean and intuitive user interface
- Rule-based routing system
- Script functionality support
- Low resource consumption
## ✨ Product Highlights
## Basic Information
### 🎨 Core Features
- **System Requirements**: iOS 9.0 or later
- **Compatible Devices**: iPhone / iPad
- 🎭 **Clean Interface**: Minimalist design, easy to use
- ⚡ **Stable Performance**: Low resource consumption, smooth operation
- 💰 **Affordable Price**: Only $2.99, excellent value for money
- 🔧 **Practical Functions**: Complete basic features for daily needs
- 🛡️ **Battle-tested**: Years of market validation, excellent reputation
> ⚠️ **Important Notes**
>
> - This app is not available in the mainland China App Store
> - Requires non-mainland China Apple ID for download
### 🔧 Protocol Support
## Usage Guide
| Protocol Type | Support Status | Use Case |
|---------------|----------------|----------|
| 🔒 Shadowsocks (SS) | ✅ | Classic protocol, strong compatibility |
| 🔓 ShadowsocksR (SSR) | ✅ | Enhanced version, anti-detection |
| 🌟 V2Ray (VMess) | ✅ | Modern protocol, feature-rich |
| ⚡ Xray (VLESS) | ✅ | High performance, low latency |
| 🛡️ Trojan | ✅ | HTTPS traffic camouflage |
| 🌐 HTTP/HTTPS | ✅ | Traditional proxy protocols |
| 🧦 SOCKS5 | ✅ | Universal proxy standard |
### Import Configuration
### 📱 System Compatibility
- **Minimum Requirement**: iOS 9.0 or higher
- **Recommended Version**: iOS 12.0 and above
- **Compatible Devices**: iPhone / iPad / iPod Touch
- **Storage Requirement**: About 50MB available space
![Image 1](shadowrocket-01.png)
![Image 2](shadowrocket-02.png)
![Image 3](shadowrocket-03.png)
![Image 4](shadowrocket-04.png)
---
Last updated: 2024.11.17
## 📥 Download & Installation
### 🏪 Official Channels
> ⚠️ **Important Reminder**
>
> - **Not available** in China mainland App Store
> - Requires **non-China mainland Apple ID**
> - Recommend US, Hong Kong, or other region accounts
#### 📍 Price Information
| Region | Price | Notes |
|--------|-------|-------|
| 🇺🇸 US | $2.99 | Recommended, stable |
| 🇭🇰 Hong Kong | HK$23 | Convenient payment |
| 🇯🇵 Japan | ¥370 | Exchange rate advantage |
### 🔑 Apple ID Acquisition
#### Method 1: Self Registration
1. Visit [appleid.apple.com](https://appleid.apple.com)
2. Select non-China mainland region
3. Complete email verification and information filling
#### Method 2: Purchase Ready Account
- Choose reputable merchants
- Pay attention to account security and after-sales service
- Recommend changing password after purchase
---
## 🚀 Configuration Tutorial
### 📋 Prerequisites
Before starting configuration, please ensure:
- ✅ Shadowrocket is successfully installed
- ✅ You have valid server information
- ✅ Network connection is normal
### 🛠️ Import Configuration
#### 🔗 Method 1: Subscription Link Import
##### Step 1: Open Application
Launch Shadowrocket and enter the main interface:
![Application Main Interface](shadowrocket-01.png)
##### Step 2: Add Subscription
Click the `+` icon in the top right corner, select `Subscribe`:
![Add Subscription](shadowrocket-02.png)
##### Step 3: Paste Link
Paste the subscription link in the URL box, click Done:
![Paste Subscription Link](shadowrocket-03.png)
##### Step 4: Update Subscription
Swipe the subscription entry, click `Update` to refresh nodes:
![Update Subscription](shadowrocket-04.png)
#### 📱 Method 2: QR Code Scanning
1. Click the scan icon in the top left corner
2. Scan the QR code provided by the service provider
3. Automatically recognize and import configuration
#### ⌨️ Method 3: Manual Addition
1. Click `+` and select `Add Server`
2. Choose the corresponding protocol type
3. Fill in detailed server information
---
## 🌐 Usage Guide
### 🎯 Connect to Server
1. **Select Node**: Choose appropriate server in main interface
2. **Start Connection**: Click the top switch to enable proxy
3. **Confirm Permissions**: First use requires VPN permission grant
4. **Verify Connection**: Check VPN icon in status bar
### ⚙️ Basic Settings
#### 🔧 Global Routing
- **Configuration**: Configuration → Default
- **Proxy**: All traffic through proxy
- **Direct**: All traffic direct connection
- **Scene**: Smart splitting (recommended)
#### 📊 Rule Configuration
- **Domain Rules**: Traffic splitting by domain name
- **IP Rules**: Traffic splitting by IP address
- **GeoIP**: Traffic splitting by geographical location
---
## 🎛️ Advanced Features
### 📜 Script Support
- **JS Scripts**: Support custom JavaScript
- **Function Extension**: Ad blocking, data modification
- **Community Resources**: Rich script library
### 📈 Network Tools
- **Ping Test**: Check server latency
- **Speed Test**: Test connection speed
- **DNS Query**: Domain name resolution tool
### 🔄 Backup & Restore
- **Export Configuration**: Backup all settings
- **Import Configuration**: Quick setting restoration
- **iCloud Sync**: Multi-device synchronization
---
## ❓ Frequently Asked Questions
### 🔧 Connection Issues
**Q: What to do if connection fails?**
A: Troubleshooting steps:
- Confirm server information is correct
- Check network connection status
- Try switching to other nodes
- Restart application or device
**Q: Slow speed or unstable connection?**
A: Optimization suggestions:
- Select nodes with lower latency
- Avoid peak network usage times
- Check local network quality
- Contact service provider customer service
### 📱 Application Issues
**Q: App crashes or freezes?**
A: Solutions:
- Restart application
- Restart device
- Check iOS version compatibility
- Clear device storage space
**Q: Cannot download application?**
A: Notes:
- Confirm using foreign region Apple ID
- Check if account is valid
- Try switching to different region account
---
## 🔗 Useful Resources
### 📚 Learning Materials
- 📖 [Official User Manual](https://shadowrocket.org)
- 🎥 [Video Tutorial Collection](https://www.youtube.com/results?search_query=shadowrocket+tutorial)
- 💬 [User Community](https://t.me/ShadowrocketApp)
### 🛠️ Tool Recommendations
- 🔧 [Rule Subscription](https://github.com/Loyalsoldier/surge-rules)
- 📜 [Script Collection](https://github.com/yichahucha/surge)
- 🎯 [Traffic Splitting Rules](https://github.com/DivineEngine/Profiles)
---
## 💡 Usage Tips
### ⚡ Performance Optimization
1. **Choose Nodes Wisely**: Select servers with low latency and high speed
2. **Enable Smart Splitting**: Avoid unnecessary proxy traffic
3. **Update Rules Regularly**: Keep rule library current
### 🛡️ Security Recommendations
1. **Protect Account Security**: Don't share Apple ID information
2. **Choose Trusted Providers**: Avoid services from unknown sources
3. **Update App Timely**: Get latest security patches
---
> 📅 Last Updated: July 10, 2025 | 🚀 Applicable Version: Shadowrocket 2.2.38
en-US/ios-ipados/sing-box.md
+276 -25
View File
@@ -1,43 +1,294 @@
# Sing-box - Next Generation Universal Proxy Tool
# 📦 sing-box for iOS - Next-Generation Cross-Platform Proxy Tool
Sing-box is a universal proxy tool developed in Go, featuring high performance and cross-platform compatibility.
> 🌟 sing-box is an emerging cross-platform proxy software developed in Go, providing modern proxy solutions on iOS platform and representing an excellent example of free and open-source proxy tools.
## Features
## ✨ Product Features
- Full protocol support: Shadowsocks, VMess, Trojan, etc.
- Built-in DNS server
- TUN mode support
- Flexible routing system
- Real-time traffic monitoring
### 🎯 Core Advantages
## Basic Information
- 🆓 **Open Source & Free**: Completely open source with free iOS version
- 🚀 **High Performance**: Developed in Go language for excellent performance
- 🌍 **Cross-Platform**: Unified configuration format for consistent multi-platform experience
- 🔄 **Continuous Updates**: Active development team with rapid feature iteration
- 🛡️ **Modern**: Adopts latest networking technologies and security standards
- **System Requirements**: iOS 15.0 or later
### 🔗 Protocol Support
| Protocol Type | Support Status | Feature Description |
|---------------|----------------|---------------------|
| 🔒 Shadowsocks | ✅ | Full version support, performance optimized |
| 🌟 VMess (V2Ray) | ✅ | Complete functionality support |
| ⚡ VLESS | ✅ | Lightweight protocol |
| 🛡️ Trojan | ✅ | TLS camouflaged traffic |
| 🚀 Hysteria | ✅ | QUIC high-speed protocol |
| 🌊 TUIC | ✅ | New QUIC-based protocol |
| 🔐 WireGuard | ✅ | Modern VPN protocol |
| 🧦 SOCKS5 | ✅ | Universal proxy protocol |
### 🛠️ Feature Highlights
| Feature Module | Specific Functions | Advantages |
|----------------|-------------------|------------|
| 🌐 **Network Core** | TUN mode, system proxy | Global traffic takeover |
| 📡 **DNS Service** | Built-in DNS server | Prevent DNS leaks |
| 🎯 **Routing System** | Flexible rule engine | Precise traffic splitting |
| 📊 **Traffic Monitoring** | Real-time statistics and analysis | Detailed usage information |
| 🔧 **Configuration Management** | JSON configuration format | Standardized configuration |
| 🔄 **Hot Reload** | Dynamic configuration updates | No service restart needed |
### 📱 System Requirements
- **Minimum Version**: iOS 15.0 or higher
- **Recommended Version**: iOS 16.0 and above
- **Compatible Devices**: iPhone / iPad
- **Storage Requirement**: About 100MB available space
- **Memory Requirement**: 3GB RAM or above recommended
> ⚠️ **Notes**
---
## 📥 Download & Installation
### 🏪 App Store Information
> 🎉 **Great News**
>
> - This app is not available in the mainland China App Store
> - Requires non-mainland China Apple ID for download
> - sing-box iOS version is **completely free**
> - **Not available** in China mainland App Store
> - Requires **non-China mainland Apple ID**
> - Excellent value compared to other paid apps
> ⚠️ **Important Notice**
#### 💰 Price Comparison
- Please note that Sing-box for iOS is a paid software, you need to purchase it yourself
- Please be aware that this is professional software. We only provide basic usage tutorials and cannot provide troubleshooting or advanced usage support. Your understanding is appreciated.
| App | Price | Open Source | Feature Completeness |
|-----|-------|-------------|---------------------|
| **sing-box** | **Free** | ✅ Open Source | ⭐⭐⭐⭐ |
| Shadowrocket | $2.99 | ❌ Closed Source | ⭐⭐⭐⭐ |
| Quantumult X | $7.99 | ❌ Closed Source | ⭐⭐⭐⭐⭐ |
| Surge | $49.99 | ❌ Closed Source | ⭐⭐⭐⭐⭐ |
## Usage Guide
### 🆚 Advantage Comparison
### Import Configuration
Comparison with other clients:
| Feature Comparison | sing-box | Shadowrocket | Quantumult X |
|-------------------|----------|--------------|--------------|
| 🏷️ **Price** | Free | $2.99 | $7.99 |
| 🔓 **Open Source** | ✅ | ❌ | ❌ |
| 🚀 **Performance** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| 📚 **Ease of Use** | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| 🔧 **Functionality** | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| 🔄 **Update Frequency** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
![Image 1](Singbox-01.png)
![Image 2](Singbox-02.png)
![Image 3](Singbox-03.png)
![Image 4](Singbox-04.png)
---
### Update Configuration
## ⚠️ Usage Notes
### 🆓 Free Software Advantages
> 🎉 **Important Notice**
>
> - sing-box iOS version is **completely free**
> - Based on open source project with transparent and auditable code
> - No need to worry about payment and subscription issues
> - Continuous feature updates with community-driven development
### 🎯 Target Users
> 📋 **Recommended Users**
>
> - ✅ **Budget-Conscious**: Want free but powerful tools
> - ✅ **Tech Enthusiasts**: Love open source software and follow technology development
> - ✅ **Privacy-Focused**: Prefer transparent and auditable code
> - ✅ **Performance Seekers**: Need high-performance proxy solutions
### 📚 Technical Support Scope
> 📋 **Service Description**
>
> - ✅ **Basic Configuration**: Configuration import and connection tutorials provided
> - ✅ **Common Issues**: Basic usage questions answered
> - ❌ **Advanced Configuration**: Complex routing and rule configuration not provided
> - ❌ **JSON Editing**: Manual configuration file editing guidance not provided
> - 💡 **Learning Resources**: Recommend official documentation and community support
![Image 5](Singbox-05.png)
---
Last updated: 2024.11.17
## 🚀 Usage Tutorial
### 📋 Prerequisites
Before starting, please ensure:
- ✅ sing-box downloaded and installed from App Store
- ✅ Valid proxy service configuration available
- ✅ Basic understanding of JSON configuration format
- ✅ Device network connection is normal
### 🛠️ Basic Configuration
#### 🔗 Configuration Import Process
##### Step 1: Launch Application
Open sing-box and enter the main interface:
![Application Main Interface](Singbox-01.png)
> 💡 First launch will require permission setup, please follow the prompts
##### Step 2: Add Configuration
Click the "+" button to add new configuration:
![Add Configuration](Singbox-02.png)
##### Step 3: Import Method
Choose configuration import method (URL, file, or manual):
![Import Method](Singbox-03.png)
##### Step 4: Configuration Details
Enter configuration information and save:
![Configuration Details](Singbox-04.png)
##### Step 5: Enable Connection
Select configuration and start proxy service:
![Enable Connection](Singbox-05.png)
---
## 🎛️ Advanced Features
### 🌐 TUN Mode
- **Global Proxy**: System-level traffic interception
- **DNS Hijacking**: Built-in DNS server prevents leaks
- **Route Table**: Custom routing rules for precise control
### 📊 Traffic Monitoring
- **Real-time Statistics**: Live traffic speed and usage monitoring
- **Connection Details**: View active connections and protocols
- **Historical Data**: Traffic usage history and analytics
### 🔧 Configuration Management
- **JSON Format**: Standard configuration file format
- **Hot Reload**: Dynamic configuration updates without restart
- **Profile Switching**: Quick switching between multiple configurations
---
## ❓ Frequently Asked Questions
### 🔧 Configuration Issues
**Q: Configuration import failed?**
A: Troubleshooting steps:
- Verify configuration file format is correct JSON
- Check network connectivity for URL imports
- Ensure proxy server information is accurate
- Try manual configuration entry
**Q: Connection established but no internet access?**
A: Common solutions:
- Check TUN permission is granted
- Verify DNS settings are correct
- Test with different proxy nodes
- Review routing rules configuration
### 📱 Performance Issues
**Q: High battery consumption?**
A: Optimization tips:
- Disable unnecessary routing rules
- Use direct connection for local traffic
- Reduce logging verbosity
- Close unused features
**Q: Slow connection speeds?**
A: Performance optimization:
- Select geographically closer servers
- Use appropriate encryption methods
- Check local network quality
- Optimize routing configuration
---
## 🔗 Related Resources
### 📚 Official Resources
- 🏠 [sing-box Official GitHub](https://github.com/SagerNet/sing-box)
- 📖 [Configuration Documentation](https://sing-box.sagernet.org/)
- 💬 [Community Discussions](https://github.com/SagerNet/sing-box/discussions)
### 🌟 Community Resources
- 🔧 [Configuration Examples](https://github.com/chika0801/sing-box-examples)
- 📜 [Rule Sets](https://github.com/Loyalsoldier/geoip)
- 🎯 [Tutorial Collection](https://github.com/chengxiaoxiao/sing-box)
### 🛠️ Tools & Utilities
- 🔧 [Configuration Converter](https://github.com/Toperlock/sing-box-subscribe)
- 📊 [Speed Testing](https://fast.com/)
- 🎯 [Rule Generator](https://github.com/MetaCubeX/meta-rules-dat)
---
## 💡 Usage Tips
### ⚡ Performance Optimization
1. **Efficient Routing**: Use precise rules to minimize unnecessary processing
2. **DNS Configuration**: Use reliable DNS servers for better resolution
3. **Regular Updates**: Keep both app and configurations up to date
### 🛡️ Security Best Practices
1. **Configuration Security**: Only use trusted configuration sources
2. **Privacy Protection**: Review and understand what data is processed
3. **Update Vigilance**: Keep software updated for latest security patches
---
## 🎯 Summary & Evaluation
### ✅ Advantages
- 🆓 **Completely Free**: No cost barrier for high-quality proxy tool
- 🔓 **Open Source**: Transparent code for security and trust
- 🚀 **High Performance**: Go language provides excellent speed and efficiency
- 🔄 **Active Development**: Regular updates and feature improvements
### ❌ Considerations
- 📚 **Learning Curve**: JSON configuration may be challenging for beginners
- 🎨 **Interface Simplicity**: Less polished UI compared to paid alternatives
- 📖 **Documentation**: Community-driven support may vary in quality
- 🔧 **Advanced Features**: Some enterprise features may be limited
### 🎯 Recommended For
- 🆓 **Budget Users**: Those seeking free but powerful proxy solutions
- 🔓 **Open Source Advocates**: Users who prefer transparent and auditable software
- 🚀 **Performance Enthusiasts**: Those who prioritize speed and efficiency
- 🌍 **Cross-Platform Users**: Those using multiple operating systems
---
> 📅 Last Updated: July 10, 2025 | 📦 Applicable Version: sing-box for iOS 1.8.0
en-US/ios-ipados/surge.md
+406 -30
View File
@@ -1,50 +1,426 @@
# Surge for iOS/iPadOS
# 🌊 Surge - Enterprise Network Toolkit Platform
Surge is a powerful network toolbox platform that serves not only as a proxy tool but also as a full-featured network debugging utility.
> 💎 Surge is the most professional network tool on iOS platform, not just a proxy software, but a complete network analysis and debugging platform, acclaimed as the benchmark product for mobile network tools.
## Features
## ✨ Product Positioning
- Support for multiple proxy protocols: SS, VMess, Trojan, Snell, etc.
- Powerful rules system
- Real-time network monitoring
- MitM and scripting capabilities
- High-performance and energy-efficient architecture
### 🏢 Enterprise-Grade Features
## Basic Information
- 💼 **Professional Focus**: Designed for network professionals and enterprise users
- 🛡️ **Reliable & Stable**: Enterprise-grade stability proven over years
- 📊 **Comprehensive Features**: Integrates network proxy, monitoring, and analysis
- 🎯 **Precise Control**: Provides the most granular network traffic control
- 🔧 **Highly Professional**: Professional-grade functionality in both depth and breadth
- **System Requirements**: iOS 9.0 or later
### 🎯 Core Values
- 🌟 **Industry Benchmark**: Technical leader among iOS proxy tools
- 🔬 **Network Analysis**: Powerful network diagnosis and analysis capabilities
- 📈 **Performance Monitoring**: Real-time network performance monitoring and statistics
- 🛠️ **Developer Tools**: Essential debugging tool for mobile app developers
- 🏆 **Quality Assurance**: Years of continuous development with guaranteed quality
### 🔗 Protocol Support
| Protocol Type | Support Status | Feature Description |
|---------------|----------------|---------------------|
| 🔒 Shadowsocks (SS) | ✅ | Full version support, well optimized |
| 🌟 VMess (V2Ray) | ✅ | Complete support, excellent performance |
| 🛡️ Trojan | ✅ | Native support, perfect TLS disguise |
| 🐚 Snell | ✅ | Proprietary protocol, exceptional performance |
| 🌐 HTTP/HTTPS | ✅ | Full feature support |
| 🧦 SOCKS5 | ✅ | Complete implementation |
| ❌ ShadowsocksR | ❌ | Explicitly does not support SSR protocol |
### 🛠️ Professional Features
| Feature Module | Specific Functions | Application Scenarios |
|---------------|-------------------|----------------------|
| 📋 **Rules Engine** | Domain/IP/GeoIP/Process rules | Precise traffic splitting |
| 🎭 **Script System** | JavaScript support | Advanced feature extensions |
| 🔍 **MitM Function** | HTTPS decryption analysis | Network debugging analysis |
| 📊 **Real-time Monitoring** | Connection/speed/latency monitoring | Network performance analysis |
| 🔧 **Network Tools** | DNS/Ping/Traceroute | Network diagnostic tools |
| 📈 **Historical Statistics** | Detailed usage statistics | Network behavior analysis |
### 📱 System Requirements
- **Minimum Version**: iOS 9.0 or higher
- **Recommended Version**: iOS 14.0 and above
- **Compatible Devices**: iPhone / iPad
- **Software Version**: Surge 2/3/4/5
- **Storage Required**: Approximately 300MB available space
- **Memory Required**: Recommended 4GB RAM or more
> ⚠️ **Notes**
---
## 📥 Purchase & Download
### 🏪 App Store Pricing
> 💰 **Price Alert**
>
> - This app is not available in the mainland China App Store
> - Requires non-mainland China Apple ID for download
> - Does not support SSR protocol
> - Surge is the **most expensive** proxy software on iOS platform
> - **Not available** in mainland China App Store
> - Requires **non-mainland China Apple ID**
> - Offers **7-day free trial** - try before you buy
#### 💎 Version Pricing
| Version | Region | Price | Feature Description |
|---------|--------|-------|-------------------|
| **Surge 5** | 🇺🇸 US Store | $49.99 | Latest version, most comprehensive features |
| **Surge 5** | 🇭🇰 HK Store | HK$388 | Convenient payment option |
| **Surge 4** | 🇺🇸 US Store | $39.99 | Previous generation |
| **Surge 3** | 🇺🇸 US Store | $29.99 | Older version, limited features |
#### 📊 Version Feature Comparison
| Feature | Surge 3 | Surge 4 | Surge 5 |
|---------|---------|---------|---------|
| 🔧 **Basic Proxy** | ✅ | ✅ | ✅ |
| 📜 **Script Support** | ✅ | ✅ | ✅ |
| 🎯 **Advanced Rules** | ✅ | ✅ | ✅ |
| 📊 **Network Monitoring** | Basic | Enhanced | Complete |
| 🛡️ **Security Features** | Basic | Enhanced | Latest |
| 🔄 **Update Frequency** | Stopped | Slow | Active |
### 🆚 Competitor Comparison
Detailed comparison with other high-end clients:
| Feature | Surge 5 | Quantumult X | Shadowrocket |
|---------|---------|--------------|--------------|
| 🏷️ **Price** | $49.99 | $7.99 | $2.99 |
| 🎯 **Target** | Enterprise | Advanced Users | General Users |
| 📊 **Network Analysis** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
| 🔧 **Ease of Use** | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| 🛡️ **Stability** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| 📚 **Learning Curve** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐ |
| 🎨 **Customization** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
---
## ⚠️ Usage Guidelines
### 💰 Paid Software Notice
> ⚠️ **Important Notice**
>
> - Surge is **paid software** priced at **$49.99**
> - It is the **most expensive** proxy app on iOS platform
> - Offers **7-day free trial** - recommend trying before purchasing
> - Designed for **professional users** with complex features and high learning curve
- Please note that Surge for iOS is a paid software that requires purchase, but it offers a 7-day trial
- Please be aware that this is professional software. We only provide basic usage tutorials and cannot provide troubleshooting or advanced usage support. Your understanding is appreciated.
### 🎯 Target Audience
> 📋 **Recommended Users**
>
> - ✅ **Network Professionals**: Network engineers, system administrators
> - ✅ **Developers**: Mobile and web application developers
> - ✅ **Enterprise Users**: Those requiring highest stability and functionality
> - ✅ **Budget Flexible**: Users not concerned about software price, seeking best experience
> - ❌ **General Users**: Features too professional, not recommended for casual users
## Usage Guide
### 📚 Technical Support Scope
### Import Configuration
> 📋 **Service Description**
>
> - ✅ **Basic Configuration**: Subscription import and basic connection tutorials
> - ✅ **Common Questions**: Answers to basic usage questions
> - ❌ **Advanced Configuration**: No professional-level rules and script configuration
> - ❌ **Troubleshooting**: No in-depth technical support
> - ❌ **Network Debugging**: No network analysis guidance
> - 💡 **Learning Suggestion**: Recommend learning through official documentation and professional training
![Image 1](surge-01.png)
![Image 2](surge-02.png)
![Image 3](surge-03.png)
![Image 4](surge-04.png)
![Image 5](surge-05.png)
![Image 6](surge-06.png)
![Image 7](surge-07.png)
![Image 8](surge-08.png)
---
### Update Configuration
## 🚀 Usage Tutorial
### 📋 Preparation
Before starting, please confirm:
- ✅ Purchased and installed Surge (recommend trying 7-day trial first)
- ✅ Have valid server configuration information
- ✅ Have basic understanding of network technology
- ✅ Prepared to invest time learning professional features
### 🛠️ Basic Configuration
#### 🔗 Configuration Import Tutorial
##### Step 1: Launch Application
Open Surge and enter the main interface:
![Application Main Interface](surge-01.png)
> 💡 First launch requires basic setup configuration, recommend choosing default settings
##### Step 2: Access Settings
Tap the settings button in the top right corner:
![Settings Entry](surge-02.png)
##### Step 3: Configuration Management
Find "Configuration Files" or "Profiles" option:
![Configuration Management](surge-03.png)
##### Step 4: Add Configuration
Tap the "+" button and select addition method:
![Add Configuration](surge-04.png)
##### Step 5: Enter Information
Fill in configuration according to provided information:
![Enter Configuration Info](surge-05.png)
##### Step 6: Verify Configuration
Confirm configuration information is correct:
![Verify Configuration](surge-06.png)
##### Step 7: Apply Configuration
Select the newly added configuration and apply:
![Apply Configuration](surge-07.png)
##### Step 8: Start Service
Enable proxy service and begin using:
![Start Service](surge-08.png)
![Image 9](surge-07.png)
---
Last updated: 2024.11.17
### 🔄 Configuration Management
#### 📱 Update Configuration
Regularly update configuration files to maintain latest status:
![Update Configuration](surge-09.png)
> 💡 **Update Recommendations**
>
> - Recommend setting up automatic updates
> - Can set update frequency
> - Supports background silent updates
---
## 🎛️ Enterprise-Grade Features
### 📊 Network Monitoring
Surge's network monitoring capability is its core advantage:
#### 🔍 Real-time Monitoring
- **Connection Monitoring**: View all active network connections
- **Speed Monitoring**: Real-time display of upload/download speeds
- **Latency Monitoring**: Monitor network latency changes
- **Traffic Statistics**: Statistics by application and domain
#### 📈 Historical Analysis
- **Usage Trends**: Long-term network usage trend analysis
- **Performance Reports**: Detailed network performance reports
- **Fault Records**: Network failure and anomaly records
- **Optimization Suggestions**: Data-based optimization recommendations
### 🛠️ Network Tools
Integrated professional network tools:
- **DNS Query**: Detailed DNS resolution tools
- **Ping Test**: Network connectivity testing
- **Traceroute**: Network path tracing
- **Port Scanning**: Network port status detection
### 🔍 MitM Functionality
Man-in-the-middle attack functionality for HTTPS analysis:
- **Certificate Management**: Automatic certificate generation and management
- **Traffic Decryption**: HTTPS traffic decryption analysis
- **Request Modification**: Modify HTTP requests and responses
- **API Debugging**: Mobile application API debugging
---
## 🎯 Professional Configuration
### 📋 Advanced Rules
Surge supports the most complex rule configurations:
```ini
# Process-based rules
PROCESS-NAME,WeChat,DIRECT
PROCESS-NAME,QQ,DIRECT
# User-agent based rules
USER-AGENT,*WeChat*,DIRECT
# Time-based rules
TIME,9:00-18:00,WORK-PROXY
# Network environment based rules
NETWORK,WIFI:HOME,DIRECT
NETWORK,CELLULAR,PROXY
```
### 🎭 Script Features
JavaScript script extension support:
```javascript
// HTTP request modification script
let headers = $request.headers;
headers['User-Agent'] = 'Custom-Agent';
$done({headers});
// HTTP response modification script
let body = $response.body;
let obj = JSON.parse(body);
obj.vip = true;
$done({body: JSON.stringify(obj)});
```
### 🔄 Policy Groups
Complex policy group configurations:
```ini
# URL test group
url-test = Auto,Server1,Server2,Server3,url = http://www.gstatic.com/generate_204
# Load balance group
load-balance = Balance,Server1,Server2,Server3,persistent = true
# Fallback group
fallback = Fallback,Server1,Server2,Server3,url = http://www.gstatic.com/generate_204
```
---
## ❓ Frequently Asked Questions
### 🔧 Technical Issues
**Q: Unable to install MitM certificate?**
A: Solution steps:
- Generate new CA certificate
- Complete certificate installation following the wizard
- Trust certificate in system settings
- Confirm certificate is enabled in "Certificate Trust Settings"
**Q: Rules not working?**
A: Check points:
- Confirm rule syntax is correct
- Check rule priority order
- Verify matching conditions are accurate
- Check real-time logs to confirm matching
### 💰 Purchase Issues
**Q: Is it worth purchasing?**
A: Evaluation points:
- Are you a professional user or developer
- Do you need detailed network analysis features
- Is budget sufficient ($49.99)
- Do you have time to learn complex features
**Q: Trial period limitations?**
A: Trial description:
- Provides 7-day full feature trial
- Can experience all features during trial
- Need to purchase to continue after trial ends
- Recommend fully utilizing trial period for evaluation
---
## 🔗 Learning Resources
### 📚 Official Resources
- 🏠 [App Store Page](https://apps.apple.com/app/surge-5/id1442620678)
- 📖 [Official Manual](https://manual.nssurge.com/)
- 🎯 [Configuration Examples](https://github.com/ConnersHua/Profiles)
- 🔧 [Rule Collections](https://github.com/Loyalsoldier/surge-rules)
### 💬 Community Support
- 🔗 [Telegram Group](https://t.me/surge_users)
- 📢 [Official Twitter](https://twitter.com/nssurge)
- 💭 [Reddit Community](https://www.reddit.com/r/nssurge/)
### 🎓 Professional Training
- 📺 [Official Video Tutorials](https://www.youtube.com/c/nssurge)
- 📖 [In-depth Configuration Guide](https://surge.mitsea.com/)
- 🛠️ [Enterprise Deployment Guide](https://manual.nssurge.com/book/understanding-surge/en/)
---
## 💡 Best Practices
### 🎯 Usage Strategies
1. **Progressive Learning**: Start with basic features, gradually learn advanced capabilities
2. **Full Trial**: Utilize 7-day trial period for comprehensive evaluation
3. **Community Learning**: Actively participate in community, learn from others' experiences
4. **Continuous Optimization**: Continuously optimize configuration based on usage
### 🛡️ Security Recommendations
1. **Certificate Management**: Properly manage MitM certificates, avoid security risks
2. **Configuration Backup**: Regularly backup important configuration files
3. **Permission Control**: Reasonably set permissions for various features
4. **Privacy Protection**: Pay attention to privacy implications of network monitoring features
---
## 🎯 Summary & Evaluation
### ✅ Core Advantages
- 🏆 **Industry Benchmark**: Most professional network tool on iOS platform
- 📊 **Most Comprehensive Features**: Unmatched network analysis and debugging capabilities
- 🛡️ **Reliable & Stable**: Enterprise-grade stability, battle-tested
- 🔧 **Highly Professional**: Meets the most demanding professional requirements
### ❌ Notable Disadvantages
- 💰 **Expensive**: $49.99 price makes it unaffordable for general users
- 📚 **High Learning Curve**: Complex features require significant time investment
- 🔧 **Complex Operation**: Not suitable for users seeking simplicity
- 🎯 **Limited Audience**: Primarily targets professional users and enterprise customers
### 🎯 Applicable Scenarios
- 💼 **Enterprise Environment**: Enterprises requiring professional network management
- 🔬 **Development Debugging**: Mobile app development and API debugging
- 📊 **Network Analysis**: Detailed network data analysis needs
- 🎓 **Professional Learning**: Network technology learning and research
---
> 📅 Last Updated: July 10, 2025 | 🌊 Compatible Version: Surge 5.9.0