GD-C100 Ubuntu

GD-C100 Ubuntu 서버 웹캠 운영

PC용 GD-C100 USB 화상카메라를 192.168.0.197 Ubuntu 서버에서 인식시키고, 장치 확인부터 테스트 캡처와 운영 메모까지 이어가는 서버용 설명서입니다.

서버 192.168.0.197
카메라 GD-C100 USB
장치 경로 /dev/video0
GD-C100 실시간 영상 원본 열기
GD-C100 Ubuntu 서버 실시간 웹캠 영상 192.168.0.197 / MJPEG
프록시는 192.168.0.197:8088/stream을 우선 연결하고, 서버 스트림이 꺼져 있으면 PC 카메라를 직접 열 수 있습니다.

Ubuntu 인식 절차

  1. GD-C100을 서버 USB 포트에 연결합니다.
  2. lsusb로 USB 카메라가 잡히는지 확인합니다.
  3. v4l-utilsffmpeg를 설치합니다.
  4. v4l2-ctl --list-devices/dev/video0 같은 영상 장치를 확인합니다.
  5. 웹 서버나 캡처 프로세스를 실행할 계정을 video 그룹에 넣고 재로그인합니다.
  6. 정지 이미지 또는 짧은 영상 캡처로 화면 입력을 검증합니다.
sudo apt update
sudo apt install -y v4l-utils ffmpeg
lsusb
v4l2-ctl --list-devices
v4l2-ctl -d /dev/video0 --all
sudo usermod -aG video "$USER"
그룹 변경 뒤에는 SSH 세션을 새로 열어야 권한이 반영됩니다.

테스트 캡처

장치가 /dev/video0로 보이면 아래 명령으로 한 장을 캡처합니다. 파일이 정상 생성되면 서버가 카메라 입력을 받을 준비가 된 상태입니다.

mkdir -p ~/gd-c100-test
ffmpeg -y -f v4l2 -video_size 1280x720 -i /dev/video0 -frames:v 1 ~/gd-c100-test/gd-c100.jpg
ls -lh ~/gd-c100-test/gd-c100.jpg

실시간 확인이 필요할 때

ffplay -f v4l2 -video_size 1280x720 -i /dev/video0

서버에 GUI가 없으면 ffmpeg 캡처 파일을 웹 폴더에 저장하거나, 별도 스트리밍 도구로 내부망 화면을 열면 됩니다.

운영용 서비스 예시

페이지는 PHP-FPM을 붙잡는 MJPEG 프록시 대신 192.168.0.197:8088/stream uStreamer에 직접 연결합니다. 192.168.0.197 서버에서 아래처럼 GD-C100을 MJPEG로 열면 웹 화면에 바로 표시됩니다.

sudo mkdir -p /var/www/html/camera-live
sudo chown "$USER":www-data /var/www/html/camera-live
ustreamer --device /dev/video0 --host 0.0.0.0 --port 8088 \
  --resolution 640x480 --format YUYV --desired-fps 30 \
  --encoder CPU --quality 90 --persistent --drop-same-frames 30

정지 이미지 백업 갱신

sudo mkdir -p /var/www/html/camera-live
sudo chown "$USER":www-data /var/www/html/camera-live
while true; do
  ffmpeg -loglevel error -y -f v4l2 -video_size 1280x720 -i /dev/video0 -frames:v 1 /var/www/html/camera-live/gd-c100.jpg
  sleep 5
done