🔄 Subscription Setup Guide
Learn how to add, manage, and auto-update server subscriptions in Shadowrocket
What are Subscriptions? Subscriptions allow you to automatically import and update multiple servers from a single URL provided by your VPN service provider.
📱 Adding a Subscription (iOS)
- Open Shadowrocket app
- Tap the "+" button (top-right corner)
- Select "Subscribe" from the menu
- Paste your subscription URL in the URL field
- Add a descriptive name (e.g., "MyVPN Servers")
- Tap "Done" to save
- Servers will be imported automatically
- Pull down to refresh and update servers
💻 Adding a Subscription (Desktop)
- Launch Shadowrocket application
- Click "Subscription" or "Subscribe"
- Enter subscription URL in the input field
- Provide a name for easy identification
- Click "Add" or "Subscribe"
- Wait for automatic server import
- Check server list for new entries
🔗 Subscription URL Formats
Common URL Examples:
Standard HTTP/HTTPS:
https://example.com/api/v1/client/subscribe?token=abc123def456Base64 Encoded:
https://provider.com/sub/aHR0cHM6Ly9leGFtcGxlWith User Authentication:
https://api.vpnprovider.com/user/12345/subscription?key=secret⚙️ Subscription Management
Updating Subscriptions:
- Manual Update: Pull down on subscription or click "Update"
- Auto Update: Enable automatic updates in settings
- Update Frequency: Set how often to check for updates
- Update on Launch: Refresh subscriptions when app starts
Managing Multiple Subscriptions:
- Name subscriptions clearly (e.g., "Work VPN", "Personal Servers")
- Enable/disable specific subscriptions as needed
- Check update status and last refresh time
- Remove unused or expired subscriptions
Subscription Settings:
- User Agent: Set custom user agent for requests
- Update Interval: Configure automatic update frequency
- Include/Exclude Rules: Filter specific servers
- Backup Settings: Export subscription configurations
🔧 Advanced Configuration
Subscription Filters:
Include only specific regions:
https://provider.com/sub/token123?filter=US|JP|SGExclude certain servers:
https://provider.com/sub/token123?exclude=CN|RUCustom Headers:
- Add authentication headers if required
- Set custom User-Agent strings
- Include API keys in headers
- Configure timeout settings
🚨 Troubleshooting Subscriptions
Subscription Won't Load
- Check if URL is correct and accessible
- Verify internet connection
- Try updating manually first
- Contact provider for valid subscription link
Servers Not Updating
- Check last update time in subscription list
- Force manual update by pulling down
- Verify auto-update is enabled
- Check if subscription has expired
Authentication Errors
- Verify subscription URL includes valid token
- Check if account is active with provider
- Regenerate subscription URL from provider
- Contact provider support for assistance
No Servers Imported
- Check if URL format is supported
- Try different subscription format (v2ray, ss, etc.)
- Verify provider supports Shadowrocket
- Test URL in browser to see response
🔒 Security Best Practices
- Use HTTPS URLs: Always use secure HTTPS subscription URLs
- Keep URLs Private: Don't share subscription URLs with others
- Regular Updates: Enable auto-updates to get latest servers
- Backup Subscriptions: Save subscription URLs securely
- Monitor Usage: Check for unexpected server changes
- Verify Provider: Only use trusted VPN providers
- Clean Old Subscriptions: Remove expired or unused subscriptions
💡 Pro Tips
Organization Tips:
- Use descriptive names for subscriptions
- Group similar providers together
- Tag subscriptions by purpose (work, gaming, streaming)
- Keep active subscriptions at the top
Performance Tips:
- Set reasonable update intervals (6-24 hours)
- Disable unused subscriptions
- Use subscription filters to reduce server count
- Monitor bandwidth usage from subscriptions
🎉 Subscriptions Ready!
Your subscriptions are now configured and will automatically stay updated.