centos7 python项目 pyinstaller编译及docker安装

注：centos7安装pyinstaller比较麻烦，因为pyinstaller5.0需要python3.7以上，而centos7默认安装的是Python 2.7.5，如果通过yum install python3，则安装的python是3.6.8。

经研究采用两种方法安装python，一是基于源码安装python3.10版本，二是基于miniconda3安装

一、python源码安装及pyinstaller编译

1、安装Python 3.10

（1）yum更新

yum update
yum install openssl-devel bzip2-devel libffi-devel  
yum groupinstall "Development Tools" 

（2）下载python3.10

wget https://www.python.org/ftp/python/3.10.2/Python-3.10.2.tgz

（3）安装python3.10

tar -xzf Python-3.10.2.tgz  
cd Python-3.10.2  
./configure --enable-optimizations  
make altinstall  

（4）验证安装

python3.10 --version  

其他版本安装同理

2、安装pyinstaller

（1）升级pip

python3.10 -m pip install --upgrade pip -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com

（2）安装pyinstaller

pip3.10 install pyinstaller -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com

运行上面命令，应该看到如下输出结果：

Successfully installed pyinstaller-x.x.x

3、优化项目的requirements.txt

注：这一步可以不需要，有时优化后pyinstaller编译后运行不了。

（1）将代码上传到centos目录

（2）安装pipreqs

pip install pipreqs -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com

（3）根据代码重新生成requirements.txt

pipreqs ./ --encoding=utf8 --use-local --force

4、编译python项目

（1）在centos目录执行编译

pip install -r requirements.txt -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com
pyinstaller -D main.py

编译后当前目录下会有dist目录

5、编译过程中出现的错误记录

特别说明：所有的错误，通过咨询deepseek都解决了。

（1）The 'pathlib' package is an obsolete backport of a standard library package and is incompatible with PyInstaller. Please remove this package

pip3.10 uninstall pathlib

（2）No matching distribution found for pipreqs

pip3.10 install pipreqs -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn

（3）Could not fetch URL https://mirrors.aliyun.com/pypi/simple/pipreqs/: There was a problem confirming the ssl certificate: HTTPSConnectionPool(host='mirrors.aliyun.com', port=443)

将https改为 http

pip3.10 install pipreqs -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com

（4）ERROR: Python library not found: libpython3.10.so, libpython3.10.so.1.0

# 进入 Python 源码目录（如果是自行编译的）
cd Python-3.10.2

# 清理之前的编译
make distclean

# 重新配置并启用共享库
./configure --enable-optimizations --enable-shared
make -j$(nproc)
sudo make altinstall

（5）/usr/local/bin/python3.10: error while loading shared libraries: libpython3.10.so.1.0: cannot open shared object file: No such file or directory

# 配置动态库加载路径，永久生效
echo "/usr/local/lib" | sudo tee /etc/ld.so.conf.d/python3.10.conf
# 刷新动态库缓存
sudo ldconfig  

（6）ModuleNotFoundError: No module named '_ssl'

这个错误表明 PyInstaller 打包后的可执行文件缺少 Python 的 _ssl模块（用于 HTTPS/SSL 加密支持）

手动编译openssl

wget https://www.openssl.org/source/openssl-1.1.1w.tar.gz
tar xzf openssl-1.1.1w.tar.gz
cd openssl-1.1.1w
./config --prefix=/usr/local/openssl --openssldir=/usr/local/openssl
make -j$(nproc)
sudo make install

# 更新动态库链接
echo "/usr/local/openssl/lib" | sudo tee /etc/ld.so.conf.d/openssl-1.1.1.conf
sudo ldconfig

重新编译python

# 进入 Python 源码目录
cd Python-3.10.x

# 清理旧编译
make distclean

# 配置时指定 OpenSSL 路径
./configure \
  --enable-optimizations \
  --enable-shared \
  --with-openssl=/usr/local/openssl  # 或 /usr/include/openssl11（CentOS）

# 编译安装
make -j$(nproc)
sudo make altinstall

二、miniconda3安装及pyinstaller编译

1、安装python

conda create -n test python=3.11.7
conda activate test

2、安装pyinstaller

pip install pyinstaller -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com

3、优化项目的requirements.txt

注：这一步可以不需要，有时优化后pyinstaller编译后运行不了，另外：安装pipreqs太多异常。

