dufs-zh-build

补充说明

本教程介绍 dufs-zh 的发布流程：不依赖本地编译，只需更新版本号、推送代码与 tag，由 GitHub Actions 自动完成多架构二进制编译、创建 GitHub Release、构建并推送多架构 Docker 镜像（mobufan/dufs-zh:latest + 版本标签）。

项目：dufs-zh｜Dufs 文件服务器（中文界面版） 仓库：https://github.com/meimolihan/dufs-zh 仅标准语义化版本 vX.Y.Z 才会推送镜像 latest 标签（含 rc 等后缀视为预发布，只建 Release 不推镜像）。

发布前置条件

• 已安装 git、python3
• 可选：gh（存在时自动清理同名 Release / tag，重复发布不报错）
• 有仓库推送权限（main 分支 + 创建 tag）

发布命令

cd /vol1/1000/GitHub/dufs-zh

bash scripts/build-and-push.sh v1.0.0 --yes
bash scripts/build-and-push.sh v1.0.0 --yes -m "本次新增 xxx"

• 脚本执行内容：

  1. 清理已存在的同名 Release 与本地/远端 tag（防重复发布冲突）
  2. 更新 Cargo.toml 与 Cargo.lock 中版本号为 1.0.0
  3. 写入 RELEASE_NOTES.md（标题 + 可选备注）
  4. git commit（chore: bump version to 1.0.0）并推送 main
  5. 创建并推送 tag v1.0.0
  6. 后续全部交给 GitHub Actions Release 工作流

• 版本号与 tag 不一致会直接失败：Actions 首步校验 Cargo.toml 的 version 必须等于 tag 去掉 v 的内容（所以发布务必用 build-and-push.sh，不要手工打 tag）。

GitHub Actions Release 工作流

触发方式：推送 v* 标签 / 手动 workflow_dispatch。

Docker 使用 Dockerfile-release（build-args REPO、VER），容器内从当前仓库 Release 下载对应架构 musl 二进制；rc=true（如 v1.0.0-rc1）时构建但不推送。

Release 产出

• 二进制资产：dufs-v<版本>-<target>.tar.gz（Windows 为 .zip）
  • x86_64-unknown-linux-musl、aarch64-unknown-linux-musl、i686-unknown-linux-musl、armv7-unknown-linux-musleabihf、arm-unknown-linux-musleabihf
  • x86_64-apple-darwin、aarch64-apple-darwin
  • x86_64-pc-windows-msvc、aarch64-pc-windows-msvc
• Docker 镜像：docker pull mobufan/dufs-zh:latest 或 docker pull mobufan/dufs-zh:v1.0.0

常用操作

注意事项

• 只能按 vX.Y.Z 格式发版，脚本会自动校验
• --locked 编译要求 Cargo.lock 中根包版本与 Cargo.toml 一致，务必用 build-and-push.sh 发布（脚本同步两处）
• 预发布（如 v1.0.1-rc1）只建 Release 不推 Docker 镜像
• 目标机器安装/升级用 scripts/install.sh（自动按架构选择 Release 资产），详见 dufs-zh

相关命令

• dufs-zh-build 👈 当前所在位置
• dufs-zh
• dufs-zh_menu
• dc_inst_dufs-zh
• opencode_menu