Question 1

## Why this happens

When you see your own video but no remote audio/video, signaling (Socket.io over the Ngrok HTTPS tunnel) is working, but **WebRTC media can't establish a peer connection**. Media doesn't flow through Ngrok — it goes directly browser-to-browser via ICE candidates.

- On LAN: host candidates (192.168.x.x) work, so calls succeed.
- Over the internet: peers behind NAT need **STUN** (to discover public IP) and often **TURN** (relay) if either side is behind symmetric NAT/CGNAT (common on mobile networks and many ISPs).

MiroTalk C2C ships with only a public STUN server enabled and TURN disabled, which is exactly why LAN works but Ngrok doesn't.

## Fix 1: Verify STUN is working

In `mirotalkc2c/backend/.env` make sure you have:

```env
STUN_SERVER_ENABLED=true
STUN_SERVER_URL=stun:stun.l.google.com:19302
```

Restart the server and test. If it still fails, you're behind symmetric NAT → you need TURN.

## Fix 2: Set up a TURN server (the real fix)

Install coturn on the Pi (or any VPS with a public IP — a VPS is easier):

```bash
sudo apt install coturn
sudo systemctl enable coturn
```

Edit `/etc/turnserver.conf`:

```conf
listening-port=3478
tls-listening-port=5349
realm=yourdomain.duckdns.org
user=mirotalk:strongpassword
external-ip=YOUR_PUBLIC_IP/10.0.0.x
min-port=49152
max-port=65535
fingerprint
lt-cred-mech
```

Then forward ports on your router to the Pi:
- 3478 TCP/UDP
- 5349 TCP/UDP (optional, for TURNS)
- 49152–65535 UDP (relay ports)

Update MiroTalk C2C `.env`:

```env
TURN_SERVER_ENABLED=true
TURN_SERVER_URL=turn:YOUR_PUBLIC_IP_OR_DOMAIN:3478
TURN_SERVER_USERNAME=mirotalk
TURN_SERVER_CREDENTIAL=strongpassword
```

Restart MiroTalk and test from two devices on different networks.

## Quick test without running coturn

Temporarily use Metered's Open Relay TURN to confirm TURN fixes it:

```env
TURN_SERVER_ENABLED=true
TURN_SERVER_URL=turn:openrelay.metered.ca:443
TURN_SERVER_USERNAME=openrelayproject
TURN_SERVER_CREDENTIAL=openrelayproject
```

(Not reliable for production, but good for diagnosis.)

## Debugging tools

- **https://icetest.info** — verifies your STUN/TURN config returns srflx/relay candidates.
- **`chrome://webrtc-internals`** — during a call, check the ICE candidate grid:
  - No `srflx` candidates → STUN blocked/unreachable.
  - `srflx` present but pair never reaches "succeeded" → you need TURN.

## Alternative: skip TURN entirely

If only your own devices connect, install **Tailscale** or **ZeroTier** on the Pi and clients. Devices get direct UDP connectivity over the overlay network, so host/srflx candidates succeed without a TURN server — often the simplest fix on a Pi behind CGNAT.

**Bottom line:** Ngrok only tunnels your HTTP/WebSocket signaling; WebRTC media is separate. Local works because NAT isn't involved — for internet access you need a reachable TURN server, which solves it in virtually all cases.

Accepted Answer

이 문제는 Ngrok을 별도로 수동 시작할 때 발생합니다: MiroTalk C2C에는 WebRTC 터널링을 자동으로 처리하는 Ngrok 통합 기능이 내장되어 있으므로 Ngrok 수동 시작은 지원되지 않습니다. 다음 공식 단계에 따라 해결하세요:
1. https://ngrok.com에서 무료 Ngrok 계정에 가입한 다음, https://dashboard.ngrok.com/get-started/your-authtoken에서 인증 토큰을 복사하세요
2. MiroTalk C2C 설치 디렉토리에 있는 `.env` 파일을 편집하고 다음 구성을 추가하세요:
```env
NGROK_ENABLED=true
NGROK_AUTH_TOKEN=your_copied_ngrok_auth_token
```
`your_copied_ngrok_auth_token`을 복사한 토큰으로 교체하세요.
3. 수동으로 실행한 모든 Ngrok 프로세스와 실행 중인 MiroTalk C2C 서비스를 중지한 다음, `npm start`로 MiroTalk C2C를 다시 시작하세요
4. localhost 또는 수동으로 생성한 Ngrok 터널 대신 시작 콘솔 로그에 출력된 `ngrokHome` URL(`.ngrok-free.app`로 끝남)을 통해 서비스에 접속하세요.
이 구성을 완료하면 원격 오디오 및 비디오가 정상적으로 작동합니다.

Question 2

MiroTalk에서 방 생성 및 접근을 승인된 사용자로만 제한하는 방법은 무엇인가요?

Accepted Answer

