Binary Upgrade

Work in Progress

This page is still being improved. Some details may not be fully accurate — please refer to the actual behavior when in doubt.

Before upgrading the Frpc-Hub binary, back up your data first, then replace the executable.

Upgrade Steps

1. Back Up Data

Data is stored in pb_data/ under the working directory. Back it up before upgrading:

cp -r /var/lib/frpc-hub/pb_data /var/lib/frpc-hub/pb_data.bak

2. Stop the Service

sudo systemctl stop frpc-hub

If not using systemd, kill the process manually:

pkill frpc-hub

3. Download the New Version

Visit GitHub Releases for the latest version, or download via command line (Linux amd64 example):

curl -LO https://github.com/luckjiawei/frpc-hub/releases/latest/download/frpc-hub-linux-amd64.tar.gz
tar -xzf frpc-hub-linux-amd64.tar.gz

4. Replace the Binary

sudo mv frpc-hub /usr/local/bin/frpc-hub
sudo chmod +x /usr/local/bin/frpc-hub

5. Restart the Service

sudo systemctl start frpc-hub

# Confirm service is running
sudo systemctl status frpc-hub

Rollback

If issues occur after upgrading, restore the backup and reinstall the old version:

# Stop service
sudo systemctl stop frpc-hub

# Restore data backup
rm -rf /var/lib/frpc-hub/pb_data
cp -r /var/lib/frpc-hub/pb_data.bak /var/lib/frpc-hub/pb_data

# Download the old version from GitHub Releases, replace the binary, then start
sudo systemctl start frpc-hub