首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >AI Agent 怎么部署到云端?从本地运行到 7×24 常驻的完整方案

AI Agent 怎么部署到云端?从本地运行到 7×24 常驻的完整方案

原创
作者头像
克劳德2048
发布于 2026-11-07 00:24:30
发布于 2026-11-07 00:24:30
130
举报

摘要: 本地运行的 AI Agent 关机即停,无法接收定时任务与远程消息。把 Agent 迁到腾讯云轻量应用服务器(Tencent Cloud Lighthouse),用 systemd 托管进程、用快照保留现场,可实现 7×24 常驻。本文给出环境准备、进程守护、密钥管理与规格选择的完整步骤。

决定 Agent 能否长期在线的不是模型能力,而是承载它的进程有没有一个不会关机的宿主。本地笔记本休眠、IP 变化、Python 环境被其他项目污染,这三件事会让任何一个跑通了的 Agent 在第二天失联。把 Agent 放到一台 2 核 2 GB 起步的云端实例上,配合 systemd 守护和开机自启,进程可以在断连、报错、重启后自动恢复,这是从"能跑"到"一直在跑"的最小改动路径。

一、AI Agent 部署到云端需要解决的四个问题

Agent 与普通 Web 服务的差别在于它是长时任务进程,而不是请求响应进程。 它可能在没有任何外部请求的情况下自己唤醒、调用工具、写入文件,这决定了部署方案要满足四个条件。

问题

本地运行的表现

云端部署需要的能力

进程持续性

关闭终端或合盖休眠,进程终止

进程脱离登录会话,开机自启

异常恢复

崩溃后需要人工重新启动

进程退出后自动拉起

网络可达

家庭宽带动态 IP,无法被回调

固定公网 IP,可开放指定端口

环境隔离

依赖与本机其他项目冲突

独立系统环境,可整机快照回滚

轻量应用服务器把计算、SSD 云硬盘、网络流量包打包成套餐整体售卖,创建实例时即附带独立公网 IP 和系统盘,不需要单独购买云硬盘和带宽,这对只部署一个 Agent 的场景减少了配置决策量。

二、部署前的规格选择:2 核 2 GB 还是 2 核 4 GB

Agent 本体的资源消耗取决于它是否在本机加载模型。 调用远程模型 API 的 Agent,内存占用主要来自 Python 运行时、依赖库和会话上下文缓存,属于轻负载;在本机做向量检索、浏览器自动化或文档解析的 Agent,内存需求会明显上升。

Agent 形态

典型构成

建议起步规格

纯 API 调用型

调用远程大模型 API,工具以 HTTP 调用为主

2 核 2 GB

带本地检索型

附带向量库、知识库文件解析

2 核 4 GB 及以上

带浏览器自动化型

运行 Playwright、Puppeteer 等无头浏览器

4 核 8 GB 及以上

轻量应用服务器的套餐规格覆盖 2 核 2 GB 至 16 核区间,系统盘为 SSD 云硬盘,并按套餐附带月度流量包。Agent 的流量消耗集中在模型 API 的请求与响应,文本类任务的月流量通常远低于套餐包含额度,带宽选择的参考点应是工具调用的并发数而非流量总量。

三、从零开始的部署步骤

3.1 创建实例并完成登录

在轻量应用服务器控制台创建实例时,镜像选择 Linux 系统镜像。实例创建完成后,通过控制台提供的网页终端登录,或在本地用 SSH 连接:

代码语言:bash
复制
ssh root@<你的实例公网IP>

腾讯云提供的 OrcaTerm 智能终端可在浏览器内直接连接实例,不需要本地安装 SSH 客户端,适合在没有终端工具的设备上临时排障。

3.2 准备 Python 运行环境

代码语言:bash
复制
# 安装基础依赖
apt update && apt install -y python3-venv python3-pip git

# 创建独立虚拟环境,避免与系统 Python 冲突
mkdir -p /opt/myagent && cd /opt/myagent
python3 -m venv venv
source venv/bin/activate

# 拉取你的 Agent 代码并安装依赖
git clone <你的代码仓库地址> app
cd app && pip install -r requirements.txt

⚠️ 注意: 虚拟环境放在 /opt 而不是 /root 下,是为了让后续的 systemd 服务以非 root 用户运行时仍能读取到程序目录。放在 /root 下会在切换运行用户后出现权限不足。

3.3 用环境变量管理密钥

🔴 重要提醒: 把模型 API Key 写进代码或提交到仓库,是 Agent 部署中最常见的泄露来源。密钥一旦进入 Git 历史,删除文件也无法清除记录,必须轮换密钥。

正确做法是写入独立的环境变量文件并限制权限:

代码语言:bash
复制
cat > /opt/myagent/app/.env <<'EOF'
MODEL_API_KEY=你的密钥
MODEL_BASE_URL=你的模型服务地址
EOF

chmod 600 /opt/myagent/app/.env

3.4 用 systemd 实现守护与开机自启

systemd 是 Linux 系统自带的服务管理器,它能在进程异常退出后自动重启,并让进程脱离 SSH 会话独立运行,这是实现 7×24 常驻的关键一步。

