BIRD 中文文档

Appearance

第一章·第二节 安装 BIRD (Installing BIRD) ​

⚠️ 注意

如果您发现了错误，欢迎 参与贡献。

⚠️ 注意

由于原文档对于此节的描述非常简略，所以本译文大部分内容是译者原创内容，如果有任何错误，欢迎指正。

💡 技巧小贴士

  • 本页内容较多，您可以使用 Ctrl/Command + F 快速查找本页面的关键词。

  • 如果想快速搜索全站内容，也可以在页面中单击 / 键 快速全文检索关键词。

  • 对于小屏用户，您可以点击右上角的 放大镜 (🔍) 图标以输入关键词进行全文检索。

请注意查看下方的本节目录，点击目录中的小节可以快速跳转到对应内容。

💡 摘要 (Summary by DeepSeek-v4-Flash)

在本文中，我们将介绍如何在 Debian/Ubuntu、Centos/RHEL、Arch Linux 系统上使用包管理器或源码编译安装 BIRD。我们还将介绍如何配置 BIRD 服务，以便在安装完成后启动 BIRD 服务。

📖 本节目录

目前 BIRD 最新的版本是多少？ ​

截止到 2026 年 05 月 02 日，BIRD 的最新主线版本为 v2.18 （2025 年 12 月 26 日发布），v3 主线最新版本为 v3.1.6 （2026 年 04 月 02 日发布）。

您还可以通过以下命令查看当前系统中安装的 BIRD 版本：

bash
birdc -v

环境要求 ​

BIRD 可以在大多数 UNIX-like 系统上运行，包括 Linux、FreeBSD、macOS 。

一般情况下建议通过 系统包管理器 安装 BIRD，但如果你需要使用最新的 BIRD 版本，或者你的系统包管理器没有最新的 BIRD ，那么你可以选择从 源码编译安装 BIRD。

通过系统包管理器安装 ​

💡 小贴士

系统包管理器仓库一般会有 bird 和 bird2 两种版本，前者为 1.x 版本，后者对应的是 2.x 版本。

1.x 版本已经停止维护，所以本文档不再考虑 1.x 版本的安装。

如果你并不知道自己在干什么，请一定不要安装 1.x 版本的 BIRD，否则可能会导致一些不可预知的问题。

Debian/Ubuntu ​

Debian/Ubuntu 系统可以通过 apt 包管理器安装 BIRD：

使用 CZ.NIC 官方源 (推荐) ​

CZ.NIC 官方文档

对于 Debian / Ubuntu 系统，目前最推荐的安装方式是使用 CZ.NIC 官方源。

BIRD 2.x 安装 ​
bash
sudo apt update && sudo apt -y install apt-transport-https ca-certificates wget lsb-release
sudo wget -O /usr/share/keyrings/cznic-labs-pkg.gpg https://pkg.labs.nic.cz/gpg

echo "deb [signed-by=/usr/share/keyrings/cznic-labs-pkg.gpg] https://pkg.labs.nic.cz/bird2 $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/cznic-labs-bird2.list

sudo apt update && sudo apt install bird2
BIRD 3.x 安装 ​
bash
sudo apt update && sudo apt -y install apt-transport-https ca-certificates wget lsb-release
sudo wget -O /usr/share/keyrings/cznic-labs-pkg.gpg https://pkg.labs.nic.cz/gpg

echo "deb [signed-by=/usr/share/keyrings/cznic-labs-pkg.gpg] https://pkg.labs.nic.cz/bird3 $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/cznic-labs-bird3.list

sudo apt update && sudo apt install bird3

Ubuntu 系发行版本安装 BIRD ​

⚠️ 注意

目前推荐使用 CZ.NIC 官方源安装 BIRD，故不再推荐使用 noble 通道安装 BIRD。

Ubuntu noble 通道最新版本

Ubuntu 系统默认软件源中 BIRD 版本比较旧，如果你需要安装最新版的 BIRD ，可以通过添加 noble 通道来安装最新版 BIRD：

bash
echo "deb http://archive.ubuntu.com/ubuntu/ $(lsb_release -sc)-noble main contrib non-free" | tee -a /etc/apt/sources.list
apt update
apt install -t $(lsb_release -sc)-noble bird2

Debian 使用 Backports 通道安装 BIRD ​

⚠️ 注意

目前推荐使用 CZ.NIC 官方源安装 BIRD，故不再推荐使用 Backports 通道安装 BIRD。

Debian Backports 通道最新版本

Debian 系统默认的软件源中的 BIRD 版本较旧，如果你需要安装最新版的 BIRD ，可以通过添加 Backports 通道来安装最新版 BIRD：

bash
echo "deb http://deb.debian.org/debian $(lsb_release -sc)-backports main" > tee -a /etc/apt/sources.list
apt update
apt install -t $(lsb_release -sc)-backports bird2

Fedora/RHEL ​

注意

CentOS7 即将在 2021 年 12 月 31 日停止维护，所以本文档不再考虑 CentOS 系统。

Fedora/RHEL 类系统可以通过 dnf 包管理器安装 BIRD：

Fedora-最新版本徽章

bash
dnf install bird

Arch Linux ​

注意

