Updated Updating Zoraxy (markdown)

Toby Chui 2024-07-16 16:52:35 +08:00
parent 6583225124
commit d5293b9dc3

@ -30,6 +30,30 @@ If you are running Zoraxy on Windows, you can easily download and overwrite the
4. Rename `zoraxy_windows_amd64.exe` to `zoraxy.exe`
5. Start the bat file (if any) or double click the zoraxy exe file.
## Updating Zoraxy (Docker)
### Updating to v3.0.9
The automatic update system was introduced in v3.0.7 but it has some issue with docker installations. The following guide helps you to manually patch a few files for updating from pre-v3.0.8 versions of Zoraxy
1. Backup all config files under `./conf/`
2. Pull the image of `zoraxy:laterst` from docker hub
3. Start the container and stop if after it has started for around 5 minutes. This will give enough time for the upgrader to update the system to the latest config format.
4. Open the volume used by the container. If you are using Portainer, you can find the "Browse" button next to the volume id.
![圖片](https://github.com/user-attachments/assets/40f9e318-f348-4aa5-8914-58faa475e62b)
5. Download the config file
![圖片](https://github.com/user-attachments/assets/a51a7a32-52f6-40cb-aa1f-c207e402e363)
6. Open with a text editor like Notepad++. Fill in the missing "OriginIpOrDomain" filed under "ActiveOrigins" (if upgrade failed, this field will be empty string)
![圖片](https://github.com/user-attachments/assets/0e6aefc5-ad6f-421e-8195-3e86a2734d7c)
7. Save and upload it to the volume to replace the original file.
8. Repeat until all configs are updated.
## Post v3.0.9
For post v3.0.9, the internal update system should support skip version update by default. You can just pull the latest docker image to update your Zoraxy from v3.1.0 onward.
## IMPORTANT NOTES
- Note that each version might have some slight startup flag change. See change log and release notes for more information
- Always backup your config before update. Some version might contain breaking change that will alter your config files
- Always backup your config before update. Some version might contain breaking change that will alter your config files