把整个flask项目部署到linux服务器

分类：技术教程发布时间：2025-10-03 15:12 阅读：25

案例一

这是一个Flask应用程序，包含以下关键文件和目录：

- app.py - 主应用程序文件
- models.py - 数据模型
- requirements.txt - 项目依赖
- templates/ - HTML模板
- static/ - 静态资源
- lottery.db - SQLite数据库

## 一、系统要求
- Linux服务器（推荐Ubuntu 20.04或CentOS 7/8）
- Python 3.8或更高版本
- 网络连接
- 基本的Linux命令知识
## 二、准备Linux环境
### 1. 更新系统包
```
# Ubuntu/Debian系统
sudo apt update && sudo apt upgrade -y

# CentOS/RHEL系统
sudo yum update -y
```
### 2. 安装必要的软件包
```
# Ubuntu/Debian系统
sudo apt install -y python3
python3-pip python3-venv git nginx
curl

# CentOS/RHEL系统
sudo yum install -y python3
python3-pip git nginx curl
```
## 三、克隆项目代码
```
# 创建项目目录
mkdir -p /var/www/lottery_app
cd /var/www/lottery_app

# 克隆项目代码（假设您的代码在Git仓库中）
git clone <您的项目Git地址> .

# 如果没有Git仓库，可以使用FTP/SCP等方式
上传代码
```
## 四、创建虚拟环境并安装依赖
```
# 在项目目录中创建虚拟环境
python3 -m venv venv

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

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

# 安装Gunicorn作为WSGI服务器
pip install gunicorn
```
## 五、配置环境变量
创建 .env 文件（如果不存在）或修改现有的环境变量配置：

```
# 在项目根目录创建.env文件
touch .env
nano .env
```
添加以下内容（根据实际情况修改）：

```
SECRET_KEY=your_secure_secret_key_here
DATABASE_URL=sqlite:////var/www/
lottery_app/lottery.db
```
## 六、准备数据库
```
# 激活虚拟环境
source venv/bin/activate

# 运行Python shell创建数据库表
python
```
在Python shell中执行：

```
from app import app, db
from models import Admin

with app.app_context():
    db.create_all()
    # 检查是否存在管理员账户，如果不存在则
    创建
    if not Admin.query.filter_by
    (username='admin').first():
        admin = Admin
        (username='admin')
        admin.set_password
        ('your_secure_password_here')
        db.session.add(admin)
        db.session.commit()

exit()
```
## 七、配置Gunicorn
### 1. 测试Gunicorn能否正常运行
```
source venv/bin/activate
gunicorn --bind 0.0.0.0:8000 app:app
```
如果一切正常，您应该能看到Gunicorn启动成功的信息。按 Ctrl+C 停止。

### 2. 创建Gunicorn配置文件
```
mkdir -p /var/www/lottery_app/logs
touch /var/www/lottery_app/
gunicorn_config.py
nano /var/www/lottery_app/
gunicorn_config.py
```
添加以下内容：

```
import multiprocessing
import os

# 绑定的地址和端口
bind = '127.0.0.1:8000'

# 工作进程数量
workers = multiprocessing.cpu_count()
* 2 + 1

# 工作方式
worker_class = 'sync'

# 每个工作进程的最大并发数
worker_connections = 1000

# 请求超时时间
timeout = 30

# 保持连接时间
keepalive = 2

# 日志文件
errorlog = '/var/www/lottery_app/logs/
gunicorn_error.log'
accesslog = '/var/www/lottery_app/
logs/gunicorn_access.log'

# 日志级别
loglevel = 'info'

# 进程ID文件
pidfile = '/var/www/lottery_app/
gunicorn.pid'
```
## 八、配置Systemd服务
创建Systemd服务文件，以便系统可以自动启动Gunicorn服务：

```
sudo nano /etc/systemd/system/
lottery_app.service
```
添加以下内容：

```
[Unit]
Description=Gunicorn instance to
serve lottery_app
After=network.target

[Service]
User=www-data
Group=www-data
WorkingDirectory=/var/www/lottery_app
Environment="PATH=/var/www/
lottery_app/venv/bin"
ExecStart=/var/www/lottery_app/venv/
bin/gunicorn -c gunicorn_config.py
app:app
Restart=on-failure

[Install]
WantedBy=multi-user.target
```
启用并启动服务：

