如何打包自制软件 fpm快速打包工具使用

fpm 是一个用 ruby 编写的高效打包工具，能将目录、脚本等快速转换为 rpm、deb 等标准格式，无需编写复杂的 spec 或 control 文件。使用 fpm 打包自制软件的核心步骤是：1. 组织好文件目录结构；2. 编写 fpm 命令，指定源类型（-s）、目标格式（-t）、包名（-n）、版本（-v）、安装路径（--prefix）及要打包的文件或目录；3. 可选添加元信息（如维护者、依赖、描述）、配置文件标记（--config-files）、安装前后执行的脚本（--after-install、--after-remove）以实现系统服务集成。例如打包一个带 systemd 服务的脚本时，需包含服务文件并映射到目标路径，同时提供 post-install.sh 和 post-remove.sh 脚本来重载 daemon、启用或停止服务。常见注意事项包括：避免空目录问题、使用 --config-files 标记配置文件以防升级被覆盖、遵循 fhs 规范选择安装路径、测试包内容以确保正确性，且 fpm 支持跨平台打包，可在 ubuntu 上生成 rpm，在 centos 上生成 deb。通过掌握这些方法，可快速生成标准化安装包，极大简化运维部署流程，特别适用于内部工具和自动化交付场景，最终实现几分钟内完成高质量软件包的制作。

在运维或软件发布过程中，我们经常需要将自己开发的脚本、服务或应用打包成 RPM、DEB 等标准格式，以便在不同服务器上统一部署。手动写 spec 文件或 control 文件既繁琐又容易出错。这时，

fpm

（Effing Package Manager）就派上了用场——它是一个简单、高效的打包工具，支持多种输入输出格式。

下面介绍如何使用 fpm 快速打包自制软件。

---

什么是 fpm？

fpm 是一个用 Ruby 编写的第三方工具，由 jordansissel 开发，能将目录、脚本、源码包等快速转换为常见的软件包格式，比如：

• 输入源：目录（dir）、tar 包、Python 模块（pip）、gem 等
• 输出格式：RPM、DEB、tar、zip、puppet 等

它最大的优势是无需编写复杂的打包脚本，几条命令就能生成标准安装包。

---

安装 fpm

fpm 是基于 Ruby 的工具，所以需要先安装 Ruby 环境。

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install ruby ruby-dev rubygems build-essential

# CentOS/RHEL
sudo yum install ruby ruby-devel rubygems gcc make
# 或者使用 dnf（CentOS 8+）
sudo dnf install ruby ruby-devel rubygems gcc make

然后安装 fpm gem 包：

sudo gem install fpm

注意：某些系统可能需要升级 gem 源或使用 --no-document 提高安装速度。

验证安装：

fpm --version

---

快速打包一个自制脚本或服务

假设你有一个简单的脚本项目，结构如下：

/myapp/
├── bin/
│   └── myapp.sh
├── config/
│   └── app.conf
└── log/

你想把这个打包成 RPM 或 DEB，方便部署。

1. 基本打包命令

fpm -s dir -t rpm -n myapp -v 1.0.0 \
    --prefix /opt/myapp \
    ./myapp/bin \
    ./myapp/config

参数说明：

• -s dir

  ：源类型是目录

• -t rpm

  ：目标格式为 rpm（也可用

  deb

  ）

• -n myapp

  ：软件包名称

• -v 1.0.0

  ：版本号

• --prefix /opt/myapp

  ：安装路径（打包后文件会放在该路径下）
• 后面跟的是要打包的目录或文件

执行后会生成：

myapp-1.0.0-1.x86_64.rpm

2. 添加更多元信息（推荐）

为了让包更规范，可以添加维护者、描述、依赖等信息：

fpm -s dir -t rpm -n myapp -v 1.0.0 --iteration 1.el7 \
    --vendor "Your Company" \
    --maintainer "admin@company.com" \
    --license "MIT" \
    --description "My custom application for internal use" \
    --url "https://yourcompany.com/myapp" \
    --depends "bash" \
    --depends "coreutils" \
    --prefix /opt/myapp \
    ./myapp/bin \
    ./myapp/config

说明：

--iteration

是发行版本号，常用于区分构建次数或适配系统（如 el7、ubuntu20）

---

打包可执行服务（带启动脚本）

如果你的软件是一个后台服务，还需要打包启动脚本并注册为系统服务。

示例：打包一个带 systemd 服务的脚本

1. 准备服务文件：

   myapp.service

[Unit]
Description=My Custom App
After=network.target

[Service]
Type=simple
ExecStart=/opt/myapp/bin/myapp.sh
Restart=always
User=root

[Install]
WantedBy=multi-user.target

2. 打包时包含服务文件，并指定安装后执行脚本

fpm -s dir -t rpm -n myapp -v 1.0.0 \
    --prefix /opt/myapp \
    --after-install ./scripts/post-install.sh \
    --after-remove ./scripts/post-remove.sh \
    --config-files /etc/systemd/system/myapp.service \
    ./myapp/bin \
    ./myapp/config \
    ./myapp.service=/etc/systemd/system/myapp.service

注意：

./myapp.service=/etc/systemd/system/myapp.service

表示将本地文件映射到目标路径

3. 创建

   post-install.sh

   脚本（安装后执行）

#!/bin/bash
systemctl daemon-reload
systemctl enable myapp.service
systemctl restart myapp.service
echo "MyApp service installed and started."

4. 创建

   post-remove.sh

   （卸载后执行）

#!/bin/bash
systemctl stop myapp.service || true
systemctl disable myapp.service || true
systemctl daemon-reload
echo "MyApp service removed."

别忘了给脚本加可执行权限：

chmod +x ./scripts/*.sh

---

常见技巧与注意事项

• 避免打包空目录：fpm 不会自动创建空目录（如 log），建议在安装脚本中用

  mkdir -p

  创建
• 配置文件标记：使用

  --config-files

  标记配置文件，升级时不会被覆盖
• 多平台兼容：打包 DEB 时，

  --prefix

  最好用

  /usr/local

  或

  /opt

  ，避免违反 FHS
• 测试包内容：

  rpm -qpl myapp-1.0.0-1.x86_64.rpm
  dpkg -c myapp_1.0.0_amd64.deb

• 跨平台打包：可以在 Ubuntu 上打包 RPM，在 CentOS 上打包 DEB，fpm 支持交叉打包

---

总结

使用 fpm 打包自制软件，核心就是三步：

1. 组织好你的文件目录
2. 写一条 fpm 命令，指定输入、输出、元信息
3. （可选）添加安装/卸载脚本和系统集成

它极大简化了传统打包流程，特别适合内部工具、脚本服务、快速交付场景。

基本上就这些，不复杂但容易忽略细节。只要掌握常用参数，几分钟就能打出一个像样的安装包。