NDN-QUIC gateway

This repository provides a proxy between Chromium WebTransport API and Named Data Networking's plain UDP transport. It is designed to work with NDNts @ndn/quic-transport package.

gateway.py (deprecated)

This script is an HTTP/3 WebTransport server that accepts WebTransport sessions and forwards datagrams to a plain UDP server such as NDN forwarder. It has been deprecated in favor of NDN HTTP/3 WebTransport Gateway written in Go.

Deployment Instructions

1. Install system-wide dependencies in a sudoer user:

   sudo apt install python3-dev python3-venv
   curl -fsLS https://bootstrap.pypa.io/get-pip.py | sudo python3
   sudo pip install -U pip pipenv

2. Clone the repository in a non-root non-sudoer user.

3. Install local dependencies:

   pipenv install

4. Configure pm2 service:

   mkdir .data
   touch .data/tls.cert .data/tls.key
   cp sample.ecosystem.config.js ecosystem.config.js
   # modify ecosystem.config.js: fill in ROUTER hostname
   pm2 start ecosystem.config.js
   pm2 stop ecosystem.config.js

5. Obtain certificate with acme.sh in the root user: (assume the service is installed in node user)

   acme.sh --issue --standalone -d ndn-quic-gateway.example.net
   acme.sh --install-cert -d ndn-quic-gateway.example.net \
           --fullchain-file '/home/node/NDN-QUIC-gateway/.data/tls.cert' \
           --key-file '/home/node/NDN-QUIC-gateway/.data/tls.key' \
           --reloadcmd 'sudo -u node bash -ic "pm2 restart NDN-QUIC-gateway"'

6. Edit UDP MTU in NFD configuration:

   infoedit -f /etc/ndn/nfd.conf -s face_system.udp.unicast_mtu -v 1200

health.py

This script is an NDN-FCH 2021 health probe for HTTP/3. It should be deployed as a Docker container. No special configuration is necessary.