[시놀로지] DSM 7.3 환경에서 SONOFF 지그비 동글 USB 인식시키기

시놀로지가 DSM 7.0 이후 버전부터 보안 및 안정성 정책을 이유로 운영체제 내부에서 USB 시리얼 통신 드라이버(.ko 파일)를 삭제했습니다. 이로 인해 스마트홈 구축 시 많이 사용하는 지그비(Zigbee) USB 동글을 꽂아도 NAS가 전혀 인식하지 못하는 문제가 발생합니다.

이 글은 DS720+(Geminilake 아키텍처) 및 DSM 7.3.2 버전에서, Sonoff Zigbee 3.0 USB Dongle Plus V2(ZBDongle-E)를 도커(Container Manager) 환경의 홈어시스턴트(HA)에 성공적으로 인식시킨 과정을 팩트 기반으로 정리한 가이드입니다.

참고: 사용하는 NAS 모델에 따라 CPU 아키텍처가 다릅니다. 이 글은 DS720+(Geminilake)를 기준으로 작성되었으므로, 다른 모델을 사용 중이라면 본인의 아키텍처에 맞는 폴더를 선택해야 합니다.

준비 단계: 드라이버 파일 다운로드 및 NAS 업로드

시놀로지 시스템 내부에 삭제된 드라이버 파일을 사용자가 직접 복사해 넣어야 합니다.

1. 드라이버 다운로드
   • PC 환경에서 GitHub의 robertklep/dsm7-usb-serial-drivers 저장소에 접속합니다.
   • [<> Code] → [Download ZIP]을 눌러 전체 파일을 다운로드하고 압축을 풉니다.
2. 시놀로지에 파일 업로드
   • 시놀로지 File Station을 엽니다.
   • 임의의 폴더(예: /volume1/docker/usb_driver/)를 생성하고, 압축을 푼 파일 중 다음 항목을 업로드합니다.
     • usb-serial-drivers.sh (스크립트 파일 1개)
     • modules/geminilake/dsm-7.3/ 폴더 안에 있는 모든 .ko 파일들

0단계: 시놀로지에서 SSH 활성화 및 포트 설정하기

터미널 명령어를 입력하려면 먼저 시놀로지 NAS의 문을 열어주어야 합니다.

1. 시놀로지 IP 확인하기
   • 평소에 시놀로지에 접속할 때 주소창에 치는 숫자(예: 192.168.0.XX)가 본인의 NAS 아이피입니다. 이 숫자를 따로 메모해 두세요.
2. 제어판에서 SSH 켜기
   • 시놀로지 바탕화면에서 제어판을 엽니다.
   • 메뉴 중 터미널 및 SNMP를 클릭합니다.
   • 상단의 터미널 탭에서 [SSH 서비스 활성화] 체크박스에 체크합니다.
3. 포트 번호 설정하기
   • 바로 아래에 있는 포트 입력란을 확인합니다. 기본값은 22로 되어 있습니다.
   • 보안 팁: 기본 포트 22를 그대로 쓰면 외부 해킹 공격에 취약할 수 있으므로, 2222나 3322 같은 나만의 4자리 숫자로 바꿔주는 것을 권장합니다. (여기서는 예시로 2222로 설정했다고 가정하겠습니다.)
   • 우측 하단의 적용 버튼을 누르면 문이 열립니다.

 

 

1단계: SSH를 통한 시스템 폴더로 드라이버 복사

터미널을 이용해 시놀로지 코어 시스템에 드라이버 파일을 심고, 부팅 시 자동 실행되도록 설정하는 과정입니다.

• PC에서 터미널 프로그램(명령 프롬프트, Power Shell 등)을 열고 SSH로 NAS에 접속합니다.

ssh 본인ID@NAS아이피 -p 포트번호 # (Synology 비밀번호 입력)
sudo -i  # root 권한 획득 (비밀번호 재입력)

• 아래 명령어를 순서대로 입력합니다.
  (※ 팁: 파일이 있는 폴더 경로 이름에 띄어쓰기가 포함된 경우, 반드시 경로 부분을 큰따옴표(" ")로 감싸야 에러가 발생하지 않습니다.)

# 1. 드라이버 파일(.ko)들을 시스템 모듈 폴더로 복사
cp "/volume1/본인이/업로드한/경로/"*.ko /lib/modules/

# 2. 자동 실행 스크립트(.sh)를 부팅 스크립트 폴더로 복사
cp "/volume1/본인이/업로드한/경로/usb-serial-drivers.sh" /usr/local/etc/rc.d/

# 3. 스크립트에 실행 권한 부여
chmod +x /usr/local/etc/rc.d/usb-serial-drivers.sh

# 4. 재부팅 없이 즉시 스크립트 실행하여 드라이버 로드
/usr/local/etc/rc.d/usb-serial-drivers.sh start

• 드라이버가 정상 로드되었는지 확인합니다.

ls /dev/ttyUSB*

정상적으로 인식되었다면 /dev/ttyUSB0 이라는 결과가 출력됩니다.

2단계: Container Manager 권한 부여 (복제 기능 활용)

NAS 시스템이 USB를 인식했더라도, 컨테이너(도커) 내부에서 하드웨어에 접근하려면 권한 설정이 필요합니다. 최신 시놀로지 Container Manager는 생성된 컨테이너의 권한 편집을 제한하고 있으므로 '복제' 기능을 활용해야 합니다.

1. 시놀로지 Container Manager > 컨테이너 메뉴에서 실행 중인 홈어시스턴트 컨테이너를 중지합니다.
2. 중지된 컨테이너를 선택하고 상단의 [복제]를 클릭합니다.
3. 새 컨테이너 생성 창이 나타나면, 일반 설정 탭에서 "높은 권한을 사용하여 컨테이너 실행" 항목을 체크합니다.
4. 하단에 있는 [복제]를 클릭하여 마무리합니다.

3단계: 홈어시스턴트(HA) 연동 확인 및 기기 추가

권한이 정상적으로 부여되었다면, 홈어시스턴트는 부팅 시 지그비 동글을 자동으로 감지합니다.

1. 홈어시스턴트 웹 페이지에 접속합니다.
2. [설정] → [기기 및 서비스] 메뉴로 이동합니다.
3. 화면의 '발견된 통합 구성 요소' 목록에 Sonoff Zigbee 3.0 USB Dongle Plus V2가 자동으로 나타납니다.
   

   

   
   
4. 해당 항목의 [추가]를 눌러 설정을 마무리합니다.
5. 설정이 완료된 후 지그비 센서 기기의 페어링 버튼을 누르면 화면에 "초기화가 완료되었습니다"라는 메시지가 뜨며, 영역 지정 후 자동으로 시스템에 등록됩니다.
   
   

제품 구매는 아래 링크를 참고하세요.

SONOFF ZBDongle-E Zigbee 3.0 USB Dongle Plus Smart Home Zigbee Hub Gateway Bridge Support Home Assistant OpenHAB And Zigbee2MQTT

이상입니다.