Linux User Quick Start Guide

This tutorial will provide detailed instructions for installing and configuring Hiddify Next on Linux systems, covering mainstream Linux distributions and multiple installation methods.

📋 System Requirements

• Operating System: Any modern Linux distribution (64-bit)
• Kernel Version: Linux 3.2 or higher
• Architecture: x86_64 (amd64)
• Memory: At least 1GB RAM
• Storage: At least 100MB available space
• Permissions: Administrator privileges required for network configuration

🔽 Step 1: Choose Installation Method

Select the most suitable installation method for your Linux distribution:

AppImage Format (Recommended)

Suitable for: All Linux distributions, no dependency installation required

1. Visit our Download Center page
2. Download the “Linux (AppImage)” file
3. After download, add execute permissions to the file:

1

chmod +x Hiddify-Linux-x64.AppImage

4. Double-click to run or execute in terminal:

1

./Hiddify-Linux-x64.AppImage

AppImage Advantages:

• No installation required, download and use
• Independent of system package manager
• Self-contained with all dependency libraries
• Compatible with all Linux distributions

DEB Package Installation

Suitable for: Ubuntu, Debian, Linux Mint, elementary OS, etc.

1. Download the DEB installation package
2. Install using package manager:

1
2
3
4
5
6
7
8

# Using dpkg to install
sudo dpkg -i hiddify-next.deb

# Install dependencies (if needed)
sudo apt-get install -f

# Or use apt to install directly
sudo apt install ./hiddify-next.deb

RPM Package Installation

Suitable for: Red Hat, CentOS, Fedora, openSUSE, etc.

1
2
3
4
5
6
7
8

# CentOS/RHEL
sudo rpm -ivh hiddify-next.rpm

# Or using dnf (Fedora)
sudo dnf install hiddify-next.rpm

# openSUSE
sudo zypper install hiddify-next.rpm

Arch Linux Installation

Suitable for: Arch Linux, Manjaro, etc.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# Using yay (recommended)
yay -S hiddify-next

# Or using paru
paru -S hiddify-next

# Manual compilation and installation
git clone https://aur.archlinux.org/hiddify-next.git
cd hiddify-next
makepkg -si

⚙️ Step 2: Launch Application

Graphical Interface Launch

1. Search for “Hiddify Next” in the application menu
2. Click the application icon to launch
3. Or search and launch in Activities Overview

Command Line Launch

1
2
3
4
5

# If installed via package manager
hiddify-next

# If using AppImage
./Hiddify-Linux-x64.AppImage

🔧 Step 3: System Permissions Configuration

Linux systems may require additional network permission configuration:

Network Permission Setup

1. Ensure user is in network group:

1
2
3
4
5

# Check current user groups
groups

# Add user to network-related groups (if needed)
sudo usermod -a -G netdev $USER

2. Configure iptables permissions (required for some distributions):

1
2
3
4
5
6

# Check iptables status
sudo iptables -L

# Ensure firewall allows proxy connections
sudo ufw allow from 127.0.0.1
sudo ufw allow to 127.0.0.1

TUN/TAP Module Support

Ensure the system supports TUN devices:

1
2
3
4
5
6
7
8

# Check TUN module
lsmod | grep tun

# If not present, manually load
sudo modprobe tun

# Set to auto-load on boot
echo 'tun' | sudo tee -a /etc/modules

🔗 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! Run curl ipinfo.io in terminal to check if your current IP address has changed.

🔧 Advanced Configuration

System Proxy Settings

GNOME Desktop Environment

1. Open “Settings” > “Network”
2. Click “Network Proxy”
3. Select “Manual” mode
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

KDE Plasma Desktop Environment

1. Open “System Settings” > “Network” > “Proxy”
2. Select “Manually specify proxy configuration”
3. Configure the same proxy settings as above

Command Line Environment

For terminal applications, set environment variables:

1
2
3

export http_proxy=http://127.0.0.1:8080
export https_proxy=http://127.0.0.1:8080
export socks_proxy=socks5://127.0.0.1:1080

Auto-start Configuration

Systemd Service (Recommended)

1. Create service file:

1

sudo nano /etc/systemd/system/hiddify-next.service

2. Add the following content:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

[Unit]
Description=Hiddify Next
After=network.target

[Service]
Type=simple
User=your-username
ExecStart=/path/to/hiddify-next
Restart=always

[Install]
WantedBy=multi-user.target

3. Enable and start service:

1
2

sudo systemctl enable hiddify-next
sudo systemctl start hiddify-next

Desktop Autostart

1. Create autostart file:

1
2

mkdir -p ~/.config/autostart
nano ~/.config/autostart/hiddify-next.desktop

2. Add the following content:

1
2
3
4
5
6
7

[Desktop Entry]
Type=Application
Name=Hiddify Next
Exec=/path/to/hiddify-next
Hidden=false
NoDisplay=false
X-GNOME-Autostart-enabled=true

❓ Common Issues

Q: Application won’t start?

A: Try these solutions:

• Check system compatibility and ensure OS version meets requirements
• Run with administrator privileges: sudo hiddify-next
• Check firewall settings to ensure it’s not blocking the application
• Reinstall: uninstall and download the latest version
• Check dependencies: ensure system has necessary runtime libraries
• View logs: check application log files for error information

Q: Connection successful but can’t browse?

A: Troubleshooting steps:

• Check system proxy configuration
• Try different server nodes
• Verify DNS settings
• Restart network service: sudo systemctl restart NetworkManager

Q: High CPU usage?

A: Optimization methods:

• Switch protocols: some protocols (like VMess) have higher CPU usage, try VLESS or Trojan
• Reduce concurrent connections: lower maximum concurrent connections in settings
• Disable unnecessary features: such as real-time speed monitoring, detailed logging
• Check background applications: ensure no other applications are consuming excessive CPU

Q: Permission denied errors?

A: Solutions:

• Run with sudo privileges
• Check file permissions: chmod +x hiddify-next
• Add user to appropriate groups: sudo usermod -a -G netdev $USER
• Check SELinux settings (if applicable)

🚀 Next Steps

Now that you’ve mastered the basic usage, you can continue learning:

• Understanding Routing Rules
• Performance Optimization Guide
• Common Questions and Answers

If you encounter any issues, feel free to check our FAQ page or contact support.