Rust项目在Debian如何打包发布

Rust 项目在 Debian 的打包与发布指南

一 快速上手 cargo-deb

• 安装工具链与打包工具
  • 安装或更新 Rust：rustup update
  • 安装 cargo-deb：cargo install cargo-deb
  • 安装基础打包依赖（Debian/Ubuntu）：sudo apt-get install dpkg dpkg-dev liblzma-dev
• 准备项目元数据
  • 在 Cargo.toml 中完善包信息（如 name、version、description、license、authors），便于生成符合规范的 .deb 控制信息。
• 构建 .deb
  • 在项目根目录执行：cargo deb
  • 产物路径通常为：target/debian/<项目名><版本>-1<架构>.deb
• 安装与验证
  • 安装：sudo dpkg -i target/debian/*.deb
  • 若依赖未满足：sudo apt-get install -f
  • 验证：your_app --version
• 一键安装（可选）
  • 使用 cargo deb --install 构建并直接安装到本机（便于测试）。

二 常用配置与系统集成

• 自定义包元数据（写入 Cargo.toml）
  • 示例：
    • [package.metadata.deb]
    • maintainer = "Your Name <you@example.com>"
    • description = "A short description."
    • section = "utils"
    • priority = "optional"
    • depends = "libc6 (>= 2.28), zlib1g"
• Systemd 单元文件
  • 将服务文件随包部署：
    • [package.metadata.deb]
    • systemd-units = [ ["your_app.service", "lib/systemd/system/your_app.service", "644"] ]
• 调试符号
  • 保留调试信息：在 Cargo.toml 设置 [profile.release] debug = true
  • 分离调试符号：cargo deb --separate-debug-symbols（符号将安装到 /usr/lib/debug/…）。

三 发布流程与注意事项

• 版本与变更
  • 遵循 语义化版本，每次发布递增 Cargo.toml 的 version；变更日志建议同步更新，便于用户与维护者追踪。
• 产物命名与多架构
  • 产物命名遵循 <项目名><版本>-1<架构>.deb；在 CI 中可矩阵构建 amd64/arm64 等架构并产出对应 .deb。
• 安装与升级
  • 测试安装/卸载流程，确认文件归属与权限正确；在目标系统使用 apt-get install -f 校验依赖收敛。
• 持续集成
  • 将 cargo deb 集成到 GitHub Actions/GitLab CI，自动产出 .deb 并上传为 GitHub Releases 或制品仓库，便于分发与回滚。

四 常见问题与排查

• 依赖不满足
  • 安装时若报缺依赖，执行 sudo apt-get install -f 自动补齐；必要时在 package.metadata.deb 的 depends 中显式声明。
• 调试符号与体积
  • 默认发布包会剥离调试符号；如需保留或分离，使用 [profile.release] debug = true 或 --separate-debug-symbols。
• 架构与交叉编译
  • 在 x86_64 主机上为 arm64 打包需配置交叉编译工具链（如 cross 或 cargo-zigbuild），确保生成对应 arm64 产物并通过 dpkg 校验。
• 本地安装与系统一致性
  • 开发阶段可用 cargo deb --install 快速验证；上线前建议在干净的 chroot/容器 中安装测试，避免本机环境影响结论。