4. Agent 部署环境准备：操作系统选型与运行时安装

日志检索 Agent 的稳定运行高度依赖底层操作系统的选型与运行时环境的正确配置。本节从生产环境出发，对比主流操作系统、运行时安装方案及依赖管理策略，确保 Agent 在准入门禁场景下具备低延迟、高可用的基础。

4.1 操作系统选型：Linux vs. Windows

准入门禁日志检索 Agent 通常部署在边缘网关或中心日志服务器上，操作系统选型直接影响资源占用、安全策略和运维复杂度。下表从关键维度进行对比：

4.2 Python 运行时安装与版本管理

日志检索 Agent 若基于 Python 开发（如使用 asyncio 实现非阻塞日志采集），需确保 Python 版本 ≥ 3.9，并启用虚拟环境隔离依赖。

4.2.1 Linux 下安装 Python 3.11

# 更新包索引并安装编译依赖
sudo apt update
sudo apt install -y build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \
libncurses5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev \
libffi-dev liblzma-dev

# 下载并编译 Python 3.11.5
wget https://www.python.org/ftp/python/3.11.5/Python-3.11.5.tgz
tar -xf Python-3.11.5.tgz
cd Python-3.11.5
./configure --enable-optimizations --with-ensurepip=install
make -j$(nproc)
sudo make altinstall

# 验证安装
python3.11 --version
# 输出: Python 3.11.5

4.2.2 虚拟环境与依赖锁定

每个 Agent 实例应使用独立的虚拟环境，避免系统级包冲突：

# 创建虚拟环境
python3.11 -m venv /opt/agent-env

# 激活环境
source /opt/agent-env/bin/activate

# 安装依赖（示例：日志解析 + HTTP 客户端）
pip install --upgrade pip
pip install aiofile==23.1.0 httpx==0.25.0 pyyaml==6.0.1

# 导出依赖清单
pip freeze > requirements.txt

4.3 Go 运行时安装与编译部署

Go 编译后的二进制文件无外部依赖，特别适合准入门禁场景下的轻量级 Agent。推荐使用 Go 1.21+ 版本，支持泛型和更好的错误处理。

4.3.1 Linux 下安装 Go 1.21

# 下载 Go 二进制包
wget https://go.dev/dl/go1.21.5.linux-amd64.tar.gz

# 解压到 /usr/local
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.21.5.linux-amd64.tar.gz

# 配置环境变量（写入 /etc/profile.d/go.sh）
export PATH=$PATH:/usr/local/go/bin
export GOPATH=/opt/go-projects
export GO111MODULE=on
export GOPROXY=https://goproxy.cn,direct

# 验证安装
go version
# 输出: go version go1.21.5 linux/amd64

4.3.2 编译与部署 Agent 二进制

# 克隆或复制 Agent 源码
cd /opt/agent-source

# 下载依赖并编译（静态链接，无外部依赖）
go mod tidy
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-s -w" -o /opt/agent-bin/log-agent

# 验证编译产物
file /opt/agent-bin/log-agent
# 输出: ELF 64-bit LSB executable, x86-64, statically linked

# 直接运行（无需安装运行时）
/opt/agent-bin/log-agent --config /etc/agent/config.yaml

4.4 依赖管理策略

无论是 Python 还是 Go，依赖管理都需遵循“可重复、可审计、最小化”原则。下表列出两种语言的最佳实践：

4.5 环境验证清单

部署完成后，建议执行以下验证步骤，确保环境符合 Agent 运行要求：

1. 操作系统内核版本：uname -r 确认 ≥ 5.4（支持 eBPF 特性）
2. 文件描述符限制：ulimit -n 应 ≥ 65535，避免高并发日志采集时句柄耗尽
3. 时区与时间同步：timedatectl 确认 NTP 同步开启，日志时间戳准确
4. 磁盘 I/O 调度：SSD 场景建议使用 none 或 mq-deadline 调度器
5. 网络连通性：Agent 到日志存储端（Elasticsearch / ClickHouse）的延迟 < 50 ms

4.6 常见部署问题与规避

• Python 版本冲突：系统自带 Python 3.6 与 Agent 要求的 3.9+ 不兼容。解决方案：使用 pyenv 或源码编译安装独立版本，并通过虚拟环境隔离。
• Go 编译 CGO 依赖：若 Agent 使用了 CGO（如 SQLite 驱动），编译时需安装 gcc 和 musl-dev，并设置 CGO_ENABLED=1。建议优先选择纯 Go 实现避免交叉编译问题。
• 依赖缓存污染：CI/CD 流水线中未清理 pip cache 或 go build cache，导致旧版本包被复用。每次构建前执行 pip cache purge 或 go clean -cache。
• 文件描述符耗尽：Agent 同时监控数百个日志文件时，默认 1024 限制会导致打开文件失败。务必在 systemd service 中配置 LimitNOFILE=65535。