CentOS 系统下 Python 环境搭建与生产部署实战指南

sudo yum install centos-release-scl
sudo yum install rh-python38
scl enable rh-python38 bash

2. 包管理与虚拟环境

2.1 pip 的权限陷阱

直接在系统上用 sudo pip install 是大忌，容易污染环境。推荐用 --user 参数安装到当前用户目录，或者干脆进虚拟环境玩。

国内网络访问 PyPI 慢？配置个镜像源，清华或阿里云的都行：

pip3.12 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

2.2 虚拟环境最佳实践

项目依赖冲突是常态，venv 是标配。创建、激活一气呵成：

python3.12 -m venv my_project_env
source my_project_env/bin/activate
pip install django

激活后提示符会变，这时候装的包只在这个环境里生效。需求文件 requirements.txt 一定要管好，方便迁移：

pip freeze > requirements.txt
pip install -r requirements.txt

2.3 依赖兼容性与目录结构

有时候系统库太老，包编译不过，试试从源码编译：

pip install --no-binary :all: package_name

了解虚拟环境的目录结构很有用，特别是 site-packages 在哪，调试导入问题时能省不少心。

3. 模块导入与路径问题

3.1 搜索路径机制

Python 找模块是有顺序的，脚本所在目录优先，然后是 PYTHONPATH，最后是标准库。遇到 ModuleNotFoundError，先打印 sys.path 看看：

import sys
print(sys.path)

3.2 常见错误排查

大小写敏感、环境不对、权限不足，都是常见原因。特别是自定义安装的 Python，站点包路径可能在 /usr/local/lib/python3.12/site-packages/，跟系统自带的 /usr/lib/python2.7/site-packages/ 不一样，别搞混了。

3.3 路径配置技巧

临时加路径用 export PYTHONPATH=...，永久加就改 ~/.bashrc。或者在 site-packages 里放 .pth 文件批量添加路径。开发项目建议用 -e 模式安装，代码改了立马生效：

pip install -e .

4. 权限与安全性

4.1 文件系统与用户权限

Linux 权限严格，脚本得有执行权限，数据目录得有写入权限。别用 root 跑应用，创建一个专用用户最安全：

sudo adduser --system --no-create-home myappuser
sudo chown myappuser:myappgroup /var/lib/myapp

4.2 SELinux 与防火墙

SELinux 可能会拦路，查日志看拒绝信息：

sudo ausearch -m avc -ts recent

必要时调整上下文或策略。防火墙方面，CentOS 7+ 用 firewalld，开放必要端口：

sudo firewall-cmd --permanent --add-port=5000/tcp
sudo firewall-cmd --reload

4.3 敏感信息管理

密码别硬编码，走环境变量。配置文件权限设严点，chmod 600 起步。

5. 系统工具兼容性

5.1 别碰系统 Python

yum、dnf 依赖特定 Python 版本。修改符号链接 /usr/bin/python 可能导致系统崩溃。坚持用 altinstall，保持系统 Python 原样。

5.2 容器化隔离

实在怕搞坏系统，就用 Docker 或 Podman。把 Python 环境和依赖打包进去，跟宿主机彻底隔离：

FROM centos:7
RUN yum install -y gcc openssl-devel && \
    curl -O https://www.python.org/ftp/python/3.12.2/Python-3.12.2.tgz && \
    tar xzf Python-3.12.2.tgz && \
    cd Python-3.12.2 && ./configure --enable-optimizations && make altinstall
WORKDIR /app
COPY . .
RUN python3.12 -m pip install -r requirements.txt
CMD ["python3.12", "app.py"]

6. 高级部署与优化

6.1 WSGI 与 Nginx

开发服务器不能上生产，换 Gunicorn 吧：

pip install gunicorn
gunicorn --bind 0.0.0.0:5000 --workers 4 app:app

配合 Nginx 做反向代理，处理静态文件和负载均衡，配置好 proxy_set_header 让后端知道真实 IP。

6.2 Systemd 服务管理

用 systemd 管理进程，开机自启，挂了自动重启：

[Unit]
Description=Python Web Application
After=network.target

[Service]
User=myappuser
WorkingDirectory=/opt/myapp
ExecStart=/opt/myapp/venv/bin/gunicorn --workers 4 --bind 0.0.0.0:5000 app:app
Restart=always

[Install]
WantedBy=multi-user.target

6.3 监控与日志

Prometheus 抓指标，结构化日志方便分析。日志轮转用 logrotate，别让磁盘爆满。

6.4 安全加固

最小权限原则，定期更新系统补丁，扫描漏洞。网络层面限制 SSH 来源，只开业务端口。

搞定这些，你的 Python 应用在 CentOS 上就能稳稳当当跑起来了。