fribbledom/beehive

Beehive Docker镜像文档

镜像概述

Beehive是一个事件和代理系统，可让您创建自动化任务代理，这些任务由事件和过滤器触发。它采用模块化设计，灵活且易于扩展，通过称为“Hives”的模块与***、Tumblr、Email、IRC、Jabber、RSS、Jenkins、Hue等多种服务集成。通过连接不同模块，可构建实用的自动化工作流。

核心功能和特性

• 模块化架构：通过“Hives”模块扩展功能，支持多种外部服务集成
• 事件驱动：基于事件触发自动化任务，支持丰富的事件源
• 灵活配置：可创建多个独立的“Bee”实例（模块实例），如私人和工作***分离
• Web管理界面：通过浏览器配置Bees和任务链，直观易用
• 模板语言支持：在任务动作中使用模板语言处理事件参数，实现动态内容生成
• 跨平台支持：提供Docker镜像，便于快速部署

使用场景

• 自动将***推文转发到Tumblr博客
• 将传入的聊天消息转发到电子邮件账户
• 温度低于阈值时自动开启供暖系统
• 运行IRC机器人，通过聊天命令触发Jenkins CI构建
• 控制Hue照明系统
• ***价格低于设定值时发送通知

使用方法

Docker部署

基本运行命令

bash
docker run --name beehive -d -p 8181:8181 docker.xuanyuan.run/fribbledom/beehive

自定义绑定地址和URL

如需绑定到特定网络接口或设置自定义URL：

bash
docker run --name beehive -d \
  -e CANONICAL_URL="http://192.168.0.1:8181" \
  -p 8181:8181 \
  docker.xuanyuan.run/fribbledom/beehive

访问Web界面

容器启动后，通过http://localhost:8181访问管理界面（默认仅允许本地访问）。如需从其他设备访问，需通过-bind参数指定绑定地址，例如：

bash
docker run --name beehive -d \
  -e CANONICAL_URL="http://192.168.0.1:8181" \
  -p 8181:8181 \
  docker.xuanyuan.run/fribbledom/beehive \
  -bind "0.0.0.0:8181"

配置说明

核心概念

• Hives：功能模块，提供特定服务的事件和动作能力（如RSS、Email等）
• Bees：Hives的实例，可配置多个独立实例（如多个Email账户）
• Chains：事件-动作连接，定义当某个事件发生时执行的动作

创建Bees

1. 访问Web界面，在可用Hives列表中选择所需模块（如RSS、Email）
2. 配置Bee参数（如RSS源URL、Email服务器信息）
3. 保存创建Bee实例

设置任务链（Chain）

1. 在Web界面中创建新Chain
2. 选择触发事件的Bee和具体事件（如RSS Bee的“新feed项”事件）
3. 选择执行动作的Bee和具体动作（如Email Bee的“发送邮件”动作）
4. 使用模板语言配置动作参数，例如邮件内容：

   标题：{{.title}} - 链接：{{index .links 0}}
   

5. 保存Chain配置，系统将自动监控事件并执行动作

配置文件

Beehive默认在工作目录生成beehive.conf配置文件，可通过-config参数指定自定义路径：

bash
docker run --name beehive -d \
  -v /path/to/config:/config \
  -p 8181:8181 \
  docker.xuanyuan.run/fribbledom/beehive \
  -config /config/custom.conf

故障排除

• Web界面无法访问：确保容器端口映射正确（-p 8181:8181），默认仅允许本地访问，如需外部访问需设置-bind "0.0.0.0:8181"
• 配置文件问题：使用自定义配置文件时，确保挂载目录有读写权限
• 资源文件缺失：Docker镜像已嵌入Web界面资源，无需额外配置
• 安全注意事项：当前Web界面无认证机制，建议仅在可信网络中暴露或通过反向代理添加认证

开发与支持

• 开发交流：IRC频道（irc://freenode.net/#beehive）或Gitter（https://gitter.im/the_beehive/Lobby%EF%BC%89
• 项目主页：https://github.com/muesli/beehive
• 文档 wiki：https://github.com/muesli/beehive/wiki