NIEUW 📢 Black Friday: onze lanceeractie eindigt op 30 nov. Tot 70% korting op je eerste maand, voor elke game!Bekijk pakketten
Black FridayTot 70% korting op je eerste maand, eindigt op 30 nov.Eindigt over 9 d 02 u 49 minBlack FridayTot 70% korting op je eerste maand, eindigt op 30 nov.Eindigt over 9 d 02 u 49 minBlack FridayTot 70% korting op je eerste maand, eindigt op 30 nov.Eindigt over 9 d 02 u 49 min

Een hikari-bot 24/7 hosten

Discord-bothostingBijgewerkt 6 nov 202610 min lezen

Om een hikari-bot 24/7 te hosten, laat je hem draaien op een machine die aan blijft in plaats van op je pc: een Linux-VPS met een systemd-service als je zelf host, of een botabonnement bij PlayNHost Discord-bothosting (vanaf US$1.99 per maand), waar je je code uploadt, het token plakt en op Start drukt. In onze test gebruikte een hikari 2.7.0-bot ongeveer 61 MB geheugen en bereikte hij Discord ongeveer 1,3 seconden na het starten. hikari 2.7 heeft Python 3.11 of nieuwer nodig en heeft geen eigen commandoframework, dus deze pagina bevat een slash-commando dat alleen met hikari is geschreven. De stappen bij PlayNHost:

  1. Klik op de pagina Discord-bothosting bij een abonnement op Server aanmaken. Beantwoord in het bestelvenster Voor welk platform is je bot? met Discord en kies Python.
  2. Open je server in het paneel. De kaart Je bot instellen op het Overzicht opent bij Verbinden met Discord. De eerste stap, Wat er draait, hoort Deze bot draait Python Bot. te tonen; klik op die stap om het te controleren en dan op Doorgaan.
  3. Plak bij Verbinden met Discord je token in Plak je bottoken, klik op Verbinden en dan op Ja, doorgaan.
  4. Vink bij Rechten Mijn code gebruikt dit alleen aan voor de bevoorrechte intents die je code vraagt (de bot hieronder heeft er geen nodig), klik op Toevoegen aan een Discord-server en dan op Doorgaan.
  5. Klik bij Je code op Bestanden uploaden en upload bot.py en een requirements.txt waarin hikari staat, of klik op Git koppelen.
  6. Laat op de pagina Bot, paneel Code, de Runtime op Python 3.12 (recommended) staan of kies 3.11, 3.13 of 3.14 (niet 3.10), stel het Startbestand in als het niet bot.py is en klik op Opslaan.
  7. Klik op Bot starten en bekijk de Console. Als je bot Logged in as ... afdrukt, zegt de kaart Je bot is online in Discord.

De algemene Python-stappen (pakketten, consoleregels) staan in Een Python Discord-bot hosten. Deze pagina behandelt wat er bij hikari anders is.

Wat we hebben gemeten

We hebben elke Python-Discordbibliotheek op onze eigen servers laten draaien, in dezelfde Python 3.12-opzet die een botabonnement gebruikt, met een geheugenlimiet van 1 GB:

BibliotheekVersieGeheugen in rustStart tot antwoord van Discord
hikari2.7.061 MB1.3 s
discord.py2.7.148 MB1.0 s
Pycord2.8.151 MB1.1 s
nextcord3.2.047 MB1.0 s
disnake2.12.247 MB0.9 s
Alleen Python3.129 MB

Hoe: het kleinst mogelijke programma dat de bibliotheek laadt en inlogt met een nep-token, geïnstalleerd zoals onze servers het installeren. Het geheugen is wat het proces 15 seconden nadat Discord het token weigerde in gebruik had, en de starttijd loopt van het starten tot dat antwoord, dus er zit één reis naar Discord in. Elke waarde is de mediaan van drie runs na een opwarmrun. Het is de ondergrens: een bot die verbonden is, servers is binnengegaan en leden heeft gecachet, gebruikt meer, met een hoeveelheid die van de bot afhangt.

Wat het voor het abonnement betekent: een minimale hikari-bot gebruikt een klein deel van het STARTER-abonnement van 0.5 GB. Kies het abonnement op basis van wat je eigen bot in het geheugen houdt, niet op basis van de bibliotheek.

Een minimale hikari-bot

Hij antwoordt op /ping met een slash-commando en drukt een gereedregel af. Hij leest het token uit DISCORD_TOKEN, de naam die het paneel aan je code geeft.

requirements.txt

hikari>=2.7,<3

bot.py

import os

import hikari

