# 腾讯云CentOS7下Docker部署小智AI Server全流程（含避坑指南）

在当今AI技术快速发展的背景下，将AI模型部署为可用的服务已成为开发者必备技能。本文将手把手教你如何在腾讯云CentOS7服务器上，通过Docker容器技术部署小智AI Server，涵盖从服务器选购到最终测试的全流程，特别针对新手开发者整理了常见问题解决方案。

1. 腾讯云服务器选购与基础配置

对于初次接触云服务器的开发者，选择合适的配置至关重要。腾讯云提供了多种规格的云服务器，针对AI服务部署，我们推荐以下配置：

• CPU：2核（处理AI推理任务的基本要求）
• 内存：4GB（运行轻量级AI模型的理想选择）
• 操作系统：CentOS 7.6 64位（稳定且兼容性佳）

购买完成后，通过以下步骤进行基础安全配置：

# 更新系统软件包 sudo yum update -y # 安装常用工具 sudo yum install -y vim wget curl git # 配置防火墙（开放SSH端口） sudo firewall-cmd --permanent --add-port=22/tcp sudo firewall-cmd --reload 

> 提示：强烈建议在购买后立即设置SSH密钥对登录，比密码登录更安全。腾讯云控制台提供了便捷的密钥对管理功能。

常见问题排查：

1. 连接超时：检查安全组规则是否开放22端口
2. 权限不足：确保使用root用户或sudo执行管理命令
3. 软件源问题：国内服务器建议替换为腾讯云镜像源

2. Docker环境安装与优化

Docker作为容器化部署的标准工具，其正确安装是后续步骤的基础。以下是针对CentOS7的优化安装流程：

2.1 系统准备与依赖安装

# 卸载旧版本（如有） sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine # 安装必要依赖 sudo yum install -y yum-utils device-mapper-persistent-data lvm2 # 设置阿里云镜像仓库（国内加速） sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo 

2.2 Docker引擎安装与配置

# 安装最新稳定版 sudo yum install -y docker-ce docker-ce-cli containerd.io # 启动并设置开机自启 sudo systemctl start docker sudo systemctl enable docker # 验证安装 docker --version 

安装后建议进行以下优化配置：

# 创建配置文件 sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json <<-'EOF' { "registry-mirrors": ["https://mirror.ccs.tencentyun.com"], "log-driver": "json-file", "log-opts": { "max-size": "100m" }, "storage-driver": "overlay2" } EOF # 重启生效 sudo systemctl daemon-reload sudo systemctl restart docker 

3. Docker Compose安装与验证

Docker Compose是管理多容器应用的关键工具，以下是两种安装方式：

3.1 直接下载安装（推荐）

# 下载最新稳定版（替换版本号） sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose # 设置执行权限 sudo chmod +x /usr/local/bin/docker-compose # 验证安装 docker-compose --version 

3.2 手动安装（网络受限时）

1. 在浏览器访问 Docker Compose发布页
2. 下载对应版本的Linux二进制文件
3. 通过SFTP上传至/usr/local/bin/目录
4. 重命名为docker-compose并设置权限

常见问题解决方案：

• 权限拒绝：确保使用sudo或root用户操作
• 版本不兼容：选择与Docker引擎匹配的版本
• 执行慢：检查服务器网络连接

4. 小智AI Server部署实战

4.1 项目准备与目录结构

# 创建项目目录 mkdir -p ~/xiaozhi-ai && cd ~/xiaozhi-ai # 下载部署脚本 curl -L -o docker-setup.sh https://raw.githubusercontent.com/xinnan-tech/xiaozhi-esp32-server/main/docker-setup.sh # 赋予执行权限 chmod +x docker-setup.sh # 运行安装脚本 ./docker-setup.sh 

脚本执行完成后，目录结构应包含：

• docker-compose.yml：容器编排定义文件
• data/：配置和数据存储
• logs/：服务运行日志

4.2 关键配置修改

编辑配置文件data/.config.yaml，重点修改API密钥部分：

ChatGLMLLM: # 定义LLM API类型 api_key: "your_actual_api_key_here" # 替换为真实API密钥 model: "chatglm3-6b" # 默认模型 

> 注意：API密钥需从智谱AI开放平台获取，注册后可在控制台创建。免费额度足够个人测试使用。

4.3 容器启动与监控

# 启动服务（后台模式） docker-compose up -d # 查看运行状态 docker-compose ps # 跟踪日志输出 docker-compose logs -f 

部署成功的关键指标检查：

5. 服务测试与故障排除

5.1 基础功能测试

通过浏览器访问http:// <服务器ip> :8000 ，应能看到服务欢迎页面。对于API测试：

# WebSocket连接测试 curl --include --no-buffer --header "Connection: Upgrade" --header "Upgrade: websocket" --header "Host: localhost:8003" --header "Origin: http://localhost:8003" http://localhost:8003/ws 

5.2 常见问题解决方案

问题1：端口无法访问

• 检查腾讯云安全组规则
• 验证服务器本地防火墙设置
• 确认服务是否正常监听端口

问题2：容器启动失败

• 查看详细日志：docker-compose logs
• 检查配置文件语法：yamllint data/.config.yaml
• 验证依赖服务连通性

问题3：API响应慢

• 优化模型参数配置
• 考虑升级服务器配置
• 检查网络延迟

对于持续运行的服务，建议配置基础监控：

# 监控容器资源使用 docker stats # 设置日志轮转 sudo tee /etc/logrotate.d/docker < 
  
    
    

# 示例：资源限制配置 services: ai-server: image: xiaozhi-ai:latest deploy: resources: limits: cpus: '1.5' memory: 2G 

environment: - TZ=Asia/Shanghai