Version 3.x is a major release! The core architecture has been completely refactored, transitioning from Next.js to Vite for bundling, and the backend has been rebuilt with GORM + Gin architecture.
- In the 2.x version's master control list, use the export function to save all master control configuration data
- Obtain the latest
docker-compose.ymlconfiguration file from the repository
docker pull ghcr.io/nodepassproject/nodepassdash:latest# Run in the directory containing the compose file
docker compose down && docker compose up -d- Access the new version interface and recreate master control configurations
- Import the previously exported master control data
- Verify that all functions are working properly
This version is not backward compatible. Please backup/export your master control data before upgrading. It is recommended to create a fresh master control setup to avoid issues with legacy data!
- Database Incompatibility: Version 3.x uses a completely new database table structure and cannot directly migrate 2.x data
- Configuration Format Changes: Master control configuration format has been adjusted; manual reconfiguration of important tunnels is recommended
- Feature Changes: Some function interfaces and operation methods have changed; please refer to the new version documentation
A: No. Due to the complete database structure refactoring, data must be migrated through the export/import process.
A: The exported data includes all master control configuration information, including master control addresses, ports, credentials, and other settings.
A: Yes, but you need to use the data backed up before the upgrade. It is recommended to make a complete backup before upgrading.
If you encounter problems during migration:
- Check GitHub Issues
- Join Telegram Group for help
- Follow Telegram Channel for latest updates