Latest Version

DXCMS 10.4.82026.06.15 배포 D+147일 (4개월)

185다운로드
0테마
77플러그인
7스킨

NEW DXMB 실시간 화상채팅 플러그인

DX관리자

2026.11.08 22:43 3 0

MB 화상채팅 설치·사용 매뉴얼

회원 프로필에서 버튼 한 번으로 1:1 화상통화를 할 수 있는 플러그인입니다. 영상과 음성은 두 사람의 브라우저끼리 직접 연결되어 서버를 거치지 않습니다.

0. 먼저 알아 두세요

필요한 파일 (압축 파일 3개)

파일	역할	꼭 필요한가요?
`mb-profile-extend_v1.1.0.zip`	프로필에 "더보기" 버튼을 만듭니다. 화상채팅 버튼이 여기에 들어갑니다.	필수
`mb-webrtc_v2.0.0.zip`	화상채팅 본체입니다.	필수
`mb-log-gate_v2.0.0.zip`	사이트 속도를 조금 높여 주는 보조 프로그램입니다.	선택 (권장)

설치 전에 확인할 것

사이트 주소가 https://로 시작해야 합니다. http://로 시작하면 브라우저가 카메라와 마이크를 막아서 화상채팅이 시작되지 않습니다.
DXCMS 관리자 > 소켓 설정에 이 사이트의 소켓 키가 있어야 합니다. 키가 없으면 화상채팅은 꺼진 상태로 있습니다. (키 발급과 설정은 DXCMS 소켓 안내를 따르세요.)
FTP 접속 정보(주소, 아이디, 비밀번호)를 알고 있어야 합니다. 호스팅 업체의 안내 메일이나 관리 화면에서 확인할 수 있습니다.

1. 설치하기

1-1. 압축 풀기

내려받은 압축 파일 3개를 컴퓨터의 한 폴더(예: 바탕화면의 mb-install)에 모읍니다.
압축 파일을 하나씩 마우스 오른쪽 클릭 > 압축 풀기(또는 "여기에 압축 풀기")로 풉니다.
- 파일 이름과 같은 폴더가 새로 생깁니다. 예: mb-webrtc_v2.0.0 폴더
풀린 폴더를 열어서 안을 확인합니다. 폴더 구조가 파일마다 다릅니다.

압축 파일	풀린 폴더 안에서 보이는 것	올릴 폴더
`mb-profile-extend_v1.1.0`	`mb-profile-extend` 폴더	`mb-profile-extend`
`mb-webrtc_v2.0.0`	`mb-webrtc` 폴더	`mb-webrtc`
`mb-log-gate_v2.0.0`	`plugins` 폴더 > 그 안의 `mb-log-gate` 폴더	`plugins` 안에 있는 `mb-log-gate`

주의 mb-log-gate만 plugins 폴더 안에 들어 있습니다. plugins 폴더째 올리지 말고, 그 안의 mb-log-gate 폴더만 올리세요. plugins 안에 또 plugins가 생기면 플러그인 목록에 나타나지 않습니다.

최종적으로 올릴 폴더는 아래 3개입니다.

mb-profile-extend
mb-webrtc
mb-log-gate        (선택)

각 폴더를 열었을 때 manifest.php와 plugin.php 파일이 바로 보이면 올바른 폴더입니다. 폴더를 열었는데 또 같은 이름의 폴더만 하나 들어 있다면, 한 단계 더 안으로 들어간 폴더가 올릴 폴더입니다.

1-2. FTP로 접속하기

FTP 프로그램은 FileZilla(무료)를 기준으로 설명합니다.

FileZilla를 실행합니다.
화면 위쪽 입력칸에 호스트(FTP 주소), 사용자명, 비밀번호를 넣고 빠른 연결을 누릅니다. 포트는 비워 두면 됩니다.
연결되면 화면이 둘로 나뉩니다.
- 왼쪽: 내 컴퓨터
- 오른쪽: 내 사이트가 있는 서버

1-3. 사이트 폴더 찾기

오른쪽(서버)에서 사이트가 설치된 폴더를 찾아 들어갑니다.

보통 이름이 public_html, www, html, htdocs 중 하나입니다.
그 안에 plugins, themes, data, admin 폴더와 index.php 파일이 같이 보이면 제대로 찾은 것입니다.
사이트를 하위 폴더에 설치했다면(예: www/community) 그 폴더 안까지 들어가세요.

