first commit
This commit is contained in:
229
deploy/1panel-setup.md
Normal file
229
deploy/1panel-setup.md
Normal file
@@ -0,0 +1,229 @@
|
||||
# 1Panel 部署指南 - SalesPipeline
|
||||
|
||||
## 系統需求
|
||||
- Python 3.10+
|
||||
- Node.js 18+ (僅用於建置前端)
|
||||
- MySQL 5.7+ / 8.0+
|
||||
|
||||
---
|
||||
|
||||
## 部署步驟
|
||||
|
||||
### 1. 上傳專案
|
||||
將專案上傳至伺服器，例如：`/opt/salespipeline`
|
||||
|
||||
```bash
|
||||
# 建立專案目錄
|
||||
mkdir -p /opt/salespipeline
|
||||
cd /opt/salespipeline
|
||||
|
||||
# 上傳或 clone 專案
|
||||
# git clone <your-repo> .
|
||||
```
|
||||
|
||||
### 2. 設定 Python 虛擬環境
|
||||
|
||||
```bash
|
||||
cd /opt/salespipeline/backend
|
||||
|
||||
# 建立虛擬環境
|
||||
python3 -m venv venv
|
||||
|
||||
# 啟動虛擬環境
|
||||
source venv/bin/activate
|
||||
|
||||
# 安裝依賴
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
### 3. 設定環境變數
|
||||
|
||||
```bash
|
||||
# 複製範本
|
||||
cp .env.example .env
|
||||
|
||||
# 編輯環境變數
|
||||
nano .env
|
||||
```
|
||||
|
||||
編輯 `.env` 檔案：
|
||||
```env
|
||||
# Database Configuration
|
||||
DB_HOST=your_mysql_host
|
||||
DB_PORT=3306
|
||||
DB_USER=your_user
|
||||
DB_PASSWORD=your_password
|
||||
DB_DATABASE=your_database
|
||||
|
||||
# JWT Configuration
|
||||
SECRET_KEY=<更換為強密碼>
|
||||
ALGORITHM=HS256
|
||||
ACCESS_TOKEN_EXPIRE_MINUTES=1440
|
||||
|
||||
# Application Settings
|
||||
APP_HOST=0.0.0.0
|
||||
APP_PORT=8000
|
||||
WORKERS=2
|
||||
DEBUG=False
|
||||
|
||||
# CORS Settings (開發時使用)
|
||||
CORS_ORIGINS=http://localhost:3000,http://127.0.0.1:3000
|
||||
```
|
||||
|
||||
### 4. 建置前端
|
||||
|
||||
```bash
|
||||
cd /opt/salespipeline/frontend
|
||||
|
||||
# 安裝依賴
|
||||
npm install
|
||||
|
||||
# 建置 (輸出至 backend/static)
|
||||
npm run build
|
||||
```
|
||||
|
||||
### 5. 初始化資料庫
|
||||
資料庫表會在應用程式首次啟動時自動建立。
|
||||
|
||||
### 6. 設定 Systemd 服務
|
||||
|
||||
建立服務檔案 `/etc/systemd/system/salespipeline.service`：
|
||||
|
||||
```ini
|
||||
[Unit]
|
||||
Description=SalesPipeline Application
|
||||
After=network.target
|
||||
|
||||
[Service]
|
||||
Type=simple
|
||||
User=www-data
|
||||
Group=www-data
|
||||
WorkingDirectory=/opt/salespipeline/backend
|
||||
Environment="PATH=/opt/salespipeline/backend/venv/bin"
|
||||
EnvironmentFile=/opt/salespipeline/backend/.env
|
||||
ExecStart=/opt/salespipeline/backend/venv/bin/python run.py
|
||||
Restart=always
|
||||
RestartSec=10
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
```
|
||||
|
||||
啟動服務：
|
||||
```bash
|
||||
# 重新載入 systemd
|
||||
sudo systemctl daemon-reload
|
||||
|
||||
# 啟動服務
|
||||
sudo systemctl start salespipeline
|
||||
|
||||
# 設定開機自啟
|
||||
sudo systemctl enable salespipeline
|
||||
|
||||
# 查看狀態
|
||||
sudo systemctl status salespipeline
|
||||
|
||||
# 查看日誌
|
||||
sudo journalctl -u salespipeline -f
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 1Panel 設定
|
||||
|
||||
### 方案 A：直接使用 Python 網站 (推薦)
|
||||
|
||||
1. 進入 1Panel 控制台
|
||||
2. 網站 → 建立網站 → Python 專案
|
||||
3. 設定：
|
||||
- 專案路徑：`/opt/salespipeline/backend`
|
||||
- Python 版本：3.10
|
||||
- 啟動命令：`/opt/salespipeline/backend/venv/bin/python run.py`
|
||||
- Port：依 `.env` 中的 `APP_PORT` 設定
|
||||
|
||||
### 方案 B：使用反向代理
|
||||
|
||||
1. 建立 Systemd 服務 (如上述步驟 6)
|
||||
2. 1Panel → 網站 → 建立網站 → 反向代理
|
||||
3. 設定：
|
||||
- 網站域名：your-domain.com
|
||||
- 代理地址：`http://127.0.0.1:<APP_PORT>` (依 .env 設定)
|
||||
|
||||
---
|
||||
|
||||
## 目錄結構
|
||||
|
||||
```
|
||||
/opt/salespipeline/
|
||||
├── backend/
|
||||
│ ├── app/ # 應用程式碼
|
||||
│ ├── data/ # 資料目錄 (上傳檔案)
|
||||
│ ├── static/ # 前端建置檔案
|
||||
│ ├── venv/ # Python 虛擬環境
|
||||
│ ├── .env # 環境變數
|
||||
│ ├── requirements.txt
|
||||
│ └── run.py # 啟動腳本
|
||||
└── frontend/
|
||||
├── src/
|
||||
├── package.json
|
||||
└── ...
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 環境變數說明
|
||||
|
||||
| 變數名稱 | 說明 | 預設值 |
|
||||
|---------|------|--------|
|
||||
| DB_HOST | 資料庫主機 | localhost |
|
||||
| DB_PORT | 資料庫端口 | 3306 |
|
||||
| DB_USER | 資料庫使用者 | root |
|
||||
| DB_PASSWORD | 資料庫密碼 | - |
|
||||
| DB_DATABASE | 資料庫名稱 | sales_pipeline |
|
||||
| SECRET_KEY | JWT 密鑰 | - |
|
||||
| ALGORITHM | JWT 演算法 | HS256 |
|
||||
| ACCESS_TOKEN_EXPIRE_MINUTES | Token 過期時間(分鐘) | 1440 |
|
||||
| APP_HOST | 應用監聽地址 | 0.0.0.0 |
|
||||
| APP_PORT | 應用監聽端口 | 8000 |
|
||||
| WORKERS | 工作進程數 | 1 |
|
||||
| DEBUG | 除錯模式 | False |
|
||||
| TABLE_PREFIX | 資料表前綴 | PJ_SOA_ |
|
||||
| CORS_ORIGINS | 允許的跨域來源 | - |
|
||||
|
||||
---
|
||||
|
||||
## 常用指令
|
||||
|
||||
```bash
|
||||
# 啟動服務
|
||||
sudo systemctl start salespipeline
|
||||
|
||||
# 停止服務
|
||||
sudo systemctl stop salespipeline
|
||||
|
||||
# 重啟服務
|
||||
sudo systemctl restart salespipeline
|
||||
|
||||
# 查看日誌
|
||||
sudo journalctl -u salespipeline -f
|
||||
|
||||
# 更新程式碼後重建
|
||||
cd /opt/salespipeline/frontend && npm run build
|
||||
sudo systemctl restart salespipeline
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 故障排除
|
||||
|
||||
### 連線資料庫失敗
|
||||
1. 確認 `.env` 中的資料庫連線資訊正確
|
||||
2. 確認防火牆允許連接資料庫 Port
|
||||
|
||||
### 無法存取網站
|
||||
1. 確認服務正在運行：`systemctl status salespipeline`
|
||||
2. 確認 APP_PORT 未被佔用
|
||||
3. 檢查防火牆設定
|
||||
|
||||
### 靜態檔案 404
|
||||
確認前端已建置：`ls /opt/salespipeline/backend/static/`
|
||||
Reference in New Issue
Block a user