160 lines
3.1 KiB
Markdown
160 lines
3.1 KiB
Markdown
# IPCam Orange Pi Dashboard — INSTALL
|
|
|
|
Tài liệu này hướng dẫn triển khai trên Orange Pi (Linux). Mục tiêu: MediaMTX chạy như media server, FastAPI chạy như dashboard backend, React build ra static.
|
|
|
|
## 1) Yêu cầu
|
|
|
|
- Orange Pi chạy Debian/Ubuntu
|
|
- MediaMTX đã cài và chạy được
|
|
- Python 3.9+ (khuyến nghị 3.10+)
|
|
- Node.js 20+ (để build frontend)
|
|
|
|
## 2) MediaMTX cấu hình tối thiểu
|
|
|
|
Trong file `mediamtx.yml`:
|
|
|
|
```yaml
|
|
api: yes
|
|
apiAddress: :9997
|
|
|
|
webrtc: yes
|
|
webrtcAddress: :8889
|
|
|
|
record: yes
|
|
recordFormat: fmp4
|
|
recordPath: /recordings/%path/%Y-%m-%d_%H-%M-%S-%f
|
|
recordPartDuration: 5m
|
|
```
|
|
|
|
Trong `paths`, bạn có thể để dashboard tự thêm path bằng API (Settings → Add Camera).
|
|
|
|
Tạo thư mục recordings:
|
|
|
|
```bash
|
|
sudo mkdir -p /recordings
|
|
sudo chown -R $USER:$USER /recordings
|
|
```
|
|
|
|
Mở firewall/cổng (tuỳ hệ thống):
|
|
|
|
- `8554/tcp` RTSP
|
|
- `8889/tcp` WebRTC HTTP
|
|
- `9997/tcp` MediaMTX Control API
|
|
- `8189/udp` ICE
|
|
|
|
## 3) Backend FastAPI
|
|
|
|
### 3.1 Cài dependencies
|
|
|
|
```bash
|
|
cd IPCam_OrangePi_Dashboard
|
|
python3 -m venv api/.venv
|
|
source api/.venv/bin/activate
|
|
pip install -r api/requirements.txt
|
|
```
|
|
|
|
### 3.2 Cấu hình
|
|
|
|
Chạy backend lần đầu sẽ tự tạo `api/data/config.json`.
|
|
|
|
Bạn có thể chỉnh:
|
|
|
|
- `mediamtx_api_url` (mặc định `http://127.0.0.1:9997`)
|
|
- `mediamtx_webrtc_url` (mặc định `http://127.0.0.1:8889`)
|
|
- `recordings_dir` (mặc định `/recordings`)
|
|
|
|
Nếu MediaMTX API có auth, export biến môi trường:
|
|
|
|
```bash
|
|
export MEDIAMTX_API_USER="..."
|
|
export MEDIAMTX_API_PASS="..."
|
|
```
|
|
|
|
### 3.3 Chạy backend
|
|
|
|
```bash
|
|
source api/.venv/bin/activate
|
|
uvicorn api.app.main:app --host 0.0.0.0 --port 8000
|
|
```
|
|
|
|
## 4) Frontend (build static)
|
|
|
|
### 4.1 Build
|
|
|
|
```bash
|
|
cd IPCam_OrangePi_Dashboard
|
|
npm install
|
|
npm run build
|
|
```
|
|
|
|
Output nằm ở `dist/`.
|
|
|
|
### 4.2 Serve frontend
|
|
|
|
Có 2 cách phổ biến:
|
|
|
|
1) Nginx serve `dist/` và reverse proxy `/api` + `/videos` về backend `:8000`
|
|
2) Dùng Caddy tương tự
|
|
|
|
Ví dụ Nginx server block tối thiểu:
|
|
|
|
```nginx
|
|
server {
|
|
listen 80;
|
|
server_name _;
|
|
|
|
root /opt/ipcam-dashboard/dist;
|
|
index index.html;
|
|
|
|
location / {
|
|
try_files $uri $uri/ /index.html;
|
|
}
|
|
|
|
location /api/ {
|
|
proxy_pass http://127.0.0.1:8000;
|
|
}
|
|
|
|
location /videos/ {
|
|
proxy_pass http://127.0.0.1:8000;
|
|
}
|
|
}
|
|
```
|
|
|
|
## 5) Systemd service (khuyến nghị)
|
|
|
|
### 5.1 Backend service
|
|
|
|
Tạo file `/etc/systemd/system/ipcam-dashboard.service`:
|
|
|
|
```ini
|
|
[Unit]
|
|
Description=IPCam Dashboard Backend
|
|
After=network.target
|
|
|
|
[Service]
|
|
WorkingDirectory=/opt/ipcam-dashboard
|
|
Environment=MEDIAMTX_API_USER=
|
|
Environment=MEDIAMTX_API_PASS=
|
|
ExecStart=/opt/ipcam-dashboard/api/.venv/bin/uvicorn api.app.main:app --host 0.0.0.0 --port 8000
|
|
Restart=always
|
|
RestartSec=2
|
|
|
|
[Install]
|
|
WantedBy=multi-user.target
|
|
```
|
|
|
|
Enable:
|
|
|
|
```bash
|
|
sudo systemctl daemon-reload
|
|
sudo systemctl enable --now ipcam-dashboard
|
|
sudo systemctl status ipcam-dashboard
|
|
```
|
|
|
|
## 6) Kiểm tra nhanh
|
|
|
|
- Backend: `curl http://localhost:8000/api/health`
|
|
- MediaMTX API: `curl http://localhost:9997/v3/paths/list`
|
|
- Frontend: mở `http://<orange-pi-ip>/`
|
|
|