Bir hikari botunu 24/7 barındırmak için onu bilgisayarınızda değil, hep açık kalan bir makinede çalıştırın: kendiniz barındırıyorsanız systemd hizmetli bir Linux VPS, ya da kodunuzu yüklediğiniz, token'ı yapıştırdığınız ve Start'a bastığınız PlayNHost Discord bot barındırma sayfasındaki bir bot planı (ayda US$1,99'dan başlayan fiyatla). Testimizde hikari 2.7.0 botu yaklaşık 61 MB bellek kullandı ve başlatıldıktan yaklaşık 1,3 saniye sonra Discord'a ulaştı. hikari 2.7 Python 3.11 veya daha yenisini gerektirir ve kendi komut çerçevesi yoktur, bu yüzden bu sayfada yalnızca hikari ile yazılmış bir slash komutu var. PlayNHost'taki adımlar:
- Discord bot barındırma sayfasında bir planda Sunucu oluştur düğmesine tıklayın. Sipariş penceresinde Botunuz hangi platform için? sorusuna Discord ile yanıt verin ve Python'u seçin.
- Sunucunuzu panelde açın. Genel bakış sayfasındaki Botunuzu kurun kartı Discord’a bağlan adımında açılır. İlk adımı olan Ne çalışır içinde Bu bot Python Bot çalıştırır. yazmalı; kontrol etmek için bu adıma tıklayın, sonra Devam düğmesine.
- Discord’a bağlan adımında token'ınızı Bot token’ınızı yapıştırın alanına yapıştırın, Bağlan düğmesine, ardından Evet, devam düğmesine tıklayın.
- İzinler adımında, Kodum bunu kullanıyor kutusunu yalnızca kodunuzun istediği ayrıcalıklı intent'ler için işaretleyin (aşağıdaki bot hiçbirine ihtiyaç duymaz), Bir Discord sunucusuna ekle düğmesine, sonra Devam düğmesine tıklayın.
- Kodunuz adımında Dosya yükle düğmesine tıklayın ve
bot.pyilerequirements.txtdosyalarını yükleyin (hikariyazılı olmalı), ya da Git’i bağla düğmesine tıklayın. - Bot sayfasında Kod bölmesinde Çalışma ortamı ayarını Python 3.12 (recommended) olarak bırakın veya 3.11, 3.13 ya da 3.14'ü seçin (3.10'u değil), Giriş dosyası
bot.pydeğilse onu ayarlayın ve Kaydet düğmesine tıklayın. - Botu başlat düğmesine tıklayın ve Console'u izleyin. Botunuz
Logged in as ...yazdırdığında kart Botunuz Discord’da çevrimiçi. der.
Genel Python adımları (paketler, konsol satırları) Python Discord botu nasıl barındırılır yazısında. Bu sayfa hikari ile farklı olan noktaları anlatır.
Ne ölçtük
Her Python Discord kütüphanesini kendi sunucularımızda, bir bot planının kullandığı aynı Python 3.12 kurulumunda, 1 GB bellek sınırıyla çalıştırdık:
| Kütüphane | Sürüm | Boştaki bellek | Başlatmadan Discord'un yanıtına |
|---|---|---|---|
| hikari | 2.7.0 | 61 MB | 1.3 s |
| discord.py | 2.7.1 | 48 MB | 1.0 s |
| Pycord | 2.8.1 | 51 MB | 1.1 s |
| nextcord | 3.2.0 | 47 MB | 1.0 s |
| disnake | 2.12.2 | 47 MB | 0.9 s |
| Yalnızca Python | 3.12 | 9 MB |
Yöntem: kütüphaneyi yükleyen ve sahte bir token ile giriş yapan en küçük program, sunucularımızın kurduğu şekilde kurulmuş. Bellek, Discord token'ı reddettikten 15 saniye sonra işlemin tuttuğu miktardır; başlangıç süresi başlatmadan bu yanıta kadar sürer, yani Discord'a bir gidiş dönüşü içerir. Her değer, bir ısınma çalıştırmasından sonra üç çalıştırmanın ortancasıdır. Bu alt sınırdır: bağlanmış, sunuculara katılmış ve üyeleri önbelleğe almış bir bot daha fazlasını kullanır, ne kadar fazla olduğu bota göre değişir.
Plan için anlamı: en küçük bir hikari botu, 0.5 GB'lık STARTER planının küçük bir kısmını kullanır. Planı kütüphaneye göre değil, kendi botunuzun bellekte tuttuklarına göre seçin.
En küçük hikari botu
Bir slash komutuyla /ping komutuna yanıt verir ve bir hazır satırı yazdırır. Token'ı DISCORD_TOKEN değişkeninden okur; panelin koduna verdiği ad budur.
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 olayı her listener üzerindeki türe göre seçer. Tüm shard'lar başladığında (StartedEvent), bot komut listesini set_application_commands ile Discord'a gönderir; bu, botun genel komutlarını o listeyle değiştirir, sonra hazır satırını yazdırır. CommandInteractionCreateEvent biri bir komut kullandığında her seferinde gelir. Logged in as satırı, Genel bakış sayfasındaki etiketi Discord’da çevrimiçi durumuna çevirir.
Token yanlışsa
Discord token'ı reddettiğinde hikari şu hatayı verir (test botumuzun yazdırdığı metin):
UnauthorizedError: Unauthorized 401: '401: Unauthorized' for https://discord.com/api/v10/gateway/bot
Bu bir hikari.errors.UnauthorizedError hatasıdır; bot başlarken hikari'nin Discord'a yaptığı ilk istek tarafından oluşturulur ve bot durur. Token'ı Bot sayfasında Discord bölmesinde kontrol edin: Şimdi kontrol et düğmesine tıklayın ve Discord kabul etmedi yazıyorsa Discord Developer Portal'da Bot, Reset Token ile yeni bir token kopyalayın, Token’ı değiştir ile yapıştırın ve botu yeniden başlatın. Bkz. Discord botu nasıl oluşturulur ve token’ı nasıl alınır.
Bir barındırıcının hikari hakkında bilmesi gerekenler
- Python 3.11 veya daha yenisi. hikari 2.7.0 Python 3.11 veya sonrasını gerektirir; README'si 3.11 ile 3.15 arasını listeler. Python 3.10'da yalın bir
hikarisatırı pip'in 2.6.0'ı kurmasına yol açar, bu 3.10 için son sürümdür.hikari>=2.7,<3ile pip reddeder: konsol pip'in hatasını ve[PlayNHost] pip could not install everything in requirements.txt.satırını gösterir, hikari sunucuya hiç kurulmadıysa bot ardındanModuleNotFoundError: No module named 'hikari'hatasıyla durur. Çalışma ortamı altında 3.10 dışındaki her seçim çalışır. - Komut çerçevesi dahil değil. hikari olayları ve Discord'un REST API'sini sunar; README'si komutlar için lightbulb, tanjun, crescent ve arc'a yönlendirir. Yukarıdaki bot komutunu her başlangıçta kendisi kaydeder, README bunu oldukça spammy olarak niteler; bir komut işleyici veya komutların yalnızca değiştiklerinde gönderilmesi için kontroller önerir. Bir çerçeve,
requirements.txtiçinde bir satır daha demektir. - Her başlangıçta bir uyarı. hikari
You are running on optimization level 0 (no optimizations)yazar ve-Oönerir. Bir PlayNHost sunucusunda başlangıç betiği giriş dosyanızı yalınpythonile çalıştırır, bu yüzden bu uyarıyı görürsünüz ve bot normal çalışır. Gizlemek içinsuppress_optimization_warning=Truedeğerinihikari.GatewayBot()çağrısına verin. Kendi VPS'inizde bunun yerine-Oekleyebilirsiniz. - Günlükleme ve bir banner varsayılan olarak açıktır.
GatewayBotgünlüklemeyiINFOdüzeyinde kurar ve hikari banner'ını yazdırır. Bir shard bağlandığında kendi satırıshard is ready: ...biçimindedir; panelin etiketi bu satırı çevrimiçi saymaz, bu yüzden yukarıdaki gibi kendiLogged in assatırınızı yazdırın. - Güncellemeleri kontrol eder. Varsayılan olarak
run()PyPI'dan en yeni hikari'yi sorar ve varsaA newer version of hikari is availableyazar.bot.run(check_for_updates=False)bunu kapatır. - Intent'ler. Varsayılan, ayrıcalıklı olmayan tüm intent'lerdir. Mesaj metnini okumak için
hikari.Intents.MESSAGE_CONTENTdeğeriniintents=ile vermek ve Developer Portal'da Message Content Intent seçeneğini açmak gerekir. Kodunuz bunu isterken Portal'da kapalıysa Discord girişi reddeder. Bkz. Discord botunuzdaki "Used disallowed intents" hatasını düzeltin.
Linux VPS'te kendiniz barındırın
Önce Python sürümünü kontrol edin: python3 --version 3.11 veya daha yenisini göstermelidir. Debian 12 3.11, Ubuntu 24.04 3.12 ve Debian 13 3.13 ile gelir; Ubuntu 22.04 3.10 ile gelir, hikari 2.7 için fazla eski. Sonra Python'u kurun, bot için bir kullanıcı ve klasör oluşturun ve hikari'yi bir sanal ortama kurun:
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
Token'ı yalnızca root'un okuyabildiği bir dosyaya koyun. /etc/hikari-bot.env dosyasını sudo nano /etc/hikari-bot.env ile oluşturun, tek bir satır yazın, DISCORD_TOKEN= ve ardından token'ınız, kaydedin ve sudo chmod 600 /etc/hikari-bot.env komutunu çalıştırın.
Sonra /etc/systemd/system/hikari-bot.service dosyasını oluşturun. Python'u hikari README'sinin üretim için önerdiği gibi -O ile çalıştırır:
[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
Şimdi ve her açılışta başlatın, sonra çıktısını izleyin:
sudo systemctl daemon-reload
sudo systemctl enable --now hikari-bot
sudo journalctl -u hikari-bot -f
PYTHONUNBUFFERED=1, print() çıktısının bir tampon dolana kadar beklemeden günlüğe hemen ulaşmasını sağlar. Botu güncellemek için yeni dosyaları kopyalayın, pip install satırını yeniden çalıştırın ve sudo systemctl restart hikari-bot komutunu verin.
Kendi barındırma veya bot planı
| Kendi VPS'iniz | PlayNHost bot planı | |
|---|---|---|
| Python | Dağıtımınızın sunduğu sürüm; hikari 2.7 için 3.11 veya daha yenisi olmalı | Çalışma ortamı altında 3.11, 3.12, 3.13 veya 3.14'ü seçin |
| Paketler | Her değişiklikten sonra pip install komutunu siz çalıştırırsınız | requirements.txt veya Python sürümü değiştikten sonraki bir başlangıçta ve son kurulumdan bir gün sonraki ilk başlangıçta kurulur |
| Yeniden başlatmalar | Sizin systemd birimiz | Çökmeden sonra yeniden başlatılır; bir dakika içinde tekrar çökerse nedeniyle birlikte durdurulmuş bırakılır |
| Token | Kendinizin koruduğu bir dosya | Şifreli saklanır, yapıştırdığınızda Discord ile kontrol edilir, kodunuza DISCORD_TOKEN olarak verilir |
| Python bayrakları | -O seçeneğini ExecStart satırına ekleyin | Yalın python ile çalışır |
| Sistem güncellemeleri, güvenlik duvarı, SSH | Size ait | Sizin işiniz değil |
Sık sorulan sorular
lightbulb, tanjun, crescent veya arc gerekli mi?
Hayır. Yukarıdaki bot gösterdiği gibi, tek başına hikari slash komutlarını kaydedip yanıtlayabilir. Bir çerçeve hazır bir komut işleyicidir; birkaç komuttan fazlası olduğunda kaydı ve yönlendirmeyi kendiniz yazmazsınız. requirements.txt dosyasına ekleyin; bir sonraki başlangıçta kurulur.
/ping neden sunucumda görünmüyor?
Botun Bir Discord sunucusuna ekle ile eklendiğini ve konsolun Logged in as gösterdiğini kontrol edin: komut bu satırdan hemen önce kaydedilir. Test ederken guild=your_server_id değerini set_application_commands çağrısına verin: komut o zaman yalnızca o sunucuda oluşturulur ve Discord'un belgelerine göre sunucu komutları anında güncellenir.
Optimizasyon uyarısı bir sorun mu?
Hayır. Python'un -O olmadan çalıştığını söyler; bu seçenek assert deyimlerini ve yalnızca hata ayıklama amaçlı diğer kontrolleri kaldırır ve hikari bunu hız için önerir. Botunuz onsuz da çalışır. Uyarıyı suppress_optimization_warning=True ile gizleyin.
Bir hikari botu en küçük plana sığar mı?
Evet. Testimizde yaklaşık 61 MB ile en küçük bir hikari botu, 0.5 GB'lık STARTER planının çoğunu kendi kodunuza bırakır. Botun kendisi gerektirdiğinde bir üst plana geçin: üyelerini önbelleğe aldığı büyük sunucular, işlediği dosyalar veya görseller ya da bellekte tuttuğu veriler.
Kendi botunuzu çalıştırmaya hazır mısınız? Discord bot barındırma sayfasında bir plan seçin ve hikari botunuzu yükleyin.



