Docker 部署 Python 实战指南

第二步：写一个测试程序

echo 'print("Hello from Docker App!")' > app.py

第三步：启动容器并挂载目录

docker run -it --name py-app \
  -v /data/python-app:/app \
  -w /app \
  python:3.12 python app.py

说明：

• -v /data/python-app:/app：挂载宿主机目录到容器
• -w /app：指定容器内工作目录
• python app.py：执行程序

输出应为：

Hello from Docker App!

3.3 使用 docker-compose 部署（适合企业级项目）

第一步：创建项目目录

mkdir -p /data/py-compose
cd /data/py-compose

第二步：准备应用 写一个 main.py：

print("Python running in Docker with docker-compose!")

第三步：编写 docker-compose.yml

version: '3'
services:
  python-app:
    image: python:3.12
    container_name: python-service
    working_dir: /app
    volumes:
      - ./app:/app
    command: python main.py
    restart: always

目录结构：

/data/py-compose
├─ docker-compose.yml
└─ app
   └─ main.py

第四步：启动服务

docker compose up -d

查看状态

docker compose ps

查看日志

docker compose logs -f

输出：

python-service | Python running in Docker with docker-compose!

4. 进阶实践

4.1 安装第三方库

运行交互式容器，使用 pip 安装：

docker run -it --name py-pandas python:3.12 bash
pip install pandas

或者在项目目录添加 requirements.txt：

flask
requests

然后容器启动时自动安装：

docker run -it -v /data/python-app:/app -w /app python:3.12 pip install -r requirements.txt

4.2 构建自定义 Python 镜像

在项目中写一个 Dockerfile：

FROM python:3.12
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
CMD ["python", "app.py"]

构建镜像：

docker build -t my-python-app .

运行：

docker run -it --name py-custom my-python-app

5. 常见问题

5.1 进入容器后 Python 环境丢失？

默认进入是 /bin/bash，需要手动执行 python。也可以直接：

docker exec -it py-app python

5.2 如何持久化依赖环境？

• 使用 requirements.txt + pip install
• 或者构建自定义镜像（见上文 4.2）

5.3 容器内时区不对？

加 -e TZ=Asia/Shanghai：

docker run -it -e TZ=Asia/Shanghai python:3.12

5.4 如何运行 Flask / Django Web 项目？

以 Flask 为例，在 app.py：

from flask import Flask
app = Flask(__name__)
@app.route("/")
def hello():
    return "Hello Flask from Docker!"
if __name__ == "__main__":
    app.run(host="0.0.0.0", port=5000)

运行容器：

docker run -d --name py-flask -p 5000:5000 \
  -v /data/python-app:/app -w /app \
  python:3.12 pip install flask && python app.py

访问 http://服务器 IP:5000 即可。