Gwida

Ospita s-server Mumble tiegħek

Mumcord ma jeħtieġx server speċjali: server Mumble normali huwa biżżejjed. B’Docker tiegħek ikun għaddej f’madwar 15-il minuta, anke jekk qatt ma għamilt dan qabel.

  • 64738 port, TCP u UDP
  • 1 core u 512 MB RAM jlaħħqu ma’ għexieren ta’ nies
  • €0 open source; tħallas biss għall-magna

Fi tmien passi

  1. Agħżel magna

    L-eħfef għażla hija server Linux żgħir minn provider tal-hosting (“VPS” għal ftit ewro fix-xahar). Jaħdem bla waqfien u għandu indirizz fiss. Kompjuter id-dar jew Raspberry Pi jaħdmu wkoll; imbagħad trid tiftaħ port fuq ir-router tiegħek (pass 5).

    Mumble jeħtieġ ftit li xejn qawwa. Il-konnessjoni tgħodd aktar: kull persuna li titkellem tuża madwar 40–100 kbit/s.

  2. Installa Docker

    Idħol fis-server permezz ta’ SSH. Fuq Linux dan il-kmand jinstalla Docker inkluż Compose. Fuq Windows u macOS uża Docker Desktop minflok.

    Terminal
    curl -fsSL https://get.docker.com | sudo sh
    docker compose version

    Jekk tara numru tal-verżjoni, int lest.

  3. Oħloq folder u password

    Oħloq folder u ġġenera password każwali għall-kont tal-amministratur SuperUser:

    Terminal
    mkdir -p ~/mumble && cd ~/mumble
    openssl rand -base64 24
    .env
    # Stays on the server. Never share it in Git, chats or screenshots.
    SUPERUSER_PASSWORD=paste-the-random-password-here
    SERVER_PASSWORD=

    Salva t-tieni fajl bħala .env u waħħal fih il-password iġġenerata (pereżempju b’nano .env). Jekk mhux kulmin għandu l-indirizz għandu jidħol, issettja SERVER_PASSWORD li tagħtiha lin-nies tiegħek. Imbagħad chmod 600 .env iżomm lill-utenti l-oħra tal-magna barra mill-fajl.

  4. Id-docker-compose.yml

    Dan il-fajl imur fl-istess folder bħala docker-compose.yml. Biddel l-isem tas-server u t-test ta’ merħba kif tixtieq; il-bqija huwa tajjeb kif inhu.

    docker-compose.yml
    # Mumble server for Mumcord and any other Mumble client
    name: mumble
    
    services:
      mumble-server:
        image: mumblevoip/mumble-server:v1.5.735   # pinned version; raise it here to update
        restart: unless-stopped
        ports:
          - "64738:64738/tcp"   # connection and chat
          - "64738:64738/udp"   # voice
        volumes:
          - data:/data          # channels, registrations and certificate
        environment:
          # Passwords come from the .env file next to this one, never straight in here.
          MUMBLE_SUPERUSER_PASSWORD: ${SUPERUSER_PASSWORD:?SUPERUSER_PASSWORD is missing in .env}
          MUMBLE_CONFIG_SERVER_PASSWORD: ${SERVER_PASSWORD:-}   # empty = anyone with the address can join
          MUMBLE_CONFIG_REGISTER_NAME: "Our Server"              # name of the top channel
          MUMBLE_CONFIG_WELCOME_TEXT: "Welcome! Say hi in the chat."   # pinned at the top of the chat in Mumcord
          MUMBLE_CONFIG_USERS: "50"                             # at most this many at once
          MUMBLE_CONFIG_IMAGE_MESSAGE_LENGTH: "1048576"         # images in chat up to 1 MB (default: 128 KB)
          MUMBLE_CONFIG_TEXT_MESSAGE_LENGTH: "10000"            # longer messages (default: 5000 characters)
    
    volumes:
      data:

    L-aħħar żewġ settings huma hemm għal Mumcord: l-istampi mwaħħla jistgħu jkunu akbar, u messaġġi twal ma jinqatgħux. Kull setting ieħor isegwi l-istess mudell MUMBLE_CONFIG_…, ara d-dokumentazzjoni tal-image.

  5. Ibdih u iftaħ il-port

    Ibda s-server u agħti ħarsa malajr lill-log:

    Terminal
    docker compose up -d
    docker compose logs -f   # Ctrl+C only stops the output

    Hekk kif jgħid Server listening on 0.0.0.0:64738, ikun qed jaħdem. Issa l-port 64738 għal TCP u UDP irid ikun jista’ jintlaħaq minn barra:

    Server b’firewall (pereżempju ufw): sudo ufw allow 64738/tcp u sudo ufw allow 64738/udp. Xi providers għandhom ukoll firewall fil-panel tal-klijenti.

    Kompjuter id-dar: issettja port forwarding fuq ir-router tiegħek għal 64738 TCP u UDP lejn dan il-kompjuter.

  6. Ikkonnettja ma’ Mumcord

    F’Mumcord, ikklikkja + fil-bar tas-servers u daħħal l-indirizz IP jew l-isem tas-server tiegħek. Isem huwa isbaħ minn IP: oħloq A record għand il-provider tad-dominju tiegħek, bħal voice.example.org, li jipponta lejn l-IP.

    Fl-ewwel konnessjoni Mumcord juri l-fingerprint taċ-ċertifikat. Dan huwa mistenni: is-server ħoloq iċ-ċertifikat tiegħu stess fl-ewwel bidu. Ikkonfermah darba; jekk jinbidel b’mod mhux mistenni aktar tard, Mumcord iwissik.

  7. Stieden lin-nies

    Ibgħat link lin-nies tiegħek. Meta jikklikkjawh jiftaħ Mumcord (jew kwalunkwe client ieħor ta’ Mumble) u jikkonnettja minnufih; żid isem ta’ kanal fl-aħħar biex jaslu fil-kanal it-tajjeb:

    Terminal
    mumble://voice.example.org
    mumble://voice.example.org/Gaming

    Min għad m’għandux Mumcord isibu fuq mumcord.app. Ibgħat il-password tas-server separatament mil-link.

  8. Issettja l-kanali u l-permessi

    Il-ħolqien tal-kanali u l-għoti tal-permessi jaslu f’Mumcord mal-Epic 4. Sa dakinhar, uża l-client uffiċjali ta’ Mumble darba:

    1. Ikkonnettja bl-username SuperUser u l-password minn .env.

    2. Right-click fuq il-kanal ta’ fuq nett → Żid, għal kull kanal li trid.

    3. Biex ma jkollokx bżonn SuperUser kull darba: ikkonnettja ma’ Mumcord b’ismek u ikklikkja ismek isfel fuq ix-xellug → Irreġistra fuq dan is-server. Imbagħad, bħala SuperUser, il-kanal ta’ fuq nett → Editja → Gruppi → żid ismek mal-grupp admin.

