ericwyuan/sentinel-home-ai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[6.0] 部署脚本与文档 - start_core/edge/ui.sh + DEPLOY.md 部署指南

Browse Source
This commit is contained in:
ericwyuan
2026-08-19 22:27:47 +08:00
parent 4cfb327455
commit d741ade9b7
4 changed files with 224 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

155
docs/DEPLOY.md Normal file
View File

@@ -0,0 +1,155 @@
# 部署指南
## 1. NAS 端部署 (FAM-Core + FAM-UI + MariaDB)
### 1.1 MariaDB
```bash
# 安装 MariaDB (通过 Synology 套件中心)
# 确认端口 3306 可用
# 执行 DDL
python3 scripts/init_db.py --host 127.0.0.1 --port 3306 --user root --password <密码>
```
### 1.2 FAM-Core
```bash
cd /path/to/sentinel-home-ai/fam-core
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
# 配置
cp config/config.yaml.example config/config.yaml
# 编辑 config.yaml: 数据库密码、Oracle Tailscale IP、token 等
# 启动
./scripts/start_core.sh
# 或手动: gunicorn -w 1 -b 0.0.0.0:8000 --timeout 120 src.fam_core.app:app
```
### 1.3 FAM-UI
```bash
cd /path/to/sentinel-home-ai/fam-ui
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
# 配置
cp config/config.yaml.example config/config.yaml
# 编辑 config.yaml: 数据库连接、FAM-Core 地址
# 启动
./scripts/start_ui.sh
# 或手动: streamlit run src/app.py --server.port 8501 --server.address 0.0.0.0
```
## 2. Oracle 端部署 (FAM-Edge + Ollama + FFmpeg)
### 2.1 系统依赖
```bash
# FFmpeg
sudo apt update && sudo apt install -y ffmpeg
# OpenCV 依赖
sudo apt install -y python3-opencv libopencv-dev
# Ollama
curl -fsSL https://ollama.com/install.sh | sh
systemctl enable ollama
systemctl start ollama
# 拉取模型
ollama pull llava-phi3
```
### 2.2 FAM-Edge
```bash
cd /path/to/sentinel-home-ai/fam-edge
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
# 配置
cp config/config.yaml.example config/config.yaml
# 编辑 config.yaml: NAS Tailscale IP、media_token、Gemini API Key
# 设置 Gemini API Key 环境变量
export GEMINI_API_KEY="your-api-key-here"
# 启动
./scripts/start_edge.sh
# 或手动: gunicorn -w 1 -b 0.0.0.0:5000 --timeout 600 src.fam_edge.app:app
```
### 2.3 模型可行性压测 (阶段一验证)
```bash
# 测试 llava-phi3 单张图推理耗时
ollama run llava-phi3 "描述这张图片" --images /path/to/test.jpg
# 预期:
# - 单张 ≤ 8 秒 → 可行
# - 单张 ≤ 30 秒 → 可接受
# - 单张 > 30 秒 → 需换更小模型或减帧
```
## 3. Tailscale 组网
```bash
# NAS 端
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
# Oracle 端
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
# 验证
# NAS: ping 100.x.x.20 (Oracle Tailscale IP)
# Oracle: ping 100.x.x.10 (NAS Tailscale IP)
```
## 4. 开机自启 (可选)
### NAS 端 (使用任务计划)
```bash
# Synology DSM -> 控制面板 -> 任务计划 -> 新增 -> 触发的任务 -> 开机
# 脚本:
cd /path/to/sentinel-home-ai
./scripts/start_core.sh &
./scripts/start_ui.sh &
```
### Oracle 端 (使用 systemd)
```bash
sudo tee /etc/systemd/system/fam-edge.service << 'EOF'
[Unit]
Description=FAM-Edge Service
After=network.target ollama.service
[Service]
Type=simple
User=ubuntu
WorkingDirectory=/path/to/sentinel-home-ai/fam-edge
Environment=GEMINI_API_KEY=your-api-key
ExecStart=/path/to/sentinel-home-ai/fam-edge/venv/bin/gunicorn -w 1 -b 0.0.0.0:5000 --timeout 600 src.fam_edge.app:app
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl enable fam-edge
sudo systemctl start fam-edge
```
## 5. 验证清单
| 项目 | 命令 | 预期 |
|------|------|------|
| NAS MariaDB | `mysql -u root -p -e "SHOW DATABASES"` | 包含 sentinel_home_ai |
| NAS FAM-Core | `curl http://localhost:8000/health` | `{"status":"ok"}` |
| NAS FAM-UI | 浏览器访问 `http://192.168.50.64:8501` | Streamlit 页面 |
| Oracle FAM-Edge | `curl http://localhost:5000/health` | `{"status":"ok"}` |
| Oracle Ollama | `curl http://localhost:11434/api/tags` | 模型列表含 llava-phi3 |
| Tailscale | NAS `ping 100.x.x.20` | 通 |

23
scripts/start_core.sh Executable file
View File

@@ -0,0 +1,23 @@
#!/bin/bash
# FAM-Core 启动脚本 (NAS 端)
# 用法: ./scripts/start_core.sh
set -e
APP_DIR="$(cd "$(dirname "$0")/.." && pwd)/fam-core"
CONFIG_FILE="$APP_DIR/config/config.yaml"
if [ ! -f "$CONFIG_FILE" ]; then
echo "错误: 配置文件不存在: $CONFIG_FILE"
echo "请复制 config.yaml.example 为 config.yaml 并修改实际值"
exit 1
fi
cd "$APP_DIR"
# 检查虚拟环境
if [ -d "venv" ]; then
source venv/bin/activate
fi
echo "启动 FAM-Core (端口 8000)..."
exec gunicorn -w 1 -b 0.0.0.0:8000 --timeout 120 src.fam_core.app:app

23
scripts/start_edge.sh Executable file
View File

@@ -0,0 +1,23 @@
#!/bin/bash
# FAM-Edge 启动脚本 (Oracle 端)
# 用法: ./scripts/start_edge.sh
set -e
APP_DIR="$(cd "$(dirname "$0")/.." && pwd)/fam-edge"
CONFIG_FILE="$APP_DIR/config/config.yaml"
if [ ! -f "$CONFIG_FILE" ]; then
echo "错误: 配置文件不存在: $CONFIG_FILE"
echo "请复制 config.yaml.example 为 config.yaml 并修改实际值"
exit 1
fi
cd "$APP_DIR"
# 检查虚拟环境
if [ -d "venv" ]; then
source venv/bin/activate
fi
echo "启动 FAM-Edge (端口 5000)..."
exec gunicorn -w 1 -b 0.0.0.0:5000 --timeout 600 src.fam_edge.app:app

23
scripts/start_ui.sh Executable file
View File

@@ -0,0 +1,23 @@
#!/bin/bash
# FAM-UI 启动脚本 (NAS 端)
# 用法: ./scripts/start_ui.sh
set -e
APP_DIR="$(cd "$(dirname "$0")/.." && pwd)/fam-ui"
CONFIG_FILE="$APP_DIR/config/config.yaml"
if [ ! -f "$CONFIG_FILE" ]; then
echo "错误: 配置文件不存在: $CONFIG_FILE"
echo "请复制 config.yaml.example 为 config.yaml 并修改实际值"
exit 1
fi
cd "$APP_DIR"
# 检查虚拟环境
if [ -d "venv" ]; then
source venv/bin/activate
fi
echo "启动 FAM-UI Streamlit (端口 8501)..."
exec streamlit run src/app.py --server.port 8501 --server.address 0.0.0.0