Vector 在 Ubuntu 上的安装与部署指南五种安装方式与运维实战【免费下载链接】vectorA high-performance observability data pipeline.项目地址: https://gitcode.com/GitHub_Trending/vect/vectorVector 是一款高性能的可观测性数据管道observability data pipeline用于采集、转换与路由日志、指标和 trace 数据。Ubuntu 作为基于 Debian 的主流 Linux 发行版是 Vector 最常部署的操作系统之一。本指南以 Ubuntu 官方安装文档 为核心完整覆盖 APT、dpkg、官方安装脚本、Docker 与 Helm 五种受支持安装方式并结合仓库中的 systemd 服务单元、Debian 打包脚本与配置样例帮助你在 Ubuntu 上完成从安装、配置、运行到安全加固的全流程。支持的安装方式概览根据 Ubuntu 安装文档 的声明Vector 在 Ubuntu 上共支持五种安装方式对应文档 frontmatter 中的supported_installers字段安装方式适用场景对应文档APT最推荐支持自动升级与 systemd 集成package-managers/apt.mddpkg需要离线安装或精确控制 .deb 包版本package-managers/dpkg.mdVector installer跨平台脚本安装一条命令完成manual/vector-installer.mdDocker容器化部署隔离环境、便于编排platforms/docker.mdHelmKubernetes 集群内以 Agent / Aggregator 角色部署package-managers/helm.md其中 APT 与 dpkg 两种方式在 Ubuntu 上均可直接使用下面逐一展开。方式一通过 APT 仓库安装推荐APTAdvanced Package Tool是 Debian/Ubuntu 系发行版的标准包管理器。Vector 的 APT 仓库由 Datadog 提供支持x86_64、ARM64、ARMv7三种架构。添加仓库bash -c $(curl -L https://setup.vector.dev)该脚本会自动配置 Vector 的 APT 源并完成密钥导入。你也可以在 package-managers/apt.md 中查看完整说明。安装sudo apt-get install vector升级sudo apt-get upgrade vector卸载sudo apt remove vector选择 APT 方式的优势在于安装即注册 systemd 服务、自动创建运行用户与数据目录且后续升级只需一条命令与 Ubuntu 系统的包管理生态完全融合。方式二通过 dpkg 手动安装 .deb 包当你需要离线安装、锁版本或审计包内容时可以直接使用 dpkg 安装.deb包。安装包托管在 APT 仓库的 pool 目录下格式为curl \ --proto https \ --tlsv1.2 -O \ https://apt.vector.dev/pool/v/ve/vector_版本-1_架构.deb sudo dpkg -i vector_版本-1_架构.deb其中架构需替换为以下三者之一amd64arm64armhfdpkg 方式的升级与卸载# 升级重新安装新版 .deb 包 dpkg -i vector-版本-架构.deb # 卸载 dpkg -r vector从仓库中的 distribution/debian/scripts/postinst 脚本可以看出.deb包安装后会执行一系列后置配置创建vector专用运行用户将vector用户追加到adm组使其能够读取/var/log下的日志文件若系统存在systemd-journal/systemd-journal-remote组则将vector加入其中以读取 journald 日志触发systemctl daemon-reload使 systemd 服务单元生效。方式三使用 Vector 官方安装脚本Vector 提供了平台无关的官方安装脚本适合快速上手或脚本化部署curl --proto https --tlsv1.2 -sSfL https://sh.vector.dev | bash如需安装指定版本可通过环境变量VECTOR_VERSION指定curl --proto https --tlsv1.2 -sSfL https://sh.vector.dev | VECTOR_VERSION0.34.1 bash该方式细节见 manual/vector-installer.md。脚本安装后Vector 可执行文件通常位于/usr/bin/vector同样带有 systemd 服务支持详见下文服务管理小节。方式四Docker 容器运行若你倾向于容器化部署Vector 官方镜像托管于 Docker Hub 与 GHCR。Ubuntu 用户可直接拉取基于 Debian 的镜像docker pull timberio/vector:版本-debian除debian外官方还提供alpine、distroless-libc、distroless-static等发行版变体可按镜像体积与运行时依赖灵活选择。完整说明见 platforms/docker.md。最小配置并启动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 docker run \ -d \ -v $PWD/vector.yaml:/etc/vector/vector.yaml:ro \ -p 8686:8686 \ --name vector \ timberio/vector:版本-debian上述配置通过demo_logs源每秒生成一条 JSON 日志经consolesink 输出到 stdout。若使用其他发行版镜像请将debian替换为对应名称。容器运维命令# 停止 docker stop vector # 热加载配置发送 HUP 信号 docker kill --signalHUP vector # 重启 docker restart $(docker ps -aqf namevector) # 查看日志 docker logs -f $(docker ps -aqf namevector) # 查看运行指标 docker exec -ti $(docker ps -aqf namevector) vector top # 卸载删除容器 docker rm vector方式五Helm 部署Kubernetes在 Kubernetes 集群中推荐使用 Helm 管理 Vector。Vector 支持以Agent与Aggregator两种角色部署详见 deployment/roles.mdAgent 负责在节点上采集数据Aggregator 负责集中处理与转发。添加 Helm 仓库helm repo add vector https://helm.vector.dev helm repo update以 Agent 角色部署# values.yaml role: Agenthelm install vector vector/vector \ --namespace vector \ --create-namespace \ --values values.yaml以 Aggregator 角色部署chart 默认helm install vector vector/vector \ --namespace vector \ --create-namespace查看与更新配置# 查看全部可配置项 helm show values vector/vector # 更新 helm repo update \ helm upgrade vector vector/vector \ --namespace vector \ --reuse-values卸载helm uninstall vector --namespace vector安装后的服务管理与运维通过 APT、dpkg 或官方脚本安装后Vector 会注册为 systemd 服务。仓库中的 distribution/systemd/vector.service 展示了服务单元的关键配置[Unit] DescriptionVector Afternetwork-online.target Requiresnetwork-online.target [Service] Uservector Groupvector ExecStartPre/usr/bin/vector validate ExecStart/usr/bin/vector ExecReload/usr/bin/vector validate --no-environment ExecReload/bin/kill -HUP $MAINPID Restartalways EnvironmentFile-/etc/default/vector从中可以看到几个重要的运维设计启动前校验ExecStartPre/usr/bin/vector validate会在进程真正启动前对配置文件做合法性校验配置有误时服务直接启动失败并给出明确错误避免带病运行热加载ExecReload先执行vector validate --no-environment校验跳过环境变量解析见 src/validate.rs校验通过后再向主进程发送HUP信号触发配置热重载自动拉起Restartalways保证进程异常退出后由 systemd 自动重启环境变量文件EnvironmentFile-/etc/default/vector可选允许在 distribution/systemd/vector.default 中注入环境变量权限最小化服务以vector用户非 root运行。日常管理命令sudo systemctl start vector # 启动 sudo systemctl status vector # 查看状态 sudo systemctl reload vector # 热加载配置HUP sudo systemctl restart vector # 重启 sudo systemctl enable vector # 设置开机自启快速开始最小可运行配置安装完成后可以在/etc/vector/vector.yaml默认配置路径写入一个最小配置进行冒烟测试。仓库根目录的 config/vector.yaml 提供了完整参考Docker 章节给出的 demo 配置同样适用于本机运行sources: demo_logs: type: demo_logs interval: 1 format: json sinks: console: inputs: - demo_logs target: stdout type: console encoding: codec: json写入配置后执行sudo systemctl restart vector再通过sudo journalctl -u vector -f即可实时观察输出的 JSON 日志。更多入门示例可参考 docs/quickstart。安全加固建议在生产环境的 Ubuntu 主机上部署 Vector 时建议遵循 going-to-prod/hardening.md 中的加固指引其中与 Ubuntu/系统包安装直接相关的要点包括不以下载裸文件方式获取二进制始终通过加密通道下载并校验安装包对应供应链攻击防御限制数据目录访问/var/lib/vector仅允许vector服务账号读写禁止 root 运行systemd 服务单元已默认以vector用户运行请勿修改限制 core dump在服务单元中设置LimitCORE0。hardening 文档明确说明通过apt安装 Vector 时会自动应用该设置及时升级将sudo apt-get upgrade vector纳入常规维护节奏以获取安全修复。相关文档导航Ubuntu 安装文档operating-systems/ubuntu.mdAPT 方式package-managers/apt.mddpkg 方式package-managers/dpkg.md官方安装脚本manual/vector-installer.mdDocker 部署platforms/docker.mdHelm 部署package-managers/helm.md部署角色Agent / Aggregatordeployment/roles.md安全加固going-to-prod/hardening.md【免费下载链接】vectorA high-performance observability data pipeline.项目地址: https://gitcode.com/GitHub_Trending/vect/vector创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Vector 在 Ubuntu 上的安装与部署指南：五种安装方式与运维实战
Vector 在 Ubuntu 上的安装与部署指南五种安装方式与运维实战【免费下载链接】vectorA high-performance observability data pipeline.项目地址: https://gitcode.com/GitHub_Trending/vect/vectorVector 是一款高性能的可观测性数据管道observability data pipeline用于采集、转换与路由日志、指标和 trace 数据。Ubuntu 作为基于 Debian 的主流 Linux 发行版是 Vector 最常部署的操作系统之一。本指南以 Ubuntu 官方安装文档 为核心完整覆盖 APT、dpkg、官方安装脚本、Docker 与 Helm 五种受支持安装方式并结合仓库中的 systemd 服务单元、Debian 打包脚本与配置样例帮助你在 Ubuntu 上完成从安装、配置、运行到安全加固的全流程。支持的安装方式概览根据 Ubuntu 安装文档 的声明Vector 在 Ubuntu 上共支持五种安装方式对应文档 frontmatter 中的supported_installers字段安装方式适用场景对应文档APT最推荐支持自动升级与 systemd 集成package-managers/apt.mddpkg需要离线安装或精确控制 .deb 包版本package-managers/dpkg.mdVector installer跨平台脚本安装一条命令完成manual/vector-installer.mdDocker容器化部署隔离环境、便于编排platforms/docker.mdHelmKubernetes 集群内以 Agent / Aggregator 角色部署package-managers/helm.md其中 APT 与 dpkg 两种方式在 Ubuntu 上均可直接使用下面逐一展开。方式一通过 APT 仓库安装推荐APTAdvanced Package Tool是 Debian/Ubuntu 系发行版的标准包管理器。Vector 的 APT 仓库由 Datadog 提供支持x86_64、ARM64、ARMv7三种架构。添加仓库bash -c $(curl -L https://setup.vector.dev)该脚本会自动配置 Vector 的 APT 源并完成密钥导入。你也可以在 package-managers/apt.md 中查看完整说明。安装sudo apt-get install vector升级sudo apt-get upgrade vector卸载sudo apt remove vector选择 APT 方式的优势在于安装即注册 systemd 服务、自动创建运行用户与数据目录且后续升级只需一条命令与 Ubuntu 系统的包管理生态完全融合。方式二通过 dpkg 手动安装 .deb 包当你需要离线安装、锁版本或审计包内容时可以直接使用 dpkg 安装.deb包。安装包托管在 APT 仓库的 pool 目录下格式为curl \ --proto https \ --tlsv1.2 -O \ https://apt.vector.dev/pool/v/ve/vector_版本-1_架构.deb sudo dpkg -i vector_版本-1_架构.deb其中架构需替换为以下三者之一amd64arm64armhfdpkg 方式的升级与卸载# 升级重新安装新版 .deb 包 dpkg -i vector-版本-架构.deb # 卸载 dpkg -r vector从仓库中的 distribution/debian/scripts/postinst 脚本可以看出.deb包安装后会执行一系列后置配置创建vector专用运行用户将vector用户追加到adm组使其能够读取/var/log下的日志文件若系统存在systemd-journal/systemd-journal-remote组则将vector加入其中以读取 journald 日志触发systemctl daemon-reload使 systemd 服务单元生效。方式三使用 Vector 官方安装脚本Vector 提供了平台无关的官方安装脚本适合快速上手或脚本化部署curl --proto https --tlsv1.2 -sSfL https://sh.vector.dev | bash如需安装指定版本可通过环境变量VECTOR_VERSION指定curl --proto https --tlsv1.2 -sSfL https://sh.vector.dev | VECTOR_VERSION0.34.1 bash该方式细节见 manual/vector-installer.md。脚本安装后Vector 可执行文件通常位于/usr/bin/vector同样带有 systemd 服务支持详见下文服务管理小节。方式四Docker 容器运行若你倾向于容器化部署Vector 官方镜像托管于 Docker Hub 与 GHCR。Ubuntu 用户可直接拉取基于 Debian 的镜像docker pull timberio/vector:版本-debian除debian外官方还提供alpine、distroless-libc、distroless-static等发行版变体可按镜像体积与运行时依赖灵活选择。完整说明见 platforms/docker.md。最小配置并启动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 docker run \ -d \ -v $PWD/vector.yaml:/etc/vector/vector.yaml:ro \ -p 8686:8686 \ --name vector \ timberio/vector:版本-debian上述配置通过demo_logs源每秒生成一条 JSON 日志经consolesink 输出到 stdout。若使用其他发行版镜像请将debian替换为对应名称。容器运维命令# 停止 docker stop vector # 热加载配置发送 HUP 信号 docker kill --signalHUP vector # 重启 docker restart $(docker ps -aqf namevector) # 查看日志 docker logs -f $(docker ps -aqf namevector) # 查看运行指标 docker exec -ti $(docker ps -aqf namevector) vector top # 卸载删除容器 docker rm vector方式五Helm 部署Kubernetes在 Kubernetes 集群中推荐使用 Helm 管理 Vector。Vector 支持以Agent与Aggregator两种角色部署详见 deployment/roles.mdAgent 负责在节点上采集数据Aggregator 负责集中处理与转发。添加 Helm 仓库helm repo add vector https://helm.vector.dev helm repo update以 Agent 角色部署# values.yaml role: Agenthelm install vector vector/vector \ --namespace vector \ --create-namespace \ --values values.yaml以 Aggregator 角色部署chart 默认helm install vector vector/vector \ --namespace vector \ --create-namespace查看与更新配置# 查看全部可配置项 helm show values vector/vector # 更新 helm repo update \ helm upgrade vector vector/vector \ --namespace vector \ --reuse-values卸载helm uninstall vector --namespace vector安装后的服务管理与运维通过 APT、dpkg 或官方脚本安装后Vector 会注册为 systemd 服务。仓库中的 distribution/systemd/vector.service 展示了服务单元的关键配置[Unit] DescriptionVector Afternetwork-online.target Requiresnetwork-online.target [Service] Uservector Groupvector ExecStartPre/usr/bin/vector validate ExecStart/usr/bin/vector ExecReload/usr/bin/vector validate --no-environment ExecReload/bin/kill -HUP $MAINPID Restartalways EnvironmentFile-/etc/default/vector从中可以看到几个重要的运维设计启动前校验ExecStartPre/usr/bin/vector validate会在进程真正启动前对配置文件做合法性校验配置有误时服务直接启动失败并给出明确错误避免带病运行热加载ExecReload先执行vector validate --no-environment校验跳过环境变量解析见 src/validate.rs校验通过后再向主进程发送HUP信号触发配置热重载自动拉起Restartalways保证进程异常退出后由 systemd 自动重启环境变量文件EnvironmentFile-/etc/default/vector可选允许在 distribution/systemd/vector.default 中注入环境变量权限最小化服务以vector用户非 root运行。日常管理命令sudo systemctl start vector # 启动 sudo systemctl status vector # 查看状态 sudo systemctl reload vector # 热加载配置HUP sudo systemctl restart vector # 重启 sudo systemctl enable vector # 设置开机自启快速开始最小可运行配置安装完成后可以在/etc/vector/vector.yaml默认配置路径写入一个最小配置进行冒烟测试。仓库根目录的 config/vector.yaml 提供了完整参考Docker 章节给出的 demo 配置同样适用于本机运行sources: demo_logs: type: demo_logs interval: 1 format: json sinks: console: inputs: - demo_logs target: stdout type: console encoding: codec: json写入配置后执行sudo systemctl restart vector再通过sudo journalctl -u vector -f即可实时观察输出的 JSON 日志。更多入门示例可参考 docs/quickstart。安全加固建议在生产环境的 Ubuntu 主机上部署 Vector 时建议遵循 going-to-prod/hardening.md 中的加固指引其中与 Ubuntu/系统包安装直接相关的要点包括不以下载裸文件方式获取二进制始终通过加密通道下载并校验安装包对应供应链攻击防御限制数据目录访问/var/lib/vector仅允许vector服务账号读写禁止 root 运行systemd 服务单元已默认以vector用户运行请勿修改限制 core dump在服务单元中设置LimitCORE0。hardening 文档明确说明通过apt安装 Vector 时会自动应用该设置及时升级将sudo apt-get upgrade vector纳入常规维护节奏以获取安全修复。相关文档导航Ubuntu 安装文档operating-systems/ubuntu.mdAPT 方式package-managers/apt.mddpkg 方式package-managers/dpkg.md官方安装脚本manual/vector-installer.mdDocker 部署platforms/docker.mdHelm 部署package-managers/helm.md部署角色Agent / Aggregatordeployment/roles.md安全加固going-to-prod/hardening.md【免费下载链接】vectorA high-performance observability data pipeline.项目地址: https://gitcode.com/GitHub_Trending/vect/vector创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考