国内docker启动脚本

This commit is contained in:
2025-11-10 23:15:36 +08:00
parent 7b4606010b
commit 438f74cab5
3 changed files with 585 additions and 0 deletions

61
docker-compose.cn.yml Normal file
View File

@@ -0,0 +1,61 @@
# Docker Compose 配置文件(国内网络优化版)
# 使用国内镜像源优化的 Dockerfile
# 适用于网络访问 Docker Hub 受限的环境
services:
# 后端服务 (Go API)
backend:
build:
context: ./backend
dockerfile: Dockerfile.cn # 使用国内优化版 Dockerfile
container_name: ai-router-backend
restart: unless-stopped
ports:
- "${BACKEND_PORT:-8080}:8080"
environment:
- DB_PATH=${DB_PATH:-/app/data/gateway.db}
- TZ=Asia/Shanghai
volumes:
# 持久化数据库文件
- backend-data:/app/data
networks:
- ai-router-network
healthcheck:
test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:8080/api/providers"]
interval: 30s
timeout: 10s
retries: 3
start_period: 40s
# 前端服务 (React + Nginx)
frontend:
build:
context: ./frontend
dockerfile: Dockerfile.cn # 使用国内优化版 Dockerfile
container_name: ai-router-frontend
restart: unless-stopped
ports:
- "${FRONTEND_PORT:-3000}:80"
depends_on:
backend:
condition: service_healthy
networks:
- ai-router-network
healthcheck:
test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:80/health"]
interval: 30s
timeout: 10s
retries: 3
start_period: 20s
# 网络配置
networks:
ai-router-network:
driver: bridge
name: ai-router-network
# 数据卷配置
volumes:
backend-data:
driver: local
name: ai-router-backend-data

262
docker-mirror-setup.md Normal file
View File

