Tools

mumpeer

Relay żgħir għall-konnessjonijiet diretti ta' Mumcord bejn l-utenti, pereżempju għall-qsim tal-iskrin jew għal immaġini bid-daqs sħiħ. Meta żewġ persuni ma jistgħux jilħqu lil xulxin direttament, wara CGNAT, firewalls stretti jew f'netwerks mingħajr UDP, jew ma jridux juru l-indirizz IP tagħhom, it-tnejn jikkonnettjaw mar-relay minflok. Dan jgħaddi biss il-pakketti kriptati, bħal server TURN.

L-aħħar verżjoni: v0.1.0

Maġenb is-server Mumble tiegħek

Komunità tħaddem mumpeer maġenb is-server Mumble tagħha, flimkien mal-bot tar-relay mumbot peer. Il-bot jannunzja r-relay u jqassam tokens ta' ħajja qasira. Is-server Mumble jibqa' mhux mibdul.

Utenti vverifikati biss

Token jaħdem biss għal eżattament żewġ ċertifikati, darba għal kull naħa u għal 120 sekonda b'mod awtomatiku. Ir-relay qatt ma jgħaddi lil xi mkien ieħor u qatt ma jiftaħ konnessjonijiet waħdu, allura mhuwiex proxy miftuħ.

Kriptat minn tarf sa tarf

Dak li jgħaddi mir-relay huwa konnessjoni kriptata separata bejn iż-żewġ utenti, marbuta maċ-ċertifikati Mumble tagħhom. Ir-relay la jista' jaqrah u lanqas jbiddlu.

Minn kważi kull firewall

QUIC fuq UDP jew, fejn l-UDP hu mblukkat, TLS fuq TCP. It-tnejn fuq il-port 443 u b'TLS 1.3.

Għażla sħiħa

Mumcord jaħdem ukoll mingħajr bot u relay. Fil-Mumcord int tagħżel: relay mitfi, biss meta konnessjoni diretta tfalli, jew dejjem.

Dak li l-operatur jista' jara

  • L-indirizzi IP taż-żewġ utenti ta' sessjoni
  • Liema żewġ ċertifikati qed jitkellmu ma' xulxin
  • Kemm qed jiġri data u meta
  • Mhux il-kontenut: huwa kriptat minn tarf sa tarf. Mumcord jgħidlek dan qabel ma tuża relay
  • Qatt ma jiġu rreġistrati: indirizzi IP sħaħ, hashes sħaħ taċ-ċertifikati, tokens u kontenut tal-pakketti

Mexxih b'Docker

Poġġi sigriet twil każwali ġewwa .env bħala PEER_API_SECRET (per eżempju minn openssl rand -hex 32). Mill-eżempju tar-relay ta' Mumbot, issejvja mumpeer.example.toml bħala mumpeer.toml u ssettja public_host fih, u bot.example.toml bħala bot.toml. Imbagħad ibda r-relay u l-bot flimkien:

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:

L-ewwel darba li jibda, il-marka tas-swaba' tar-relay tidher fil-log. Il-bot jannunzjaha lil Mumcord, m'hemm bżonn naqsmu xejn aktar. Iftaħ UDP u TCP fuq il-port 443, l-API jibqa' bejn ir-relay u l-bot. Mumcord juża r-relay mill-verżjoni 0.5.0.

Kontributuri

Kodiċi sors Il-gwida sħiħa fil-README → Ideat u bugs →