将代码上传到centos目录，然后安装pipreqs、生成requirements.txt

pip install pipreqs -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com

上面安装一直失败，最后通过如下命令安装成功

conda install -c conda-forge pyzmq pipreqs

4、编译python项目

pip install -r requirements.txt -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com
pyinstaller -D main.py

编译后会产生dist和build目录，其中dist目录才是运行文件的目录

三、docker镜像制作

1、查询应用依赖

ldd ./dist/main

显示如下

linux-vdso.so.1 => (0x00007ffe6a9c5000) 
libdl.so.2 => /lib64/libdl.so.2 (0x00007f0b2eb67000)
libz.so.1 => /lib64/libz.so.1 (0x00007f0b2e951000)
libpthread.so.0 => /lib64/libpthread.so.0 (0x00007f0b2e735000)
libc.so.6 => /lib64/libc.so.6 (0x00007f0b2e367000)
/lib64/ld-linux-x86-64.so.2 (0x00007f0b2ed6b000)

3、查找libpython3.11.so.1.0依赖

存在_internal目录，是因为pyinstaller打包时采用 -D，而不是 -F。

ldd ./dist/_internal/libpython3.11.so.1.0

显示如下

	linux-vdso.so.1 =>  (0x00007ffc975f0000)
	libpthread.so.0 => /lib64/libpthread.so.0 (0x00007f2d8286f000)
	libdl.so.2 => /lib64/libdl.so.2 (0x00007f2d8266b000)
	libutil.so.1 => /lib64/libutil.so.1 (0x00007f2d82468000)
	libm.so.6 => /lib64/libm.so.6 (0x00007f2d82166000)
	libc.so.6 => /lib64/libc.so.6 (0x00007f2d81d98000)
	/lib64/ld-linux-x86-64.so.2 (0x00007f2d83056000)

4、制作Dockerfile

# 使用轻量级基础镜像
FROM alpine:3.18
#FROM scratch，如果用这个，则后面的RUN chmod +x /app/main会报如下错误
#runc run failed: unable to start container process: exec: "/bin/sh": stat /bin/sh: no such file or directory

# 创建库文件目录
WORKDIR /lib64/

# 从 CentOS 7 镜像复制关键库文件
# ldd ./dist/main的依赖
COPY --from=centos:7 /lib64/libdl.so.2 /lib64/libdl.so.2
COPY --from=centos:7 /lib64/libz.so.1 /lib64/libz.so.1
COPY --from=centos:7 /lib64/libpthread.so.0 /lib64/libpthread.so.0
COPY --from=centos:7 /lib64/libc.so.6 /lib64/libc.so.6
COPY --from=centos:7 /lib64/ld-linux-x86-64.so.2 /lib64/ld-linux-x86-64.so.2

#ldd ./dist/_internal/libpython3.11.so.1.0的依赖
COPY --from=centos:7 /lib64/libutil.so.1 /lib64/libutil.so.1
COPY --from=centos:7 /lib64/libm.so.6 /lib64/libm.so.6
COPY --from=centos:7 /lib64/libc.so.6 /lib64/libc.so.6

#其他依赖
#如果没有此句，则在启动容器时会报如下错误
#ImportError: librt.so.1: cannot open shared object file: No such file or directory
COPY --from=centos:7 /lib64/librt.so.1 /lib64/librt.so.1

# 设置动态库搜索路径
ENV LD_LIBRARY_PATH=/lib64

# 复制打包好的可执行文件
COPY dist/ /app/
RUN chmod +x /app/main

# 设置工作目录和启动命令
WORKDIR /app

# 设置入口点
ENTRYPOINT ["/app/main"]

5、制作docker-compose.yml

version: '3.8'

services:
  mytest:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: mytest   
    ports:
      - '6080:6080'
    volumes:
      - ./log:/app/log:rw  # 挂载宿主机 log 目录到容器
      - ./template:/app/template:ro  # 挂载宿主机 template 目录到容器     
    environment:
      - TZ=Asia/Shanghai  # 可选：设置时区

6、构建并启动服务

docker-compose up -d --build

四、改进

（1）容器后台运行及支持bash

docker-compose.yml

version: '3.8'

services:
  mytest:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: mytest   
    ports:
      - '6080:6080'
    volumes:
      - ./log:/app/log:rw  # 挂载宿主机 log 目录到容器
      - ./template:/app/template:ro  # 挂载宿主机 template 目录到容器        
    environment:
      - TZ=Asia/Shanghai  # 可选：设置时区

