Vector 在 Amazon Linux 上的安装与运维完整指南
【免费下载链接】vectorA high-performance observability data pipeline.项目地址: https://gitcode.com/GitHub_Trending/vect/vector
导读
Vector 是一个高性能的可观测性数据管道（observability data pipeline），用于采集、转换和路由日志、指标与 trace 数据。本文聚焦 Amazon Linux（AWS 官方为 EC2 提供的 Linux AMI）这一操作系统，完整讲解 Vector 的安装方式、包管理操作、systemd 服务管理以及基于 YUM/RPM 与 Docker 的日常运维命令，并辅以当前仓库源码（RPM 打包规范、systemd 单元文件、安装脚本）作为底层实现依据，帮助你在 Amazon EC2 环境中快速落地一套可维护的 Vector 部署。
Amazon Linux 与 Vector 的适配背景
Amazon Linux AMI 是 Amazon Web Services 为 Amazon Elastic Compute Cloud（Amazon EC2）提供的受支持且持续维护的 Linux 镜像，其设计目标是为 EC2 上运行的应用提供稳定、安全、高性能的执行环境。它基于 RPM 包管理体系，因此可以无缝使用 Vector 官方提供的 YUM 软件源与 RPM 包。
当前仓库中，Vector 的 RPM 打包规范位于 distribution/rpm/vector.spec，该规范明确将包元数据定义为Name: vector、License: MPL-2.0，并把二进制安装到%{_bindir}（即/usr/bin/vector），同时安装 systemd 单元文件与示例配置。也就是说，Amazon Linux 用户可以直接通过系统包管理器获得与仓库发行版本一致的安装产物。
支持的安装方式
Vector 官方为 Amazon Linux 提供以下安装器（installer）支持：
- YUM：通过 Datadog 托管的 YUM 软件源安装（推荐，自动处理依赖与升级）
- RPM：直接下载并安装官方 RPM 包
- Docker：在容器中运行 Vector
- Vector installer：平台无关的官方安装脚本
这些安装器在文档站点中由supported-installersshortcode 自动渲染成链接列表，其实现见 website/layouts/shortcodes/supported-installers.html，它会根据页面 front matter 中的supported_installers参数（本文档声明为["YUM", "RPM", "Docker", "Vector installer"]）逐个生成对应安装文档的跳转链接。
下文分别给出每种方式的完整操作步骤。
方式一：通过 YUM 软件源安装（推荐）
YUM（Yellowdog Updater, Modified）是基于 RPM 包管理器的命令行包管理工具，适合 Amazon Linux、CentOS、RHEL 等 RPM 系发行版。Vector 的 YUM 仓库由 Datadog。
添加软件源并安装
首先执行官方 setup 脚本添加 Vector 软件源：
bash -c "$(curl -L https://setup.vector.dev)"然后安装 Vector：
sudo yum install vector升级 Vector
sudo yum upgrade vector卸载 Vector
sudo yum remove vector使用 YUM 安装的收益在于：包管理器会替你处理依赖、文件属性和升级路径。仓库中的 RPM 规范（distribution/rpm/vector.spec）显示，安装包在%post阶段会自动创建名为vector的系统用户（--shell /sbin/nologin、主目录/var/lib/vector），并将其加入systemd-journal与systemd-journal-remote用户组，从而让 Vector 能够读取 journald 日志（例如用于journald源）。同时%post阶段还会创建/var/lib/vector目录并设置属主。
方式二：直接安装 RPM 包
如果你不想添加 YUM 软件源，也可以直接使用rpm命令从官方仓库下载并安装：
sudo rpm -i https://yum.vector.dev/stable/vector-0/{arch}/vector-<版本号>-1.{arch}.rpm注意将{arch}替换为以下架构之一：
| 架构值 | 说明 |
|---|---|
x86_64 | 64 位 Intel/AMD 架构（绝大多数 EC2 实例） |
aarch64 | 64 位 ARM 架构（如 Graviton 系列实例） |
armv7hl | 32 位 ARM hard-float 架构 |
并替换<版本号>为具体版本（例如0.59.0，与仓库 Cargo.toml 中声明的版本一致）。
卸载 Vector
sudo rpm -e vectorRPM 包的安装内容
从 distribution/rpm/vector.spec 的%files段可以看到，RPM 包实际交付的文件包括：
/usr/bin/vector：主二进制- systemd 单元文件（
vector.service） /etc/default/vector：环境变量配置文件（%config(noreplace)，升级时不会覆盖用户修改）/etc/vector/examples/*：示例配置/var/lib/vector：数据目录（属主为vector用户）- README、NOTICE、LICENSE 与第三方许可清单等文档
也就是说，安装完成后你不仅获得了可执行文件，还获得了开箱即用的 systemd 服务单元与配置骨架。
方式三：使用 Vector installer 官方脚本
Vector installer 是一个平台无关的安装脚本，适合快速安装或脚本化部署：
curl --proto '=https' --tlsv1.2 -sSfL https://sh.vector.dev | bash如需指定版本，可以通过环境变量VECTOR_VERSION传入：
curl --proto '=https' --tlsv1.2 -sSfL https://sh.vector.dev | VECTOR_VERSION=0.34.1 bash官方脚本的完整说明见 Vector installer 文档。它同样会落地二进制与 systemd 服务，方便后续统一管理。
方式四：通过 Docker 运行
若你的 EC2 环境已经容器化，可以直接使用 Vector 官方镜像。完整文档见 Docker 安装文档，镜像构建配置位于 distribution/docker（提供alpine、debian、distroless-libc、distroless-static等变体）。
拉取镜像
docker pull timberio/vector:0.59.0-debian也可从 GitHub Container Registry 拉取：
docker pull ghcr.io/vectordotdev/vector:0.59.0-debian除debian外，还可使用alpine、distroless-libc、distroless-static等发行变体。
编写配置并启动
创建一份最小可用的 Vector 配置（输出 demo 日志到 stdout）：
cat <<-EOF > $PWD/vector.yaml api: enabled: true address: 0.0.0.0:8686 sources: demo_logs: type: demo_logs interval: 1 format: json sinks: console: inputs: - demo_logs target: stdout type: console encoding: codec: json EOF启动容器（将配置挂载到容器内/etc/vector/vector.yaml）：
docker run \ -d \ -v $PWD/vector.yaml:/etc/vector/vector.yaml:ro \ -p 8686:8686 \ --name vector \ timberio/vector:0.59.0-debian如果使用其他发行变体，请相应替换镜像标签中的debian。
停止 / 重载 / 重启 / 观察 / 卸载
# 停止 docker stop vector # 重载配置（向主进程发送 HUP 信号） docker kill --signal=HUP vector # 重启 docker restart $(docker ps -aqf "name=vector") # 查看实时日志 docker logs -f $(docker ps -aqf "name=vector") # 查看运行指标 docker exec -ti $(docker ps -aqf "name=vector") vector top # 卸载（删除容器） docker rm vector安装后的 systemd 服务管理
无论通过 YUM、RPM 还是 installer 安装，Amazon Linux 上的 Vector 都由 systemd 管理。仓库中的单元文件 distribution/systemd/vector.service 揭示了服务的完整行为：
[Unit] Description=Vector Documentation=https://vector.dev After=network-online.target Requires=network-online.target [Service] User=vector Group=vector ExecStartPre=/usr/bin/vector validate ExecStart=/usr/bin/vector ExecReload=/usr/bin/vector validate --no-environment ExecReload=/bin/kill -HUP $MAINPID Restart=always AmbientCapabilities=CAP_NET_BIND_SERVICE EnvironmentFile=-/etc/default/vector StartLimitInterval=10 StartLimitBurst=5 [Install] WantedBy=multi-user.target要点解读：
- 专用运行用户：服务以
vector用户和vector组运行（由 RPM%post脚本自动创建），遵循最小权限原则。 - 启动前校验：
ExecStartPre=/usr/bin/vector validate会在启动前校验配置合法性，配置有误时拒绝启动；ExecReload同样先执行validate --no-environment再发送 HUP 信号完成热重载。 - 自动重启：
Restart=always保证进程异常退出后被 systemd 拉起，StartLimitInterval=10、StartLimitBurst=5限制了重启频率，防止崩溃循环。 - 特权能力：
AmbientCapabilities=CAP_NET_BIND_SERVICE允许以非 root 身份绑定 1024 以下特权端口（例如 80/443 的 source/sink 监听）。 - 环境变量配置：
EnvironmentFile=-/etc/default/vector读取 distribution/systemd/vector.default 中的环境变量（默认文件为空，可参照注释按需填写，例如注入用于 secret 管理的环境变量），-前缀表示文件缺失时不报错。
常用 systemd 命令
# 启动并设置开机自启 sudo systemctl enable --now vector # 查看状态 sudo systemctl status vector # 停止 sudo systemctl stop vector # 重载配置（先校验、后 HUP 热重载） sudo systemctl reload vector # 重启 sudo systemctl restart vector # 查看日志 sudo journalctl -u vector -f # 禁用开机自启 sudo systemctl disable vector仓库还提供了加固版本单元文件 distribution/systemd/hardened-vector.service，适用于对安全基线要求更高的生产环境。
快速验证安装
安装完成后，可以通过以下命令确认 Vector 正常工作：
# 查看版本 vector --version # 校验配置 sudo vector validate --config /etc/vector/vector.yaml # 运行顶层监控界面（观察吞吐与拓扑） vector top其中vector validate是启动前校验、配置热重载等场景共用的核心子命令，源码入口位于 src/validate.rs；vector top是实时监控命令，实现在 src/top。
典型落地场景：EC2 上的日志采集
将以上步骤组合，一个典型的 Amazon Linux EC2 采集节点部署流程为：
- 通过 YUM 安装 Vector：
sudo yum install vector； - 编写
/etc/vector/vector.yaml，例如配置file源采集/var/log/下日志，经remap转换后发送到目标 sink； sudo systemctl enable --now vector启动并自启；- 修改配置后执行
sudo systemctl reload vector热重载； - 用
sudo journalctl -u vector -f与vector top持续观察运行状态与吞吐指标。
如需在 Kubernetes 环境部署，可参考 Helm 安装文档 与 Kubernetes 部署文档。
参考文档
- YUM 安装文档
- RPM 安装文档
- Vector installer 安装文档
- Docker 安装文档
- RPM 打包规范
- systemd 服务单元
- 示例配置
【免费下载链接】vectorA high-performance observability data pipeline.项目地址: https://gitcode.com/GitHub_Trending/vect/vector
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
