Help CenteršŸ”§ InstallationšŸŒ ServersšŸšØ TroubleshootingšŸ’¬ Contact

šŸ“„ Config Files Guide

Learn how to import, create, and manage configuration files in Shadowrocket

What are Config Files? Configuration files (.conf) contain server settings, rules, and preferences that can be imported to quickly set up Shadowrocket.

šŸ“„ Importing Config Files

Method 1: Direct File Import

  1. Download the .conf file from your provider
  2. Open Shadowrocket app
  3. Tap "+" ā†’ "Import from File"
  4. Browse and select the configuration file
  5. Review the imported settings
  6. Tap "Import" to add all servers and rules

Method 2: URL Import

  1. Get configuration URL from your provider
  2. Tap "+" ā†’ "Import from URL"
  3. Paste the configuration URL
  4. Tap "Download"
  5. Review and confirm the import

šŸ“ Configuration File Structure

Basic .conf File Example:

[General]
# Shadowrocket Configuration
bypass-system = true
skip-proxy = 192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12, localhost, *.local
bypass-tun = 10.0.0.0/8, 100.64.0.0/10, 127.0.0.0/8, 169.254.0.0/16
dns-server = 8.8.8.8, 8.8.4.4
fallback-dns-server = system

[Rule]
# Block ads
DOMAIN-SUFFIX,doubleclick.net,REJECT
DOMAIN-SUFFIX,googlesyndication.com,REJECT

# Direct connections
DOMAIN-SUFFIX,apple.com,DIRECT
DOMAIN-SUFFIX,icloud.com,DIRECT

# Proxy rules
DOMAIN-SUFFIX,youtube.com,PROXY
DOMAIN-SUFFIX,twitter.com,PROXY
FINAL,DIRECT

[Proxy]
# Server configurations
ss1 = ss, server1.example.com, 443, encrypt-method=aes-256-gcm, password=password123
vmess1 = vmess, server2.example.com, 443, username=uuid-here, ws=true, tls=true

[Proxy Group]
# Server groups
šŸš€ Proxy = select, ss1, vmess1, DIRECT

āš™ļø Configuration Sections

[General] Section

  • bypass-system: Use system proxy settings
  • skip-proxy: Local network ranges
  • dns-server: Primary DNS servers
  • fallback-dns-server: Backup DNS
  • ipv6: Enable IPv6 support
  • test-timeout: Connection test timeout

[Rule] Section

  • DOMAIN-SUFFIX: Match domain endings
  • DOMAIN: Exact domain match
  • DOMAIN-KEYWORD: Contains keyword
  • IP-CIDR: IP address ranges
  • GEOIP: Geographic IP rules
  • FINAL: Default action

[Proxy] Section

  • ss: Shadowsocks servers
  • vmess: V2Ray servers
  • trojan: Trojan servers
  • http/https: HTTP proxies
  • socks5: SOCKS5 proxies

[Proxy Group]

  • select: Manual selection
  • url-test: Auto-select fastest
  • fallback: Failover servers
  • load-balance: Balance traffic

šŸ› ļø Creating Custom Configs

Step-by-Step Config Creation:

  1. Start with General Settings: Set DNS, bypass rules
  2. Add Your Servers: Include all proxy servers
  3. Create Proxy Groups: Organize servers by region/purpose
  4. Define Rules: Set routing for different domains/IPs
  5. Test Configuration: Validate syntax and connectivity
  6. Save and Share: Export for backup or sharing

Advanced Rules Examples:

# Streaming services
DOMAIN-SUFFIX,netflix.com,šŸŽ¬ Streaming
DOMAIN-SUFFIX,hulu.com,šŸŽ¬ Streaming
DOMAIN-SUFFIX,disneyplus.com,šŸŽ¬ Streaming

# Social media
DOMAIN-SUFFIX,facebook.com,šŸ“± Social
DOMAIN-SUFFIX,instagram.com,šŸ“± Social
DOMAIN-SUFFIX,twitter.com,šŸ“± Social

# Gaming
DOMAIN-SUFFIX,steam.com,šŸŽ® Gaming
DOMAIN-SUFFIX,battle.net,šŸŽ® Gaming
DOMAIN-SUFFIX,epicgames.com,šŸŽ® Gaming

# Ad blocking
DOMAIN-SUFFIX,googlesyndication.com,REJECT
DOMAIN-SUFFIX,googleadservices.com,REJECT
DOMAIN-KEYWORD,ads,REJECT

šŸ“± Platform-Specific Config Tips

iOS/iPhone:

  • Use AirDrop to transfer .conf files
  • Import via Files app integration
  • Share configs via iCloud Drive
  • Use iTunes file sharing
  • Enable "Open in Shadowrocket"

Android:

  • Download configs to Downloads folder
  • Use file manager to locate files
  • Share via Bluetooth or WiFi Direct
  • Store in cloud storage (Google Drive)
  • Use QR codes for sharing

Windows/macOS:

  • Drag and drop files into app
  • Use "Import from File" menu
  • Double-click .conf files
  • Import from clipboard
  • Batch import multiple configs

Best Practices:

  • Always backup working configs
  • Test configs before sharing
  • Use descriptive server names
  • Keep configs updated regularly
  • Document custom rules

šŸ”§ Troubleshooting Config Issues

Import Failed

  • Check file format is .conf or valid text
  • Verify syntax is correct (no typos)
  • Ensure file is not corrupted
  • Try importing individual sections

Rules Not Working

  • Check rule order (more specific first)
  • Verify domain/IP syntax
  • Test with simple rules first
  • Clear DNS cache after changes

Servers Not Connecting

  • Validate server credentials
  • Check server addresses and ports
  • Test individual servers manually
  • Verify encryption methods

šŸ“š Popular Config Templates

Gaming Optimized:

  • Low latency server selection
  • Gaming platform rules
  • Speed test integration
  • Fallback configurations

Streaming Focused:

  • Regional streaming rules
  • High bandwidth servers
  • Content platform routing
  • Buffer optimization

Privacy Enhanced:

  • Maximum encryption
  • DNS leak prevention
  • Ad/tracker blocking
  • Kill switch rules

Business Use:

  • Corporate network rules
  • Work app priorities
  • Security compliance
  • Audit logging

šŸŽÆ Master Configuration Files!

With config files, you can create powerful, customized Shadowrocket setups.

Add ServersSubscription Setup
;