Dockerfile

# 使用轻量级基础镜像
FROM alpine:3.18
#FROM scratch，如果用这个，则后面的RUN chmod +x /app/main会报如下错误
#runc run failed: unable to start container process: exec: "/bin/sh": stat /bin/sh: no such file or directory

# 使用 Alpine 自带的 libz（删除从 CentOS 复制的 libz.so.1）,会安装在 /lib
RUN apk add --no-cache zlib

# 创建软链接，让程序在 /lib64 也能找到 libz.so.1
RUN mkdir -p /lib64 && ln -s /lib/libz.so.1 /lib64/libz.so.1

# 创建库文件目录
WORKDIR /lib64/

# 从 CentOS 7 镜像复制关键库文件
# ldd ./dist/main的依赖
COPY --from=centos:7 /lib64/libdl.so.2 /lib64/libdl.so.2
###COPY --from=centos:7 /lib64/libz.so.1 /lib64/libz.so.1
COPY --from=centos:7 /lib64/libpthread.so.0 /lib64/libpthread.so.0
COPY --from=centos:7 /lib64/libc.so.6 /lib64/libc.so.6
COPY --from=centos:7 /lib64/ld-linux-x86-64.so.2 /lib64/ld-linux-x86-64.so.2

#ldd ./dist/_internal/libpython3.11.so.1.0的依赖
COPY --from=centos:7 /lib64/libutil.so.1 /lib64/libutil.so.1
COPY --from=centos:7 /lib64/libm.so.6 /lib64/libm.so.6
COPY --from=centos:7 /lib64/libc.so.6 /lib64/libc.so.6

#其他依赖
#如果没有此句，则在启动容器时会报如下错误
#ImportError: librt.so.1: cannot open shared object file: No such file or directory
COPY --from=centos:7 /lib64/librt.so.1 /lib64/librt.so.1

# 设置动态库搜索路径（包含 /lib 和 /lib64）
ENV LD_LIBRARY_PATH=/lib64:/lib

# 安装bash（如需）
RUN apk add --no-cache bash

# 复制打包好的可执行文件
COPY dist/ /app/
RUN chmod +x /app/main

# 设置工作目录和启动命令
WORKDIR /app

# 设置入口点
ENTRYPOINT ["/app/main", "--daemon"]

（2）多阶段构建（一战式构建）

docker-compose.yml

version: '3.8'

services:
  mytest:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: mytest   
    ports:
      - '6080:6080'
    volumes:
      - ./log:/app/log:rw  # 挂载宿主机 log 目录到容器
      - ./template:/app/template:ro  # 挂载宿主机 template 目录到容器        
    environment:
      - TZ=Asia/Shanghai  # 可选：设置时区

Dockerfile

# 第一阶段：构建
FROM python:3.11-alpine as builder

# 安装系统依赖
RUN apk add --no-cache \
    build-base \
    zlib-dev \
    libffi-dev \
    openssl-dev \
    mariadb-connector-c-dev \
    pkgconfig \
    mariadb-dev 

# 安装Python依赖
WORKDIR /build

# 安装依赖
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt && \
    pip install pyinstaller

# 复制源码并打包（关键修改）
COPY . .
RUN pyinstaller \
    --onefile \
    --add-binary /usr/local/lib/libpython3.11.so.1.0:. \
    --runtime-tmpdir . \
    main.py

# 第二阶段：运行时
FROM python:3.11-alpine
RUN apk add --no-cache \
    libstdc++ \
    gcompat \
    libc6-compat \
    mariadb-connector-c

COPY --from=builder /build/dist/main /app/main
COPY --from=builder /usr/local/lib/libpython3.11.so.1.0 /app/

# 安装bash（如需）,以便进入容器可以执行bash命令
RUN apk add --no-cache bash

ENV LD_LIBRARY_PATH=/app
WORKDIR /app
RUN chmod +x main

# 让容器后台进程运行
ENTRYPOINT ["/app/main", "--daemon"]

五、分发

#导出镜像
docker save test -o test.img

#在另外的服务器导入镜像
docker load -i test.img

#启动镜像
docker run -d -p 6080:6080 --name mytest_docker\
  -v ./log:/app/log:rw \
  -v ./template:/app/template:ro \
  test