This is a modified V0 version of the Nezha panel Agent installation script, aimed at fixing the issue where Windows/MacOS Agent installation fails after the discontinuation of maintenance for the V0 Nezha panel.
This repository is primarily for personal use. If you'd like to contribute, make suggestions, or report bugs, feel free to submit issues, forks, or pull requests!
Important
The Agent installation script in this repository is only suitable for the V0 version of the Nezha panel. If you are using the V1 version and want your Windows/MacOS servers to work with it, use the installation instructions provided directly in the V1 Nezha panel backend.
This repository’s Agent installation script does not contain any backdoors or encryption. All code is open for inspection.
The installation packages downloaded through the installation commands in this repository are sourced exclusively from the official Nezha panel repository or its official mirrors.
If you have concerns about using this script, you can review the code yourself or have it verified by AI. If you still have doubts, do not use the script.
- The Agent installation version is locked to v0.20.5 (the last version supporting the V0 Nezha panel).
- Retains IP geolocation logic to allow users in mainland China to download the Agent from the official Gitee mirror.
- Fixes the issue where running the original script while the Agent is already running could result in "Access is denied." This script checks if the Agent is running before installation and stops it if necessary.
- Resolves issues where leftover local Agent files could cause "File exists and cannot be created" errors. The script checks for residual files and removes them before installation.
- Includes more detailed prompts to facilitate troubleshooting.
Note
Contributions, suggestions, and bug reports are welcome via issues, forks, or PRs!
Copy the Windows Agent installation command from the Nezha panel backend. Assuming the following is the copied command:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Ssl3 -bor [Net.SecurityProtocolType]::Tls -bor [Net.SecurityProtocolType]::Tls11 -bor [Net.SecurityProtocolType]::Tls12;set-ExecutionPolicy RemoteSigned;Invoke-WebRequest https://raw.githubusercontent.com/nezhahq/scripts/main/extras/install.ps1 -OutFile C:\install.ps1;powershell.exe C:\install.ps1 1.1.1.1.nip.io:5555 [Key]
Replace the original script URL:
https://raw.githubusercontent.com/nezhahq/scripts/main/extras/install.ps1
With the modified script URL from this repository:
https://raw.githubusercontent.com/DuolaD/NeZha_V0_Agent_install_Fix/main/install.ps1
Then, reconstruct the command:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Ssl3 -bor [Net.SecurityProtocolType]::Tls -bor [Net.SecurityProtocolType]::Tls11 -bor [Net.SecurityProtocolType]::Tls12;set-ExecutionPolicy RemoteSigned;Invoke-WebRequest https://raw.githubusercontent.com/DuolaD/NeZha_V0_Agent_install_Fix/main/install.ps1 -OutFile C:\install.ps1;powershell.exe C:\install.ps1 1.1.1.1.nip.io:5555 [Key]
Copy the reconstructed command into a Windows PowerShell terminal with administrator privileges to install the Agent.
If prompted for execution policy change confirmation, input [Y] or [A] to proceed.
Copy the MacOS Agent installation command from the Nezha panel backend. Assuming the following is the copied command:
curl -L https://raw.githubusercontent.com/nezhahq/scripts/main/extras/install.command -o nezha.command && chmod +x nezha.command && sudo ./nezha.command install_agent 1.1.1.1.nip.io 5555 [Key]
Replace the original script URL:
https://raw.githubusercontent.com/nezhahq/scripts/main/extras/install.command
With the modified script URL from this repository:
https://raw.githubusercontent.com/DuolaD/NeZha_V0_Agent_install_Fix/main/install.command
Then, reconstruct the command:
curl -L https://raw.githubusercontent.com/DuolaD/NeZha_V0_Agent_install_Fix/main/install.command -o nezha.command && chmod +x nezha.command && sudo ./nezha.command install_agent 1.1.1.1.nip.io 5555 [Key]
Copy the reconstructed command into the terminal and run it to install the Agent.
- Install the V0 version of the Nezha panel (version v0.20.13, the last version of the V0 Nezha panel). Copy and paste the following commands directly into your SSH terminal to run:
Important
If you have already installed the V1 version of the Nezha panel, please use the uninstall function in the V1 installation script to remove the panel first to avoid unnecessary bugs.
If your server is located outside mainland China, copy and paste the following command into the SSH terminal to install the V0 version of the Nezha panel:
curl -L https://raw.githubusercontent.com/nezhahq/scripts/refs/heads/v0/install.sh -o nezha.sh && chmod +x nezha.sh && sudo ./nezha.sh
If your server is located in mainland China, copy and paste the following command into the SSH terminal to install the V0 version of the Nezha panel:
curl -L https://gitee.com/naibahq/scripts/raw/v0/install.sh -o nezha.sh && chmod +x nezha.sh && sudo CN=true ./nezha.sh
To open the script menu after installation, copy and paste the following command into the SSH terminal:
./nezha.sh
Important
After running the installation script, do not select option 13 to update the script, as this will update it to the latest V1 Nezha panel installation script. If you accidentally update to the V1 script, you can reinstall the V0 script using the commands provided above.
- Install the Agent for the V0 version of the Nezha panel on a Linux server:
Copy your Linux Agent installation command from the Nezha panel backend. Assuming the copied command is:
curl -L https://raw.githubusercontent.com/nezhahq/scripts/main/install.sh -o nezha.sh && chmod +x nezha.sh && ./nezha.sh install_agent 1.1.1.1.nip.io 5555 [key]
Replace the original script URL:
https://raw.githubusercontent.com/nezhahq/scripts/main/install.sh
With the script URL from the official Nezha repository’s V0 branch:
https://raw.githubusercontent.com/nezhahq/scripts/v0/install.sh
Then reconstruct the command:
curl -L https://raw.githubusercontent.com/nezhahq/scripts/v0/install.sh -o nezha.sh && chmod +x nezha.sh && ./nezha.sh install_agent 1.1.1.1.nip.io 5555 [key]
After confirming that the command has been correctly modified, copy and paste it into the SSH terminal to execute.
Important
After running the installation script, do not select option 13 to update the script, as this will update it to the latest V1 Nezha panel installation script. If you accidentally update to the V1 script, you can reinstall the V0 script using the commands provided above.