mirror of https://github.com/mofeng-git/One-KVM.git synced 2025-12-13 17:50:29 +08:00

mofeng-git c8d1dcca30 feat: 完善 GitHub Actions 工作流和构建系统

- 添加自动下载缺失文件功能，支持 .xz 压缩格式
- 优化构建流程，增加文件清理和压缩功能
- 修复发布资产上传步骤，确保预发布标记正确设置
- 调整发布标签格式，包含版本号、设备目标和运行 ID
- 升级 Actions 版本，使用 softprops/action-gh-release@v1
- 移除 NFS 挂载依赖，简化部署流程
- 增强错误处理和日志输出

2025-08-20 16:12:40 +08:00

3.9 KiB

Raw Blame History

自动下载功能说明

概述

构建脚本现在支持自动下载缺失的文件。当构建过程中发现所需的镜像文件、DTB文件、配置文件或工具不存在时，系统会自动尝试从远程服务器下载。

功能特性

1. 智能下载策略

首先尝试直接下载：使用原始文件名从远程服务器下载
失败后尝试压缩版本：如果直接下载失败，自动尝试添加 .xz 后缀下载压缩版本
自动解压：如果下载的是 .xz 压缩文件，会自动解压

2. 支持的文件类型

镜像文件：各种设备的 Armbian 镜像
DTB 文件：设备树二进制文件
配置文件：JSON、CONF 等配置文件
工具文件：如 AmlImg 工具

3. 错误处理

文件已存在时跳过下载
下载失败时提供详细的错误信息
解压失败时自动清理临时文件

配置

环境变量

# 远程文件服务器前缀（默认值）
REMOTE_PREFIX="https://files.mofeng.run"

# 本地源码路径（默认值）
SRCPATH="/mnt/src"

文件路径映射

本地文件路径：$SRCPATH/image/device/filename 远程下载URL：$REMOTE_PREFIX/image/device/filename

使用示例

1. 构建特定设备

# 构建 Cumebox2（会自动下载所需文件）
./build/build_img.sh cumebox2

2. 构建所有设备

# 构建所有设备（会自动下载所有所需文件）
./build/build_img.sh all

3. 自定义远程服务器

# 使用自定义的远程服务器
REMOTE_PREFIX="https://your-server.com/files" ./build/build_img.sh cumebox2

支持的文件列表

Onecloud 设备

image/onecloud/AmlImg_v0.3.1_linux_amd64 - AmlImg 工具
image/onecloud/Armbian_by-SilentWind_24.5.0-trunk_Onecloud_bookworm_legacy_5.9.0-rc7_minimal_support-dvd-emulation.burn.img - 源镜像
image/onecloud/meson8b-onecloud-fix.dtb - DTB 文件

Cumebox2 设备

image/cumebox2/Armbian_25.2.2_Khadas-vim1_bookworm_current_6.12.17_minimal.img - 源镜像
image/cumebox2/v-fix.dtb - DTB 文件
image/cumebox2/ssd - SSD 脚本
image/cumebox2/config.json - OLED 配置文件

Chainedbox 设备

image/chainedbox/Armbian_24.11.0_rockchip_chainedbox_bookworm_6.1.112_server_2024.10.02_add800m.img - 源镜像
image/chainedbox/rk3328-l1pro-1296mhz-fix.dtb - DTB 文件

VM 设备

image/vm/Armbian_25.2.1_Uefi-x86_bookworm_current_6.12.13_minimal.img - 源镜像

E900V22C 设备

image/e900v22c/Armbian_23.08.0_amlogic_s905l3a_bookworm_5.15.123_server_2023.08.01.img - 源镜像

Octopus-Planet 设备

image/octopus-flanet/Armbian_24.11.0_amlogic_s912_bookworm_6.1.114_server_2024.11.01.img - 源镜像
image/octopus-flanet/model_database.conf - 配置文件

技术实现

核心函数

download_file_if_missing(file_path)

工作流程

检查文件是否已存在
计算相对于 SRCPATH 的路径
确保目标目录存在
尝试直接下载
如果失败，尝试下载 .xz 版本
如果是 .xz 文件，自动解压
返回成功或失败状态

依赖工具

curl - 用于下载文件
xz - 用于解压 .xz 文件
mkdir - 用于创建目录

注意事项

网络连接：确保构建环境能够访问远程服务器
磁盘空间：下载的文件可能很大，确保有足够的磁盘空间
权限：确保脚本有权限创建目录和文件
防火墙：确保防火墙允许 HTTP/HTTPS 连接

故障排除

常见问题

下载失败
- 检查网络连接
- 验证 REMOTE_PREFIX 是否正确
- 确认远程文件是否存在
解压失败
- 检查 xz 工具是否安装
- 验证下载的文件是否完整
权限错误
- 确保脚本有足够的权限
- 检查目标目录的权限设置

调试模式

可以通过设置环境变量来启用更详细的输出：

export DEBUG=1
./build/build_img.sh cumebox2

3.9 KiB Raw Blame History Unescape Escape