Docker部署小老虾AI完整指南：从零到上手
前置准备
在进行 Docker部署小老虾AI 之前，你需要确保服务器满足以下条件：
- 一台安装了 Linux（推荐 Ubuntu 20.04+ / CentOS 7+）的云服务器或本地虚拟机。
- Docker 和 Docker Compose 已安装。没装的话先执行下面命令：
curl -fsSL https://get.docker.com | bash
sudo systemctl start docker && sudo systemctl enable docker- 服务器防火墙放行要使用的端口（本文以 8080 为例）。
- 准备一个工作目录，例如
/opt/xiaolaoxia-ai，用于存放配置文件和数据。
小提示：如果使用的是宝塔面板，可以在“安全” → “防火墙”中放行端口；在“文件” → “远程下载”中创建目录。
分步操作
第一步：拉取小老虾AI镜像
docker pull douyin/xiaolaoxia-ai:latest如果网速慢，可以配置国内镜像加速（如阿里云、中科大）。
第二步：创建挂载目录并准备配置文件
mkdir -p /opt/xiaolaoxia-ai/data
chmod 755 /opt/xiaolaoxia-ai/data小老虾AI的配置文件（如 config.yaml）可以从项目仓库下载，放到 /opt/xiaolaoxia-ai/ 下。
如果暂时没有，可以先运行容器生成默认配置。
第三步：启动容器
使用 docker run 启动，关键参数说明：
docker run -d \
--name xiaolaoxia-ai \
-p 8080:8080 \
-v /opt/xiaolaoxia-ai/data:/app/data \
-v /opt/xiaolaoxia-ai/config.yaml:/app/config.yaml \
-e TZ=Asia/Shanghai \
douyin/xiaolaoxia-ai:latest-d：后台运行。--name：容器名称。-p 8080:8080：将宿主机的8080端口映射到容器的8080端口。-v：挂载目录和配置文件，方便日后升级数据不丢失。-e：设置时区。
第四步：验证容器是否正常运行
docker ps如果看到 xiaolaoxia-ai 的状态为 Up，则启动成功。
接着用浏览器访问 http://你的服务器IP:8080，应该能看到小老虾AI的 Web 界面。
避坑指南
❌ 问题1：镜像拉取失败
- 检查 Docker 是否正常运行：
systemctl status docker。 - 若网络慢，配置镜像加速：修改
/etc/docker/daemon.json，加入{ "registry-mirrors": ["https://mirror.ccs.tencentyun.com"] }，然后重启 Docker。
❌ 问题2：端口被占用
- 执行
netstat -tulnp | grep 8080，如果提示端口已占用，更换一个端口（如 8081）并修改-p参数。
❌ 问题3：容器启动后马上退出
- 查看日志：
docker logs xiaolaoxia-ai。常见原因是配置文件格式错误或挂载目录权限不足。请确认目录和文件属主与容器内用户一致，或用chmod 777临时测试。
效果验证
- 在终端运行
curl -I http://127.0.0.1:8080，若返回 HTTP/1.1 200 OK 说明服务正常。 - 浏览器打开
http://你的服务器IP:8080，应该看到小老虾AI的登录或首页界面。 - 尝试完成一次简单的对话或任务，确保 AI 功能可用。
高频问题解答
问：Docker部署小老虾AI需要多大内存？
答：建议服务器至少有 2GB 可用内存，因为小老虾AI内置模型推理需要一定资源。
问：如何升级到最新版本？
答：先停并删除旧容器：docker stop xiaolaoxia-ai && docker rm xiaolaoxia-ai，再重新拉取镜像并运行，注意配置和数据因挂载了卷所以保留。
问：我想使用自己的模型文件，怎么替换？
答：如果容器支持自定义模型，一般挂载 /app/models 目录到宿主机，然后将模型文件放入即可。具体路径请参考项目说明。
问：宝塔面板如何操作？
答：宝塔用户可以在“Docker” → “容器”中直接拉取镜像、创建容器，填写端口映射和挂载路径，无需输入命令。
---
如果你正在处理 Docker部署小老虾AI，建议先按本文步骤完整执行，再根据自己的环境做微调；
遇到异常时优先回看避坑和高频问题部分。
