火天下 ERP 私有化部署 安装指南

版本：v1.0.3 ｜ 适用：火天下平台 2.0 接入企业

一、环境要求

安装 Docker（Ubuntu 示例）：

curl -fsSL https://get.docker.com | bash

二、安装步骤（3 分钟）

# 1. 解压部署包
unzip htx-erp-latest.zip && cd 火天下ERP-私有化部署包

# 2. 一键启动（首次会生成 .env 并退出）
bash start.sh

# 3. 编辑 .env，填写三项必填配置
#    MYSQL_ROOT_PASSWORD  数据库 root 密码
#    MYSQL_PASSWORD       业务库密码
#    JWT_SECRET           执行 openssl rand -hex 32 生成
vi .env

# 4. 再次启动
bash start.sh

首次启动自动完成建库建表（Flyway 迁移）与基础数据初始化，约 1-3 分钟。 完成后浏览器访问 http://服务器IP:8080/ 即可看到 ERP 登录页。

三、首次登录

1. 在中心平台完成企业入驻登记（联系平台运营），平台将为贵司分配行业类型并生成：
   • 企业 ID
   • 管理员初始账号（登录名 admin + 一次性初始密码）
2. 在 ERP 登录页输入：企业 ID + 登录名 + 密码（三段式登录）。
3. 系统按贵司行业自动呈现专属功能菜单，无关行业功能完全隐藏。
4. 登录后请立即在右上角「修改密码」。

四、目录结构

火天下ERP-私有化部署包/
├── docker-compose.yml        # 编排：MySQL + Redis + 后端 + 前端
├── .env.example              # 环境变量模板（复制为 .env 使用）
├── nginx.conf                # 前端站点与 API 反代配置
├── start.sh                  # 一键启动脚本
├── deploy/
│   └── htx-server-1.0.0.jar  # ERP 后端程序
└── web/                      # ERP 前端静态资源

五、常用运维命令

docker compose ps                 # 查看运行状态
docker logs -f htx-erp-server     # 后端日志
docker compose restart            # 重启全部服务
docker compose down               # 停止（数据保留在数据卷中）

# 数据库备份（建议每日执行）
docker exec htx-erp-mysql mysqldump -uhtx -p你的密码 htx_platform | gzip > backup-$(date +%F).sql.gz

六、安全须知

• .env 含数据库密码与 JWT 密钥，请执行 chmod 600 .env 并勿外传。
• MySQL 与 Redis 默认仅监听本机回环地址，外部无法直连。
• AI 助手为可选项：在 .env 填入阿里云百炼 API Key 即可启用，不填不影响其他功能。
• 生产环境建议在 8080 端口前再加一层 HTTPS（如 Nginx + Let’s Encrypt）。

七、版本升级

平台发布新版本后，只需替换 deploy/htx-server-1.0.0.jar 与 web/ 目录， 然后 docker compose restart htx-server erp-web，数据库结构由 Flyway 自动增量升级。