零基础Docker部署小老虾AI：从环境准备到效果验证
前置准备
使用 Docker部署小老虾AI 之前，需要确保你的服务器符合以下条件：
- 一台 Linux 服务器（推荐 CentOS 7+ 或 Ubuntu 20.04+），已安装 Docker（若未安装，请先执行
curl -fsSL https://get.docker.com | bash快速安装）。 - 已安装 Docker Compose（可选，但推荐）：
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && sudo chmod +x /usr/local/bin/docker-compose。 - 开放需要用的端口（默认 8080 或 80/443，根据配置自行调整）。
- 确保服务器内存至少 2GB，磁盘剩余空间 10GB 以上。
- 一个稳定的网络，因为需要拉取 Docker 镜像。
分步操作
以下步骤基于 Docker Compose 一键部署，如果你更习惯纯 Docker 命令，可跳过第一步。
第一步：下载小老虾AI的 Compose 文件
在服务器上创建一个目录并进入：
mkdir -p /data/xiaolaoxia && cd /data/xiaolaoxia从官方仓库获取 docker-compose.yml 文件（示例地址，请替换为实际仓库）：
wget https://github.com/example/xiaolaoxia-ai/raw/main/docker-compose.yml若没有 wget，可使用 curl -O 链接。
第二步：修改配置（可选）
编辑 docker-compose.yml：
vim docker-compose.yml重点检查几项：
- 端口映射：默认
"8080:80"，若本地 8080 被占用，可改为其他端口，如"3000:80"。 - 环境变量：如
API_KEY或ADMIN_PASSWORD等，按需设置。 - 数据卷：确保挂载目录存在，例如
./data:/app/data。
第三步：启动服务
docker-compose up -d等待镜像拉取和容器启动。
首次运行约 1-3 分钟。
第四步：查看容器状态
docker-compose ps应看到类似 xiaolaoxia-ai 容器状态为 Up。
第五步：访问页面
浏览器打开 http://你的服务器IP:映射端口（如 http://192.168.1.100:8080），若看到小老虾AI的登录或聊天界面，即部署成功。
避坑指南
- 镜像拉取超时：国内服务器建议配置 Docker 镜像加速器，编辑
/etc/docker/daemon.json添加{"registry-mirrors":["https://mirror.ccs.tencentyun.com"]}，然后systemctl restart docker。 - 端口冲突：启动前用
netstat -tlnp | grep 端口检查端口占用。 - 权限不足：如果 Docker 命令需要
sudo，请确保当前用户已加入 docker 组：sudo usermod -aG docker $USER并重启会话。 - 数据库连接失败：检查
docker-compose.yml中数据库服务的名称和密码是否正确匹配。
高频问题解答
- Q：部署后页面显示 502 怎么办？ A：通常是服务启动较慢，等待 30 秒后刷新；若仍报错，执行
docker-compose logs -f查看错误日志，常见原因是内存不足或数据库未就绪。 - Q：如何更新小老虾AI？ A：在项目目录下执行
docker-compose pull && docker-compose up -d重新拉取最新镜像并重启。 - Q：没有域名，可以用 IP 访问吗？ A：可以，默认使用 IP+端口即可。如需 HTTPS，建议使用 Nginx 反向代理。
效果验证
- 打开浏览器访问页面，能正常加载小老虾AI的界面。
- 尝试发送一条测试消息（如“你好”），应该能收到 AI 回复。
- 检查容器日志：
docker-compose logs --tail=20，无关键错误。 - 查看资源占用：
docker stats xiaolaoxia-ai，CPU/内存使用率正常。
若以上全通过，则 Docker部署小老虾AI 已成功。
如遇问题，先回看避坑指南和高频问题，通常能解决 90% 的异常。
