flectrahq/flectra

Flectra Docker镜像文档

镜像概述和主要用途

Flectra是一款开源的ERP（企业资源规划）和CRM（客户关系管理）应用套件，本Docker镜像提供了Flectra的便捷部署方式。使用此镜像需配合运行中的PostgreSQL服务器，适用于企业管理、客户关系维护等场景。

核心功能和特性

• 集成ERP与CRM功能，满足企业业务管理需求
• 支持自定义配置，可通过卷挂载或命令行参数调整
• 允许挂载自定义插件，扩展系统功能
• 支持多实例部署，通过不同端口运行多个Flectra服务
• 提供环境变量配置，简化PostgreSQL连接设置

使用场景和适用范围

• 中小企业ERP系统部署
• 客户关系管理系统搭建
• 多租户业务系统运行
• 开发测试环境快速搭建

使用方法和配置说明

前提条件

使用本镜像前需先启动PostgreSQL服务器。

启动PostgreSQL服务器

bash
$ docker run -d -e POSTGRES_USER=flectra -e POSTGRES_PASSWORD=flectra --name db postgres:14

启动Flectra实例

bash
$ docker run -p 7073:7073 --name flectra --link db:db -t flectrahq/flectra

注意：运行PostgreSQL的容器别名必须为db，以便Flectra能够连接到PostgreSQL服务器。

停止和重启Flectra实例

bash
# 停止Flectra实例
$ docker stop flectra

# 重启Flectra实例
$ docker start -a flectra

停止和重启PostgreSQL服务器

当PostgreSQL服务器重启后，链接到该服务器的Flectra实例也必须重启，因为服务器地址已更改，链接会中断。PostgreSQL服务器重启不会影响已创建的数据库。

使用自定义配置运行Flectra

默认配置文件位于/etc/flectra/flectra.conf，可在启动时通过卷挂载覆盖。假设自定义配置位于/path/to/config/flectra.conf：

bash
$ docker run -v /path/to/config:/etc/flectra -p 7073:7073 --name flectra --link db:db -t flectrahq/flectra 

提示：建议使用配置模板编写自定义配置，因为容器内已设置部分运行Flectra所需的参数。

也可直接在命令行指定Flectra参数，参数需放在--之后：

bash
$ docker run -p 7073:7073 --name flectra --link db:db -t flectrahq/flectra -- --db-filter=flectra_db_.*

挂载自定义插件

可将自定义Flectra插件挂载到容器的/mnt/extra-addons目录：

bash
$ docker run -v /path/to/addons:/mnt/extra-addons -p 7073:7073 --name flectra --link db:db -t flectrahq/flectra

运行多个Flectra实例

bash
$ docker run -p 8070:7073 --name flectra2 --link db:db -t flectrahq/flectra
$ docker run -p 8071:7073 --name flectra3 --link db:db -t flectrahq/flectra

注意：当主机端口与容器端口不同（如8070和7073），为正常使用邮件和报表功能，需在Flectra中设置：设置->参数->系统参数（需开启技术特性），将web.base.url设为容器端口（如127.0.0.1:7073）。

环境变量

通过以下环境变量可轻松配置PostgreSQL连接：

• HOST：PostgreSQL服务器地址。若使用PostgreSQL容器，设为容器名称。默认值：db
• PORT：PostgreSQL服务器监听端口。默认值：5432
• USER：Flectra连接PostgreSQL使用的角色。若使用PostgreSQL容器，需与POSTGRES_USER值相同。默认值：flectra
• PASSWORD：Flectra连接PostgreSQL使用的密码。若使用PostgreSQL容器，需与POSTGRES_PASSWORD值相同。默认值：flectra