zjpb.net/1PANEL_DEPLOY.md

1Panel Web界面部署指南

使用1Panel Web界面部署ZJPB项目

前提条件

• 1Panel已安装并可访问
• 1Panel版本支持Python项目管理

---

方式一：使用1Panel的运行时环境（推荐）

步骤1：准备项目文件

1. 压缩项目
   • 在本地压缩整个项目文件夹
   • 排除：venv/, __pycache__/, .env, test_*.py, logs/

步骤2：在1Panel中创建数据库

1. 登录1Panel管理面板
2. 进入 数据库 菜单
3. 点击 创建数据库
4. 填写信息：

   数据库名：ai_nav
   用户名：ai_nav_user
   密码：（自动生成或自定义）
   权限：本地访问
   

5. 点击确定，记录数据库密码

步骤3：上传项目文件

1. 进入 文件 菜单
2. 导航到网站目录（如 /www/wwwroot/）
3. 创建项目目录 zjpb
4. 上传并解压 zjpb.zip

步骤4：配置环境变量

1. 在项目目录中，找到 .env.example 文件
2. 复制为 .env
3. 点击编辑，填写配置：

# 数据库配置
DB_HOST=localhost
DB_PORT=3306
DB_USER=ai_nav_user
DB_PASSWORD=你的数据库密码
DB_NAME=ai_nav

# 安全配置
SECRET_KEY=你的密钥（使用下方命令生成）
FLASK_ENV=production

# DeepSeek API（可选）
DEEPSEEK_API_KEY=sk-xxxxx
DEEPSEEK_BASE_URL=https://api.deepseek.com

生成SECRET_KEY：

# 在1Panel终端执行
python3 -c "import secrets; print(secrets.token_hex(32))"

步骤5：使用1Panel创建Python项目

5.1 进入网站管理

1. 点击 网站 菜单
2. 点击 创建网站
3. 选择 运行时 类型

5.2 配置Python项目

填写以下信息：

基本设置：

网站类型：运行时
运行时：Python
域名：your-domain.com（或IP地址）
代码目录：/www/wwwroot/zjpb

Python设置：

Python版本：选择 3.8+ 的版本
应用类型：选择 "Flask" 或 "其他"
启动文件：app.py
启动命令：gunicorn -c gunicorn_config.py app:app
端口：5000（默认）

环境变量：（如果1Panel支持在界面配置）

FLASK_ENV=production

其他选项：

☑ 自动启动
☑ 守护进程
进程数：4

5.3 安装依赖

1. 创建网站后，1Panel会自动创建虚拟环境
2. 进入网站设置
3. 找到 依赖管理 或 包管理
4. 上传 requirements.txt 或手动安装
5. 点击 安装依赖

或者使用1Panel的终端：

# 进入项目目录
cd /www/wwwroot/zjpb

# 激活虚拟环境（1Panel自动创建的）
source venv/bin/activate

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

步骤6：初始化数据库

1. 在1Panel中打开 终端 或 SSH连接
2. 执行：

cd /www/wwwroot/zjpb
source venv/bin/activate
python init_db.py

步骤7：启动和管理

1. 在1Panel网站列表中找到你的项目
2. 点击 启动 按钮
3. 查看状态：运行中 ✓

步骤8：配置反向代理（如果需要）

如果1Panel没有自动配置Nginx：

1. 进入网站设置
2. 找到 反向代理 或 代理配置
3. 配置：

   目标地址：http://127.0.0.1:5000
   

步骤9：配置SSL证书（推荐）

1. 在网站设置中找到 SSL
2. 选择 Let's Encrypt
3. 点击申请证书
4. 启用 强制HTTPS

步骤10：访问验证

1. 前台：https://your-domain.com
2. 后台：https://your-domain.com/admin/login
   • 默认用户名：admin
   • 默认密码：admin123
3. 立即修改密码：访问 /admin/change-password

---

方式二：使用1Panel的OpenResty/Nginx + Supervisor

如果1Panel的Python运行时不支持或不稳定，可以使用传统方式：

步骤1-4：同上（数据库、文件上传、环境配置）

步骤5：手动创建虚拟环境

cd /www/wwwroot/zjpb
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

步骤6：创建Supervisor配置

1. 在1Panel中进入 容器 或 进程管理
2. 如果有Supervisor功能，创建新任务

或手动创建配置文件：

nano /etc/supervisor/conf.d/zjpb.conf

内容：

[program:zjpb]
command=/www/wwwroot/zjpb/venv/bin/gunicorn -c gunicorn_config.py app:app
directory=/www/wwwroot/zjpb
user=www
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/www/wwwroot/zjpb/logs/supervisor.log
environment=FLASK_ENV="production"

启动：

supervisorctl reread
supervisorctl update
supervisorctl start zjpb

步骤7：创建反向代理网站

1. 在1Panel 网站 菜单中点击 创建网站
2. 选择 反向代理
3. 填写：

   域名：your-domain.com
   代理地址：http://127.0.0.1:5000
   

步骤8：配置SSL

同方式一

---

常见问题

Q1: 1Panel在哪里创建Python项目？

A:

• 进入 网站 菜单
• 点击 创建网站
• 选择 运行时 或 Runtime
• 选择 Python

Q2: 找不到虚拟环境？

A:

• 1Panel创建的虚拟环境通常在项目目录下的 venv/ 文件夹
• 路径：/www/wwwroot/zjpb/venv/
• 可以在文件管理器中查看

Q3: 如何查看应用日志？

A:

• 方式1：在网站管理中点击 日志 按钮
• 方式2：查看文件 logs/error.log
• 方式3：使用1Panel的终端：tail -f logs/error.log

Q4: 如何重启应用？

A:

• 方式1：在1Panel网站列表中点击 重启 按钮
• 方式2：使用管理脚本：./manage.sh restart
• 方式3：Supervisor：supervisorctl restart zjpb

Q5: 端口被占用怎么办？

A: 修改 gunicorn_config.py 中的端口：

bind = "0.0.0.0:5001"  # 改为其他端口

然后在反向代理中也修改为对应端口。

---

管理和维护

更新代码

1. 在1Panel文件管理中上传新文件
2. 在网站管理中点击 重启

查看状态

1. 进入网站列表
2. 查看状态指示灯
3. 点击网站名称查看详细信息

备份数据库

1. 进入 数据库 菜单
2. 找到 ai_nav 数据库
3. 点击 备份 按钮

监控日志

1. 在网站设置中找到 日志 选项
2. 查看访问日志和错误日志
3. 可以设置日志轮转

---

推荐配置

生产环境推荐配置

服务器配置：
- CPU: 2核+
- 内存: 2GB+
- 硬盘: 20GB+

Python版本：
- Python 3.8+

数据库：
- MySQL 5.7+
- MariaDB 10.3+

Web服务器：
- Nginx (1Panel自带)

进程管理：
- Supervisor 或 1Panel内置

工作进程数：
- gunicorn workers: 4
- gunicorn threads: 2

---

安全建议

1. ✅ 修改默认管理员密码
2. ✅ 使用强密码的SECRET_KEY
3. ✅ 启用HTTPS (Let's Encrypt)
4. ✅ 定期备份数据库
5. ✅ 设置文件权限：

   chmod 600 .env
   chmod 755 static/uploads
   

6. ✅ 配置防火墙（1Panel通常自动配置）

---

获取帮助

如果遇到问题：

1. 查看 logs/error.log 日志文件
2. 检查1Panel的系统日志
3. 验证数据库连接
4. 检查端口是否被占用
5. 确认虚拟环境依赖已安装

祝部署顺利！🎉