Agent安装

本文档介绍如何在目标服务器上安装智站CMS Agent节点。

环境要求

系统要求 — Linux操作系统(Ubuntu、CentOS、Debian等),支持x86_64、ARM32、ARM64架构,内核版本3.10+。

硬件要求 — 内存256MB以上(推荐512MB+),磁盘5GB以上可用空间,网络能访问互联网(连接主控端)。

依赖软件 — Nginx(必需,用于Web服务)、curl/wget(用于下载安装包)。

安装步骤

第一步:在主控端生成Token

  1. 登录智站CMS后台
  2. 进入「Agent管理」→「节点列表」
  3. 点击「添加节点」
  4. 填写节点名称和备注
  5. 点击「创建」
  6. 复制生成的Token(保存好,只显示一次)

第二步:在目标服务器安装Agent

方式一:一键安装脚本(推荐)

使用curl或wget下载安装脚本并执行,传入你的Token参数。

方式二:手动安装

  1. 创建目录 /opt/zhancms-agent
  2. 根据服务器架构下载对应版本的Agent程序(x86_64/arm64/armv7)
  3. 解压程序文件
  4. 创建配置文件config.yaml,填写主控端URL和Token
  5. 安装Nginx
  6. 配置systemd服务并启动

第三步:验证安装

检查服务状态,查看日志,在主控端「Agent管理」→「节点列表」中查看节点是否在线。

在手机上安装Agent

智站CMS Agent可以在Android手机上运行(需要Termux)。

准备工作 — 安装Termux(从F-Droid下载,不要从Google Play),打开Termux更新包,安装nginx。

安装Agent — 创建目录,下载arm64版本的agent,创建配置文件,运行agent程序。

注意:手机上运行需要保持Termux在后台,建议使用wakelock插件保持唤醒。

在树莓派上安装

树莓派是理想的Agent节点设备,低功耗、稳定。

准备 — 树莓派3/4/Zero 2,Raspberry Pi OS(64位推荐),网络连接。

安装步骤 — 启用SSH和网络,安装Nginx,下载对应架构的Agent(arm64或armv7),配置并启动服务,步骤同上。

常见问题

Agent连不上主控端 — 检查网络连接、Token是否正确、防火墙是否阻止了出站连接、查看Agent日志找错误信息。

如何更新Agent — Agent支持自动更新,在主控端可以触发节点自动更新。也可以手动下载新版本替换。

如何卸载Agent — 停止服务,禁用服务,删除服务文件,删除程序目录。

一个服务器可以跑多个站点吗 — 可以。一个Agent节点可以托管多个站点,Nginx自动配置虚拟主机。

安装完成后,继续阅读节点管理文档了解如何管理节点。