Python + Streamlit项目部署方案超详细教程(非Docker版)

更新时间：2025年11月28日 11:26:27 作者：Tizzy JJ

Streamlit是一款强大的Python框架,专为机器学习及数据可视化打造,这篇文章主要介绍了Python + Streamlit项目部署方案(非Docker版)的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下

一、针对 Alibaba Cloud Linux/CentOS 系统的完整部署方案

1. 服务器基础配置（阿里云ECS）

# 更新系统
sudo yum update -y

# 安装基础工具
sudo yum install -y git wget vim python3 python3-pip python3-devel gcc make

# 安装Streamlit系统依赖
sudo yum install -y libXext libSM libXrender

# 安装Node.js（用于Streamlit监控）
curl -sL https://rpm.nodesource.com/setup_16.x | sudo bash -
sudo yum install -y nodejs

# 安装Firewalld防火墙（如果未安装）
sudo yum install -y firewalld
sudo systemctl start firewalld
sudo systemctl enable firewalld

2. 获取项目代码

# 克隆您的Gitee仓库
git clone https://gitee.com/您的用户名/case.git
cd case

# 切换到doc分支
git checkout doc

3. 创建Python虚拟环境

# 安装虚拟环境工具
python3 -m pip install virtualenv

# 创建虚拟环境
python3 -m virtualenv venv

# 激活虚拟环境
source venv/bin/activate

# 验证环境（应显示Python 3.x）
python --version

4. 安装项目依赖

# 更新pip
pip install --upgrade pip

# 设置国内镜像源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# 安装依赖
pip install -r requirements.txt

# 额外安装Streamlit（确保版本兼容）
pip install streamlit==1.25.0

5. 配置环境变量（如有）

创建环境变量文件：

nano .env

写入内容：

export DEEPSEEK_API_KEY="sk-510d447cc2da4ae39a9807d6"
# 添加其他需要设置的环境变量

加载环境变量：

# 临时生效
source .env

# 永久生效（添加到shell配置文件）
echo "source /opt/casegenerate/.env" >> ~/.bashrc
source ~/.bashrc

6. 测试应用运行

# 手动启动测试
streamlit run app.py --server.port=8501

# 测试访问（新开终端）
curl http://localhost:8501
# 按CTRL+C停止服务

# 若阿里云端口已开放，也可以直接从浏览器进入

7. 创建Systemd服务（后台运行）

创建服务文件：

sudo nano /etc/systemd/system/case.service

添加以下内容，根据项目实际路径调整：

[Unit]
Description=Case Streamlit App
After=network.target

[Service]
User=root
WorkingDirectory=/opt/case  # 修改为您的实际路径
Environment="PATH=/opt/case/venv/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin"
EnvironmentFile=/opt/case/.env
ExecStart=/opt/case/venv/bin/streamlit run app.py --server.port=8501 --server.headless=true --server.enableCORS=false
Restart=always
RestartSec=3

[Install]
WantedBy=multi-user.target

启用服务：

# 重新加载服务配置
sudo systemctl daemon-reload

# 启动服务
sudo systemctl start case

# 设置开机自启
sudo systemctl enable case

# 查看服务状态
sudo systemctl status case

8. 配置Nginx反向代理（可选）

# 安装Nginx
sudo yum install -y nginx

# 创建配置
sudo nano /etc/nginx/conf.d/case.conf

内容：

upstream streamlit_app {
    server 127.0.0.1:8501;
}

server {
    listen 80;
    server_name yourdomain.com; # 替换为您的域名

    access_log /var/log/nginx/case.access.log;
    error_log /var/log/nginx/case.error.log;

    location / {
        proxy_pass http://streamlit_app;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_read_timeout 86400;
    }
}

应用配置：

# 测试配置
sudo nginx -t

# 重启Nginx
sudo systemctl restart nginx

# 设置开机自启
sudo systemctl enable nginx

9. 阿里云安全组配置

登录阿里云控制台 → ECS → 安全组
添加规则：
- 方向：入方向
- 协议类型：TCP
- 端口范围：80
- 授权对象：0.0.0.0/0
保存规则

10. 域名配置

在域名控制台添加A记录：
- 记录类型：A
- 主机记录：@ 或子域名
- 记录值：服务器公网IP
TTL：10分钟

11. 测试访问

浏览器访问：http://yourdomain.com

12.维护与管理

第一步：更新项目代码

1. 拉取最新代码

# 进入项目目录
cd /root/case

# 切换到开发分支（假设您的开发分支是 doc）
git checkout doc

# 拉取最新代码
git fetch origin
git reset --hard origin/doc
git clean -fd

2、更新依赖，如果有需要

# 激活虚拟环境
source venv38/bin/activate

# 安装新依赖
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/