```
sudo systemctl daemon-reload
sudo systemctl start lottery_app
sudo systemctl enable lottery_app
```
检查服务状态：
sudo systemctl status lottery_app

九、配置Nginx作为反向代理
1. 创建Nginx配置文件
sudo nano /etc/nginx/sites-available/lottery_app
添加以下内容（替换 your_domain.com 为您的域名或服务器IP）：
server {
listen 80;
server_name your_domain.com;

location / {
proxy_pass http://127.0.0.1:8000;
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;
}

location /static {
alias /var/www/lottery_app/static;
expires 30d;
}

location /uploads {
alias /var/www/lottery_app/static/uploads;
expires 30d;
}
}
2. 启用Nginx配置
sudo ln -s /etc/nginx/sites-available/lottery_app /etc/nginx/sites-enabled
sudo nginx -t # 测试配置是否正确
sudo systemctl restart nginx

十、配置文件权限
sudo chown -R www-data:www-data /var/www/lottery_app
sudo chmod -R 755 /var/www/lottery_app
sudo chmod -R 775 /var/www/lottery_app/static/uploads
sudo chmod -R 775 /var/www/lottery_app/backups

十一、配置防火墙
# Ubuntu/Debian系统
sudo ufw allow 'Nginx Full'
sudo ufw allow OpenSSH
sudo ufw enable

# CentOS/RHEL系统
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --permanent --add-service=ssh
sudo firewall-cmd --reload

十二、获取SSL证书（可选但推荐）
使用Let's Encrypt获取免费的SSL证书：
# 安装Certbot
sudo apt install certbot python3-certbot-nginx # Ubuntu/Debian
sudo yum install certbot python3-certbot-nginx # CentOS/RHEL

# 获取证书
sudo certbot --nginx -d your_domain.com

# 设置自动续期
sudo certbot renew --dry-run

十三、部署后的维护
1. 查看应用日志
tail -f /var/www/lottery_app/logs/gunicorn_error.log
tail -f /var/www/lottery_app/logs/gunicorn_access.log
sudo journalctl -u lottery_app
sudo journalctl -u nginx
2. 重启服务
sudo systemctl restart lottery_app
sudo systemctl restart nginx
3. 更新代码
cd /var/www/lottery_app
git pull
source venv/bin/activate
pip install -r requirements.txt
sudo systemctl restart lottery_app

十四、项目特性说明
## 十四、项目特性说明
部署完成后，您的Flask应用将包含以下功能：

1. 1.
黄历查询功能：通过 /huangli 路由访问，数据处理逻辑在前端JavaScript中实现
2. 2.
开奖结果展示：通过 /results 路由访问
3. 3.
新闻管理系统：包括新闻列表和详情页
4. 4.
后台管理中心：包含开奖设置、新闻管理、数据备份等功能
5. 5.
安全特性：包含CSRF保护、管理员认证等
通过以上步骤，您的Flask项目应该已经成功部署到Linux服务器上，并且可以通过您的域名或服务器IP地址访问。

----------------------------------------------------------------------------------------------------------

案例二

# Flask博客项目CentOS部署详细步骤

下面是将您的Flask博客项目部署到CentOS系统的完整步骤：

准备CentOS环境

更新系统包

# 更新系统包

sudo yum update -y

# 安装必要的系统依赖

sudo yum install -y gcc python3 python3-devel python3-pip nginx git

# 创建项目目录

sudo mkdir -p /var/www/blog

# 设置目录权限

sudo chown -R $USER:$USER /var/www/blog

# 克隆或上传项目代码到该目录

# 如果使用git：git clone <your-repo-url> /var/www/blog

# 或使用scp/sftp等工具上传项目文件

创建并激活Python虚拟环境

# 进入项目目录

cd /var/www/blog

# 创建虚拟环境

python3 -m venv venv

# 激活虚拟环境

source venv/bin/activate

# 升级pip

pip install --upgrade pip

安装项目依赖

# 安装项目依赖

pip install -r requirements.txt

# 安装WSGI服务器（用于生产环境）

pip install gunicorn

配置环境变量

