huginn/huginn-single-process

Huginn Docker 镜像（生产环境，单进程容器）

镜像概述

该Docker镜像用于运行可链接的https://github.com/huginn/huginn实例，适用于生产环境，每个进程使用独立容器。其设计灵感来源于https://registry.hub.docker.com/u/huginn/huginn，支持通过环境变量配置数据库连接，自动处理数据库初始化与迁移，简化Huginn部署流程。

核心功能与特性

• 自动配置管理：通过scripts/init脚本生成.env文件，集成Heroku PaaS部署所需的环境变量
• 数据库集成：
  • 自动识别链接的MySQL（通过MYSQL_PORT_3306_TCP_ADDR和MYSQL_PORT_3306_TCP_PORT）或PostgreSQL（通过POSTGRES_PORT_5432_TCP_ADDR和POSTGRES_PORT_5432_TCP_PORT）容器
  • 支持通过环境变量覆盖数据库配置（DATABASE_ADAPTER、DATABASE_HOST、DATABASE_PORT）
• 数据库自动化：
  • 自动创建数据库（需数据库用户有创建权限，或通过DO_NOT_CREATE_DATABASE禁用）
  • 自动执行数据库迁移（rake db:migrate，支持幂等操作）
  • 自动初始化种子数据（rake db:seed，通过DO_NOT_SEED禁用）
• 默认用户配置：初始种子数据创建默认"admin"用户，默认密码为"password"（符合Huginn标准文档）

使用场景

适用于需要部署Huginn实例的用户，用于构建自动化监控与操作代理（Agents）。需配合支持通过环境变量创建数据库的镜像（如postgresql或mysql）使用，确保数据库在容器启动时完成初始化。

使用方法与配置

前提条件

推荐使用支持通过环境变量创建数据库的镜像（如postgresql或mysql），以便scripts/init脚本能自动完成数据库配置。

快速启动（使用docker-compose）

单进程模式

bash
cd docker/single-process
docker-compose up -d  # 添加-d参数后台运行以持久化数据

PostgreSQL模式

bash
cd docker/single-process
docker-compose -f postgresql.yml up -d

手动启动（链接MySQL容器）

1. 首先启动MySQL容器：

bash
docker run --name huginn_mysql \
  -e MYSQL_DATABASE=huginn \
  -e MYSQL_USER=huginn \
  -e MYSQL_PASSWORD=somethingsecret \
  -e MYSQL_ROOT_PASSWORD=somethingevenmoresecret \
  -d docker.xuanyuan.run/mysql

2. 启动Huginn Web容器并链接MySQL：

bash
docker run --name huginn_web \
  --link huginn_mysql:mysql \
  -p 3000:3000 \
  -e DATABASE_NAME=huginn \
  -e DATABASE_USERNAME=huginn \
  -e DATABASE_PASSWORD=somethingsecret \
  -d docker.xuanyuan.run/huginn/huginn-single-process

环境变量配置

注意事项

• Huginn启动需约1分钟，请耐心等待
• 默认种子数据包含6个代理，若无需默认代理，首次部署后设置DO_NOT_SEED
• 默认管理员密码为"password"，生产环境需及时修改

自定义构建

若需自定义镜像，在Huginn根目录执行以下命令：

bash
docker build --rm=true --tag={您的用户名}/huginn -f docker/single-process/Dockerfile .

源码地址

源码托管于https://github.com/huginn/huginn/docker/single-process/，欢迎提交PR或Fork。