Botpress Docker镜像文档

镜像概述与主要用途

Botpress Docker镜像是基于开源Botpress框架的容器化部署方案。Botpress是一款本地部署的机器人开发框架，旨在帮助开发者显著减少机器人构建时间，提升开发效率。该镜像提供便捷的容器化部署方式，适用于快速搭建和运行Botpress服务的场景。

核心功能与特性

• 开源免费：完全开源的框架，支持自定义扩展和二次开发
• 本地部署：支持企业内部环境部署，确保数据隐私与自主可控
• 灵活配置：通过环境变量自定义服务端口、数据库连接等关键参数
• 外部数据库集成：支持PostgreSQL等外部数据库连接，实现数据持久化
• 容器化优势：简化部署流程，确保环境一致性，便于版本管理与迁移

使用场景与适用范围

• 企业级机器人开发：适用于构建客户服务机器人、内部流程自动化机器人等各类业务机器人
• 数据敏感场景：满足对数据隐私有严格要求的组织，通过本地部署保障数据合规
• 快速原型验证：开发者可快速搭建Botpress环境，验证机器人流程设计与功能
• 生产环境部署：支持配置生产环境参数（如NODE_ENV=production），满足线上服务需求

使用方法与配置说明

基本运行命令

通过以下命令快速启动Botpress容器，默认映射容器3000端口到主机3000端口：

docker run -d --name=botpress -p 3000:3000 botpress/server

高级配置示例

Botpress支持通过环境变量自定义配置。以下示例展示修改内部端口、挂载数据卷并连接PostgreSQL数据库的部署方式：

docker run --detach \
           --name=botpress \
           --publish 3000:8080 \  # 主机3000端口映射到容器8080端口（需与PORT变量同步）
           --volume botpress_data:/botpress/data \  # 挂载数据卷持久化存储数据
           --env  PORT=8080 \  # Botpress内部服务端口
           --env  BP_HOST=0.0.0.0 \  # 监听所有网络接口
           --env  NODE_ENV=production \  # 运行环境（生产环境）
           --env  PG_HOST=192.168.0.11 \  # PostgreSQL数据库主机地址
           --env  PG_PORT=5432 \  # PostgreSQL数据库端口
           --env  PG_USER=bp_user \  # PostgreSQL数据库用户名
           --env  PG_PASSWORD=<********> \  # PostgreSQL数据库密码
           --env  PG_SSL=false \  # 是否启用SSL连接PostgreSQL
           botpress/server:latest

查看容器日志

启动后可通过以下命令跟踪服务运行日志：

docker logs --follow botpress

进入运行中的容器

如需与容器交互（如执行命令、查看文件），可通过以下命令进入容器终端：

docker exec --interactive --tty botpress bash

环境变量配置说明

相关资源

• 完整文档：Botpress官方文档
• Docker部署指南：Botpress Docker详细文档
• 更新日志：Botpress变更记录