云服务器Flask应用自动部署脚本实战指南

开发完Flask应用后如何高效部署到云服务器？手动登录服务器拉代码、装依赖、重启应用这些重复操作，不仅浪费时间还容易出错。今天就用实战案例带大家打造一套Flask应用自动部署脚本，从脚本编写到定时任务配置，手把手解决部署痛点。

为什么开发者需要自动部署脚本？

我之前做项目时深有体会：每次代码提交后，得先SSH登录云服务器，然后git pull拉取最新代码，检查虚拟环境是否正常，再pip安装依赖，最后杀掉旧进程重启应用。遇到依赖版本冲突时，排查半小时是常事。有次赶上线急着部署，手滑输错命令导致应用崩溃，最后熬夜修复的经历至今难忘。

自动部署脚本就像24小时在线的运维小助手，把这些重复操作写成程序指令，每次代码更新只需执行脚本，甚至设置定时任务后完全不用管。不仅能避免人为操作失误，还能把原本30分钟的部署流程压缩到3分钟，开发效率直接翻倍。

部署前的3个关键准备

在写脚本前，云服务器需要先完成基础配置：

• 安装Python3（建议3.8以上版本）和Git工具（用于代码拉取）


• 创建存放Flask应用的目录（比如/home/user/flask_app）


• 代码托管到Git仓库（本地或远程仓库均可，脚本需能访问）

特别提醒：云服务器的安全组要开放应用使用的端口（如Flask默认的5000端口），避免部署后无法访问。

手把手写自动部署脚本

这里用Bash脚本实现，核心逻辑是拉取最新代码→管理虚拟环境→安装依赖→重启应用。以下是实测可用的脚本：

#!/bin/bash

# 定义应用根目录（根据实际路径修改）
APP_DIR="/home/user/flask_app"

# 进入应用目录（关键步骤，确保后续操作路径正确）
cd $APP_DIR || { echo "目录不存在"; exit 1; }

# 拉取Git仓库最新代码（假设主分支是main）
echo "正在拉取最新代码..."
git pull origin main

# 检查并创建虚拟环境（隔离项目依赖）
if [ ! -d "venv" ]; then
    echo "创建虚拟环境..."
    python3 -m venv venv
fi

# 激活虚拟环境（必须操作，否则依赖安装到全局）
source venv/bin/activate

# 安装/更新依赖（根据requirements.txt）
echo "安装项目依赖..."
pip install --upgrade -r requirements.txt

# 优雅停止旧进程（避免端口占用）
echo "停止旧应用进程..."
pkill -f "python app.py"

# 后台启动新应用（nohup防止SSH断开后进程终止）
echo "启动新应用..."
nohup python app.py > app.log 2>&1 &

echo "部署完成！当前时间：$(date)"

脚本关键步骤解析

- `cd $APP_DIR || exit`：如果目录不存在直接终止，避免后续操作出错
- `git pull`：自动同步最新代码，比手动操作更可靠
- 虚拟环境管理：隔离项目依赖，防止不同项目版本冲突
- `pkill -f`：通过进程名精准停止旧应用，比查PID更简单
- `nohup`：后台运行并将日志输出到app.log，方便排查问题

脚本使用与定时部署

把脚本保存为`deploy.sh`后，先赋予执行权限：

chmod +x deploy.sh

测试部署时直接运行：

./deploy.sh

如果想实现定时自动部署（比如代码每天凌晨自动更新），可以用Linux的cron（定时任务工具）。执行`crontab -e`打开任务表，添加：

0 2 * * * /home/user/flask_app/deploy.sh >> /var/log/flask_deploy.log 2>&1

这条命令表示每天凌晨2点执行部署脚本，并将日志输出到/var/log/flask_deploy.log（方便后续查看执行记录）。

部署后的注意事项

- 定期检查`app.log`和`flask_deploy.log`，及时发现依赖安装失败、端口被占用等问题
- 如果Git仓库需要认证，建议配置SSH密钥免密登录，避免脚本执行时卡输入密码
- 生产环境建议用Gunicorn等WSGI服务器替代直接运行app.py，提升应用稳定性

用这套脚本后，我团队的Flask应用部署时间从平均30分钟降到3分钟，半年内没再出现人为操作导致的部署事故。选对云服务器+用好自动部署脚本，真的能让开发工作轻松很多——毕竟，把时间花在代码优化上，比重复部署更有价值。