# 在项目目录创建.env文件

cp .env.example .env # 如果没有.env.example，则直接创建.env

# 编辑.env文件，根据实际情况修改配置

nano .env

.env文件应包含以下关键配置（根据您的实际情况修改）：

# 邮件服务器配置

MAIL_SERVER=smtp.qq.com

MAIL_PORT=587

MAIL_USE_TLS=True

MAIL_USERNAME=your-email@qq.com

MAIL_PASSWORD=your-email-password

MAIL_DEFAULT_SENDER=your-email@qq.com

# 应用密钥（建议修改为随机生成的字符串）

SECRET_KEY=your-secure-secret-key

# 数据库配置（SQLite使用绝对路径）

DATABASE_URL=sqlite:///blog.db

初始化数据库

# 确保虚拟环境处于激活状态

# 运行Python交互环境

python

在Python交互环境中执行：

from app import app, db

with app.app_context():

db.create_all()

# 如果需要创建管理员用户，可以在这里添加代码

quit()

配置Gunicorn服务

# 创建Gunicorn配置文件

nano /var/www/blog/gunicorn_config.py

添加以下内容：

bind = '127.0.0.1:8000'

workers = 3

accesslog = '/var/log/blog/access.log'

errorlog = '/var/log/blog/error.log'

user = 'your_username' # 替换为您的用户名

创建日志目录：

sudo mkdir -p /var/log/blog

sudo chown -R $USER:$USER /var/log/blog

创建Systemd服务文件

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

添加以下内容（ini）：

[Unit]

Description=Gunicorn instance to serve Flask blog application

After=network.target

[Service]

User=your_username # 替换为您的用户名

Group=nginx

WorkingDirectory=/var/www/blog

Environment="PATH=/var/www/blog/venv/bin"

ExecStart=/var/www/blog/venv/bin/gunicorn --config /var/www/blog/gunicorn_config.py app:app

Restart=always

[Install]

WantedBy=multi-user.target

配置Nginx作为反向代理

sudo nano /etc/nginx/conf.d/blog.conf

添加以下内容(nginx)：

server {

listen 80;

server_name your_domain.com www.your_domain.com; # 替换为您的域名或服务器IP

location / {

proxy_pass http://127.0.0.1:8000;

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;

}

location /static {

alias /var/www/blog/static;

}

# 错误页面

error_page 404 /404.html;

error_page 500 502 503 504 /500.html;

}

配置防火墙

# 允许HTTP和HTTPS流量

sudo firewall-cmd --permanent --add-service=http

sudo firewall-cmd --permanent --add-service=https

sudo firewall-cmd –reload

启动服务并设置开机自启

# 启动Gunicorn服务

sudo systemctl start blog

sudo systemctl enable blog

# 检查Gunicorn服务状态

sudo systemctl status blog

# 测试Nginx配置

sudo nginx -t

# 启动Nginx服务

sudo systemctl start nginx

sudo systemctl enable nginx

配置SELinux（如果启用）

# 如果SELinux处于enforcing模式，需要设置以下规则

sudo semanage fcontext -a -t httpd_sys_rw_content_t '/var/www/blog(/.*)?'

sudo restorecon -Rv /var/www/blog/

# 允许Nginx连接到Gunicorn

sudo setsebool -P httpd_can_network_connect 1

13. 监控和维护

- 查看应用日志： sudo journalctl -u blog

- 查看Nginx日志： sudo tail -f /var/log/nginx/error.log

- 查看Gunicorn日志： sudo tail -f /var/log/blog/error.log

## 其他注意事项

1. 1.

数据库备份：定期备份 blog.db 文件

2. 2.

安全优化：

- 考虑配置HTTPS（使用Let's Encrypt证书）

- 修改 SECRET_KEY 为随机生成的强密码

- 定期更新系统和依赖包

3. 3.

性能优化：根据访问量调整Gunicorn的worker数量

4. 4.

静态文件：确保static目录权限正确，以便Nginx能访问

完成以上步骤后，您的Flask博客应用应该已成功部署到CentOS系统上并可以通过浏览器访问了。

-------------------------------------------------------------------------------------------

