# 1Panel快速部署向导

## 🎯 使用1Panel Web界面 - 5步完成部署

### 📋 准备工作
- [x] 1Panel已安装
- [x] 项目文件已压缩（zjpb.zip）

---

## 第1步：创建数据库（2分钟）

1. 登录1Panel → **数据库**
2. 点击 **创建数据库**
3. 填写：
   - 数据库名：`ai_nav`
   - 用户名：`ai_nav_user`
   - 密码：自动生成（**记录下来！**）
4. 确定

---

## 第2步：上传项目（3分钟）

1. **文件** → 导航到 `/www/wwwroot/`
2. 创建文件夹 `zjpb`
3. 上传 `zjpb.zip`
4. 解压缩
5. 编辑 `.env.example` → 另存为 `.env`
6. 填写数据库密码和密钥

---

## 第3步：创建Python网站（5分钟）

### 方式A：使用1Panel的Python运行时（推荐）

1. **网站** → **创建网站**
2. 类型：**运行时 (Runtime)**
3. 配置：
   ```
   运行时：Python 3.8+
   应用类型：Flask
   域名：your-domain.com
   代码目录：/www/wwwroot/zjpb
   启动文件：app.py
   启动命令：gunicorn -c gunicorn_config.py app:app
   端口：5000
   ☑ 自动启动
   ```
4. 创建

### 方式B：使用反向代理（备选）

如果没有Python运行时选项：

1. **网站** → **创建网站**
2. 类型：**反向代理**
3. 配置：
   ```
   域名：your-domain.com
   代理地址：http://127.0.0.1:5000
   ```

然后SSH到服务器手动启动（参考完整文档）

---

## 第4步：安装依赖和初始化（5分钟）

### 4.1 打开1Panel终端

点击1Panel右上角 **终端** 图标，或SSH连接

### 4.2 安装依赖

```bash
cd /www/wwwroot/zjpb

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

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

### 4.3 初始化数据库

```bash
python init_db.py
```

看到成功提示后，记住默认账号：
- 用户名：`admin`
- 密码：`admin123`

---

## 第5步：启动和访问（2分钟）

### 5.1 启动应用

**在1Panel界面：**
1. 进入 **网站** 列表
2. 找到你的项目
3. 点击 **启动** 按钮
4. 状态变为 **运行中 ✓**

### 5.2 配置SSL（推荐）

1. 点击网站名称进入设置
2. 找到 **SSL** 选项
3. 选择 **Let's Encrypt**
4. 申请证书
5. 启用 **强制HTTPS**

### 5.3 访问网站

- 前台：`https://your-domain.com`
- 后台：`https://your-domain.com/admin/login`

### 5.4 修改密码（重要！）

1. 登录后台（admin / admin123）
2. 点击左侧菜单 **修改密码**
3. 设置新密码

---

## ✅ 完成！

现在你的网站已经部署完成并运行了！

---

## 🔧 常用操作

### 重启应用
- 1Panel界面：网站列表 → 点击 **重启**

### 查看日志
- 1Panel界面：网站设置 → **日志**
- 或查看文件：`/www/wwwroot/zjpb/logs/error.log`

### 备份数据库
- 1Panel界面：数据库 → 选择 `ai_nav` → **备份**

### 更新代码
1. 上传新文件到项目目录
2. 重启应用

---

## ❓ 常见问题

**Q: 找不到Python运行时选项？**
- 使用反向代理方式，然后手动启动应用
- 参考：`1PANEL_DEPLOY.md` 方式二

**Q: 虚拟环境在哪？**
- 1Panel自动创建在：`/www/wwwroot/zjpb/venv/`

**Q: 启动失败？**
1. 查看日志：`logs/error.log`
2. 检查 `.env` 配置
3. 确认数据库连接
4. 验证依赖已安装

**Q: 需要修改端口？**
- 编辑 `gunicorn_config.py`，修改 `bind` 参数

---

## 📚 更多帮助

- 完整文档：`1PANEL_DEPLOY.md`
- 传统部署：`DEPLOYMENT.md`
- 检查清单：`DEPLOY_CHECKLIST.md`

祝部署顺利！🚀