.env 파일에서 OIDC(OpenID Connect) 인증을 활성화하세요. OIDC_ENABLED=true로 설정하고 OIDC_ISSUER_BASE_URL, OIDC_CLIENT_ID, OIDC_CLIENT_SECRET 및 기타 매개변수를 구성하세요. 완전한 제어를 위해 Auth0와 같은 관리형 서비스를 사용하거나 Keycloak으로 자체 호스팅할 수 있습니다. 이렇게 하면 방을 생성하거나 참여하기 전에 사용자가 인증을 거치도록 강제하여 무단 액세스와 서버 남용을 방지할 수 있습니다.

Question 3

iOS Firefox에서 카메라/마이크 권한 프롬프트 없이 getUserMedia NotAllowedError를 어떻게 수정하나요?

Accepted Answer

이 오류는 일반적으로 iOS 시스템 수준 권한(Firefox의 인앱 설정이나 주소 표시줄 잠금 아이콘 권한 제어가 아님)이 Firefox의 마이크 또는 카메라 접근을 차단할 때 발생하므로 권한 요청 프롬프트가 전혀 나타나지 않습니다. 다음 단계에 따라 해결하세요: 1. 기본 iOS 설정 앱을 여세요. 2. 아래로 스크롤한 후 설치된 앱 목록에서 Firefox를 탭하세요. 3. 마이크 및 카메라 권한 토글을 모두 활성화하세요. 4. Firefox를 완전히 재시작하고, 영향을 받은 웹 페이지를 새로고침한 뒤 카메라/마이크 접근을 다시 시도하세요. MiroTalk 사용자의 경우: MiroTalk C2C는 작동하려면 카메라와 마이크 권한이 모두 필요하지만, MiroTalk P2P/SFU는 일부 또는 전혀 미디어 권한 없이도 작동할 수 있습니다. 임시 해결 방법: Firefox 권한을 조정할 수 없다면 iOS Safari를 사용하여 서비스에 접속하세요.

Question 4

MiroTalk C2C에서 .env 파일을 사용하여 STUN/TURN을 비활성화하고 빈 iceServers를 구성하려면 어떻게 해야 하나요?

Accepted Answer

.env에서 새 환경 변수 두 개를 모두 false로 설정하세요:

STUN_SERVER_ENABLED=false
TURN_SERVER_ENABLED=false

이렇게 하면 STUN과 TURN이 선택 사항이 되고 WebRTC가 빈 iceServers를 사용할 수 있게 되며, 이는 직접 또는 로컬 네트워크 피어 연결에서 작동할 수 있습니다. 파일을 변경한 후 애플리케이션을 다시 시작하세요. 값을 true로 설정하고 그에 해당하는 구성을 제공하여 둘 중 하나의 서버를 다시 활성화하세요.

Question 5

MiroTalk C2C에서 OV5647과 같은 Raspberry Pi CSI 카메라를 비디오 소스로 명시적으로 어떻게 선택하나요?

Accepted Answer

브라우저는 Linux/device-tree 경로 /base/soc/i2c0mux/i2c@1/ov5647@36를 직접 사용할 수 없습니다. WebRTC는 navigator.mediaDevices.enumerateDevices()를 통해 카메라를 노출하고 Web deviceId로 선택합니다.

1. CSI 카메라를 활성화하고 시스템에서 보이는지 확인합니다:
sudo raspi-config nonint do_camera 0
sudo reboot
sudo apt install -y v4l-utils
v4l2-ctl --list-devices
libcamera-hello --list-cameras

2. Chromium에서 localhost 또는 HTTPS를 통해 MiroTalk을 열고 카메라 권한을 부여합니다. 그런 다음 브라우저 DevTools 콘솔에서 다음을 실행합니다:
await navigator.mediaDevices.getUserMedia({ video: true });
const cameras = (await navigator.mediaDevices.enumerateDevices())
  .filter(d => d.kind === 'videoinput');
console.table(cameras.map(c => ({ label: c.label, deviceId: c.deviceId })));
카메라 권한이 부여되기 전까지 device label은 보통 비어 있습니다.

3. mirotalkc2c/frontend/js/client.js에서 getUserMedia() 호출을 찾고 label 또는 하드코딩된 deviceId로 CSI 카메라를 선택합니다:
const csiCamera = videoDevices.find(d =>
  /ov5647|bcm2835|unicam|mmal|csi/i.test(d.label)
);

const stream = await navigator.mediaDevices.getUserMedia({
  video: csiCamera
    ? { deviceId: { exact: csiCamera.deviceId } }
    : true,
  audio: true,
});
또는 2단계에서 출력된 정확한 deviceId를 복사한 뒤 다음을 사용하세요:
video: { deviceId: { exact: 'your-camera-device-id' } }
OverconstrainedError가 발생하면 exact를 ideal로 바꾸세요.

CSI 카메라가 enumerateDevices()에 나열되지 않으면 MiroTalk은 아직 이를 사용할 수 없습니다. 문제는 Chromium 또는 V4L2/libcamera 스택이 이를 노출하지 않기 때문입니다. 작동하는 USB 카메라를 임시로 사용하거나 먼저 브라우저 카메라 열거를 수정하세요.

MiroTalk C2C

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트