Memasang Face SDK Edisi Prod

Kebutuhan Sistem

Pilih image yang sesuai dengan perangkat keras Anda:

[CONFIRM] Tempat pelanggan Prod menarik image (alamat registry dan cara mendapatkan aksesnya) ditetapkan saat rilis.

Opsi 1: Satu Perintah

Perintah yang sama dengan Demo, dengan kunci lisensi Prod dan image Prod Anda:

sudo docker run -d --name face-sdk --restart unless-stopped -p 8080:8080 \
  -e ARSA_LICENCE_KEY=<your key> \
  -v face-data:/data \
  -v /sys:/host/sys:ro -v /etc/machine-id:/host/etc/machine-id:ro \
  <registry>/face-sdk:<ver>-prod-cpu

Pada NVIDIA, tambahkan --gpus all dan pakai image -prod-cuda; pada GPU Intel, tambahkan --device /dev/dri dan pakai -prod-openvino. Lalu baca sudo docker logs face-sdk dan lanjutkan ke Penggunaan Pertama.

Perintah ini menjalankan API, dasbor dan pengenalan kamera. Video kamera langsung di dasbor memerlukan media server di sampingnya: pakai opsi 2.

Opsi 2: Docker Compose (Paket Instalasi)

Paket instalasi berisi berkas compose, skrip instalasi, serta checksum dan kunci tanda tangan rilis tersebut.

1. Ekstrak paketnya dan jalankan penginstal dari foldernya:

   NF_LICENSE_KEY=<your key> ./scripts/install.sh prod cpu   # or: prod openvino | prod cuda

   Skrip memeriksa host dan paket terhadap checksum-nya, menyiapkan lisensi untuk komputer ini sekali (dengan sudo), menarik image berdasarkan digest, memeriksa tanda tangannya bila cosign terpasang (pemeriksaan yang gagal menghentikan instalasi), lalu menjalankannya. Pengaturan disimpan di compose/.env.

2. Untuk video kamera langsung, tambahkan alamat yang dipakai peramban untuk menjangkau server:

   NF_PUBLIC_HOST=192.168.10.20 NF_LICENSE_KEY=<your key> ./scripts/install.sh prod cpu

   Buka port UDP 8000 bagi peramban yang menonton video. Lihat Video Langsung.

Port

Check-in lisensi memerlukan HTTPS keluar ke server lisensi ARSA, kecuali lisensi diaktifkan secara offline (lihat Lisensi).

Jaringan

Di dalam container, server mendengarkan di semua antarmukanya, port 8080. -p 8080:8080 memublikasikan port itu di setiap alamat host, sehingga API dan dasbor menjawab di IP mana pun yang dimiliki server.

• Untuk memublikasikan di satu alamat saja, sebutkan alamat itu di pemetaan port, misalnya -p 192.168.10.20:8080:8080.
• Di belakang reverse proxy pada komputer yang sama, publikasikan hanya di alamat loopback: -p 127.0.0.1:8080:8080.
• Docker menulis aturan firewall-nya sendiri: firewall host seperti ufw tidak memblokir port yang dipublikasikan. Batasi akses dengan alamat di pemetaan port atau dengan chain DOCKER-USER milik Docker.
• Untuk koneksi keluar, server memerlukan HTTPS ke server lisensi ARSA untuk aktivasi dan check-in (tidak diperlukan setelah aktivasi offline). Tidak ada koneksi lain yang masuk atau keluar, kecuali kamera yang Anda tambahkan dan webhook yang Anda konfigurasi.
• Video langsung (instalasi Compose) juga memerlukan NF_PUBLIC_HOST, satu alamat yang dipakai peramban untuk menjangkau server, dan UDP 8000 yang terbuka bagi peramban tersebut.

Melayani Lewat HTTPS

Container berbicara HTTP biasa. Untuk penggunaan apa pun di luar uji lokal, tempatkan di belakang reverse proxy dengan TLS (misalnya nginx atau Caddy) dan jalankan container dengan -e NF_SECURE_COOKIES=1, agar cookie sesi dasbor hanya dikirim lewat HTTPS.

Pengaturan