| # 参考文档: 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"] |