aitsc/docs/deployment/Gunicorn服务管理指南.md

Gunicorn服务管理指南

概述

本文档介绍如何使用Gunicorn管理Flask提示词大师应用的生产环境服务。

环境信息

• Python版本: 3.12.7
• Conda环境: myenv
• 项目路径: /home/renjianbo/aitsc
• 服务端口: 5002
• 外网地址: http://101.43.95.130:5002

快速启动命令

一键启动脚本

# 进入项目目录
cd /home/renjianbo/aitsc

# 激活conda环境并启动服务
eval "$(/home/renjianbo/miniconda3/bin/conda shell.bash hook)" && conda activate myenv && gunicorn -c gunicorn.conf.py run_dev:app

后台启动

# 后台启动服务
cd /home/renjianbo/aitsc
eval "$(/home/renjianbo/miniconda3/bin/conda shell.bash hook)" && conda activate myenv && nohup gunicorn -c gunicorn.conf.py run_dev:app > logs/gunicorn.log 2>&1 &

服务管理命令

1. 启动服务

# 方法1: 直接启动
cd /home/renjianbo/aitsc
eval "$(/home/renjianbo/miniconda3/bin/conda shell.bash hook)" && conda activate myenv && gunicorn -c gunicorn.conf.py run_dev:app

# 方法2: 后台启动
cd /home/renjianbo/aitsc
eval "$(/home/renjianbo/miniconda3/bin/conda shell.bash hook)" && conda activate myenv && nohup gunicorn -c gunicorn.conf.py run_dev:app > logs/gunicorn.log 2>&1 &

2. 停止服务

# 方法1: 使用PID文件停止
kill -TERM $(cat logs/gunicorn.pid)

# 方法2: 强制停止
kill -9 $(cat logs/gunicorn.pid)

# 方法3: 查找进程并停止
ps aux | grep gunicorn | grep -v grep | awk '{print $2}' | xargs kill -TERM

3. 重启服务

# 方法1: 优雅重启（推荐）
kill -HUP $(cat logs/gunicorn.pid)

# 方法2: 停止后重新启动
kill -TERM $(cat logs/gunicorn.pid) && sleep 3 && eval "$(/home/renjianbo/miniconda3/bin/conda shell.bash hook)" && conda activate myenv && gunicorn -c gunicorn.conf.py run_dev:app

4. 查看服务状态

# 查看进程状态
ps aux | grep gunicorn | grep -v grep

# 查看端口监听状态
ss -tlnp | grep :5002

# 查看PID文件
cat logs/gunicorn.pid

5. 查看日志

# 查看访问日志
tail -f logs/gunicorn_access.log

# 查看错误日志
tail -f logs/gunicorn_error.log

# 查看应用日志
tail -f logs/app.log

# 查看实时日志
tail -f logs/gunicorn.log

服务配置

Gunicorn配置文件

配置文件位置: gunicorn.conf.py

主要配置项:

• 端口: 5002
• 工作进程数: CPU核心数 × 2 + 1
• 每个进程连接数: 1000
• 超时时间: 30秒
• 日志级别: info

环境变量

# 设置环境变量
export FLASK_ENV=production
export SECRET_KEY="your-production-secret-key"
export LLM_API_KEY="your-api-key"

故障排除

1. 服务无法启动

# 检查端口是否被占用
ss -tlnp | grep :5002

# 检查日志文件
cat logs/gunicorn_error.log

# 检查Python环境
python --version
pip list | grep gunicorn

2. 服务响应慢

# 检查系统资源
top
free -h
df -h

# 检查进程状态
ps aux | grep gunicorn

3. 端口访问失败

# 检查防火墙
sudo firewall-cmd --list-ports

# 开放端口
sudo firewall-cmd --add-port=5002/tcp --permanent
sudo firewall-cmd --reload

性能监控

1. 系统资源监控

# CPU和内存使用情况
top -p $(cat logs/gunicorn.pid)

# 网络连接数
ss -s | grep tcp

2. 应用性能监控

# 查看请求统计
tail -f logs/gunicorn_access.log | grep -E "(GET|POST)"

# 查看响应时间
tail -f logs/gunicorn_access.log | awk '{print $NF}'

自动化脚本

启动脚本 (start_gunicorn.sh)

#!/bin/bash
cd /home/renjianbo/aitsc
eval "$(/home/renjianbo/miniconda3/bin/conda shell.bash hook)"
conda activate myenv
export FLASK_ENV=production
gunicorn -c gunicorn.conf.py run_dev:app

停止脚本 (stop_gunicorn.sh)

#!/bin/bash
cd /home/renjianbo/aitsc
kill -TERM $(cat logs/gunicorn.pid)
echo "Gunicorn服务已停止"

重启脚本 (restart_gunicorn.sh)

#!/bin/bash
cd /home/renjianbo/aitsc
kill -TERM $(cat logs/gunicorn.pid)
sleep 3
eval "$(/home/renjianbo/miniconda3/bin/conda shell.bash hook)"
conda activate myenv
export FLASK_ENV=production
gunicorn -c gunicorn.conf.py run_dev:app

常用命令速查

操作	命令
启动服务	eval "$(/home/renjianbo/miniconda3/bin/conda shell.bash hook)" && conda activate myenv && gunicorn -c gunicorn.conf.py run_dev:app
停止服务	kill -TERM $(cat logs/gunicorn.pid)
重启服务	kill -HUP $(cat logs/gunicorn.pid)
查看状态	`ps aux
查看端口	ss -tlnp | grep :5002
查看日志	tail -f logs/gunicorn_access.log
测试访问	curl http://localhost:5002/

注意事项

1. 环境激活: 每次操作前必须激活conda环境
2. 端口冲突: 确保5002端口未被其他服务占用
3. 权限问题: 确保有logs目录的写入权限
4. 防火墙: 确保5002端口在防火墙中开放
5. 日志轮转: 定期清理日志文件避免磁盘空间不足

联系信息

如有问题，请查看日志文件或联系系统管理员。