在腾讯云轻量应用服务器上部署 Python 网站并实现 SQLite 数据持久化,是一个常见且相对简单的场景。SQLite 是文件型数据库,数据直接存储在 .db 或 .sqlite3 文件中,因此核心关键在于确保该数据库文件所在的目录具有正确的读写权限,并在服务器重启或迁移时备份该文件。
以下是完整的配置与最佳实践指南:
✅ 一、环境准备(假设你使用的是 Ubuntu/Debian 系统)
-
安装 Python 和 pip
sudo apt update sudo apt install python3 python3-pip python3-venv -
创建项目目录并进入
mkdir ~/my_python_site cd ~/my_python_site -
创建虚拟环境(推荐)
python3 -m venv venv source venv/bin/activate -
安装必要依赖(以 Flask + SQLite 为例)
pip install flask # 如果需要使用 SQLAlchemy,则: pip install sqlalchemy
✅ 二、创建 SQLite 数据库文件
Python 中无需预先创建数据库文件,首次连接时会自动创建。但为了规范,建议显式指定路径:
# app.py
import sqlite3
from flask import Flask, g
app = Flask(__name__)
DATABASE = '/home/ubuntu/my_python_site/data.db' # 明确指定绝对路径
def get_db():
"""获取数据库连接"""
db = getattr(g, '_database', None)
if db is None:
db = g._database = sqlite3.connect(DATABASE)
db.row_factory = sqlite3.Row # 让查询结果可以通过列名访问
return db
@app.teardown_appcontext
def close_connection(exception):
"""关闭数据库连接"""
db = getattr(g, '_database', None)
if db is not None:
db.close()
@app.route('/')
def index():
db = get_db()
cursor = db.execute('SELECT * FROM users')
users = cursor.fetchall()
return str(users)
if __name__ == '__main__':
# 初始化数据库表
with app.app_context():
db = get_db()
db.execute('''
CREATE TABLE IF NOT EXISTS users (
id INTEGER PRIMARY KEY AUTOINCREMENT,
username TEXT UNIQUE NOT NULL,
email TEXT NOT NULL
)
''')
db.commit()
app.run(host='0.0.0.0', port=5000)
⚠️ 注意:
DATABASE路径建议使用绝对路径,避免相对路径在不同工作目录下出错。
✅ 三、关键:设置正确的文件权限
SQLite 需要读写权限才能正常操作数据库文件。
# 创建 data 目录(可选,用于组织文件)
mkdir -p /home/ubuntu/my_python_site/data
# 将数据库文件放在该目录下
DATABASE = '/home/ubuntu/my_python_site/data/data.db'
# 确保运行 Python 的用户对该目录有读写权限
sudo chown -R $USER:$USER /home/ubuntu/my_python_site/data
chmod 755 /home/ubuntu/my_python_site/data
如果你使用 systemd 或 supervisor 管理进程,请确保服务用户有权访问该目录。
✅ 四、后台运行与守护进程(生产环境必备)
方法1:使用 nohup(简单测试)
nohup python3 app.py > app.log 2>&1 &
方法2:使用 systemd(推荐生产环境)
创建服务文件 /etc/systemd/system/myflask.service:
[Unit]
Description=My Flask App
After=network.target
[Service]
Type=simple
User=ubuntu # 替换为你的用户名
Group=www-data # 可选,如需 Web 服务器交互
WorkingDirectory=/home/ubuntu/my_python_site
Environment="PATH=/home/ubuntu/my_python_site/venv/bin"
ExecStart=/home/ubuntu/my_python_site/venv/bin/python3 app.py
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
启用并启动服务:
sudo systemctl daemon-reload
sudo systemctl enable myflask.service
sudo systemctl start myflask.service
sudo systemctl status myflask.service
✅ 五、数据持久化保障策略
由于 SQLite 是文件型数据库,持久化的本质就是保护 .db 文件不被丢失或损坏。
1. 定期备份数据库文件
# 手动备份
cp /home/ubuntu/my_python_site/data/data.db /backup/data_$(date +%F).db
# 或使用 cron 自动备份
crontab -e
# 添加以下行:每天凌晨2点备份
0 2 * * * cp /home/ubuntu/my_python_site/data/data.db /backup/data_$(date +%F).db
2. 使用 WAL 模式提升并发安全性(可选)
# 在连接后开启 WAL 模式
db.execute("PRAGMA journal_mode=WAL;")
WAL(Write-Ahead Logging)模式允许读操作不阻塞写操作,提高并发性能,同时减少数据库损坏风险。
3. 避免在云盘快照外手动修改数据库
确保所有写入操作通过应用完成,不要直接编辑 .db 文件。
4. 利用腾讯云轻量服务器的“快照”功能
- 在控制台对实例创建磁盘快照。
- 定期快照可防止因误操作、硬件故障导致数据丢失。
- 恢复时可直接回滚到快照状态。
✅ 六、常见问题排查
| 问题 | 原因 | 解决方案 |
|---|---|---|
OperationalError: database is locked |
多进程/多线程同时写入 | 使用 WAL 模式;或改用 PostgreSQL/MySQL |
Permission denied |
目录无读写权限 | chown 和 chmod 修正权限 |
| 数据未保存 | 未调用 commit() |
确保每次写操作后调用 db.commit() |
| 重启后数据丢失 | 数据库文件在临时目录(如 /tmp) |
将数据库文件放在持久化目录(如 /home/) |
✅ 七、进阶建议:何时考虑迁移到其他数据库?
虽然 SQLite 适合小型项目,但在以下情况建议迁移至 MySQL/PostgreSQL:
- 高并发写入需求
- 多节点分布式部署
- 需要复杂事务支持或远程访问
- 数据量超过 GB 级别
腾讯云轻量应用服务器也提供一键部署 MySQL/PostgreSQL 的镜像,便于后续升级。
📌 总结
在腾讯云轻量应用服务器上实现 Python + SQLite 的数据持久化,核心步骤如下:
- 固定数据库文件路径(使用绝对路径)
- 确保目录权限正确(读写权限)
- 使用 systemd 等工具保持进程常驻
- 定期备份
.db文件或使用快照 - 启用 WAL 模式提升稳定性
这样即可实现稳定、可靠的数据持久化。
云知识CLOUD