Delete DOCKER_DEPLOYMENT.md

2025-08-31 18:45:30 +08:00 · 2025-08-31 18:45:30 +08:00 · 146ed3d7b5
parent a4fd8a78d5
commit 146ed3d7b5
1 changed files with 0 additions and 251 deletions
--- a/DOCKER_DEPLOYMENT.md
+++ b/DOCKER_DEPLOYMENT.md
@ -1,251 +0,0 @@
 # KatelyaTV Docker 部署指南
 > 本文档提供 KatelyaTV 的完整 Docker 部署指南，确保用户能够成功拉取和部署镜像。
 ## 📦 镜像信息
 - **镜像地址**: `ghcr.io/katelya77/katelyatv:latest`
 - **支持架构**: linux/amd64, linux/arm64
 - **基础镜像**: node:20-alpine
 - **暴露端口**: 3000
 ## 🚀 快速部署
 ### 1. 单容器部署（推荐新手）
 ```bash
 # 拉取最新镜像
 docker pull ghcr.io/katelya77/katelyatv:latest
 # 启动容器
 docker run -d \
  --name katelyatv \
  -p 3000:3000 \
  --env PASSWORD=your_secure_password \
  --restart unless-stopped \
  ghcr.io/katelya77/katelyatv:latest
 # 查看运行状态
 docker ps | grep katelyatv
 # 查看日志
 docker logs katelyatv
 ```
 ### 2. Docker Compose 部署（推荐生产环境）
 创建 `docker-compose.yml` 文件：
 ```yaml
 version: '3.8'
 services:
  katelyatv:
    image: ghcr.io/katelya77/katelyatv:latest
    container_name: katelyatv
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - PASSWORD=your_secure_password
      - SITE_NAME=KatelyaTV
    volumes:
      # 可选：挂载自定义配置
      # - ./config.json:/app/config.json:ro
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3000"]
      interval: 30s
      timeout: 10s
      retries: 3
 ```
 启动服务：
 ```bash
 # 启动服务
 docker-compose up -d
 # 查看状态
 docker-compose ps
 # 查看日志
 docker-compose logs -f
 ```
 ## 🗄️ 数据持久化部署（Redis）
 对于需要多用户支持和数据同步的场景：
 ```yaml
 version: '3.8'
 services:
  katelyatv:
    image: ghcr.io/katelya77/katelyatv:latest
    container_name: katelyatv
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - USERNAME=admin
      - PASSWORD=admin_password
      - NEXT_PUBLIC_STORAGE_TYPE=redis
      - REDIS_URL=redis://redis:6379
      - NEXT_PUBLIC_ENABLE_REGISTER=true
    depends_on:
      - redis
    networks:
      - katelyatv-network
  redis:
    image: redis:7-alpine
    container_name: katelyatv-redis
    restart: unless-stopped
    volumes:
      - redis_data:/data
    networks:
      - katelyatv-network
    command: redis-server --appendonly yes
 volumes:
  redis_data:
 networks:
  katelyatv-network:
    driver: bridge
 ```
 ## 🔧 环境变量配置
 | 变量名 | 描述 | 默认值 | 示例 |
 |--------|------|--------|------|
 | `PASSWORD` | 访问密码 | - | `my_secure_password` |
 | `USERNAME` | 管理员用户名（Redis模式） | - | `admin` |
 | `SITE_NAME` | 站点名称 | `KatelyaTV` | `我的影视站` |
 | `NEXT_PUBLIC_STORAGE_TYPE` | 存储类型 | `localstorage` | `redis`, `d1`, `upstash` |
 | `REDIS_URL` | Redis连接地址 | - | `redis://redis:6379` |
 | `NEXT_PUBLIC_ENABLE_REGISTER` | 开放注册 | `false` | `true` |
 | `NEXT_PUBLIC_SEARCH_MAX_PAGE` | 搜索最大页数 | `5` | `10` |
 ## 🔍 故障排查
 ### 常见问题
 1. **容器启动失败**
   ```bash
   # 查看详细错误信息
   docker logs katelyatv
   # 检查端口占用
   netstat -tulpn | grep :3000
   ```
 2. **镜像拉取失败**
   ```bash
   # 确认镜像地址正确
   docker pull ghcr.io/katelya77/katelyatv:latest
   # 如果是私有仓库，需要先登录
   docker login ghcr.io
   ```
 3. **数据丢失问题**
   - localStorage 模式：数据存储在浏览器，清除缓存会丢失
   - 建议使用 Redis 模式进行数据持久化
 ### 健康检查
 ```bash
 # 检查容器状态
 docker ps
 # 检查容器健康状态
 docker inspect katelyatv | grep -A 5 "Health"
 # 测试应用响应
 curl -I http://localhost:3000
 ```
 ## 🔄 更新升级
 ### 更新到最新版本
 ```bash
 # 停止旧容器
 docker stop katelyatv
 docker rm katelyatv
 # 拉取最新镜像
 docker pull ghcr.io/katelya77/katelyatv:latest
 # 启动新容器（使用相同配置）
 docker run -d \
  --name katelyatv \
  -p 3000:3000 \
  --env PASSWORD=your_secure_password \
  --restart unless-stopped \
  ghcr.io/katelya77/katelyatv:latest
 ```
 ### Docker Compose 更新
 ```bash
 # 拉取最新镜像
 docker-compose pull
 # 重新创建容器
 docker-compose up -d --force-recreate
 ```
 ## 🔐 安全建议
 1. **设置强密码**: 使用复杂密码保护访问
 2. **限制访问**: 配置防火墙或反向代理限制访问来源
 3. **定期更新**: 保持镜像版本最新
 4. **数据备份**: 定期备份 Redis 数据（如果使用）
 5. **监控日志**: 关注异常访问和错误日志
 ## 📊 性能优化
 ### 资源限制
 ```yaml
 services:
  katelyatv:
    image: ghcr.io/katelya77/katelyatv:latest
    deploy:
      resources:
        limits:
          memory: 512M
          cpus: '0.5'
        reservations:
          memory: 256M
          cpus: '0.25'
 ```
 ### 反向代理（Nginx）
 ```nginx
 server {
    listen 80;
    server_name your-domain.com;
    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
 }
 ```
 ## 🆘 获取帮助
 - 📖 [项目文档](README.md)
 - 🐛 [问题反馈](https://github.com/katelya77/KatelyaTV/issues)
 - 💬 [讨论区](https://github.com/katelya77/KatelyaTV/discussions)
 ---
 **注意**: 本项目仅供学习和个人使用，请遵守当地法律法规。