macOS User Quick Start Guide
This tutorial will provide detailed instructions for installing and configuring Hiddify Next on macOS systems, supporting both Intel and Apple Silicon Macs.
📋 System Requirements
- Operating System: macOS 10.15 Catalina or later
- Architecture: Intel x64 or Apple Silicon (M1/M2/M3)
- Memory: At least 4GB RAM
- Storage: At least 200MB available space
- Permissions: Administrator privileges required for network configuration
🔽 Step 1: Download and Installation
Method 1: Direct Download (Recommended)
- Visit our Download Center page
- Download the “macOS (Universal)” DMG file
- Double-click the downloaded DMG file to mount
- Drag Hiddify Next to the Applications folder
- Eject the DMG file
Method 2: Homebrew Installation
If you have Homebrew installed:
| |
🔐 Step 2: Security Settings
macOS may block unsigned applications. Follow these steps:
First Launch
- Open Applications folder
- Right-click Hiddify Next
- Select “Open” from the context menu
- In the security dialog, click “Open”
Alternative Method
If the above doesn’t work:
- Open System Preferences > Security & Privacy
- In the General tab, click “Open Anyway” next to the Hiddify Next message
- Enter your administrator password
Gatekeeper Bypass (Advanced Users)
| |
⚙️ Step 3: Network Permissions
macOS requires explicit permission for network access:
Grant Network Extension Permission
- Launch Hiddify Next
- When prompted for network extension permission, click “Allow”
- Enter your administrator password
- The system may require a restart
Manual Permission Configuration
If automatic permission fails:
- Open System Preferences > Security & Privacy
- Click the Privacy tab
- Select “Network Extensions” from the left sidebar
- Check the box next to Hiddify Next
🔗 Step 4: Add Subscription Configuration
Launch the Hiddify Next application
Click the "+" button in the main interface
Choose the import method:
- Import from Clipboard: If subscription link is already copied
- Import from URL: Manually enter subscription link
- Import Configuration File: Select local configuration file
Enter your subscription link
Click “Add” to complete the import
🌐 Step 5: Connection Test
- View imported servers in the node list
- Click “Latency Test” to test node connectivity
- Select a node with low latency
- Click the “Connect” button to start proxy
Connection successful! Open Terminal and run curl ipinfo.io to check if your current IP address has changed.
🔧 Advanced Configuration
System Proxy Settings
Automatic Configuration (Recommended)
Hiddify Next can automatically configure system proxy settings:
- In Hiddify Next settings, enable “Auto Configure System Proxy”
- The application will automatically manage proxy settings when connecting/disconnecting
Manual Configuration
If you prefer manual configuration:
- Open System Preferences > Network
- Select your active network connection
- Click “Advanced…” > “Proxies” tab
- Configure proxy settings:
- HTTP Proxy: 127.0.0.1:8080
- HTTPS Proxy: 127.0.0.1:8080
- SOCKS Proxy: 127.0.0.1:1080
Menu Bar Integration
- In Hiddify Next settings, enable “Show in Menu Bar”
- The application icon will appear in the menu bar
- Click the icon for quick access to connection status and settings
Launch at Login
- Open System Preferences > Users & Groups
- Select your user account
- Click the “Login Items” tab
- Click "+" and add Hiddify Next from Applications
Or enable in the application:
- Open Hiddify Next preferences
- Check “Launch at Login”
🛡️ Firewall Configuration
Built-in Firewall
If macOS Firewall is enabled:
- Open System Preferences > Security & Privacy > Firewall
- Click “Firewall Options…”
- Ensure Hiddify Next is allowed to receive incoming connections
Third-party Firewall
For applications like Little Snitch:
- Allow Hiddify Next to make outbound connections
- Allow connections to proxy ports (typically 8080, 1080)
- Allow DNS queries if using custom DNS
📱 Browser Configuration
Safari
Safari will automatically use system proxy settings when enabled.
Chrome
Chrome typically uses system proxy settings, but you can also configure manually:
| |
Firefox
Firefox has independent proxy settings:
- Open Firefox preferences
- Search for “proxy”
- Click “Settings…” next to “Configure Proxy Access to the Internet”
- Select “Manual proxy configuration”
- Configure SOCKS proxy: 127.0.0.1:1080
❓ Common Issues
Q: Application won’t start after installation?
A: Try these solutions:
- Check system compatibility (macOS 10.15+)
- Remove quarantine attribute:
sudo xattr -rd com.apple.quarantine /Applications/Hiddify\ Next.app - Restart your Mac and try again
- Check Console.app for error messages
Q: “Network Extension” permission denied?
A: Solutions:
- Restart your Mac after granting permission
- Check System Preferences > Security & Privacy > Privacy > Network Extensions
- Try disabling and re-enabling the permission
- Contact support if the issue persists
Q: Connection successful but websites won’t load?
A: Troubleshooting steps:
- Check DNS settings in Hiddify Next
- Try different server nodes
- Disable other VPN applications
- Reset network settings: System Preferences > Network > Advanced > TCP/IP > Renew DHCP Lease
Q: High battery consumption?
A: Optimization tips:
- Use efficient protocols (VLESS, Trojan)
- Reduce connection frequency
- Disable unnecessary features like real-time speed monitoring
- Close the application when not needed
Q: Conflicts with other proxy applications?
A: Solutions:
- Quit other proxy applications before using Hiddify Next
- Check for port conflicts (change proxy ports if needed)
- Reset network configuration
- Use different proxy protocols
🔄 Updates and Maintenance
Automatic Updates
- Enable automatic updates in preferences
- The application will check for updates periodically
- You’ll be notified when updates are available
Manual Updates
- Visit our Download Center
- Download the latest version
- Replace the old application in the Applications folder
Backup Configuration
Export your configuration regularly:
- Open Hiddify Next
- Go to Settings > Backup & Restore
- Click “Export Configuration”
- Save the file to a secure location
🚀 Next Steps
Now that you’ve mastered the basic usage, you can continue learning:
If you encounter any issues, feel free to check our FAQ page or contact support.