Huginn快速上手5分钟用Docker部署自己的Agent自动化平台保姆级教程【免费下载链接】huginnCreate agents that monitor and act on your behalf. Your agents are standing by!项目地址: https://gitcode.com/gh_mirrors/hu/huginnHuginn 是一款开源的Agent 自动化平台跑在你自己的服务器上你可以创建一个个Agent让它们替你监控天气、盯守推特关键词、抓取网页变化并自动发邮件、推送 Slack 或执行 Webhook——相当于一个可完全自托管的 IFTTT/Zapier。本文是一份Huginn Docker 部署教程只需一条命令、5 分钟带你从零上线属于自己的 Agent 自动化平台并完成登录验证与第一个 Agent 的创建。一、Huginn 是什么一个完全属于你的 Agent 自动化平台很多自动化工具要求你把数据和账号交给第三方。而 Huginn 的理念很简单你的数据由你掌控。每个 Agent 都会创建和消费事件Event事件沿着有向图在 Agent 之间流转最终触发你想要的动作。官方内置了 60 多种 Agent常见的能力包括️ 监控天气明天下雨自动发邮件提醒你带伞 盯守推特关键词讨论量出现峰值时立刻通知你 监控机票、购物优惠页面价格变化第一时间推送 定时抓取网站内容一变化就触发后续流程 连接 Slack、RSS、IMAP、JIRA、MQTT、微博、Twilio 等 每天固定时间发送摘要邮件汇总你关心的内容⚡ 运行自定义 JavaScript 函数灵活扩展下面这张图就是登录 Huginn 后看到的 Agent 列表页首次部署完成后默认会自带一批示例 Agent状态一目了然所有 Agent 的源码都在 app/models/agents/ 目录下每种 Agent 一个文件想扩展能力时从这里入手。二、准备工作安装 Docker 并确认端口Huginn 最快的部署方式就是Docker 容器官方推荐方式文档见 doc/docker/install.md。你只需要两件事安装 Docker安装任意最新版 DockerLinux 上为 Docker EngineWindows/Mac 上为 Docker Desktop即可无需预装 Ruby、MySQL 等任何依赖确认 3000 端口空闲Huginn 默认对外提供 3000 端口如被占用可换用其他端口后文命令会一并说明。✅ 没有数据库没关系——多进程镜像内自带 MySQL开箱即用稍后我们会讲如何把数据持久化。三、一条命令部署5 分钟跑起 Huginn打开终端执行下面这一行命令这是本教程的核心步骤docker run -it -p 3000:3000 ghcr.io/huginn/huginn这条命令做了什么参数作用-p 3000:3000把容器的 3000 端口映射到本机 3000 端口ghcr.io/huginn/huginn拉取 Huginn 官方多进程镜像-it交互模式方便观察启动日志启动过程中会发生以下事情首次运行自动拉取镜像约几百 MB视网络而定容器内启动内置 MySQL自动建库、执行数据库迁移自动 seed 示例数据创建管理员账号并导入默认示例 Agent等待不到一分钟浏览器访问http://localhost:3000即可看到登录页。⚠️ 注意这个一行命令模式适合快速体验与评估。不挂载数据卷的话容器删掉后 Agent 数据也会丢失。正式使用请接着看第六节数据持久化。四、首次登录admin 账号与默认 Agent 体验浏览器打开http://localhost:3000使用默认账号登录用户名admin密码password登录后请立即修改密码进入 Agents 页面就能看到上一节提到的默认 Agent 列表RSS 抓取、天气监控、推特监控等。登录后还值得一看的是View diagram事件流图。它把所有 Agent 之间的事件流向画成一张有向图——左边是各类信息源右边是触发器和摘要邮件非常直观地展示了Agent 自动化平台是如何把事件串联起来的另外内置的 Peak Detector峰值检测器会统计高频事件当某个关键词的讨论量突然飙升时发出告警下图就是它的趋势图表页面五、创建你的第一个 Agent一切就绪现在来创建属于你自己的 Agent在 Agents 页面底部点击 New Agent在Type下拉框选择 Agent 类型如TwitterStreamAgent、WebsiteAgent、EmailAgent等填写Name和Schedule执行间隔在Options面板中配置选项右侧会实时显示该类型 Agent 的说明文档。配置完成后点击Create稍等片刻你的第一个自动化 Agent 就开始工作了。小贴士不同 Agent 需要的事件来源Sources不同页面会提示该类型能否接收上游事件跟着表单提示填写即可。六、数据持久化升级镜像不丢 Agent体验满意后建议切换到挂载数据卷的模式把内置 MySQL 的数据落到宿主机目录docker run --rm -it -p 3000:3000 \ -v /home/huginn/mysql-data:/var/lib/mysql \ ghcr.io/huginn/huginn更稳妥的生产做法是使用 docker/multi-process/ 目录下的 docker-compose 方案包含独立 MySQL 容器 数据卷容器直接执行cd docker/multi-process docker-compose up如果你已有现成的 MySQL 或 PostgreSQL 实例也可以不挂载卷、改为外部数据库连接参考 docker/mysql.env 中的环境变量命名方式HUGINN_DATABASE_*完整变量说明见 docker/multi-process/README.md。七、常用环境变量速查Huginn 全部采用 12-Factor 风格的环境变量配置完整清单见 .env.exampleDocker 部署时通过-e传入即可。新手最常改的几个变量说明SEED_USERNAME/SEED_PASSWORD自定义初始管理员账号默认 admin/passwordDO_NOT_SEED设为 true 后不再自动导入默认示例 AgentDOMAIN部署域名默认localhost:3000FORCE_SSL是否强制 HTTPS公网部署建议开启HUGINN_DATABASE_*外部数据库的地址、用户名、密码等INVITATION_CODE新用户注册所需的邀请码八、常见问题FAQQ1页面打不开 / 一直转圈镜像首次启动需要建库、迁移、seed 数据请耐心等待约 1 分钟再看容器日志直到出现服务启动完成的信息。Q23000 端口被占用了怎么办把-p 3000:3000改为-p 8080:3000即可然后用http://localhost:8080访问。Q3升级镜像后 Agent 数据会丢吗未挂载数据卷时会丢内置 MySQL 随容器消失。请按第六节挂载数据卷或使用外部数据库这是 Docker 部署 Huginn 最重要的一个习惯。Q4Agent 建好了却不动检查 Agent 列表中的Working?状态是否为 Yes并确认该类型 Agent 的执行间隔Schedule设置是否符合预期也可以点Run event propagation手动触发一次事件传播。总结恭喜 你已经在自己的服务器上用 Docker 部署好了 Huginn Agent 自动化平台✅ 一条docker run命令完成部署✅ 用 admin/password 登录并修改初始密码✅ 看懂了默认 Agent 与事件流图✅ 创建了自己的第一个 Agent✅ 用数据卷保证数据持久化接下来可以去 doc/ 目录安装与运维文档或打开 Agents 类型列表开始搭建属于你的自动化工作流。你的 Agent已经就位待命【免费下载链接】huginnCreate agents that monitor and act on your behalf. Your agents are standing by!项目地址: https://gitcode.com/gh_mirrors/hu/huginn创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考