Arch Linux 的 Extra 通道 中的软件包可能会有一定不稳定性，所以本文档不建议在生产环境中使用 Arch Linux 系统。

如果你使用 Arch Linux，可以通过 pacman 包管理器的 Extra 通道安装最新版本的 BIRD：

Arch Linux-最新版本徽章

bash
pacman -Syu --needed --repository=extra bird

Alpine Linux ​

Alpine Linux 系统可以通过 apk 包管理器从社区仓库安装 BIRD：

💡 小贴士

Alpine Linux 的稳定版本（如 v3.21）通常包含较旧的 BIRD 版本，如果需要最新版本，建议使用 Edge 分支。

Alpine Linux Edge-最新版本徽章

Alpine Linux 稳定版-最新版本徽章

安装最新版本 (Edge 分支) ​

bash
# 添加 Edge 社区仓库
echo "https://dl-cdn.alpinelinux.org/alpine/edge/community" >> /etc/apk/repositories

# 更新包索引并安装 BIRD
apk update && apk add bird

安装稳定版本 ​

bash
# 启用社区仓库（如果尚未启用）
sed -i 's/#.*community//' /etc/apk/repositories

# 更新包索引并安装 BIRD
apk update && apk add bird

启动 BIRD 服务 ​

Alpine Linux 使用 OpenRC 作为初始化系统：

bash
# 启用并启动 BIRD 服务
rc-update add bird default
rc-service bird start

从源码编译安装 ​

安装依赖 ​

  • gcc & make (构建编译套件)
  • binutils & m4 (二进制链接器)
  • autoconf (自动配置工具)

除此之外，你可能还需要安装以下依赖：

  • flex & bison (语法分析器)
  • libncurses & libreadline (birdc 的依赖)
  • git & curl (从官方 Gitlab 仓库下载源码)
bash
apt install gcc make binutils m4 flex bison libncurses-dev libreadline-dev autoconf
bash
dnf install gcc make binutils m4 flex bison ncurses-devel readline-devel autoconf
bash
pacman -Syu --needed gcc make binutils m4 flex bison ncurses readline autoconf
bash
apk add gcc make binutils m4 flex bison ncurses-dev readline-dev autoconf

拓展依赖：

bash
apt install git curl
bash
dnf install git curl
bash
pacman -Syu --needed git curl
bash
apk add git curl

下载源码 ​

BIRD 的源码托管在官方的 Gitlab 上，你可以通过以下命令下载源码：

点击展开

自动获取最新版本号并下载：

bash
_BIRD_VERSION=$(curl -Ls https://gitlab.nic.cz/labs/bird/-/raw/master/NEWS | head -n 1 | grep -oP 'Version \K[^ ]+')

git clone https://gitlab.nic.cz/labs/bird.git -b $_BIRD_VERSION BIRD-$_BIRD_VERSION

生成 makefile，自定义配置路径为 /etc/bird，运行状态路径为 /var/run/bird：

bash
cd BIRD-$_BIRD_VERSION

autoconf

./configure --prefix= --sysconfdir=/etc/bird --runstatedir=/var/run/bird

make && make install

配置 BIRD 服务 ​

💡 小贴士

如果此前选择通过包管理器安装了 BIRD，那请跳过本节。

包管理器一般会自动配置 BIRD 服务，所以并不需要手动配置 BIRD 服务。

大多数 Linux 发行版都使用 systemd 来管理系统服务，所以本文档以 systemd 为例来配置 BIRD 服务。

创建配置文件 ​

如果你从源码编译安装 BIRD ，那么你需要手动创建配置文件。

bash
# /etc/systemd/system/bird.service

[Unit]
Description="BIRD Internet Routing Daemon"
After=network.target

[Service]
Type=simple
ExecStartPre=/usr/sbin/bird -p
ExecReload=/usr/sbin/birdc configure
ExecStart=/usr/sbin/bird -f -u bird -g bird
Restart=on-abort

[Install]
WantedBy=multi-user.target

配置解释 ​

  • ExecStartPre=/usr/sbin/bird -p：检查配置文件是否正确
  • ExecReload=/usr/sbin/birdc configure：重新加载配置文件
  • ExecStart=/usr/sbin/bird -f -u bird -g bird：使用 bird 用户和 bird 组启动 BIRD 服务
  • Restart=on-abort：当 BIRD 服务异常退出时自动重启

启动 BIRD 服务 ​

bash
systemctl daemon-reload
systemctl enable bird
systemctl start bird

安装完成 ​

至此，你已经成功安装了 BIRD 🎉

本文译者及原文信息 ​

Hat

Hat

译者

展开原文属性

原文作者 <Ondrej Filip>, <Martin Mares>, <Maria Matejka>, <Ondrej Zajicek>

原文链接： https://bird.network.cz/?get_doc&v=20&f=bird-1.html#ss1.2

原文标题： 1.2 Installation

展开译文属性

遵循协议： CC BY-NC-SA 4.0

译者： hat

校对： nelson

翻译时间： 2023-11-11

更新时间： 2026-05-02

本文链接： https://bird.xmsl.dev/docs/user-guide/1-2-installing.html

译文采用 CC BY-NC-SA 4.0 协议发布

© 2026 BIRD 中文翻译计划 版权所有