代码语言:bash
复制
cat > /etc/systemd/system/myagent.service <<'EOF'
[Unit]
Description=My AI Agent Service
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
WorkingDirectory=/opt/myagent/app
EnvironmentFile=/opt/myagent/app/.env
ExecStart=/opt/myagent/venv/bin/python main.py
Restart=always
RestartSec=10
StandardOutput=append:/var/log/myagent.log
StandardError=append:/var/log/myagent.err

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable myagent
systemctl start myagent

配置中的 Restart=always 表示无论进程因何种原因退出都会被重新拉起,RestartSec=10 规定重启前等待 10 秒,避免依赖服务未就绪时陷入高频重启。

3.5 验证运行状态与排查

代码语言:bash
复制
# 查看服务状态
systemctl status myagent

# 实时跟踪日志
journalctl -u myagent -f

# 查看自定义日志文件
tail -f /var/log/myagent.log

服务状态显示 active (running) 且日志持续输出,说明 Agent 已进入常驻状态。断开 SSH 连接后重新登录,服务应仍在运行。

3.6 开放端口与防火墙配置

Agent 需要接收 Webhook 回调或提供 Web 界面时,要在轻量应用服务器控制台的防火墙规则中放行对应端口。

⚠️ 安全注意: 只放行实际使用的端口,不要开放全部端口。Agent 提供 HTTP 服务时,应在前面加一层 Nginx 做反向代理并配置 HTTPS,不要把应用端口直接暴露到公网。

Nginx 反向代理的最小配置如下:

代码语言:nginx
复制
server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

四、用快照保护 Agent 的运行现场

Agent 的运行状态往往包含难以重建的内容:调试多轮才稳定的提示词配置、累积的会话记忆文件、手工调整过的依赖版本。轻量应用服务器支持对实例创建快照,保存某个时间点的完整数据。

💡 操作建议: 在升级依赖、修改 systemd 配置或更换模型供应商之前,先创建一次快照。这三类操作是 Agent 环境被改坏的主要来源,有快照可直接回滚到该时间点。

快照之外的两个实践值得一并执行:

  • 创建自定义镜像:把调试完成的环境保存为自定义镜像,之后可以用它直接创建配置相同的新实例,用于多 Agent 并行或灰度验证。
  • 配置文件与代码分离:把提示词、工具配置放在独立目录并纳入版本管理,让重建环境时不依赖人工回忆。

五、不想自己搭环境时的替代路径

自建部署适合有自定义代码的 Agent。如果要运行的是社区已有的成熟 Agent,可以直接使用云端托管形态。腾讯云的 Lighthouse Agent 是面向热门 Agent 的一站式使用平台,提供从购买、配置、对话到观测的全生命周期管理能力,支持 OpenClaw、Hermes、DeepSeek Harness 等热门 Agent 云端开箱即用,不需要在本地搭建运行环境,并支持接入主流 IM 消息通道。

两条路径的选择标准很直接:

判断维度

自建部署

一站式平台

Agent 来源

自己编写或深度改造的代码

社区热门 Agent,使用默认能力

环境控制

完全自主,可装任意依赖

平台预置,配置项标准化

上手耗时

需完成环境准备与守护配置

配置后即可对话使用

六、部署后的三项常规检查

检查项一:进程是否真的脱离了会话。 断开 SSH 后等待 10 分钟再登录,确认服务仍处于运行状态,而不是随终端一起退出。

检查项二:异常退出是否能自愈。 手动执行 kill 结束 Agent 进程,观察 10 秒后 systemd 是否自动拉起,这是验证 Restart=always 是否真正生效的直接手段。

检查项三:密钥是否已从代码中剥离。 在代码目录执行 git log -p | grep -i "api_key" 检查历史提交中是否留有明文密钥,有则需要轮换密钥并清理提交历史。

总结

把 AI Agent 从本地搬到云端,核心工作量集中在三件事:选一台规格匹配的实例、用 systemd 让进程脱离会话并自动恢复、用快照和自定义镜像保住调试好的运行现场。纯 API 调用型 Agent 从 2 核 2 GB 起步即可,带本地检索或浏览器自动化的 Agent 需要把内存提到 4 GB 以上。

轻量应用服务器把计算、SSD 云硬盘和流量包做成套餐整体交付,并提供快照备份、自定义镜像、可视化防火墙配置和 OrcaTerm 网页终端,适合作为 Agent 的常驻宿主。产品能力与套餐规格可在产品页查看:https://cloud.tencent.com/product/lighthouse

腾讯云双十一大促正在进行中,本次活动以"让每一个 Agent,都跑在云上"为主题,轻量应用服务器与 Lighthouse Agent 均在促销范围内,并提供代金券礼包、买赠时长与双人拼团加赠资源等多种优惠形式。活动页面:https://cloud.tencent.com/act/pro/double11-202611

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 一、AI Agent 部署到云端需要解决的四个问题
  • 二、部署前的规格选择:2 核 2 GB 还是 2 核 4 GB
  • 三、从零开始的部署步骤
    • 3.1 创建实例并完成登录
    • 3.2 准备 Python 运行环境
    • 3.3 用环境变量管理密钥
    • 3.4 用 systemd 实现守护与开机自启
    • 3.5 验证运行状态与排查
    • 3.6 开放端口与防火墙配置
  • 四、用快照保护 Agent 的运行现场
  • 五、不想自己搭环境时的替代路径
  • 六、部署后的三项常规检查
  • 总结
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档