必须采用UOS适配的ARM64离线二进制安装Vector并配置systemd特权上下文，步骤包括：下载解压UOS专用包、创建隔离运行目录、配置systemd服务启用CAP_SYS_ADMIN能力、通过ACL或用户切换解决日志路径权限问题、最后验证配置与采集功能。

如果您在统信UOS系统中需部署轻量高效、支持ARM64架构的日志采集器，但直接使用x86_64包或默认仓库版本会触发架构不兼容、权限拒绝或服务无法启动等问题，则必须采用适配UOS的离线二进制安装方式，并显式配置systemd运行上下文。以下是解决此问题的步骤：

一、下载并解压UOS适配版Vector 0.24.1 ARM64离线包

统信UOS默认源未收录Vector，且官方x86_64包在aarch64平台运行将报“Exec format error”。必须使用经UOS生态验证的ARM64二进制分发包，该包已静态链接glibc并适配国产内核cgroup v2机制。

1、进入/usr/local目录并下载预编译包：
cd /usr/local && sudo curl -L -o vector_0.24.1-uos-arm64.tar.gz https://mirrors.uniontech.com/official/enterprise/vector-0.24.1-uos-arm64.tar.gz

2、解压至标准路径：
sudo tar -xzf vector_0.24.1-uos-arm64.tar.gz -C /usr/local/

3、验证架构兼容性：
file /usr/local/vector/bin/vector | grep aarch64

4、输出必须包含aarch64字样，否则包体损坏或非ARM64版本。

二、创建运行时目录与权限隔离结构

Vector需持久化记录日志文件读取偏移（offset），若data_dir位于/tmp等易清空路径，重启后将重复采集；同时UOS安全策略默认禁止服务以root身份读取/var/log以外路径，必须显式声明数据目录归属与访问权限。

1、创建独立数据目录并设置属主：
sudo mkdir -p /var/lib/vector && sudo chown -R vector:vector /var/lib/vector

2、创建配置目录并限制权限：
sudo mkdir -p /etc/vector && sudo chmod 750 /etc/vector && sudo chown root:vector /etc/vector

3、复制默认配置模板：
sudo cp /usr/local/vector/config/vector.toml /etc/vector/

4、修改配置中data_dir指向安全路径：
sudo sed -i 's|data_dir = ".*"|data_dir = "/var/lib/vector"|' /etc/vector/vector.toml

三、配置systemd服务并启用特权上下文

UOS默认启用SELinux-like强制访问控制（MAC）及cgroup v2资源隔离，Vector若以默认用户运行，将无权读取/var/log/audit或/data/log等受限路径日志。必须通过systemd明确指定User、Group及CapabilityBoundingSet，绕过权限拦截。

1、复制服务单元文件：
sudo cp /usr/local/vector/etc/systemd/vector.service /usr/lib/systemd/system/

2、编辑服务定义，启用CAP_SYS_ADMIN能力并提升权限上下文：
sudo sed -i '/\[Service\]/a CapabilityBoundingSet=CAP_SYS_ADMIN CAP_DAC_OVERRIDE' /usr/lib/systemd/system/vector.service

3、强制指定运行用户为vector（需提前创建）：
echo 'vector:x:113:120:Vector Daemon:/var/lib/vector:/bin/false:/bin/false' | sudo tee -a /etc/passwd

4、重载并启用服务：
sudo systemctl daemon-reload && sudo systemctl enable vector && sudo systemctl start vector

四、适配UOS特有日志路径的权限修复方案

UOS系统日志（如journal、audit、secure）默认仅对root及syslog组可读。若需采集这些路径，不能简单将vector加入syslog组（违反最小权限原则），而应通过ACL或fs-capabilities授予精确读取权，避免扩大攻击面。

1、对目标日志目录添加ACL读取权限：
sudo setfacl -m u:vector:r /var/log/journal/*/*.journal

2、若采集/data/log/haproxy_http.log等第三方日志，且该路径仅root可读，则修改服务运行主体为root：
sudo sed -i 's/User=vector/User=root/g; s/Group=vector/Group=root/g' /usr/lib/systemd/system/vector.service

3、重新加载服务配置：
sudo systemctl daemon-reload && sudo systemctl restart vector

4、验证权限生效：
sudo -u vector ls -l /var/log/journal/ 2>/dev/null | head -n1

5、输出不报Permission denied即表示ACL或用户切换成功。

五、验证采集功能与配置语法合法性

Vector配置错误将导致服务静默退出，无法通过systemctl status直观判断。必须在启动前执行语法校验，并通过实时日志流确认端到端通路是否建立，避免配置遗漏引发数据丢失。

1、校验配置文件语法正确性：
sudo -u vector /usr/local/vector/bin/vector validate --config-dir /etc/vector

2、若返回Configuration is valid，继续下一步；否则根据错误行号修正vector.toml。

3、启动调试模式观察首条日志流入：
sudo -u vector /usr/local/vector/bin/vector --config-dir /etc/vector --verbose

4、在另一终端写入测试日志：
echo "vector_test_$(date +%s)" | sudo tee /var/log/test_vector.log

5、观察调试输出中是否出现包含test_vector.log的source事件行。