Troubleshooting
This guide covers the most common issues users encounter with v2RayTun and WaterlineSurf, along with step-by-step solutions.
---
Cannot Connect / Connection Timeout
Possible causes and solutions:
Wrong server selected — Try switching to a different server in the v2RayTun server list. Servers closer to your location generally perform better.
Subscription not updated — Your server list may be outdated. Update your subscription (see Setup Instructions Step 4) and retry.
Firewall or antivirus blocking — Temporarily disable your firewall or antivirus software to test. If this resolves the issue, add v2RayTun to the allow-list.
VPN permission not granted — On iOS/Android, ensure v2RayTun has VPN permission in your device's Settings → VPN.---
Slow Connection Speed
Switch server — Select a server with lower latency. v2RayTun shows ping times in the server list.
Check your local network — Run a speed test without the VPN to confirm your base connection speed.
Update subscription — New, less-congested servers may have been added. Update your subscription and try a different node.
Restart the app — Close v2RayTun completely and reopen it, then reconnect.---
Subscription Link Import Fails
Check the link — Make sure you copied the entire subscription URL from your Dashboard without extra spaces.
Network connectivity — Ensure your device has internet access before importing.
Re-copy from Dashboard — Log in again and copy a fresh subscription link; the old link may have expired.
Manual server add — As a fallback, you can add individual servers manually using the server configuration details found in your Dashboard.---
App Crashes or Won't Open
Restart your device — A simple reboot often resolves startup issues.
Reinstall v2RayTun — Uninstall the app, download the latest version from the official source, and reinstall.
Check OS compatibility — Ensure your OS meets the minimum requirements: Windows 10+, macOS 12+, iOS 14+, Android 5.0+.---
Traffic Usage Seems Incorrect
Sync traffic — In your WaterlineSurf Dashboard, click Sync Traffic to force a refresh of your usage data.
Multiple devices — If you use the same subscription on multiple devices simultaneously, traffic is counted across all of them.
Contact support — If the discrepancy is significant, contact us via the support channels listed on the About Us page.---
Still Need Help?
If none of the above solutions work, please reach out to our support team through the contact information on the About Us page. Include your account email, the platform you are using, and a brief description of the issue.