第二步：更新环境变量

方法 1：直接修改服务文件（推荐）

# 编辑服务文件
sudo nano /etc/systemd/system/case.service

修改环境变量保存后执行

# 重新加载服务配置
sudo systemctl daemon-reload

# 重启服务使新变量生效
sudo systemctl restart case

方法 2：修改 .env 文件（如果代码中使用 load_dotenv）

# 编辑 .env 文件
nano /root/case/.env

修改后，重启服务

sudo systemctl restart case

第三步：重启服务

# 安全重启服务
sudo systemctl restart case

# 验证状态
sudo systemctl status case

tips：如果环境变量要更新DEEPSEEK_API_KEY，方法1和方法2任选其一都可以解决，如果同时使用两种方法，服务文件中的环境变量会覆盖.env文件中的变量。建议只使用一种方法。

二、部署过程遇到的问题记录

1.有些依赖需要额外安装

激活虚拟环境并安装验证：

# 进入项目目录
cd /root/case

# 激活虚拟环境
source venv/bin/activate

# 1.安装 aiohttp（使用阿里云镜像加速）
pip install aiohttp==3.8.6 -i https://mirrors.aliyun.com/pypi/simple/

# 检查是否安装成功
pip show aiohttp

# 在 Python 中测试
python -c "import aiohttp; print(aiohttp.__version__)"
# 应该输出：3.8.6

# 2.安装 python-dotenv（使用阿里云镜像加速）
pip install python-dotenv==1.0.0 -i https://mirrors.aliyun.com/pypi/simple/


# 检查是否安装成功
pip show python-dotenv

# 在 Python 中测试
python -c "from dotenv import load_dotenv; print('dotenv installed successfully')"

# 3.安装 PyMuPDF（包含 fitz 模块）
pip install PyMuPDF==1.23.21 -i https://mirrors.aliyun.com/pypi/simple/

# 检查是否安装成功
pip show PyMuPDF

# 在 Python 中测试
python -c "import fitz; print('fitz version:', fitz.__doc__.split('\n')[0])"
# 应该输出类似：fitz version: PyMuPDF 1.23.21: Python bindings for MuPDF's library

# 4.安装 openpyxl（使用阿里云镜像加速）
pip install openpyxl==3.1.2 -i https://mirrors.aliyun.com/pypi/simple/

# 检查是否安装成功
pip show openpyxl

# 在 Python 中测试
python -c "import openpyxl; print('openpyxl version:', openpyxl.__version__)"
# 应该输出：openpyxl version: 3.1.2

# 升级 streamlit
pip install streamlit==1.25.0 -i https://mirrors.aliyun.com/pypi/simple/

streamlit --version
# 应该输出：Streamlit, version 1.25.0

2.在 nano 编辑器中怎么保存和退出

当您使用 sudo nano /etc/systemd/system/case.service 编辑文件后，以下是保存并退出的详细步骤：

编辑完成后：
- 使用方向键在文件中移动
- 确保所有内容正确无误
保存文件：
- 按下 Ctrl + O（按住 Ctrl 键，然后按 O 键）
- 屏幕底部会显示：File Name to Write: /etc/systemd/system/case.service
- 按 Enter 键确认保存
退出编辑器：
- 按下 Ctrl + X（按住 Ctrl 键，然后按 X 键）
- 如果文件已修改但未保存，会询问是否保存：

退出编辑器后，验证文件内容：

sudo cat /etc/systemd/system/case.service

应该显示类似内容：

[Unit]
Description=Case Streamlit App
After=network.target

[Service]
User=root
WorkingDirectory=/root/case
Environment="PATH=/root/case/venv38/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin"
Environment="DEEPSEEK_API_KEY=sk-510d447cc2da9807d6"
ExecStart=/root/case/venv38/bin/streamlit run app.py --server.port=8501 --server.address=0.0.0.0
Restart=always
RestartSec=3

[Install]
WantedBy=multi-user.target

保存文件后，执行以下命令使服务生效：

# 重新加载服务配置
sudo systemctl daemon-reload

# 启动服务
sudo systemctl start case

# 设置开机自启
sudo systemctl enable case

# 检查状态
sudo systemctl status case

3.遇到nano: command not found错误

安装nano编辑器

# 安装 nano
sudo yum install -y nano

# 验证安装
nano --version

4. http://xxx25.2:8501访问不了，阿里云要怎么添加8501端口

步骤 1：登录阿里云控制台

访问阿里云官网并登录
进入 控制台

步骤 2：找到您的 ECS 实例

在控制台首页，点击 产品与服务 > 云计算基础服务 > 云服务器 ECS
在实例列表中找到您的服务器（如 iZ7xvyay73qoZ）

步骤 3：配置安全组

