CSUBOT ni roboti msimamizi mkuu wa chanzo huria.

Makala haya yanaeleza jinsi ya kupeleka CSUBOT kibinafsi.

Tafadhali soma hati hii kikamilifu kwanza: Mwongozo wa Mtumiaji wa Roboti ya CSUBOT

Inapendekezwa: Angalia IP ya umma ya mashine hii inayofikia tovuti tofauti , kutathmini mazingira ya sasa ya mtandao.

Masharti

Kupeleka CSUBOT kibinafsi, unahitaji kukidhi angalau masharti yafuatayo:

  • Kuwa na jina la kikoa. (Kuwa na angalau kikoa kimoja cha ngazi ya pili, kwa ajili ya backend. Kwa kweli, frontend na backend zinahitaji vikoa viwili vya ngazi ya pili, lakini kwa kawaida kikoa cha frontend kinaweza kutolewa na jukwaa la upelekaji)
  • Kuwa na seva. Au ipeleke kwenye jukwaa ambalo linaweza kupeleka huduma za backend. Ikiwa unajua jukwaa lisilolipishwa ambalo linaweza kupeleka huduma za backend, tafadhali usisite, bonyeza hapa, toa maoni na umwambie mwandishi .
  • Kuwa na akaunti ya Telegram ambayo haijawekewa vikwazo, kwa ajili ya kuunda roboti ya Telegram, na kupata Tokeni ya roboti
  • Kuwa na akaunti ya Cloudflare ambayo haijawekewa vikwazo, kwa ajili ya kuwezesha msimbo wa uthibitishaji wa Cloudflare Turnstile. Fungua akaunti: https://dash.cloudflare.com/

Hatua za Uendeshaji

  1. Wezesha Cloudflare Turnstile
  2. Peleka frontend
  3. Unda roboti ya Telegram
  4. Sanidi backend

Wezesha Cloudflare Turnstile

Bonyeza kiungo hiki, fungua paneli ya usanidi ya Cloudflare Turnstile Usanidi wa Sehemu za Turnstile

Bonyeza add widget, ongeza sehemu ya Turnstile

Bonyeza Add Hostnames , ongeza kikoa cha frontend. Ikiwa unapanga kutumia kikoa kilichotolewa na jukwaa la upangishaji la frontend, unaweza kuandika chochote hapa.

Bonyeza kitufe cha kuunda, kisha unaweza kuona Site Key na Secret Key

Peleka frontend

Tunatoa mfano wa upelekaji kwenye jukwaa la upangishaji la frontend.

  1. Fungua https://github.com/cjh0613/csubot-vue , fork hifadhi hii
  2. Chagua jukwaa la kupeleka, kama vile Cloudflare Pages, Vercel, Netlify, n.k.
  3. Chagua kuagiza kutoka kwa hifadhi ya Github, chagua hifadhi iliyoforked katika hatua ya kwanza.

Njia ya kufanya kazi imesanidiwa kuwa saraka ya mizizi ya mradi, amri ya kuunganisha ni:

npm install && npm run build

Saraka ya pato ni:

dist/

Sanidi vibadala vya mazingira:

VITE_ENDPOINT=https://xxxx.com <URL ya backend, inahitaji https>

VITE_SITEKEY=0x4AAAAAABBBBBBBBBBB <Kitufe cha tovuti cha Cloudflare turnstile (kile kilicho juu zaidi)>
  1. Anza kupeleka, baada ya kukamilika unaweza kuona kikoa kilichotolewa na jukwaa. Unaweza pia kufunga kikoa chako mwenyewe. Unahitaji kusubiri usanidi wa DNS na utengenezaji wa cheti.

Unda roboti ya Telegram

Piga gumzo la faragha na https://t.me/BotFather , tuma /newbot , fuata maagizo ya roboti kuunda roboti mpya, baada ya kuunda, utapokea Tokeni

Sanidi backend

Unaweza kuchagua kuendesha faili ya utekelezaji ya binary moja kwa moja, au ujikusanye mwenyewe.

Marejeleo ya vibadala vya mazingira

TGWD_TOKEN=<tokeni ya roboti ya Telegram, imepatikana @botfather>
TGWD_FRONTEND_DOMAIN=<kikoa cha frontend, hakihitaji https>
TGWD_SECRET=<jaza chochote>
TGWD_PORT=8000
TGWD_CFTS_API_KEY=<Kitufe cha Siri cha Cloudflare turnstile (kile kilicho chini ya kitufe cha tovuti)>

