Cài đặt, vận hành và API

Mô hình triển khai

Mỗi địa điểm có một máy luôn bật cùng LAN với camera. go2rtc và AI chỉ nghe trên localhost; Cloudflare Tunnel chỉ đưa relay đã xác thực ra ngoài. Khách đăng nhập SaaS và nhận URL WebRTC ký ngắn hạn, không dùng Google Cloudflare Access.

1. Chuẩn bị máy tại site

• macOS hoặc Linux 64-bit, chạy 24/7, ưu tiên Ethernet.
• Node.js 20+, Git, Python 3.10+ với venv, curl; Linux cần sudo.
• Camera đã bật RTSP + ONVIF, có IP cố định/DHCP reservation và tài khoản riêng.
• Outbound HTTPS/WSS tới Cloudflare, GitHub và dashboard; không mở port router.
• MVP yêu cầu nhập IP camera, chưa tự động quét camera trong LAN.

2. Cài đặt

Đăng ký public key của máy trong GitHub Repository → Settings → Deploy keys, không bật quyền write.

ssh-keygen -t ed25519 -C cameraai-site -f "$HOME/.ssh/cameraai_deploy" -N ''
cat "$HOME/.ssh/cameraai_deploy.pub"

git clone --depth 1 git@github.com:nhannguyenalien/cameraaiwork.git
cd cameraaiwork
CAMERAAIWORK_REPO=git@github.com:nhannguyenalien/cameraaiwork.git \
CAMERAAIWORK_API=https://cameraaiwork.pages.dev \
./apps/relay/install.sh

Installer hỏi API key account, tên site, IP/ONVIF camera; sau đó đăng ký site, tạo Named Tunnel và cài go2rtc, relay, AI thành service.

3. Kiểm tra

launchctl list | grep cameraaiwork
tail -n 100 /tmp/cameraaiwork-relay.log
curl -fsS http://127.0.0.1:1984/api/streams
curl -fsS http://127.0.0.1:4000/health

systemctl --no-pager --full status cameraaiwork-go2rtc cameraaiwork-relay cameraaiwork-ai
journalctl -u cameraaiwork-relay -n 100 --no-pager
curl -fsS http://127.0.0.1:1984/api/streams
curl -fsS http://127.0.0.1:4000/health

Trên dashboard, test theo chuỗi: camera xuất hiện → live → PTZ rồi stop → motion event → AI → clip R2 → Telegram.

API cho AI agent

Nạp /openapi.yaml làm tool schema. Token phải nằm trong secret store và gửi qua Authorization: Bearer.

export CAMERAAI_API='https://cameraaiwork.pages.dev'
export CAMERAAI_TOKEN='account-session-key'
curl -fsS "$CAMERAAI_API/api/cameras" \
  -H "Authorization: Bearer $CAMERAAI_TOKEN"

Production checklist