在实例列表中，找到您的实例，点击右侧的更多 > 网络和安全组 > 安全组配置
或者，在实例详情页，点击 安全组 标签页

步骤 4：添加安全组规则

在安全组规则页面，点击 配置规则
在 入方向 标签页，点击 手动添加
填写规则：
- 授权策略：允许
- 协议类型：自定义 TCP
- 端口范围：8501/8501
- 授权对象：0.0.0.0/0（表示允许所有IP访问）
点击保存

步骤 5：验证安全组规则

在安全组规则列表中，您应该能看到一条类似这样的规则：

授权策略	协议类型	端口范围	授权对象	优先级
允许	自定义TCP	8501	0.0.0.0/0	1

如果仍然无法访问？

检查 1：服务器防火墙

阿里云 ECS 默认没有启用防火墙，但如果您手动启用了，需要检查：

# 查看防火墙状态
sudo systemctl status firewalld

# 如果防火墙开启，添加端口
sudo firewall-cmd --zone=public --add-port=8501/tcp --permanent
sudo firewall-cmd --reload

检查 2：端口监听状态

在服务器上执行：

netstat -tuln | grep 8501

应该显示：

tcp6       0      0 :::8501                 :::*                    LISTEN

检查 3：使用 telnet 测试端口

在您的本地电脑上（不是服务器）执行：

telnet 8xxx25.2 8501

如果端口开放，应该看到：

Trying 8.1xxx5.2...
Connected to 8.xxx.2.
Escape character is '^]'.

5.在服务器上更新开发分支的新代码

在服务器上更新开发分支的新代码，分为两种情况操作

情况1：已在开发分支但需要更新

# 1. 进入项目目录
cd /root/case

# 2. 检查当前所在分支
git branch  # 确认您在开发分支上（如 doc）

# 3. 从远程拉取最新变更
git fetch --all

# 4. 重置到远程分支最新状态（强制更新）
git reset --hard origin/doc  # 将 doc 替换为您的分支名

# 5. 清理未被跟踪的文件
git clean -fd

情况2：需要切换到其他开发分支

# 1. 进入项目目录
cd /root/case

# 2. 查看所有可用分支
git branch -a

# 3. 切换到新的开发分支
git checkout -b feature/new-feature origin/feature/new-feature

# 4. 或者强制切换到已存在的分支
git checkout -f doc

总结

到此这篇关于Python + Streamlit项目部署方案(非Docker版)的文章就介绍到这了,更多相关Python Streamlit项目部署内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

浅谈pycharm使用及设置方法
这篇文章主要介绍了浅谈pycharm使用及设置方法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2019-09-09
python模块之re正则表达式详解
正则表达式是一种小型的、高度专业化的编程语言，并不是python中特有的，是许多编程语言中基础而又重要的一部分。在python中，主要通过re模块来实现。这篇文章主要介绍了python模块之re正则表达式详解,需要的朋友可以参考下
2017-02-02
python3.6环境下安装freetype库和基本使用方法(推荐)
这篇文章主要介绍了python3.6环境下如何安装freetype库和基本使用方法,本文通过示例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2020-05-05
python3中编码获取网页的实例方法
在本篇文章里小编给大家整理了一篇关于python3中编码获取网页的实例方法，有兴趣的朋友们可以学习下。
2020-11-11
Python办公自动化处理的10大场景应用示例
这篇文章主要为大家介绍了Python办公自动化处理的10大场景应用示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-06-06
Python+Selenium实现在Geoserver批量发布Mongo矢量数据
这篇文章主要为大家详细介绍了如何利用Python+Selenium实现在 Geoserver批量发布来自Mongo中的矢量数据，文中的示例代码讲解详细，感兴趣的小伙伴可以了解一下
2022-07-07
基于Python实现PDF批量转化工具
这篇文章主要为大家详细介绍了如何基于Python制作一个PDF批量转化工具,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
2024-12-12
python图形开发GUI库pyqt5的基本使用方法详解
这篇文章主要介绍了python图形开发GUI库pyqt5的基本使用方法详解,需要的朋友可以参考下
2020-02-02
opencv python在视屏上截图功能的实现
OpenCV是一个基于BSD许可（开源）发行的跨平台计算机视觉库，可以运行在Linux、Windows、Android和Mac OS操作系统上。这篇文章主要介绍了opencv python在视屏上截图,需要的朋友可以参考下
2020-03-03
使用python解决化学问题的实用指南
在当今科学技术迅速发展的时代,计算机科学与各个学科的结合愈发紧密,尤其是在化学领域,本博文旨在探讨如何利用Python解决一些常见的化学问题,包括构建分子式、判断化合价、解析分子式、平衡化学反应方程式以及计算化合物的摩尔质量等,需要的朋友可以参考下
2024-10-10