그 안의 plugins 폴더를 더블클릭해서 엽니다. 이미 설치된 다른 플러그인 폴더들이 보입니다.

1-4. 폴더 올리기

왼쪽(내 컴퓨터)에서 압축을 푼 폴더로 이동합니다.
올릴 폴더를 마우스로 끌어서 오른쪽의 plugins 폴더 안에 놓습니다. (폴더를 우클릭해서 업로드를 눌러도 됩니다.)
하단의 "전송 완료" 탭에서 실패한 파일이 없는지 확인합니다.
- "실패한 전송" 탭에 항목이 보이면 해당 폴더를 한 번 더 올리세요.
같은 방법으로 폴더 3개를 모두 올립니다. 순서는 상관없습니다.

올린 뒤 서버의 plugins 폴더 안이 이렇게 보여야 합니다.

plugins/
├── mb-profile-extend/
│   ├── manifest.php
│   ├── plugin.php
│   └── assets/ ...
├── mb-webrtc/
│   ├── manifest.php
│   ├── plugin.php
│   └── assets/ ...
└── mb-log-gate/
    ├── manifest.php
    └── plugin.php

이미 이전 버전이 올라가 있으면, 같은 이름의 폴더에 덮어쓰기로 올리면 됩니다. FileZilla가 "대상 파일이 이미 존재합니다"라고 물으면 덮어쓰기를 고르고 "항상 이 동작을 사용"에 체크하면 한 번에 끝납니다.

1-5. 플러그인 켜기 (활성화)

사이트에 관리자로 로그인합니다.
관리자 > 플러그인으로 들어갑니다.
목록에서 아래 순서로 활성화 버튼을 누릅니다.
1. MB Profile Extend
2. MB WebRTC (1:1 화상채팅)
3. MB 로그 게이트 (올렸다면)
카드에 "활성" 표시가 보이면 완료입니다.

목록에 플러그인이 보이지 않으면 폴더 위치가 잘못된 것입니다. 서버의 plugins 폴더 안에 mb-webrtc처럼 플러그인 이름 폴더가 바로 있고, 그 안에 manifest.php가 있는지 다시 확인하세요.

1-6. 설정 확인하기

관리자 > 플러그인에서 MB WebRTC 카드의 설정 버튼을 누릅니다.
처음에는 아무것도 바꾸지 않아도 됩니다. 기본값으로 동작합니다.

항목	설명
소켓 서버 주소	비워 두면 기존 소켓 설정을 자동으로 따라갑니다.
STUN 주소	기본값이 들어 있습니다. 바꾸지 마세요.
TURN 주소·아이디·비밀번호	선택 사항입니다. 연결이 안 되는 회원이 많을 때만 넣습니다. (아래 5번 참고)
join 알림	기본값 0을 유지하세요.

2. 설치가 잘 되었는지 확인하기

관리자 계정이 아닌 다른 회원 계정 2개를 준비합니다. (컴퓨터 한 대에서는 브라우저 두 개, 또는 컴퓨터와 스마트폰으로 각각 로그인하면 됩니다.)
한 계정에서 상대 회원의 프로필을 엽니다.
프로필 모달에 더보기 버튼이 보이면 1단계는 성공입니다.
더보기를 눌러 MB 화상채팅이 보이면 2단계도 성공입니다.
눌러서 전화를 걸고, 상대 쪽에서 수신 창이 뜨는지 확인합니다.

3. 사용하기

전화 걸기

통화할 회원의 프로필을 엽니다.
더보기를 누릅니다.
MB 화상채팅을 누릅니다.
브라우저가 카메라와 마이크 사용을 물으면 허용을 누릅니다.
상대가 받을 때까지 기다립니다.
- 30초 안에 받지 않으면 "응답하지 않습니다"라고 알려 줍니다.

본인 프로필과 로그인하지 않은 상태에서는 더보기 버튼이 나오지 않습니다.

전화 받기

사이트를 열어 둔 상태에서 전화가 오면 수신 창이 뜹니다.
수락을 누르면 통화가 시작됩니다.
거절을 누르면 상대에게 거절했다고 알려 줍니다.
30초 동안 응답하지 않으면 자동으로 거절됩니다.
이미 통화 중이면 새 전화는 "통화 중"으로 처리됩니다.
같은 계정으로 여러 탭이나 기기를 열어 두었다면 모두 수신 창이 뜹니다. 한 곳에서 수락하거나 거절하면 나머지는 자동으로 닫힙니다.

