Getting Started ⏱️ 预计阅读时间:5 分钟

macOS User Quick Start Guide

发布日期:2024-01-15 难度:Easy 最后更新:2024-01-15

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

  1. Visit our Download Center page
  2. Download the “macOS (Universal)” DMG file
  3. Double-click the downloaded DMG file to mount
  4. Drag Hiddify Next to the Applications folder
  5. Eject the DMG file

Method 2: Homebrew Installation

If you have Homebrew installed:

1
2
3
4
5
# Add our tap
brew tap hiddify/tap

# Install Hiddify Next
brew install --cask hiddify-next

🔐 Step 2: Security Settings

macOS may block unsigned applications. Follow these steps:

First Launch

  1. Open Applications folder
  2. Right-click Hiddify Next
  3. Select “Open” from the context menu
  4. In the security dialog, click “Open”

Alternative Method

If the above doesn’t work:

  1. Open System Preferences > Security & Privacy
  2. In the General tab, click “Open Anyway” next to the Hiddify Next message
  3. Enter your administrator password

Gatekeeper Bypass (Advanced Users)

1
2
3
4
5
# Remove quarantine attribute
sudo xattr -rd com.apple.quarantine /Applications/Hiddify\ Next.app

# Allow execution
sudo spctl --add /Applications/Hiddify\ Next.app

⚙️ Step 3: Network Permissions

macOS requires explicit permission for network access:

Grant Network Extension Permission

  1. Launch Hiddify Next
  2. When prompted for network extension permission, click “Allow”
  3. Enter your administrator password
  4. The system may require a restart

Manual Permission Configuration

If automatic permission fails:

  1. Open System Preferences > Security & Privacy
  2. Click the Privacy tab
  3. Select “Network Extensions” from the left sidebar
  4. Check the box next to Hiddify Next

🔗 Step 4: Add Subscription Configuration

  1. Launch the Hiddify Next application

  2. Click the "+" button in the main interface

  3. 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
  4. Enter your subscription link

  5. Click “Add” to complete the import

🌐 Step 5: Connection Test

  1. View imported servers in the node list
  2. Click “Latency Test” to test node connectivity
  3. Select a node with low latency
  4. 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

Hiddify Next can automatically configure system proxy settings:

  1. In Hiddify Next settings, enable “Auto Configure System Proxy”
  2. The application will automatically manage proxy settings when connecting/disconnecting

Manual Configuration

If you prefer manual configuration:

  1. Open System Preferences > Network
  2. Select your active network connection
  3. Click “Advanced…” > “Proxies” tab
  4. Configure proxy settings:
    • HTTP Proxy: 127.0.0.1:8080
    • HTTPS Proxy: 127.0.0.1:8080
    • SOCKS Proxy: 127.0.0.1:1080
  1. In Hiddify Next settings, enable “Show in Menu Bar”
  2. The application icon will appear in the menu bar
  3. Click the icon for quick access to connection status and settings

Launch at Login

  1. Open System Preferences > Users & Groups
  2. Select your user account
  3. Click the “Login Items” tab
  4. Click "+" and add Hiddify Next from Applications

Or enable in the application:

  1. Open Hiddify Next preferences
  2. Check “Launch at Login”

🛡️ Firewall Configuration

Built-in Firewall

If macOS Firewall is enabled:

  1. Open System Preferences > Security & Privacy > Firewall
  2. Click “Firewall Options…”
  3. Ensure Hiddify Next is allowed to receive incoming connections

Third-party Firewall

For applications like Little Snitch:

  1. Allow Hiddify Next to make outbound connections
  2. Allow connections to proxy ports (typically 8080, 1080)
  3. 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:

1
2
# Launch Chrome with specific proxy
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --proxy-server="socks5://127.0.0.1:1080"

Firefox

Firefox has independent proxy settings:

  1. Open Firefox preferences
  2. Search for “proxy”
  3. Click “Settings…” next to “Configure Proxy Access to the Internet”
  4. Select “Manual proxy configuration”
  5. 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

  1. Enable automatic updates in preferences
  2. The application will check for updates periodically
  3. You’ll be notified when updates are available

Manual Updates

  1. Visit our Download Center
  2. Download the latest version
  3. Replace the old application in the Applications folder

Backup Configuration

Export your configuration regularly:

  1. Open Hiddify Next
  2. Go to Settings > Backup & Restore
  3. Click “Export Configuration”
  4. 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.

macOS Mac Installation Configuration Apple