阿里云 LoongCollector 安装与配置标准操作文档
版本: 1.0
适用地域: 华东2（上海 - cn-shanghai）
授权账号ID: 5283947722037499
机器标识模式: IP 地址（无需配置机器组自定义标识）
- 产品简介与名词解释
LoongCollector 与 Logtail 的关系
Logtail: 阿里云日志服务（SLS）早期的日志采集客户端名称。
LoongCollector: Logtail 的升级版本，采用了新的内核（C++ 与 Golang 混合），性能更强。
现状: 两者本质是同一个产品的不同演进阶段。目前官方文档和安装包逐渐统一使用 LoongCollector 名称。
Linux 安装路径通常仍包含 ilogtail。
Windows 新版服务名称已变更为 LoongCollectorDaemon。 - 环境准备
在开始安装前，请确认服务器满足以下条件：
操作系统:
Linux: Alibaba Cloud Linux, CentOS, Ubuntu, Debian 等主流发行版。
Windows: Windows Server 2016/2019/2022 (64位)。
网络要求:
Linux (ECS): 需与日志服务 Project 同属于 cn-shanghai 地域，推荐使用内网下载和传输（无需公网 IP）。
Windows: 由于新版安装包限制，必须具备公网访问能力以从海外源下载安装包，但采集数据时仍走上海内网。
权限: 需拥有服务器的 root (Linux) 或 Administrator (Windows) 权限。 Linux 安装指南
方式一：脚本自动化安装（推荐）
此脚本自动处理内网下载、安装及跨账号 UserID 配置。
创建脚本文件 install_loongcollector.sh，内容如下：!/bin/bash
地域配置：上海
REGION_ID="cn-shanghai"
授权账号ID
ALI_UID="5283947722037499"
echo ">>> 开始安装 LoongCollector (Linux)..."
1. 下载 (使用上海内网源)
wget "https://aliyun-observability-release-${REGION_ID}.oss-${REGION_ID}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh" -O /tmp/loongcollector.sh
chmod +x /tmp/loongcollector.sh
2. 安装 (指定地域)
sudo /tmp/loongcollector.sh install "${REGION_ID}"
3. 配置用户标识 (跨账号授权)
sudo mkdir -p /etc/ilogtail/users
sudo touch "/etc/ilogtail/users/${ALI_UID}"
4. 检查状态
sudo /etc/init.d/loongcollectord status
rm -f /tmp/loongcollector.sh
运行脚本：
sudo bash install_loongcollector.sh
方式二：手动分步安装
如果无法使用脚本，可执行以下命令：
下载安装脚本:
wget https://aliyun-observability-release-cn-shanghai.oss-cn-shanghai.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh
chmod +x loongcollector.sh
执行安装:
sudo ./loongcollector.sh install cn-shanghai
配置用户 ID:
sudo mkdir -p /etc/ilogtail/users
sudo touch /etc/ilogtail/users/5283947722037499
验证:
sudo /etc/init.d/loongcollectord status
输出应包含: loongcollector is running
Windows 安装指南
注意: Windows 服务器必须连接互联网才能下载安装包。
方式一：PowerShell 脚本安装（推荐）
此脚本自动从海外源下载，适配上海地域配置，并清理临时文件。
新建文本文件，命名为 install.ps1，复制以下内容：必须以管理员身份运行
$RegionId = "cn-shanghai"
$AliUid = "5283947722037499"
$TempDir = $env:TEMP
$ExtractPath = "$TempDir\loongcollector_install_dir"
1. 下载 (使用海外源)
$DownloadUrl = "https://aliyun-observability-release-ap-southeast-1.oss-ap-southeast-1.aliyuncs.com/loongcollector/win64/3.1.7/x86_64/loongcollector_installer.zip"
Invoke-WebRequest -Uri $DownloadUrl -OutFile "$TempDir\installer.zip" -UseBasicParsing
2. 解压
if (Test-Path $ExtractPath) { Remove-Item $ExtractPath -Recurse -Force }
Expand-Archive -Path "$TempDir\installer.zip" -DestinationPath $ExtractPath -Force
3. 安装
$Installer = Get-ChildItem $ExtractPath -Filter "loongcollector_installer.exe" -Recurse | Select -First 1 -Expand FullName
Start-Process -FilePath $Installer -ArgumentList "install $RegionId" -WorkingDirectory $ExtractPath -Wait -NoNewWindow
4. 配置用户ID
$UserDir = "C:\LogtailData\users"
if (-not (Test-Path $UserDir)) { New-Item -Type Directory -Path $UserDir -Force | Out-Null }
New-Item -Type File -Path "$UserDir\$AliUid" -Force | Out-Null
5. 验证
Get-Service -Name "LoongCollectorDaemon"
清理
Remove-Item "$TempDir\installer.zip" -Force
Remove-Item $ExtractPath -Recurse -Force
右键点击脚本文件，选择 "使用 PowerShell 运行" (Run with PowerShell)。
方式二：手动分步安装
下载:
在浏览器中访问以下链接下载压缩包：
https://aliyun-observability-release-ap-southeast-1.oss-ap-southeast-1.aliyuncs.com/loongcollector/win64/3.1.7/x86_64/loongcollector_installer.zip
解压:
将压缩包解压到任意文件夹（例如 C:\loongcollector）。
安装:
以管理员身份打开 PowerShell 或 CMD，进入解压目录，执行：
.\loongcollector_installer.exe install cn-shanghai
配置用户 ID:
进入目录 C:\LogtailData（如无则新建）。
新建文件夹 users。
在 users 文件夹内新建一个空文件，文件名为 5283947722037499（无后缀）。
验证:
在 PowerShell 中执行 Get-Service LoongCollectorDaemon，状态应为 Running。
- 维护与生命周期管理
卸载 (Uninstall)
Linux:
sudo /usr/local/ilogtail/installer/uninstall.sh
Windows:
以管理员身份在 PowerShell 中运行：
假设仍在安装包目录下，或重新下载安装包后执行
.\loongcollector_installer.exe uninstall
或者直接在 Windows 服务管理器中停止服务，并删除 C:\Program Files\Alibaba\Logtail 和 C:\LogtailData 目录。
更新/重装 (Update/Reinstall)
LoongCollector 的更新逻辑通常是覆盖安装。
操作: 直接重新运行上述的“安装脚本”即可。
逻辑: 安装程序会自动检测旧版本，停止服务，替换二进制文件，并重新启动服务。原有的配置（如 UserID）通常会保留，但建议脚本中保留配置 ID 的步骤以防万一。
服务启停
Linux:
sudo /etc/init.d/loongcollectord start # 启动
sudo /etc/init.d/loongcollectord stop # 停止
sudo /etc/init.d/loongcollectord restart # 重启
Windows:
Start-Service LoongCollectorDaemon # 启动
Stop-Service LoongCollectorDaemon # 停止
Restart-Service LoongCollectorDaemon # 重启
- 常见问题排查
Windows 安装报错 "errno: 1060":
现象: 安装日志中出现删除文件失败的错误。
原因: 这是正常的清理过程，如果之前未安装过或文件不存在，清理命令会报错，不影响后续安装。
控制台机器组心跳显示 "FAIL":
检查 1: 确认服务器能否访问上海的日志服务域名（Linux 测试 curl logtail.cn-shanghai-intranet.log.aliyuncs.com）。
检查 2: 确认 users 目录下是否存在文件 5283947722037499，且文件名无后缀（Windows下注意隐藏后缀名）。
检查 3: 机器组配置中的 IP 是否填写正确（应填写服务器的内网 IP）。
Windows 下载失败:
原因: Windows 安装包目前仅支持海外源。
解决: 确保服务器配置了 NAT 网关或 EIP。如果无公网，需在有公网的机器下载后通过 RDP/FTP 上传至服务器。
