腾讯云服务器安装云镜（主机安全 Agent）完整实操指引

一句话：它负责在主机侧采集并上报安全数据，主机安全控制台才能给你做木马查杀、漏洞检测、暴力破解拦截、异常登录告警这些事。

没装 Agent 的机器，可以理解为在控制台上就是"裸奔"状态，防护能力都无从谈起

一、装之前：先确认你的机器在不在支持列表里

系统，目前适配的主流发行版如下：

| TencentOS Server / Tencent tlinux | 全系列 |

| OpenCloudOS、AlmaLinux、Rocky Linux、openSUSE | 主流版本 |

| Alibaba Cloud Linux、Amazon Linux | 主流版本 |

 二、确认服务器的网络类型（这一步决定你该用哪条命令）

这是新手最容易踩坑的地方。云镜的下载源按网络环境分了不同域名，

用错了会直接下载失败或装完不上线

：现在的默认类型，购买时没特殊选择基本都是 VPC。

：较早创建的老机器，控制台实例详情里能看到"基础网络"字样。

（IDC 自建、其他云厂商）：安装命令带时效签名，

不确定的话，控制台实例详情页的"网络"一栏会明确写出来。

三、方式一：控制台一键安装（推荐，最省事）

适合绝大多数场景，尤其是非腾讯云机器和批量装机。

https://console.cloud.tencent.com/yunjing

 在列表中找到状态为"未安装"的服务器，右侧操作栏点击 

，页面会根据该机器的网络类型自动生成对应命令

 复制命令，登录服务器终端粘贴执行

 等待 1～2 分钟，回到列表刷新，状态变为"在线 / 已防护"即安装成功

：购买 CVM 时勾选"安全加固"，系统会在创建阶段自动预装云镜，后续完全不用手动操作。新业务建议直接走这条路。

四、方式二：命令行手动安装（适合批量、脚本化）

腾讯云机器可以直接用固定命令，一共三步：下载、解压、执行安装脚本。为避免大家组合出错，直接给完整的一行命令。

wget http://u.yd.tencentyun.com/ydeyes_linux64.tar.gz -O ydeyes_linux64.tar.gz && tar -zxvf ydeyes_linux64.tar.gz && ./self_cloud_install_linux64.sh

wget http://u.yd.qcloud.com/ydeyes_linux64.tar.gz -O ydeyes_linux64.tar.gz && tar -zxvf ydeyes_linux64.tar.gz && ./self_cloud_install_linux64.sh

wget http://u.yd.tencentyun.com/ydeyes_linux64_aarch64.tar.gz -O ydeyes_linux64_aarch64.tar.gz && tar -zxvf ydeyes_linux64_aarch64.tar.gz && ./self_cloud_install_linux64.sh

wget http://u.yd.qcloud.com/ydeyes_linux64_aarch64.tar.gz -O ydeyes_linux64_aarch64.tar.gz && tar -zxvf ydeyes_linux64_aarch64.tar.gz && ./self_cloud_install_linux64.sh

4.2 执行过程中的两个常见小报错

精简版镜像（尤其是 CentOS minimal）默认不带 wget，先装一下：

apt-get update && apt-get install -y wget

报错二：`Permission denied`（执行安装脚本时）

解压出来的脚本可能没有执行权限，用 

装完别急着走，务必确认进程真的跑起来了：

：存活/心跳进程，负责与控制台通信

两个都在，说明安装成功；控制台一般 1～2 分钟内会显示该主机"在线"。

如果进程没有起来，用 root 手动拉起：

 确认。若仍然起不来，基本可以锁定是网络不通或被安全组拦住

六、装完不上线？90% 是这两个原因

云镜 Agent 需要主动访问后端服务上报数据，如果机器有严格的出向策略（安全组、iptables、公司防火墙），必须把下面这些地址放通：

| 网络环境 | 需放通的域名 / IP | 端口 |

排查时可以先手动测一下连通性：

能返回 HTTP 状态码说明链路通，返回超时或解析失败就是网络层问题。

、接了内网 DNS 或自建 DNS，可能导致 

 6.3 非腾讯云机器用了固定命令

前面提过，非腾讯云机器的安装包和命令带

，使用从网上抄来的固定命令会下载失败或装完无法绑定。这类机器一律走控制台"主机列表 → 安装"取命令。

，控制台叫"主机安全"，进程叫 

，命令自动匹配网络类型，还能覆盖非腾讯云机器。

，核心是一行：下载 tar 包 → 解压 → 跑 

：出向策略有没有放通（公网记得 443）、DNS 能不能解析 

装它有什么用？一句话：它负责在主机侧采集并上报安全数据，主机安全控制台才能给你做木马查杀、漏洞检测、暴力破解拦截、异常登录告警这些事。没装 Agent 的机器，可以理解为在控制台上就是"裸奔"状态，防护能力都无从谈起。

云镜和主机安全什么关系？腾讯云linux服务器如何安装云镜

云镜是腾讯云主机安全（Cloud Workload Protection，简称 CWP）客户端的旧称。产品后来做了品牌统一，控制台入口叫"主机安全"

服务运营

人工智能

腾讯云服务器安装云镜（主机安全Agent）完整实操指引：覆盖控制台一键安装与命令行手动安装，支持VPC及基础网络，适配x86_64与ARM架构。提供安装失败排查方案，包括防火墙放通、DNS解析验证及常见报错处理。装后需确认YDService与YDLive进程在线，确保木马查杀、漏洞检测、暴力破解拦截等防护生效。

云服务器

主机安全

木马查杀

防火墙

服务器

openSUSE

CentOS

Ubuntu

Debian

Linux

Agent

4核4G3M云服务器 新用户低至38元/年！

lighthouse

2026上云采购 | AI焕新·智启新局

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

云镜和主机安全什么关系？腾讯云linux服务器如何安装云镜

云镜和主机安全什么关系？腾讯云linux服务器如何安装云镜

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