Tools

mumpeer

Athsheachadán beag do naisc dhíreacha Mumcord idir úsáideoirí, mar shampla le haghaidh comhroinnt scáileáin nó íomhánna lánmhéide. Nuair nach féidir le beirt teacht ar a chéile go díreach, taobh thiar de CGNAT, ballaí dóiteáin docha nó i líonraí gan UDP, nó nuair nach dteastaíonn uathu a seoladh IP a thaispeáint, ceanglaíonn an bheirt acu leis an athsheachadán ina ionad. Ní dhéanann sé ach na paicéid chriptithe a chur ar aghaidh, cosúil le freastalaí TURN.

An leagan is déanaí: v0.1.0

Taobh le do fhreastalaí Mumble

Ritheann pobal mumpeer taobh lena bhfreastalaí Mumble, in éineacht leis an mbota athsheachadáin mumbot peer. Fógraíonn an bota an t-athsheachadán agus tugann sé comharthaí gearrshaolacha amach. Fanann an freastalaí Mumble gan athrú.

Úsáideoirí fíoraithe amháin

Oibríonn comhartha do dhá theastas go beacht amháin, uair amháin ar gach taobh agus ar feadh 120 soicind de réir réamhshocraithe. Ní chuireann an t-athsheachadán ar aghaidh in áit ar bith eile riamh agus ní osclaíonn sé naisc ann féin riamh, mar sin ní seachfhreastalaí oscailte é.

Criptithe ó cheann go ceann

Is nasc criptithe ar leith idir an bheirt úsáideoirí an rud a théann tríd an athsheachadán, ceangailte lena dteastais Mumble. Ní féidir leis an athsheachadán é a léamh ná a athrú.

Trí bhalla dóiteáin ar bith beagnach

QUIC thar UDP nó, nuair atá UDP blocáilte, TLS thar TCP. An dá cheann ar phort 443 agus le TLS 1.3.

Roghnach go hiomlán

Oibríonn Mumcord gan bota ná athsheachadán freisin. I Mumcord roghnaíonn tú féin: athsheachadán as, nuair a theipeann ar nasc díreach amháin, nó i gcónaí.

Cad a fheiceann an t-oibreoir

  • Seoltaí IP an dá úsáideoir i seisiún
  • Cén dá theastas atá ag labhairt lena chéile
  • Cé mhéad sonraí atá ag sreabhadh agus cathain
  • Ní an t-ábhar: tá sé criptithe ó cheann go ceann. Insíonn Mumcord duit é sula n-úsáideann tú athsheachadán
  • Ní logáiltear riamh: seoltaí IP iomlána, hais iomlána teastas, comharthaí agus ábhar paicéad

Rith é le Docker

Cuir rún fada randamach in .env mar PEER_API_SECRET (mar shampla ó openssl rand -hex 32). Ó shampla athsheachadáin Mumbot, sábháil mumpeer.example.toml mar mumpeer.toml agus socraigh public_host ann, agus bot.example.toml mar bot.toml. Ansin tosaigh an t-athsheachadán agus an bota le chéile:

docker-compose.yml
services:
  mumpeer:
    image: ghcr.io/mumcord/mumpeer:0.1.0
    restart: unless-stopped
    environment:
      MUMPEER_API_SECRET: ${PEER_API_SECRET:?set PEER_API_SECRET in .env}
    ports: ["443:443/udp", "443:443/tcp"]
    volumes:
      - ./mumpeer.toml:/config/mumpeer.toml:ro
      - mumpeer-data:/var/lib/mumpeer
  mumbot:
    image: ghcr.io/mumcord/mumbot:0.2.0
    command: ["peer"]
    restart: unless-stopped
    network_mode: "service:mumpeer"
    environment:
      MUMBOT_CONFIG: /config/bot.toml
      MUMBOT_PEER_API_SECRET: ${PEER_API_SECRET:?set PEER_API_SECRET in .env}
    volumes:
      - ./bot.toml:/config/bot.toml:ro
      - mumbot-data:/data
    healthcheck:
      disable: true
volumes:
  mumpeer-data:
  mumbot-data:

Ar an gcéad tosú taispeántar méarlorg an athsheachadáin sa log. Fógraíonn an bota é do Mumcord, ní gá aon rud eile a roinnt. Oscail UDP agus TCP ar phort 443, fanann an API idir an t-athsheachadán agus an bota. Úsáideann Mumcord an t-athsheachadán ó leagan 0.5.0.

Rannpháirtithe

Cód foinse An treoir iomlán sa README → Smaointe agus fabhtanna →