Tumia faili ya utekelezaji ya binary

Tunatoa mfano wa mfumo wa uendeshaji wa linux amd64.

Kwanza unda folda mpya.

mkdir csubot && cd csubot

Pakua faili ya utekelezaji ya binary. Kiungo cha kupakua hapa, tafadhali fungua https://github.com/cjh0613/csubot/releases kupata kiungo cha hivi karibuni, unaweza kuhitaji kubonyeza Show all assets ili kupata faili inayofaa kwa jukwaa lako.

wget https://github.com/cjh0613/csubot/releases/download/vxxx/csubot-linux-amd64.zip

Kwa sababu ni kifurushi kilichobanwa cha zip, kitoe:

unzip csubot-linux-amd64.zip

Ikiwa huwezi kuendesha amri hii, tafadhali thibitisha kuwa umefanikiwa kusakinisha kifurushi cha unzip.

Ingiza saraka ambapo csubot iko,

Tumia amri ifuatayo, unaweza kuona faili iliyofichwa ya .env.example.

ls -la

Tumia kihariri chako cha maandishi (kama vile nano, vim), unda faili mpya .env , rejelea faili ya mfano .env.example ili kusanidi.

Jaribu kukimbia:

export $(grep -v '^#' .env | xargs) && ./csubot

Jikusanye mwenyewe

Endesha amri katika saraka ya mizizi ya mradi:

go build -o csubot

Jaribu kukimbia:

export $(grep -v '^#' .env | xargs) && ./csubot

HTTPS

Backend haitoi msaada wa moja kwa moja wa https, inaweza tu kufikiwa na http.

Unaweza kutumia huduma kama vile Apache, Nginx, Microsoft Internet Information Services (IIS) kusanidi HTTPS.

Ikiwa unatumia Cloudflare CDN, unaweza pia kuweka modi ya usimbaji fiche ya SSL/TLS kuwa Flexible. Kwa njia hii, mtumiaji anafikia seva ya Cloudflare kwa kutumia itifaki ya https iliyosanidiwa kiotomatiki na Cloudflare, na kisha Cloudflare inafikia seva yako iliyosanidiwa ya huduma ya backend kwa kutumia itifaki ya http.

Endesha kama huduma ya systemd

sudo mkdir /usr/local/bin/csubot/
sudo cp .env /usr/local/bin/csubot/.env
sudo cp csubot /usr/local/bin/csubot/csubot
sudo cp -r ./locales /usr/local/bin/csubot/locales

Unda mtumiaji wa huduma

sudo useradd --system --no-create-home --shell /sbin/nologin csubotuser

Sanidi ruhusa

sudo chown csubotuser:csubotuser /usr/local/bin/csubot/csubot
sudo setfacl -R -m u:csubotuser:r /usr/local/bin/csubot
sudo chmod +x /usr/local/bin/csubot/csubot

Unda na uhariri /etc/systemd/system/csubot.service , andika

[Unit]
Description=Backend ya CSUBOT
After=network-online.target
Wants=network-online.target

[Install]
WantedBy=multi-user.target

[Service]
Type=simple
User=csubotuser
Group=csubotuser
ExecStart=/usr/local/bin/csubot/csubot
WorkingDirectory=/usr/local/bin/csubot
RestartSec=10s
Restart=always
# Restart=on-failure

# Pakia faili ya vibadala vya mazingira
EnvironmentFile=/usr/local/bin/csubot/.env
# Anzisha huduma
sudo systemctl start csubot.service

# Angalia hali ya uendeshaji
sudo systemctl status csubot.service

# Weka anzisha kiotomatiki
sudo systemctl enable csubot.service

Matoleo mengine ya ukurasa huu wa wavuti

Makala hii ina matoleo katika lugha nyingi.

Ikiwa ungependa kutoa maoni, tafadhali tembelea ukurasa ufuatao wa wavuti:

ZH EN ZH-TW JA

Kurasa hizi za wavuti zinaauni tu kuvinjari, haziwezi kutoa maoni au kuacha ujumbe, lakini hutoa chaguzi zaidi za lugha, na wakati wa upakiaji mfupi:

ZH EN ZH-TW JA RU KO CS ES AR FR PT DE TR IT NL SV DA FI PL UK HE RO HU EL HR TH HI BN ID SW VI NO