bot = hikari.GatewayBot(token=os.environ["DISCORD_TOKEN"])


@bot.listen()
async def register_commands(event: hikari.StartedEvent) -> None:
    application = await bot.rest.fetch_application()
    await bot.rest.set_application_commands(
        application=application.id,
        commands=[bot.rest.slash_command_builder("ping", "Check that the bot answers")],
    )
    print(f"Logged in as {bot.get_me()}")


@bot.listen()
async def on_command(event: hikari.CommandInteractionCreateEvent) -> None:
    if event.interaction.command_name == "ping":
        await event.interaction.create_initial_response(
            hikari.ResponseType.MESSAGE_CREATE, "Pong!"
        )


bot.run()

hikari kiest het event op basis van het type bij elke listener. Als alle shards gestart zijn (StartedEvent), stuurt de bot zijn commandolijst met set_application_commands naar Discord, wat de globale commando's van de bot door die lijst vervangt, en drukt dan de gereedregel af. CommandInteractionCreateEvent komt binnen telkens als iemand een commando gebruikt. De regel Logged in as zet het label op het Overzicht op Online in Discord.

Als het token fout is

Als Discord het token weigert, geeft hikari deze fout (de tekst die onze testbot afdrukte):

UnauthorizedError: Unauthorized 401: '401: Unauthorized' for https://discord.com/api/v10/gateway/bot

Het is een hikari.errors.UnauthorizedError, veroorzaakt door het eerste verzoek van hikari aan Discord bij het starten van de bot, en de bot stopt. Controleer het token op de pagina Bot, paneel Discord: klik op Nu controleren en als er Discord heeft het niet geaccepteerd staat, kopieer dan een nieuw token in het Discord Developer Portal, Bot, Reset Token, plak het met Token vervangen en start de bot opnieuw. Zie Een Discord-bot maken en zijn token ophalen.

Wat een host over hikari moet weten

  • Python 3.11 of nieuwer. hikari 2.7.0 vereist Python 3.11 of later; de README noemt 3.11 tot 3.15. Op Python 3.10 laat een kale hikari-regel pip 2.6.0 installeren, de laatste release voor 3.10. Met hikari>=2.7,<3 weigert pip: de console toont de fout van pip en [PlayNHost] pip could not install everything in requirements.txt., en als hikari nog nooit op de server is geïnstalleerd, stopt de bot daarna met ModuleNotFoundError: No module named 'hikari'. Onder Runtime werkt elke keuze behalve 3.10.
  • Geen commandoframework inbegrepen. hikari geeft je events en de REST-API van Discord; de README verwijst voor commando's naar lightbulb, tanjun, crescent en arc. De bot hierboven registreert zijn commando bij elke start zelf, wat de README nogal spammy noemt; die stelt een commandohandler voor, of controles zodat de commando's alleen worden verstuurd als ze veranderd zijn. Een framework is één regel extra in requirements.txt.
  • Een waarschuwing bij elke start. hikari logt You are running on optimization level 0 (no optimizations) en stelt -O voor. Op een PlayNHost-server draait het startscript je startbestand met kale python, dus je ziet deze waarschuwing en de bot werkt normaal. Om haar te verbergen geef je suppress_optimization_warning=True mee aan hikari.GatewayBot(). Op je eigen VPS kun je in plaats daarvan -O toevoegen.
  • Logging en een banner staan standaard aan. GatewayBot zet logging op INFO en drukt de hikari-banner af. De eigen regel als een shard verbindt is shard is ready: ...; het label in het paneel telt die regel niet als online, dus druk zoals hierboven je eigen Logged in as-regel af.
  • Hij zoekt naar updates. Standaard vraagt run() aan PyPI naar de nieuwste hikari en logt A newer version of hikari is available als die er is. bot.run(check_for_updates=False) zet dat uit.
  • Intents. Standaard zijn dat alle intents die niet bevoorrecht zijn. Het lezen van berichttekst vraagt hikari.Intents.MESSAGE_CONTENT in intents= en Message Content Intent aan in het Developer Portal. Als je code erom vraagt terwijl het in het Portal uit staat, weigert Discord de login. Zie "Used disallowed intents" oplossen op je Discord-bot.

Zelf hosten op een Linux-VPS

Controleer eerst de Python-versie: python3 --version moet 3.11 of nieuwer zeggen. Debian 12 levert 3.11, Ubuntu 24.04 levert 3.12 en Debian 13 levert 3.13; Ubuntu 22.04 levert 3.10, te oud voor hikari 2.7. Installeer dan Python, maak een gebruiker en een map voor de bot en installeer hikari in een virtuele omgeving:

sudo apt update
sudo apt install -y python3 python3-venv
sudo useradd --system --create-home --home-dir /opt/hikari-bot bot
sudo cp bot.py requirements.txt /opt/hikari-bot/
sudo chown bot: /opt/hikari-bot/bot.py /opt/hikari-bot/requirements.txt
sudo -u bot python3 -m venv /opt/hikari-bot/venv
sudo -u bot /opt/hikari-bot/venv/bin/pip install -r /opt/hikari-bot/requirements.txt

Zet het token in een bestand dat alleen root kan lezen. Maak /etc/hikari-bot.env met sudo nano /etc/hikari-bot.env, schrijf één regel, DISCORD_TOKEN= gevolgd door je token, sla op en voer sudo chmod 600 /etc/hikari-bot.env uit.

Maak dan /etc/systemd/system/hikari-bot.service. Het draait Python met -O, zoals de README van hikari voor productie aanraadt:

[Unit]
Description=hikari Discord bot
Wants=network-online.target
After=network-online.target

[Service]
User=bot
WorkingDirectory=/opt/hikari-bot
EnvironmentFile=/etc/hikari-bot.env
Environment=PYTHONUNBUFFERED=1
ExecStart=/opt/hikari-bot/venv/bin/python -O bot.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Start het nu en bij elke boot en volg dan de uitvoer:

sudo systemctl daemon-reload
sudo systemctl enable --now hikari-bot
sudo journalctl -u hikari-bot -f

PYTHONUNBUFFERED=1 zorgt dat print() meteen in de journal komt in plaats van pas als een buffer vol raakt. Om de bot bij te werken kopieer je de nieuwe bestanden, voer je de regel pip install opnieuw uit en daarna sudo systemctl restart hikari-bot.

Zelf hosten of een botabonnement

Je eigen VPSEen PlayNHost-botabonnement
PythonDe versie van je distributie, die voor hikari 2.7 3.11 of nieuwer moet zijnKies 3.11, 3.12, 3.13 of 3.14 onder Runtime
PakkettenJij voert na elke wijziging pip install uitGeïnstalleerd bij een start nadat requirements.txt of de Python-versie is gewijzigd, en bij de eerste start een dag na de laatste installatie
HerstartsJe systemd-unitNa een crash opnieuw gestart; met de reden gestopt gelaten als hij binnen een minuut opnieuw crasht
Het tokenEen bestand dat je zelf beschermtVersleuteld opgeslagen, bij het plakken met Discord gecontroleerd, aan je code gegeven als DISCORD_TOKEN
Python-optiesVoeg -O toe in ExecStartDraait met kale python
Systeemupdates, firewall, SSHDoe je zelfNiet jouw taak

Veelgestelde vragen

Heb ik lightbulb, tanjun, crescent of arc nodig?

Nee. hikari alleen kan slash-commando's registreren en beantwoorden, zoals de bot hierboven laat zien. Een framework is een kant-en-klare commandohandler, zodat je registratie en routering niet zelf schrijft zodra je meer dan een paar commando's hebt. Voeg het toe aan requirements.txt; het wordt bij de volgende start geïnstalleerd.

Waarom verschijnt /ping niet in mijn server?

Controleer of de bot is toegevoegd met Toevoegen aan een Discord-server en of de console Logged in as toont: het commando wordt vlak voor die regel geregistreerd. Geef tijdens het testen guild=your_server_id mee aan set_application_commands: het commando wordt dan alleen in die server aangemaakt, en volgens de documentatie van Discord worden servercommando's direct bijgewerkt.

Is de optimalisatiewaarschuwing een probleem?

Nee. Ze zegt dat Python zonder -O draait, de optie die assert-statements en andere alleen-debugcontroles verwijdert en die hikari voor snelheid voorstelt. Je bot werkt zonder. Verberg de waarschuwing met suppress_optimization_warning=True.

Past een hikari-bot in het kleinste abonnement?

Ja. Met ongeveer 61 MB in onze test laat een minimale hikari-bot het grootste deel van het STARTER-abonnement van 0.5 GB over voor je eigen code. Stap over naar een groter abonnement als je bot zelf dat nodig heeft: grote servers waarvan hij de leden cachet, bestanden of afbeeldingen die hij verwerkt, of gegevens die hij in het geheugen houdt.

Klaar om de jouwe te draaien? Kies een abonnement op Discord-bothosting en upload je hikari-bot.

Draait je bot al ergens anders? Verhuis hem naar ons

ONZE NIEUWSTE BLOGS