@@ -0,0 +1,262 @@
# Docker 镜像加速器配置指南
## 问题说明
错误信息显示无法连接到 Docker Hub (`registry-1.docker.io`),这是因为网络访问受限导致的。
## 解决方案
### 方案一:配置 Docker 镜像加速器(推荐)
#### 1. 创建或编辑 Docker 配置文件
```bash
# 创建 docker 配置目录(如果不存在)
sudo mkdir -p /etc/docker
# 编辑 daemon.json 配置文件
sudo nano /etc/docker/daemon.json
```
#### 2. 添加以下配置
```json
{
"registry-mirrors": [
"https://docker.mirrors.ustc.edu.cn",
"https://hub-mirror.c.163.com",
"https://mirror.baidubce.com",
"https://docker.nju.edu.cn"
],
"insecure-registries": [],
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}
```
#### 3. 重启 Docker 服务
```bash
# 重新加载配置
sudo systemctl daemon-reload
# 重启 Docker
sudo systemctl restart docker
# 验证配置
docker info | grep -A 5 "Registry Mirrors"
```
#### 4. 测试拉取镜像
```bash
# 测试拉取一个小镜像
docker pull alpine:latest
# 如果成功,继续构建项目
cd /home/AIRouter
docker compose up --build -d
```
### 方案二:使用国内替代基础镜像
如果镜像加速器仍然不稳定,可以修改 Dockerfile 使用国内镜像源。
#### 修改后端 Dockerfile
创建 `backend/Dockerfile.cn`
```dockerfile
# 使用国内 Go 镜像源
FROM golang:1.24-bookworm AS builder
WORKDIR /app
# 配置 Go 模块代理(使用国内镜像)
ENV GO111MODULE=on \
GOPROXY=https://goproxy.cn,https://goproxy.io,direct \
CGO_ENABLED=1
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN go build -ldflags="-w -s" -o gateway main.go
# 运行阶段使用清华大学镜像源
FROM debian:bookworm-slim
RUN sed -i 's/deb.debian.org/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list.d/debian.sources && \
apt-get update && \
apt-get install -y --no-install-recommends ca-certificates wget && \
rm -rf /var/lib/apt/lists/*
WORKDIR /app
COPY --from=builder /app/gateway .
RUN mkdir -p /app/data
ENV DB_PATH=/app/data/gateway.db
EXPOSE 8080
CMD ["./gateway"]
```
#### 修改前端 Dockerfile
创建 `frontend/Dockerfile.cn`
```dockerfile
FROM node:20-alpine AS builder
WORKDIR /app
# 配置 npm 使用国内镜像
RUN npm config set registry https://registry.npmmirror.com
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build
FROM nginx:1.27-alpine
COPY --from=builder /app/dist /usr/share/nginx/html
COPY nginx.conf /etc/nginx/conf.d/default.conf
RUN echo "OK" > /usr/share/nginx/html/health
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]
```
#### 修改 docker-compose.yml
```yaml
version: '3.8'
services:
backend:
build:
context: ./backend
dockerfile: Dockerfile.cn # 使用国内优化版本
# ... 其他配置保持不变
frontend:
build:
context: ./frontend
dockerfile: Dockerfile.cn # 使用国内优化版本
# ... 其他配置保持不变
```
### 方案三:手动拉取所需镜像
```bash
# 使用镜像加速器手动拉取所需的基础镜像
docker pull golang:1.24-bookworm
docker pull debian:bookworm-slim
docker pull node:20-alpine
docker pull nginx:1.27-alpine
# 然后再构建项目
docker compose up --build -d
```
### 方案四:使用代理(临时方案)
如果你有可用的代理服务器:
```bash
# 设置 Docker 客户端代理
export HTTP_PROXY="http://your-proxy:port"
export HTTPS_PROXY="http://your-proxy:port"
export NO_PROXY="localhost,127.0.0.1"
# 然后执行构建
docker compose up --build -d
# 构建完成后取消代理
unset HTTP_PROXY HTTPS_PROXY NO_PROXY
```
或者配置 Docker daemon 使用代理:
```bash
# 创建 systemd 配置目录
sudo mkdir -p /etc/systemd/system/docker.service.d
# 创建代理配置文件
sudo nano /etc/systemd/system/docker.service.d/http-proxy.conf
```
添加以下内容:
```ini
[Service]
Environment="HTTP_PROXY=http://your-proxy:port"
Environment="HTTPS_PROXY=http://your-proxy:port"
Environment="NO_PROXY=localhost,127.0.0.1"
```
然后重启 Docker
```bash
sudo systemctl daemon-reload
sudo systemctl restart docker
```
## 推荐操作步骤
1. **首先尝试方案一**(配置镜像加速器)- 最简单且长期有效
2. 如果方案一不稳定,**使用方案三**(手动拉取镜像)
3. 如果以上都不行,**使用方案二**(国内优化 Dockerfile
## 验证成功
配置完成后,执行以下命令验证:
```bash
# 查看 Docker 配置
docker info
# 测试拉取镜像速度
time docker pull alpine:latest
# 构建项目
cd /home/AIRouter
docker compose up --build -d
# 查看构建进度
docker compose logs -f
# 检查服务状态
docker compose ps
```
## 常见问题
### Q: 镜像加速器配置后仍然超时?
A: 尝试使用不同的镜像源,或者切换到方案二使用国内优化的 Dockerfile。
### Q: 某些镜像源不可用?
A: 镜像源可能会变化,可以尝试其他可用的源,或搜索最新的国内 Docker 镜像源。
### Q: 构建速度仍然很慢?
A: 考虑使用本地镜像缓存,或者在网络条件好的时候提前拉取所需镜像。
## 其他国内可用镜像源
- 阿里云https://your-id.mirror.aliyuncs.com (需要注册获取专属地址)
- 腾讯云https://mirror.ccs.tencentyun.com
- 南京大学https://docker.nju.edu.cn
- 中国科技大学https://docker.mirrors.ustc.edu.cn
- 网易https://hub-mirror.c.163.com
- 百度云https://mirror.baidubce.com

262
start-docker-cn.sh Normal file
View File

@@ -0,0 +1,262 @@
#!/bin/bash
# AI Router Docker 国内网络优化版启动脚本
# 适用于网络访问 Docker Hub 受限的环境
set -e
# 颜色定义
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
NC='\033[0m' # No Color
# 打印带颜色的消息
print_info() {
echo -e "${BLUE}[信息]${NC} $1"
}
print_success() {
echo -e "${GREEN}[成功]${NC} $1"
}
print_warning() {
echo -e "${YELLOW}[警告]${NC} $1"
}
print_error() {
echo -e "${RED}[错误]${NC} $1"
}
# 打印标题
print_header() {
echo ""
echo -e "${BLUE}========================================${NC}"
echo -e "${BLUE} AI Router Docker 国内优化版部署${NC}"
echo -e "${BLUE}========================================${NC}"
echo ""
}
# 检查 Docker 是否安装
check_docker() {
print_info "检查 Docker 安装状态..."
if ! command -v docker &> /dev/null; then
print_error "Docker 未安装,请先安装 Docker"
print_info "安装指南: https://docs.docker.com/engine/install/"
exit 1
fi
if ! command -v docker compose &> /dev/null; then
print_error "Docker Compose 未安装,请先安装 Docker Compose"
print_info "安装指南: https://docs.docker.com/compose/install/"
exit 1
fi
print_success "Docker 和 Docker Compose 已安装"
docker --version
docker compose version
}
# 检查 Docker 服务状态
check_docker_service() {
print_info "检查 Docker 服务状态..."
if ! docker info &> /dev/null; then
print_error "Docker 服务未运行,请启动 Docker 服务"
print_info "运行: sudo systemctl start docker"
exit 1
fi
print_success "Docker 服务正常运行"
}
# 配置 Docker 镜像加速器(可选)
configure_mirror() {
print_info "检查 Docker 镜像加速器配置..."
if docker info 2>/dev/null | grep -q "Registry Mirrors"; then
print_success "已配置 Docker 镜像加速器"
docker info 2>/dev/null | grep -A 5 "Registry Mirrors"
else
print_warning "未配置 Docker 镜像加速器"
print_info "如果构建失败,请参考 docker-mirror-setup.md 配置镜像加速器"
fi
}
# 清理旧容器和镜像(可选)
cleanup_old() {
read -p "是否清理旧的容器和镜像?(y/N): " -n 1 -r
echo
if [[ $REPLY =~ ^[Yy]$ ]]; then
print_info "停止并删除旧容器..."
docker compose -f docker-compose.cn.yml down 2>/dev/null || true
print_info "删除旧镜像..."
docker rmi ai-router-backend:latest 2>/dev/null || true
docker rmi ai-router-frontend:latest 2>/dev/null || true
print_success "清理完成"
fi
}
# 构建镜像
build_images() {
print_info "开始构建 Docker 镜像(使用国内镜像源)..."
print_warning "首次构建可能需要较长时间,请耐心等待..."
# 使用国内优化版的 docker-compose 配置
if docker compose -f docker-compose.cn.yml build --no-cache; then
print_success "镜像构建成功"
else
print_error "镜像构建失败"
print_info "请检查网络连接或参考 docker-mirror-setup.md 配置镜像加速器"
exit 1
fi
}
# 启动服务
start_services() {
print_info "启动服务..."
if docker compose -f docker-compose.cn.yml up -d; then
print_success "服务启动成功"
else
print_error "服务启动失败"
print_info "查看日志: docker compose -f docker-compose.cn.yml logs"
exit 1
fi
}
# 等待服务就绪
wait_for_services() {
print_info "等待服务启动完成..."
# 等待后端服务
print_info "等待后端服务就绪(最多等待 60 秒)..."
TIMEOUT=60
ELAPSED=0
while [ $ELAPSED -lt $TIMEOUT ]; do
if docker compose -f docker-compose.cn.yml ps backend | grep -q "healthy"; then
print_success "后端服务已就绪"
break
fi
sleep 2
ELAPSED=$((ELAPSED + 2))
echo -n "."
done
echo ""
if [ $ELAPSED -ge $TIMEOUT ]; then
print_warning "后端服务启动超时,请检查日志"
fi
# 等待前端服务
print_info "等待前端服务就绪(最多等待 30 秒)..."
TIMEOUT=30
ELAPSED=0
while [ $ELAPSED -lt $TIMEOUT ]; do
if docker compose -f docker-compose.cn.yml ps frontend | grep -q "healthy"; then
print_success "前端服务已就绪"
break
fi
sleep 2
ELAPSED=$((ELAPSED + 2))
echo -n "."
done
echo ""
if [ $ELAPSED -ge $TIMEOUT ]; then
print_warning "前端服务启动超时,请检查日志"
fi
}
# 显示服务状态
show_status() {
print_info "服务运行状态:"
echo ""
docker compose -f docker-compose.cn.yml ps
echo ""
}
# 测试服务
test_services() {
print_info "测试服务连接..."
# 测试后端
if curl -f -s http://localhost:8080/api/providers > /dev/null 2>&1; then
print_success "后端 API 服务正常: http://localhost:8080/api"
else
print_warning "后端 API 服务可能未完全启动,请稍后再试"
fi
# 测试前端
if curl -f -s http://localhost:3000/health > /dev/null 2>&1; then
print_success "前端服务正常: http://localhost:3000"
else
print_warning "前端服务可能未完全启动,请稍后再试"
fi
}
# 显示访问信息
show_access_info() {
echo ""
echo -e "${GREEN}========================================${NC}"
echo -e "${GREEN} 部署完成!${NC}"
echo -e "${GREEN}========================================${NC}"
echo ""
echo -e " 前端访问地址: ${BLUE}http://localhost:3000${NC}"
echo -e " 后端 API: ${BLUE}http://localhost:8080/api${NC}"
echo ""
echo -e "${YELLOW}常用命令:${NC}"
echo -e " 查看日志: ${BLUE}docker compose -f docker-compose.cn.yml logs -f${NC}"
echo -e " 停止服务: ${BLUE}docker compose -f docker-compose.cn.yml stop${NC}"
echo -e " 重启服务: ${BLUE}docker compose -f docker-compose.cn.yml restart${NC}"
echo -e " 停止并删除: ${BLUE}docker compose -f docker-compose.cn.yml down${NC}"
echo -e " 查看状态: ${BLUE}docker compose -f docker-compose.cn.yml ps${NC}"
echo ""
echo -e "${YELLOW}更多信息请参考:${NC}"
echo -e " 部署文档: ${BLUE}README-DOCKER.md${NC}"
echo -e " 镜像配置: ${BLUE}docker-mirror-setup.md${NC}"
echo ""
}
# 主函数
main() {
print_header
# 检查环境
check_docker
check_docker_service
configure_mirror
echo ""
# 清理旧资源(可选)
cleanup_old
echo ""
# 构建和启动
build_images
start_services
wait_for_services
echo ""
# 显示状态
show_status
test_services
# 显示访问信息
show_access_info
}
# 错误处理
trap 'print_error "脚本执行失败,请检查错误信息"; exit 1' ERR
# 运行主函数
main
exit 0