更新 Wavelog（Updating）

更新 Wavelog（Updating）

目录

• 更新之前
• 更新流程
  • 通过 Docker 更新
    • 通过 Portainer 更新
  • 通过 git pull 更新
  • 通过 zip 文件更新

更新之前

在对你的 Wavelog 安装进行更新之前，请先备份现有安装。更新过程中，某些配置文件可能会被重置为默认值，因此你需要有一份备份，用来把设置重新填入新的配置文件。

这不是从 Cloudlog 迁移到 Wavelog 的方法。如果你仍在使用 Cloudlog，请前往这个 Wiki 页面

更新流程

通过 Docker 更新

要把 Wavelog 更新到最新版本，请在 docker-compose.yml 所在文件夹中运行以下命令：

# we check for any new images and pull them
docker compose pull

# docker compose down is not necessary. docker recognizes any changes in images and configuration
# and recreates any containers automatically.
docker compose up -d

这会下载新镜像、停止服务栈并重新启动全部内容。数据卷中的数据不受影响。

通过 Portainer 更新

如果你使用 Portainer 管理 Docker 容器：
前往 Stacks，选择 Wavelog 服务栈，点击 Editor → Deploy，并在对话框中启用「Pull latest image」。

通过 git pull 更新

当你在 Linux 服务器上使用 git clone 安装 Wavelog 时，可以使用 git 机制更新现有安装。你应始终优先采用这种方式，因为它更快也更安全。

1. 进入 Wavelog 所在的 Web 目录（例如 /var/www/html）

cd /var/www/html

1. 输入 git 命令

git pull

1. 你可能需要重置文件所有者

chown -R www-data:www-data /var/www/html

1. 在 Web 浏览器中重新加载页面
   • 你应当看到版本对话框，其中显示了最新发行版的发行说明。
   • 在 ADMIN > DEBUG 中检查版本。此时这里也应显示正确的版本。

通过 zip 文件更新

警告

如果你不遵循说明，而是直接覆盖现有文件，那么在我们重命名过某个文件的情况下，可能会产生两个文件。发行版 2.3.1 就多次出现过这种情况。如果你遇到迁移编号 170 存在两个版本的问题，只需删除文件 170_tag_2_6_3.php，或者直接按下面的说明进行正确的升级。我们推荐使用 git 作为安装方式，它能省去很多麻烦。

在托管型 Web 空间上使用 Wavelog 时，你可能无法访问命令行。这时你需要用下载的 zip 文件来更新 Wavelog 安装。请按以下步骤进行正确的更新。

1. 对整个安装做一次完整备份。这包括整个 Web 根目录文件夹和数据库。
2. 如果你在第 1 步中还没有下载现有的 Web 根目录文件夹，现在就下载它（可以重命名为 Wavelog-OLD）。稍后你需要把一些文件复制到新文件夹。
3. 以 zip 文件形式下载 Wavelog 的最新发行版：https://github.com/wavelog/wavelog/releases
4. 在你的计算机上解压下载的 zip 文件。你需要用第 2 步中的旧文件替换下载文件夹里的某些文件。
5. 把以下文件和文件夹从现有安装复制到新文件夹。
   • 文件：application/config/config.php
   • 文件：application/config/database.php
   • 如果你的旧安装中 $config['userdata'] = "userdata"; 处于禁用状态（更多信息）
     • 文件夹：assets/qslcard/
     • 文件夹：images/eqsl_card_images/
   • 如果你的旧安装中 $config['userdata'] = "userdata"; 处于启用状态
     • 文件夹：userdata/（或已配置并存储用户数据的那个文件夹）
   • 如果存在：
     • 文件：assets/js/sections/custom.js
6. 删除新文件夹中的 install/ 文件夹。
7. 现在你可以把包含上述所有必要文件和文件夹的新文件夹上传到你的 Web 空间。
8. 在 Web 浏览器中重新加载页面
   • 你应当看到版本对话框，其中显示了你在第 3 步下载的版本的发行说明
   • 在 ADMIN > DEBUG 中检查版本。此时这里也应显示正确的版本。