Gopeed项目威联通NAS安装包打包指南

威联通NAS平台适配背景

Gopeed作为一款高效下载工具，其跨平台特性使其能够运行在多种设备上。威联通(QNAP)NAS作为企业级和家用网络存储设备的代表，拥有广泛的用户群体。为了让Gopeed能够更好地服务于威联通NAS用户，社区开发者贡献了针对该平台的安装包打包方案。

威联通QPKG包结构解析

威联通NAS使用QPKG格式的安装包，其标准目录结构包含以下几个关键部分：

1. 平台目录：包含不同CPU架构的可执行文件，如arm_64(ARM64架构)和x86_64(x86-64架构)
2. 配置文件：qpkg.cfg文件定义了包的基本信息和运行参数
3. 图标资源：提供应用在不同场景下显示的图标
4. 启动脚本：控制应用的启动、停止和重启

QPKG打包详细流程

1. 创建工程目录

使用qbuild工具初始化工程：

qbuild --create-env Gopeed
cd Gopeed

2. 精简平台支持

根据实际需求保留必要的平台目录：

rm -rf x86_ce53xx x86 arm-x09 arm-x19 arm-x31 arm-x41

3. 准备可执行文件

将编译好的Gopeed二进制文件放入对应平台目录：

arm_64/
└── gopeed
x86_64/
└── gopeed

4. 配置qpkg.cfg

关键配置参数说明：

QPKG_NAME="Gopeed"          # 包名称
QPKG_DISPLAY_NAME="Gopeed"  # 显示名称
QPKG_VER="1.5.9"            # 版本号
QPKG_AUTHOR="GopeedLab"     # 作者
QPKG_LICENSE="GPL-3.0"      # 许可证
QPKG_SUMMARY="高效下载工具"  # 简介
QPKG_RC_NUM="101"           # 启动优先级
QPKG_WEB_PORT="9999"        # Web服务端口

5. 编写启动脚本

启动脚本(Gopeed.sh)需要实现以下功能：

• 设置环境变量
• 创建必要的符号链接
• 启动/停止应用进程
• 管理PID文件

示例脚本片段：

#!/bin/sh
# 获取安装路径
QPKG_ROOT=`/sbin/getcfg $QPKG_NAME Install_Path -f ${CONF}`

case "$1" in
    start)
        # 启动应用
        cd $QPKG_ROOT
        $EXE_NAME &
        echo $! > $PIDF
        ;;
    stop)
        # 停止应用
        kill -9 `cat $PIDF`
        rm -f $PIDF
        ;;
esac

打包与测试

执行打包命令：

qbuild

生成的QPKG文件会出现在build目录下，可通过威联通App Center进行手动安装测试。

进阶建议

1. 自动化打包：建议将打包流程集成到CI/CD系统中，实现自动构建
2. 多版本管理：维护不同Gopeed版本的QPKG包，方便用户选择
3. 依赖处理：检查并处理应用可能依赖的系统库
4. 日志系统：增强启动脚本的日志记录功能，便于问题排查

通过以上方法，开发者可以为Gopeed创建适配威联通NAS的安装包，让更多用户能够便捷地在NAS设备上使用这款高效的下载工具。