跳到主要内容

微搭私有部署 Docker 部署指南

本文档将指导您使用 Docker 在 Linux 服务器上部署微搭低代码开发平台,实现快速、稳定的单机版部署。

部署概述

微搭私有部署支持基于 Docker 的容器化部署方式,适用于单机版快速部署场景。

系统要求

前置条件
  • 操作系统:Linux 系统(支持 x86 和 aarch64 架构)
  • 服务器配置:请参考 资源准备要求
  • 权限要求:需要 root 权限执行部署操作
  • 网络要求:确保服务器可以访问外网下载安装包

部署步骤

步骤 1:准备部署环境

  1. 获取 root 权限

    sudo su
  2. 下载安装脚本

    wget -L -O install.sh https://software-1302110647.cos.ap-guangzhou.myqcloud.com/rc/lastest/install.sh && chmod +x install.sh
  3. 启动安装器

    ./install.sh
安装器说明
  • 默认端口:38080
  • 支持架构:Linux x86 和 aarch64
  • 访问地址http://<服务器IP>:38080

端口配置要求

端口检查

部署前请确保以下端口未被占用且已开放访问权限:

  • 80:微搭平台默认访问端口
  • 38080:安装器默认端口(可自定义)

如需自定义端口配置,请参考:端口及白名单 IP 配置

步骤 2:执行安装配置

  1. 访问安装器界面

    在浏览器中输入:http://<服务器IP>:38080,打开安装器页面

  2. 配置 License 信息

  3. 开始安装部署

    • 点击【开始安装】
    • 等待 3-5 分钟完成安装过程
    • 安装完成后点击【立即访问平台】
  4. 访问开发平台

    安装完成后,可通过以下方式访问:

部署结果说明

目录结构说明

安装目录信息

默认安装目录/data/tencent/weda

安装完成后,将在安装目录下生成以下重要目录:

目录名称用途说明注意事项
configs/存储服务运行所需的所有配置文件可根据需要修改配置
storage/存储 MinIO 和 MySQL 数据请勿删除,包含重要数据
logs/存储所有服务的日志信息用于问题排查和监控
.env环境变量配置文件可通过 cat .env 查看

环境变量查看

# 切换到安装目录
cd /data/tencent/weda

# 查看环境变量配置
cat .env

详细的环境变量说明请参考:环境变量配置指南

高级配置

自定义配置选项

如需进行高级配置,可参考以下文档:

生产环境建议

生产环境最佳实践

为确保生产环境的高可用性和稳定性,强烈建议:

  1. 使用外部数据库:配置独立的 MySQL 数据库服务
  2. 使用外部对象存储:配置 S3 兼容的对象存储服务
  3. 定期备份数据:备份 storage/ 目录下的重要数据
  4. 监控系统状态:定期检查服务日志和系统资源使用情况

问题排查

如果在部署过程中遇到问题,请参考:

  • 常见问题解答FAQ 文档
  • 日志查看:检查 logs/ 目录下的相关日志文件
  • 端口检查:确认所需端口是否正确开放

总结

通过以上步骤,您已经成功完成了微搭私有部署的 Docker 部署:

  1. ✅ 准备了部署环境和必要的权限
  2. ✅ 下载并执行了安装脚本
  3. ✅ 完成了 License 配置和平台安装
  4. ✅ 了解了部署后的目录结构和配置选项
  5. ✅ 掌握了高级配置和生产环境建议

现在您可以开始使用微搭低代码开发平台进行应用开发了。