Docker部署小老虾AI保姆级指南，新手一次成功

前置准备

在开始 Docker部署小老虾AI 之前，请确认你的服务器满足以下条件：

• 操作系统：推荐 Ubuntu 20.04+ 或 CentOS 7+，本文以 Ubuntu 22.04 为例。


• Docker 环境：已安装 Docker Engine 和 Docker Compose（可选）。如果未安装，请先执行下面的命令安装：

# 使用官方安装脚本（适用于 Ubuntu/Debian）

curl -fsSL https://get.docker.com -o get-docker.sh

sudo sh get-docker.sh

sudo systemctl start docker

sudo systemctl enable docker

• 网络：确保服务器能正常访问 Docker Hub 或 GitHub Container Registry（ghcr.io）。


• 端口：小老虾AI 默认使用 8080 端口，请确认该端口未被占用。


• 磁盘空间：至少 1GB 剩余空间（镜像 + 模型文件）。

分步操作

第一步：拉取或构建镜像

小老虾AI 官方提供了 Docker 镜像，直接拉取即可：

docker pull ghcr.io/xiaoxiaoxiao/ai:latest

如果网络较慢，可以配置国内镜像加速（如阿里云、中科大）。

第二步：运行容器

使用以下命令启动容器，并映射端口：

docker run -d \

--name xiaoxiaoxiao-ai \

-p 8080:8080 \

-v ./data:/app/data \

ghcr.io/xiaoxiaoxiao/ai:latest

• -d：后台运行


• --name：容器名称


• -p 8080:8080：将宿主机的 8080 端口映射到容器内的 8080 端口


• -v ./data:/app/data：挂载数据目录，便于持久化AI模型或配置

第三步：检查容器状态

docker ps

看到 xiaoxiaoxiao-ai 容器状态为 Up 即表示运行正常。

避坑指南

• 端口冲突：如果宿主机 8080 已被占用，改为其他端口，例如 -p 8888:8080。


• 内存不足：小老虾AI 至少需要 512MB 内存，建议使用 --memory=1g 限制容器内存。


• 挂载目录权限：确保 ./data 目录已创建并且有写权限，否则容器启动报错。


• 镜像拉取失败：检查网络，或尝试手动通过 docker pull 并添加 --platform linux/amd64 参数。

高频问题解答

Q1：如何访问小老虾AI的 Web 界面？

启动成功后，在浏览器输入 http://你的服务器IP:8080。

如果映射了其他端口，请使用对应端口。

Q2：如何停止并删除容器？

docker stop xiaoxiaoxiao-ai

docker rm xiaoxiaoxiao-ai

Q3：找不到镜像或版本不对？

请确认镜像名拼写正确。

最新版本可查看官方 GitHub Releases（示例链接），或者改用 xiaoxiaoxiao/ai:latest。

Q4：如何更新到新版本？

先停止并删除旧容器，然后拉取最新镜像，再用相同的命令重新创建容器。

效果验证

执行以下命令测试 API 是否正常：

curl -v http://localhost:8080/api/health

如果返回类似 {"status":"ok"} 的 JSON，说明 Docker部署小老虾AI 成功。

也可以直接访问 Web 界面，输入测试问题，观察 AI 能否正常回复。

---

如果你正在处理 Docker部署小老虾AI，建议先按本文步骤完整执行，再根据自己的环境做微调；

遇到异常时优先回看避坑和高频问题部分。

祝一次成功！