# 安装

> 如何下载与安装 pig 包管理器

---

LLMS index: [llms.txt](/llms.txt)

---

## 脚本安装

安装 `pig` 最简单的方式是运行以下安装脚本：

**默认安装**（Cloudflare CDN）：

```bash
curl -fsSL https://repo.pigsty.io/pig | bash
```

**中国镜像**：

```bash
curl -fsSL https://repo.pigsty.cc/pig | bash
```

该脚本会从 Pigsty [软件仓库](/docs/repo/) 下载最新版 `pig` 的 RPM / DEB 包，并通过 `rpm` 或 `dpkg` 进行安装。
脚本安装面向 Linux x86_64 / aarch64 的 RPM / DEB 系发行版；macOS 可使用发布压缩包中的二进制。


## 指定版本

您可以指定已经发布到所选镜像的特定版本，将版本号作为参数传入即可：

**默认安装**（Cloudflare CDN）：

```bash
curl -fsSL https://repo.pigsty.io/pig | bash -s X.Y.Z
```

**中国镜像**：

```bash
curl -fsSL https://repo.pigsty.cc/pig | bash -s X.Y.Z
```

镜像发布可能晚于 GitHub Release；如需精确获取当前版本，请使用下方 GitHub 制品。


## 发布产物下载

当前 `v1.8.0` 安装包（`RPM`/`DEB`/压缩包）可从 [GitHub Release](https://github.com/pgsty/pig/releases/tag/v1.8.0) 获取，发布哈希见 [checksums.txt](https://github.com/pgsty/pig/releases/download/v1.8.0/checksums.txt)。直接下载格式如下：

- `https://github.com/pgsty/pig/releases/download/v1.8.0/<filename>`

```text
v1.8.0
├── pig_1.8.0-1_amd64.deb
├── pig_1.8.0-1_arm64.deb
├── pig-1.8.0-1.aarch64.rpm
├── pig-1.8.0-1.x86_64.rpm
├── pig-v1.8.0.linux-amd64.tar.gz
├── pig-v1.8.0.linux-arm64.tar.gz
├── pig-v1.8.0.darwin-amd64.tar.gz
└── pig-v1.8.0.darwin-arm64.tar.gz
```

将其解压后，将二进制文件放入您的 PATH 系统路径中即可。
对应的 Pigsty 镜像目录会在软件仓库同步后可用；使用锁定版本的安装命令前，请先检查目标 URL。


## 仓库安装

`pig` 软件位于 [`pigsty-infra`](/docs/repo/infra/) 仓库中。你可以将该仓库添加到操作系统后，使用操作系统的包管理器进行安装：

### YUM

对于 RHEL，RockyLinux，CentOS，Alma Linux，OracleLinux 等 EL 系发行版：

```bash
sudo tee /etc/yum.repos.d/pigsty-infra.repo > /dev/null <<-'EOF'
[pigsty-infra]
name=Pigsty Infra for $basearch
baseurl=https://repo.pigsty.io/yum/infra/$basearch
enabled = 1
gpgcheck = 0
module_hotfixes=1
EOF

sudo yum makecache;
sudo yum install -y pig
```

### APT

对于 Debian，Ubuntu 等 DEB 系发行版：

```bash
sudo tee /etc/apt/sources.list.d/pigsty-infra.list > /dev/null <<EOF
deb [trusted=yes] https://repo.pigsty.io/apt/infra generic main
EOF

sudo apt update;
sudo apt install -y pig
```


## 更新

若要将现有 `pig` 版本升级至最新可用版本，可以使用以下命令：

```bash
pig update            # 将 pig 自身升级到最新版
pig update -m         # 使用 pigsty.cc 镜像升级
pig update -v X.Y.Z   # 升级到已发布在当前软件仓库中的指定版本
```

若要将现有 `pig` 的扩展数据升级至最新可用版本，可以使用以下命令：

```bash
pig ext reload        # 将 pig 扩展数据更新至最新版本
```


## 卸载

```bash
apt remove -y pig     # Debian / Ubuntu 等 Debian 系统
yum remove -y pig     # RHEL / CentOS / RockyLinux 等 EL 系发行版
rm -rf /usr/bin/pig   # 若直接使用二进制安装，删除二进制文件即可
```


## 构建

你也可以自行构建 `pig`。`pig` 使用 Go 语言开发，构建非常容易，源码托管在 [github.com/pgsty/pig](https://github.com/pgsty/pig)

```bash
git clone https://github.com/pgsty/pig.git; cd pig
go mod download
make build
```

所有 RPM / DEB 包都通过 GitHub CI/CD 流程使用 goreleaser 自动化构建。