Huginn自动化系统从源码安装指南

Huginn自动化系统从源码安装指南

huginn Create agents that monitor and act on your behalf. Your agents are standing by! 项目地址: https://gitcode.com/gh_mirrors/hu/huginn

前言

Huginn是一款开源的自动化系统，可以模拟人类行为执行各种网络任务。本文将详细介绍如何在生产环境中从源码安装Huginn系统。本指南适用于Debian/Ubuntu操作系统，涵盖了从基础环境配置到最终部署的全过程。

系统要求

在开始安装前，请确保您的服务器满足以下基本要求：

• 操作系统：Debian或Ubuntu
• 内存：建议至少2GB
• 存储空间：建议至少10GB可用空间
• 网络连接：稳定的互联网连接

安装步骤概览

完整的Huginn安装包含以下主要步骤：

1. 安装系统依赖包
2. 安装Ruby环境
3. 创建系统用户
4. 配置数据库(MySQL/MariaDB或PostgreSQL)
5. 安装并配置Huginn
6. 配置Nginx作为Web服务器

1. 安装系统依赖包

首先更新系统并安装必要的工具：

apt-get update -y
apt-get upgrade -y
apt-get install sudo -y

安装编译环境和开发工具：

sudo apt-get install -y runit build-essential git zlib1g-dev libyaml-dev \
libssl-dev libgdbm-dev libreadline-dev libncurses5-dev libffi-dev curl \
openssh-server checkinstall libxml2-dev libxslt-dev libcurl4-openssl-dev \
libicu-dev logrotate pkg-config cmake nodejs graphviz jq shared-mime-info

针对不同系统的特殊说明

• Debian Stretch：需要额外安装特定包
• Ubuntu 18.04 Bionic：需要安装runit-systemd

2. 安装Ruby环境

Huginn推荐使用系统Ruby而非版本管理器。以下是安装步骤：

1. 移除旧版Ruby
2. 下载并编译Ruby 3.2.6
3. 安装foreman工具

mkdir /tmp/ruby && cd /tmp/ruby
curl -L --progress-bar https://cache.ruby-lang.org/pub/ruby/3.2/ruby-3.2.6.tar.xz | tar xJ
cd ruby-3.2.6
./configure --disable-install-rdoc
make -j`nproc`
sudo make install
sudo gem install foreman --no-document

3. 创建系统用户

为Huginn创建专用系统用户：

sudo adduser --disabled-login --gecos 'Huginn' huginn

4. 数据库配置

Huginn支持MySQL/MariaDB和PostgreSQL两种数据库，以下是两种数据库的配置方法。

MySQL/MariaDB配置

1. 安装数据库服务
2. 创建Huginn专用用户和数据库
3. 设置权限

sudo apt-get install -y mysql-server mysql-client libmysqlclient-dev
sudo mysql_secure_installation

创建数据库用户：

CREATE USER 'huginn'@'localhost' IDENTIFIED BY 'your_password';
SET default_storage_engine=INNODB;
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, LOCK TABLES ON `huginn_production`.* TO 'huginn'@'localhost';
FLUSH PRIVILEGES;

PostgreSQL配置

1. 安装数据库服务
2. 创建Huginn专用用户和数据库

sudo apt-get install -y postgresql libpq-dev
sudo -u postgres -H createuser -P huginn
sudo -u postgres -H createdb -O huginn -T template0 huginn_production

5. 安装并配置Huginn

获取源码

cd /home/huginn
sudo -u huginn -H git clone https://github.com/huginn/huginn.git -b master huginn
cd /home/huginn/huginn

初始化配置

1. 复制环境配置文件
2. 创建必要的目录
3. 设置权限

sudo -u huginn -H cp .env.example .env
sudo -u huginn mkdir -p log tmp/pids tmp/sockets
sudo chown -R huginn log/ tmp/
sudo chmod -R u+rwX,go-w log/ tmp/

数据库配置

编辑.env文件配置数据库连接信息：

sudo -u huginn -H editor .env

对于MySQL配置示例：

DATABASE_ADAPTER=mysql2
DATABASE_NAME=huginn_production
DATABASE_USERNAME=huginn
DATABASE_PASSWORD='your_password'

安装依赖包

sudo -u huginn -H bundle install --deployment --without development test

初始化数据库

sudo -u huginn -H bundle exec rake db:create RAILS_ENV=production
sudo -u huginn -H bundle exec rake db:migrate RAILS_ENV=production
sudo -u huginn -H bundle exec rake db:seed RAILS_ENV=production SEED_USERNAME=admin SEED_PASSWORD=password

编译静态资源

sudo -u huginn -H bundle exec rake assets:precompile RAILS_ENV=production

配置启动脚本

编辑Procfile选择生产环境配置：

sudo -u huginn -H editor Procfile

导出启动脚本：

sudo bundle exec rake production:export

6. 配置Nginx

安装Nginx

sudo apt-get install -y nginx

配置Huginn站点

sudo cp deployment/nginx/huginn /etc/nginx/sites-available/huginn
sudo ln -s /etc/nginx/sites-available/huginn /etc/nginx/sites-enabled/huginn
sudo editor /etc/nginx/sites-available/huginn

测试并重启Nginx

sudo nginx -t
sudo service nginx restart

完成安装

现在您可以通过浏览器访问服务器IP或域名来使用Huginn系统。默认管理员账号为：

• 用户名：admin
• 密码：password

安全提示：首次登录后请立即修改默认密码！

高级配置

HTTPS配置

建议生产环境启用HTTPS：

1. 在.env中设置FORCE_SSL=true
2. 使用huginn-ssl配置文件
3. 配置SSL证书路径

系统维护

• 启动Huginn：cd /home/huginn/huginn && sudo bundle exec rake production:start
• 停止Huginn：cd /home/huginn/huginn && sudo bundle exec rake production:stop
• 检查状态：sudo bundle exec rake production:check

常见问题排查

如果安装后无法正常运行，可以检查以下日志文件：

1. Nginx错误日志：/var/log/nginx/huginn_error.log
2. Unicorn日志：/home/huginn/huginn/log/unicorn.log

常见问题包括：

• 权限问题
• 数据库连接问题
• 端口冲突

通过本指南，您应该已经成功在生产环境中部署了Huginn自动化系统。如需进一步定制或扩展功能，可以参考Huginn的官方文档和社区资源。

huginn Create agents that monitor and act on your behalf. Your agents are standing by! 项目地址: https://gitcode.com/gh_mirrors/hu/huginn