Casa Mella Web Docker镜像文档

1. 镜像概述

Casa Mella Web Docker镜像是Casa Mella Web应用的容器化版本，旨在简化该Web应用的部署与运行流程。通过Docker容器化技术，确保应用在不同环境中具备一致的运行表现，同时提供隔离性强、配置灵活的部署体验，适用于开发、测试及生产环境。

2. 核心功能与特性

2.1 容器化部署

• 基于Docker容器封装Casa Mella Web应用及其依赖，一键部署，无需手动配置运行环境。
• 支持跨平台运行，兼容Linux、macOS及Windows（需Docker环境支持）。

2.2 简化配置

• 提供环境变量配置机制，支持自定义应用端口、日志级别等核心参数。
• 内置默认配置，满足快速启动需求，同时允许通过外部文件或环境变量覆盖默认配置。

2.3 数据持久化

• 支持通过Docker卷（Volume）挂载应用数据目录，确保容器重启或重建后数据不丢失。

2.4 轻量级设计

• 基于精简基础镜像构建，减少镜像体积，提升部署和启动速度。

3. 使用场景与适用范围

3.1 个人/小型网站部署

适用于个人博客、小型展示网站等场景，通过Docker快速搭建Casa Mella Web服务。

3.2 开发与测试环境

为开发团队提供一致的本地开发环境，避免“环境不一致”导致的问题；支持快速部署测试实例，验证新功能或修复。

3.3 演示环境搭建

用于快速搭建Casa Mella应用演示实例，供用户体验或项目展示使用。

4. 使用方法与配置说明

4.1 前提条件

• 已安装Docker Engine（推荐版本20.10+）。
• 若使用Docker Compose，需安装Docker Compose工具。

4.2 快速启动（docker run）

通过以下命令快速启动Casa Mella Web容器：

docker run -d \
  --name casa-mella-web \
  -p 8080:80 \  # 端口映射（主机端口:容器内端口，容器内默认端口为80）
  -v ./app-data:/app/data \  # 挂载数据卷（持久化应用数据）
  [镜像名称]:[标签]  # 替换为实际的镜像名称和标签，如casa-mella/web:latest

参数说明：

• -d：后台运行容器。
• --name：指定容器名称（自定义）。
• -p 8080:80：将主机8080端口映射到容器内80端口（可根据需求修改主机端口）。
• -v ./app-data:/app/data：将主机当前目录下的app-data目录挂载到容器内/app/data，用于持久化应用数据（如上传文件、配置文件等）。

4.3 Docker Compose配置

创建docker-compose.yml文件，配置如下：

version: '3'
services:
  casa-mella-web:
    image: [镜像名称]:[标签]  # 替换为实际镜像名称和标签
    container_name: casa-mella-web
    ports:
      - "8080:80"  # 端口映射
    volumes:
      - ./app-data:/app/data  # 数据卷挂载
    environment:
      - TZ=Asia/Shanghai  # 设置时区
      - LOG_LEVEL=info  # 日志级别（可选：debug/info/warn/error）
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

启动服务：

docker-compose up -d

4.4 环境变量配置

通过-e参数（docker run）或environment字段（Docker Compose）设置环境变量，自定义应用行为：

示例（自定义端口和日志级别）：

docker run -d \
  --name casa-mella-web \
  -p 8000:3000 \  # 容器内端口改为3000，主机端口映射为8000
  -e PORT=3000 \
  -e LOG_LEVEL=debug \
  [镜像名称]:[标签]

4.5 数据持久化

为避免容器删除后数据丢失，需通过卷挂载持久化应用数据。默认数据存储路径为容器内/app/data，建议将该目录挂载到主机目录或Docker Volume：

• 主机目录挂载（如4.2节示例）：-v ./app-data:/app/data
• Docker Volume挂载（推荐生产环境）：

  # 创建Docker Volume
  docker volume create casa-mella-data
  # 启动容器时挂载Volume
  docker run -d \
    --name casa-mella-web \
    -p 8080:80 \
    -v casa-mella-data:/app/data \
    [镜像名称]:[标签]
  

5. 常见问题与注意事项

5.1 端口冲突

若启动时报错“Bind for 0.0.0.0:8080 failed”，表示主机端口8080已被占用，需更换主机端口（如-p 8081:80）。

5.2 数据卷权限问题

若挂载主机目录后应用无法写入数据，可能是权限不足，可通过-u参数指定容器内运行用户ID（如-u 1000:1000，需与主机目录权限匹配）。

5.3 镜像更新

如需更新镜像，可执行以下步骤：

# 拉取最新镜像
docker pull [镜像名称]:[标签]
# 停止并删除旧容器
docker stop casa-mella-web && docker rm casa-mella-web
# 用新镜像启动容器（命令同4.2节）

6. 查看日志与状态

6.1 查看容器状态

docker ps --filter "name=casa-mella-web"

6.2 查看应用日志

docker logs -f casa-mella-web  # -f参数实时跟踪日志输出

6.3 进入容器（调试用）

docker exec -it casa-mella-web /bin/sh  # 或/bin/bash（根据基础镜像调整）