통화 중

화면에 통화 시간이 표시됩니다.
마이크와 카메라 버튼으로 켜고 끌 수 있습니다.
화면 공유도 쓸 수 있습니다.
종료 버튼(빨간 전화 아이콘)으로 끊습니다. 어느 한쪽이 끊으면 상대도 함께 종료됩니다.

4. 이런 증상이 있을 때

증상	해결 방법
더보기 버튼이 안 보임	MB Profile Extend가 활성인지 확인하세요. 본인 프로필이거나 로그인하지 않은 상태에서는 나오지 않습니다. 설정을 바꾼 뒤에는 Ctrl+F5로 새로고침하세요.
더보기는 있는데 화상채팅이 없음	MB WebRTC가 활성인지 확인하세요. 소켓 키가 없으면 꺼진 상태로 있습니다.
플러그인 목록에 안 나옴	폴더를 한 겹 잘못 올렸을 가능성이 큽니다. 1-4의 폴더 구조와 같은지 확인하세요.
카메라와 마이크를 쓸 수 없다고 나옴	주소창 왼쪽의 자물쇠 아이콘을 눌러 카메라와 마이크를 허용으로 바꾸고 새로고침하세요. 다른 프로그램(화상회의 앱 등)이 카메라를 쓰고 있다면 종료하세요.
사이트 주소가 `http://`임	카메라·마이크가 막힙니다. 호스팅 업체의 SSL(https) 설정을 먼저 하세요.
"실시간 연결이 아직 준비되지 않았습니다"	잠시 후 다시 시도하세요. 계속되면 소켓 키와 소켓 서버 주소 설정을 확인하세요.
상대가 응답하지 않음	상대가 사이트에 접속해 있어야 전화가 갑니다. 접속하지 않았다면 받을 수 없습니다.
연결은 됐는데 영상이 안 나옴	회사 내부망이나 일부 통신사 망에서는 연결되지 않을 수 있습니다. 와이파이와 모바일 데이터를 바꿔서 시도해 보세요. 그래도 안 되면 5번의 TURN 설정을 하세요.

5. (선택) TURN 서버 설정

TURN은 회사망·일부 통신사 망처럼 직접 연결이 막히는 곳에서 영상을 중계해 주는 서버입니다. 일부 회원만 영상이 안 나온다면 설정해 보세요. 별도의 TURN 서버(직접 운영하거나 유료 서비스)가 필요합니다.

관리자 > 플러그인 > MB WebRTC > 설정
아래 항목을 채우고 저장합니다.
- TURN 주소: 예) turn:example.com:3478
- TURN 아이디
- TURN 비밀번호

6. 업데이트하기

새 버전 압축 파일을 풀어 1-1과 같이 올릴 폴더를 찾습니다.
FTP에서 같은 이름의 폴더에 덮어쓰기로 올립니다.
관리자 > 플러그인에서 해당 플러그인을 한 번 비활성화 후 다시 활성화합니다.
회원들에게는 Ctrl+F5로 새로고침하도록 안내합니다.

7. 삭제하기

관리자 > 플러그인에서 세 플러그인을 비활성화합니다. (MB WebRTC를 먼저, MB Profile Extend를 나중에 끄세요.)
FTP에서 plugins 폴더 안의 mb-webrtc, mb-profile-extend, mb-log-gate 폴더를 삭제합니다.

8. 문의할 때 알려 주세요

문의 전에 아래 내용을 확인해서 알려 주시면 빨리 해결됩니다.

사이트 주소가 https://인지
플러그인 3개가 활성 상태인지
어느 단계에서 막혔는지 (더보기 버튼이 없음 / 전화가 안 걸림 / 영상이 안 나옴 등)
사용한 브라우저와 기기 (예: 크롬, 갤럭시)
화면이 있다면 캡처

관리자는 통화 흐름이 기록된 data/logs/mb-webrtc.log 파일을 FTP로 내려받아 보내 주시면 원인을 찾는 데 도움이 됩니다.

첨부파일 1개 회원전용

mb-webrtc-pack.zip

27.7KB

로그인 후 댓글을 작성할 수 있습니다.

Plugin TOTAL 77

N DX 그누보드 컨버터

DX 그누보드 컨버터 상세 사용 설명서대상 버전: v1.0.1 그누보드5로 운영하던 사이트의 회원·게시글·댓글·첨부파일 등을 ...