Manutenzjoni u problemi

Kif naġġorna s-server?

Ikteb il-verżjoni l-ġdida wara image: f’docker-compose.yml (ara l-lista fuq Docker Hub), imbagħad ħaddem docker compose pull u docker compose up -d. Il-kanali u r-reġistrazzjonijiet jinżammu.

Kif nagħmel backup?

Kull ma jgħodd jinsab fil-volume mumble_data. Waqqaf, ippakkja, kompli: docker compose stop, imbagħad docker run --rm -v mumble_data:/data -v "$PWD":/backup alpine tar czf /backup/mumble-backup.tar.gz -C /data . u fl-aħħar docker compose start.

Ħadd ma jista’ jilħaq is-server.

Kważi dejjem il-port huwa magħluq. Iċċekkja b’docker compose ps li l-container qed jaħdem, imbagħad il-firewall, il-firewall tal-provider u r-router tiegħek (pass 5). Jekk is-server ikun id-dar, jista’ jkun li ma tilħaqx l-indirizz pubbliku minn ġewwa n-netwerk tiegħek; f’dak il-każ ittestja bl-IP lokali.

Il-konnessjoni taħdem, iżda l-leħen jaqbad.

Normalment huwa miftuħ biss TCP, mhux UDP. Imbagħad Mumcord jaqleb għal TCP waħdu. Jaħdem iżda huwa aktar bil-mod. Iftaħ ukoll UDP 64738.

Insejt il-password tas-SuperUser.

Poġġi waħda ġdida f’.env u ħaddem docker compose up -d. Is-server japplikaha kull darba li jibda.

Aktar għajnuna tinsab fil-wiki u fl-issues fuq GitHub. Wiki → Issues →