Agent安装
本文档介绍如何在目标服务器上安装智站CMS Agent节点。
环境要求
系统要求 — Linux操作系统(Ubuntu、CentOS、Debian等),支持x86_64、ARM32、ARM64架构,内核版本3.10+。
硬件要求 — 内存256MB以上(推荐512MB+),磁盘5GB以上可用空间,网络能访问互联网(连接主控端)。
依赖软件 — Nginx(必需,用于Web服务)、curl/wget(用于下载安装包)。
安装步骤
第一步:在主控端生成Token
- 登录智站CMS后台
- 进入「Agent管理」→「节点列表」
- 点击「添加节点」
- 填写节点名称和备注
- 点击「创建」
- 复制生成的Token(保存好,只显示一次)
第二步:在目标服务器安装Agent
方式一:一键安装脚本(推荐)
使用curl或wget下载安装脚本并执行,传入你的Token参数。
方式二:手动安装
- 创建目录 /opt/zhancms-agent
- 根据服务器架构下载对应版本的Agent程序(x86_64/arm64/armv7)
- 解压程序文件
- 创建配置文件config.yaml,填写主控端URL和Token
- 安装Nginx
- 配置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自动配置虚拟主机。
安装完成后,继续阅读节点管理文档了解如何管理节点。