...

Linux Installation Guide

Install and configure AiBooster client on Linux.

Linux Installation Guide

System Requirements

  • 64-bit Linux distribution
  • glibc 2.17 or higher
  • Desktop environment support (GNOME, KDE, XFCE, etc.)

Installation Methods

Method 1: AppImage (Recommended)

# Download AppImage
wget https://download.aibooster.app/linux/AiBooster.AppImage
 
# Add execute permission
chmod +x AiBooster.AppImage
 
# Run
./AiBooster.AppImage

Method 2: DEB Package (Debian/Ubuntu)

# Download DEB package
wget https://download.aibooster.app/linux/aibooster_latest_amd64.deb
 
# Install
sudo dpkg -i aibooster_latest_amd64.deb
 
# Fix dependencies (if needed)
sudo apt-get install -f

Method 3: RPM Package (Fedora/RHEL/CentOS)

# Download RPM package
wget https://download.aibooster.app/linux/aibooster_latest.x86_64.rpm
 
# Install
sudo rpm -i aibooster_latest.x86_64.rpm
 
# Or use dnf
sudo dnf install aibooster_latest.x86_64.rpm

Method 4: Flatpak

# Add Flathub repository (if not already added)
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
 
# Install AiBooster
flatpak install flathub com.aibooster.app

TUN Mode Configuration

TUN mode on Linux requires additional configuration:

Option 1: Set capabilities (Recommended)

# Grant network permissions to AiBooster
sudo setcap cap_net_admin,cap_net_bind_service=+ep /path/to/AiBooster

Option 2: Run as root

sudo ./AiBooster.AppImage

System Proxy Settings

AiBooster supports automatic system proxy configuration, but some desktop environments may require manual setup:

GNOME

gsettings set org.gnome.system.proxy mode 'manual'
gsettings set org.gnome.system.proxy.http host '127.0.0.1'
gsettings set org.gnome.system.proxy.http port 7890

KDE

  1. Open System Settings
  2. Go to Network → Proxy
  3. Select "Manual configuration"
  4. Enter HTTP proxy: 127.0.0.1:7890

Command Line Usage

# Start with GUI
aibooster
 
# Run in background
aibooster --headless
 
# View help
aibooster --help

Auto-start Configuration

systemd User Service

# Create service file
mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/aibooster.service << EOF
[Unit]
Description=AiBooster Proxy Client
After=network.target
 
[Service]
Type=simple
ExecStart=/usr/bin/aibooster --headless
Restart=always
 
[Install]
WantedBy=default.target
EOF
 
# Enable service
systemctl --user enable aibooster
systemctl --user start aibooster

Troubleshooting

Cannot Run AppImage

# Install FUSE
sudo apt install libfuse2  # Debian/Ubuntu
sudo dnf install fuse      # Fedora

DNS Leak

# Edit resolv.conf
sudo nano /etc/resolv.conf
# Add: nameserver 127.0.0.1

We recommend using NetworkManager for network management - AiBooster will automatically handle DNS configuration.

macOS InstallationAndroid Installation