更新Dockerfile

Dockerfile

@@ -1,16 +1,63 @@
-# Read the doc: https://huggingface.co/docs/hub/spaces-sdks-docker
-# you will also find guides on how best to write your Dockerfile
+# 参考文档: https://huggingface.co/docs/hub/spaces-sdks-docker
+# 更多关于编写最佳实践的Dockerfile指南见上述链接
 
+# ============================================================
+# 基础镜像配置
+# ============================================================
+# 使用Python 3.9作为基础镜像，包含Python运行时环境
 FROM python:3.9
 
+# ============================================================
+# 用户和权限配置
+# ============================================================
+# 创建一个名为'user'的非root用户，UID为1000
+# -m: 创建用户的主目录 (/home/user)
+# -u: 指定用户ID
 RUN useradd -m -u 1000 user
+
+# 将当前活动用户切换为'user'用户（而不是root）
+# 这样可以提高容器的安全性，防止以root权限运行应用
 USER user
+
+# ============================================================
+# 环境变量配置
+# ============================================================
+# 更新PATH环境变量，将用户本地pip安装目录加入到搜索路径中
+# 这样可以直接运行用pip install --user安装的命令行工具
 ENV PATH="/home/user/.local/bin:$PATH"
 
+# ============================================================
+# 工作目录设置
+# ============================================================
+# 为容器设置工作目录为 /app
+# 后续的RUN、COPY、CMD等指令都在此目录下执行
 WORKDIR /app
 
+# ============================================================
+# 依赖项安装
+# ============================================================
+# 将宿主机的 requirements.txt 文件复制到容器内的 requirements.txt
+# --chown=user: 确保文件由'user'用户拥有（而不是root）
 COPY --chown=user ./requirements.txt requirements.txt
+
+# 使用pip安装requirements.txt中列出的所有依赖包
+# --no-cache-dir: 不缓存pip下载，减小镜像大小
+# --upgrade: 升级所有依赖包到最新版本
 RUN pip install --no-cache-dir --upgrade -r requirements.txt
 
+# ============================================================
+# 应用代码复制
+# ============================================================
+# 将宿主机的所有文件（除了.dockerignore中排除的文件）复制到容器的/app目录
+# --chown=user: 确保所有文件由'user'用户拥有
 COPY --chown=user . /app
+
+# ============================================================
+# 容器启动命令
+# ============================================================
+# 当容器启动时自动运行此命令
+# uvicorn: Python的ASGI应用服务器
+# app:app: 指定为 app.py 文件中名为 app 的应用对象
+# --host 0.0.0.0: 监听所有网络接口（允许外部访问）
+# --port 7860: 监听端口7860
 CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "7860"]