在 CentOS 系统中搭建第二个 Flask 应用，与搭建第一个的流程类似，但需要注意端口占用和服务配置的隔离。以下是具体步骤：
1. 准备独立的环境
为第二个 Flask 应用创建独立的目录和虚拟环境，避免依赖冲突：
bash
# 创建应用目录
mkdir -p /var/www/flask_app2
cd /var/www/flask_app2

# 创建并激活虚拟环境
python3 -m venv venv
source venv/bin/activate

# 安装Flask（可指定版本）
pip install flask
2. 编写第二个 Flask 应用代码
创建应用主文件（如app.py），注意使用与第一个应用不同的端口：
python
运行
from flask import Flask
app = Flask(__name__)

@app.route('/')
def hello():
return "这是第二个Flask应用!"

if __name__ == '__main__':
# 使用不同于第一个应用的端口（如5001）
app.run(host='0.0.0.0', port=5001)
3. 配置服务（使用 systemd）
创建服务文件，确保与第一个应用的服务名不同：
bash
sudo vim /etc/systemd/system/flask-app2.service
服务文件内容：
ini
[Unit]
Description=Second Flask Application
After=network.target

[Service]
User=www-data
Group=www-data
WorkingDirectory=/var/www/flask_app2
Environment="PATH=/var/www/flask_app2/venv/bin"
ExecStart=/var/www/flask_app2/venv/bin/python app.py

[Install]
WantedBy=multi-user.target
4. 启动并设置开机自启
bash
# 重新加载systemd配置
sudo systemctl daemon-reload

# 启动服务
sudo systemctl start flask-app2

# 设置开机自启
sudo systemctl enable flask-app2

