跳到主要内容
支持地域：上海

部署前准备工作

本文档将指导您完成微搭私有部署前的环境准备工作，确保部署过程顺利进行。

前置要求​

在开始部署之前，请确保您已准备以下必要条件：

许可证要求​

技术要求​

  • Docker 环境：熟悉并安装 Docker Engine 和 Docker Compose
  • Linux 系统：基于 Linux 的服务器或虚拟机
  • 网络访问：确保服务器可以访问外网

系统环境要求​

操作系统支持​

微搭私有部署支持以下 Linux 发行版：

操作系统推荐版本
TencentOS Server3.1 (TK4) 或 4.x
CentOS7.8 或 7.9
OpenCloudOS8.x 或 9.x
Ubuntu Server22.04 LTS 或更高版本
Debian12.4 或 12.5

Docker 版本要求​

Docker 版本检查

安装完成后请检查 Docker 版本，Docker 版本必须大于 20.0.0，否则需要升级 Docker 版本。

# 查询 Docker 版本号
docker version

硬件资源配置​

最小配置要求​

资源类型最小要求说明
内存16 GiB保证服务稳定运行
CPU8 vCPU处理并发请求
存储空间100 GiBDocker 数据目录所需空间

存储配置建议​

生产环境重要提醒

如果是生产环境或服务器有多个磁盘，强烈建议将 Docker 数据目录放在独立的、大容量的磁盘上，避免系统盘被占满导致服务异常。

配置扩展

以上为开发工具运行所需的推荐配置，您可以分配更多资源以便实例轻松扩展。

软件依赖要求​

必需软件包​

请确保以下软件包已安装：

  • curl：用于下载安装脚本和文件
  • unzip：用于解压安装包

安装命令示例​

# CentOS/RHEL 系统
yum install -y curl unzip

# Ubuntu/Debian 系统  
apt-get update && apt-get install -y curl unzip

网络配置要求​

端口开放要求​

请确保以下端口未被占用且已开放访问权限：

端口用途是否可自定义
80微搭平台访问端口✅ 可自定义
38080安装器默认端口✅ 可自定义
端口配置说明

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

外网访问要求​

网络白名单配置

部署过程中需要访问以下外网地址，请确保网络策略允许访问：

  • 镜像仓库访问：

    • weda-private.tencentcloudcr.com:443 - 镜像拉取
    • https://weda-private.tencentcloudcr.com - 镜像仓库
    • https://tcr-9r3x9jec-1302110647.cos.ap-guangzhou.myqcloud.com - 镜像存储

  • License 服务：

    • https://license.tcloudbasegateway.com - 证书激活和版本获取

Docker 环境准备​

自动安装 Docker​

我们提供了自动化脚本来检查和安装 Docker：

# 运行 Docker 安装脚本
./docker-install.sh

该脚本将：

  1. 检查当前 Docker 安装状态
  2. 如果未安装，自动使用包管理工具安装 Docker
  3. 验证安装结果

国内环境优化​

镜像源配置

在国内环境下安装时，如果遇到网络问题，可以参考 云服务器运维指南 替换为国内镜像源，然后重新执行安装脚本。

环境验证​

完成上述准备工作后，请验证环境是否就绪：

1. 系统资源检查​

# 检查内存
free -h

# 检查磁盘空间
df -h

# 检查 CPU 信息
lscpu

2. Docker 环境检查​

# 检查 Docker 版本
docker version

# 检查 Docker Compose 版本
docker-compose version

# 测试 Docker 运行（国内环境可能因网络问题导致镜像拉取失败，可配置镜像加速器或跳过此步骤）
docker run hello-world

3. 网络连通性检查​

# 测试外网访问
curl -I https://weda-private.tencentcloudcr.com

# 检查端口占用
netstat -tlnp | grep -E ':(80|38080)'

总结​

完成以上准备工作后，您的环境应该满足以下条件：

  1. ✅ 已获取有效的微搭 License 密钥
  2. ✅ 系统满足硬件资源要求
  3. ✅ Docker 环境已正确安装和配置
  4. ✅ 必要的软件包已安装
  5. ✅ 网络访问权限已配置
  6. ✅ 端口开放策略已设置

现在您可以继续进行 Docker 部署流程。