# 检查服务状态
sudo systemctl status flask-app2
5. 配置 Nginx 反向代理（可选）
如果需要通过域名区分两个应用，可配置 Nginx：
bash
sudo vim /etc/nginx/conf.d/flask-app2.conf
配置内容：
nginx
server {
listen 80;
server_name app2.yourdomain.com; # 第二个应用的域名

location / {
proxy_pass http://127.0.0.1:5001; # 对应第二个应用的端口
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
重启 Nginx：
bash
sudo systemctl restart nginx
关键注意事项
端口冲突：确保两个应用使用不同的端口（默认 5000，可改为 5001、5002 等）
服务名区分：systemd 服务文件名称需不同，避免冲突
目录隔离：应用文件和虚拟环境应完全独立
防火墙设置：如果启用了 firewalld，需开放第二个应用的端口
bash
sudo firewall-cmd --add-port=5001/tcp --permanent
sudo firewall-cmd --reload

通过以上步骤，你就可以在同一台 CentOS 服务器上运行多个独立的 Flask 应用了。
.................................................................................................................................................
为第二个 Flask 应用配置 Gunicorn 的步骤如下：
1. 在虚拟环境中安装 Gunicorn
bash
# 激活第二个应用的虚拟环境
cd /var/www/flask_app2
source venv/bin/activate

# 安装Gunicorn
pip install gunicorn
2. 测试 Gunicorn 运行
bash
# 用Gunicorn启动Gunicorn启动应用（指定不同端口）
gunicorn -w 4 -b 0.0.0.0:5001 app:app
-w 4：指定 4 个工作进程
-b 0.0.0.0:5001：绑定到 5001 端口（与第一个应用不同）
app:app：表示从 app.py 文件中导入 app 实例
3. 修改 systemd 服务配置
编辑之前创建的服务文件：
bash
sudo vim /etc/systemd/system/flask-app2.service
将ExecStart行修改为使用 Gunicorn：
ini
[Unit]
Description=Second Flask Application with Gunicorn
After=network.target

[Service]
User=www-data
Group=www-data
WorkingDirectory=/var/www/flask_app2
Environment="PATH=/var/www/flask_app2/venv/bin"
# 使用Gunicorn启动，而不是直接运行python
ExecStart=/var/www/flask_app2/venv/bin/gunicorn -w 4 -b 0.0.0.0:5001 app:app

[Install]
WantedBy=multi-user.target
4. 重启服务
bash
sudo systemctl daemon-reload
sudo systemctl restart flask-app2
使用 Gunicorn 的优势
性能更好：支持多进程处理，能同时处理更多请求
更稳定：相比 Flask 开发服务器，更适合生产环境
资源控制：可以灵活配置工作进程数量
安全性：提供更好的安全特性，适合暴露在公网环境
如果后续需要进一步优化，还可以结合 Nginx 作为反向代理，处理静态文件并转发动态请求给 Gunicorn，形成更完善的生产环境部署架构。

------------------------------------------------------------------------------------------------------------------------------

第一步：重新创建 Gunicorn 服务配置文件
bash
# 1. 确保在任意目录下，执行以下命令创建服务文件
sudo nano /etc/systemd/system/gunicorn.service
粘贴以下内容（根据你的实际路径修改）：
ini
[Unit]
Description=Gunicorn daemon for blog project
After=network.target

[Service]
User=wzf
Group=wzf
WorkingDirectory=/var/www/blog
ExecStart=/var/www/blog/venv/bin/gunicorn \
--workers 3 \
--bind unix:/var/www/blog/blog.sock \
app:app

[Install]
WantedBy=multi-user.target
保存文件：按 Ctrl+O → 回车确认 → 按 Ctrl+X 退出。
第二步：重载系统服务配置（关键步骤）
bash
# 让系统识别新创建的服务文件
sudo systemctl daemon-reload
第三步：验证服务是否存在并启动
bash
# 1. 查看服务是否已被识别
sudo systemctl list-unit-files | grep gunicorn
# 若输出 `gunicorn.service enabled` 或 `static`，说明已识别

# 2. 启动服务
sudo systemctl start gunicorn

# 3. 查看服务状态（确认是否启动成功）
sudo systemctl status gunicorn
若仍提示 “Unit not found”
检查服务文件路径是否完全正确：
bash
# 确认文件存在且路径正确
ls -l /etc/systemd/system/gunicorn.service
若输出 “没有那个文件或目录”，说明第一步的文件创建失败，重新执行第一步（建议用 nano ）。
检查文件权限：
bash
# 确保服务文件有正确权限
sudo chmod 644 /etc/systemd/system/gunicorn.service
再次重载配置并尝试启动：
bash
sudo systemctl daemon-reload
sudo systemctl restart gunicorn
核心问题是系统未识别到服务文件，通过 “重新创建文件 + 重载配置” 即可解决。只要 /etc/systemd/system/gunicorn.service 存在且格式正确，systemctl 就能找到并管理该服务。

# Gunicorn 配置文件:

bind = "0.0.0.0:8888" # 绑定地址和端口
workers = 3 # 工作进程数（建议设为 CPU 核心数×2 + 1）
accesslog = "/var/www/blog/logs/access.log" # 访问日志路径
errorlog = "/var/www/blog/logs/error.log" # 错误日志路径
loglevel = "info" # 日志级别（debug/info/warning/error/critical）

注意：若指定日志路径（如 logs/access.log），需先创建 logs 目录，否则启动会报错
bash
mkdir -p /var/www/blog/logs # 创建日志目录
..................................................................................................
创建Systemd服务文件

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

添加以下内容（ini）：
[Unit]
Description=Gunicorn daemon for blog project
After=network.target

[Service]
User=wzf
Group=wzf
WorkingDirectory=/var/www/blog
ExecStart=/var/www/blog/venv/bin/gunicorn \
--config /var/www/blog/gunicorn_config.py \
app:app

[Install]
WantedBy=multi-user.target

.........................................................................................................
sudo systemctl start gunicorn # 启动服务
sudo systemctl stop gunicorn # 停止服务

........................................................................................................

# 重载配置（推荐，不中断服务）
sudo systemctl reload nginx

# 或重启服务（会短暂中断）
sudo systemctl restart nginx

# 停止服务

sudo systemctl stop nginx

#主题 #书源 #实用软件 #技术教程 #精品源码

👍 点赞 💬 评论 📤 分享

本文链接: https://hc8.top/post/19

温馨提示： 本站提供的都是免费且公益的资源，文章部分内容可能来源于网络，仅供大家学习与参考，如有侵权，请联系站长进行删除处理。

评论 (0)

请先登录后发表评论

暂无评论，快来抢沙发吧！

分享到微信

把整个flask项目部署到linux服务器

评论 (0)

相关推荐