CSUBOT on avoimen lähdekoodin superylläpitäjärobotti.

Tässä artikkelissa kerrotaan, miten CSUBOT otetaan käyttöön itse.

Lue ensin tämä dokumentti kokonaan: CSUBOT-robotin käyttöohje

Suositus: Tarkista tämän laitteen julkinen IP-osoite eri verkkosivustoille , jotta voit tarkistaa nykyisen verkkoympäristön.

Edellytykset

CSUBOTin itsenäinen käyttöönotto edellyttää vähintään seuraavien ehtojen täyttymistä:

  • Sinulla on verkkotunnus. (Sinulla on oltava vähintään toisen tason verkkotunnus taustaa varten. Itse asiassa tarvitset kaksi toisen tason verkkotunnusta sekä etu- että takaosaan, mutta yleensä käyttöönottopaikka voi tarjota etupuolen verkkotunnuksen)
  • Sinulla on palvelin. Tai ota se käyttöön alustalla, jossa voidaan ottaa käyttöön taustapalveluita. Jos tiedät ilmaisen alustan, jossa voidaan ottaa käyttöön taustapalveluita, älä epäröi
  • Sinulla on rajoittamaton Telegram-tili Telegram-robotin luomiseen ja robotin Tokenin hankkimiseen
  • Sinulla on rajoittamaton Cloudflare-tili Cloudflare Turnstile -vahvistuskoodin käyttöönottoa varten. Rekisteröi tili: https://dash.cloudflare.com/

Toimenpiteet

  1. Ota Cloudflare Turnstile käyttöön
  2. Ota etuosa käyttöön
  3. Luo Telegram-robotti
  4. Määritä taustaosa

Ota Cloudflare Turnstile käyttöön

Avaa Cloudflare Turnstile -määrityspaneeli napsauttamalla tätä linkkiä Turnstile-komponentin määritys

Lisää Turnstile-widget napsauttamalla add widget

Lisää etuosan verkkotunnus napsauttamalla Add Hostnames. Jos aiot käyttää etuosan isännöintialustan tarjoamaa verkkotunnusta, voit kirjoittaa tänne mitä tahansa.

Napsauta Luo-painiketta, jolloin näet Site Key- ja Secret Key -näppäimet

Ota etuosa käyttöön

Otetaan se käyttöön esimerkkinä etuosan isännöintialustalla.

  1. Avaa https://github.com/cjh0613/csubot-vue ja haarukoi tämä arkisto
  2. Valitse käyttöönotettava alusta, kuten Cloudflare Pages, Vercel, Netlify jne.
  3. Valitse tuonti Github-arkistosta ja valitse vaiheessa 1 haarukoitu arkisto.

Työpolku on määritetty projektin pääkansioon, ja käännöskomento on:

npm install && npm run build

Tulostuskansio on:

dist/

Määritä ympäristömuuttujat:

VITE_ENDPOINT=https://xxxx.com <taustaosan URL, tarvitsee https>

VITE_SITEKEY=0x4AAAAAABBBBBBBBBBB <Cloudflare turnstile -sivuston avain Site Key (ylempi)>
  1. Aloita käyttöönotto, kun se on valmis, näet alustan tarjoaman verkkotunnuksen. Voit myös sitoa oman verkkotunnuksesi. DNS-määrityksiä ja varmenteen luomista on odotettava.

Luo Telegram-robotti

Lähetä yksityisviesti osoitteeseen https://t.me/BotFather ja lähetä /newbot. Luo uusi robotti robotin ohjeiden mukaisesti. Kun olet valmis, saat Tokenin

Määritä taustaosa

Voit joko suorittaa binaaritiedoston suoraan tai kääntää sen itse.

Ympäristömuuttujaviite

TGWD_TOKEN=<Telegram-robotin tunnus, haettu osoitteesta @botfather>
TGWD_FRONTEND_DOMAIN=<etuosan verkkotunnus, ei tarvitse https:ää>
TGWD_SECRET=<täytä mitä tahansa>
TGWD_PORT=8000
TGWD_CFTS_API_KEY=<Cloudflare turnstile -salainen avain salainen avain (sivuston avaimen alla)>

Käytä binaaritiedostoa

Otetaan esimerkiksi linux amd64 -käyttöjärjestelmä.

Luo ensin uusi kansio.

mkdir csubot && cd csubot

Lataa binaaritiedosto. Latauslinkit löytyvät osoitteesta https://github.com/cjh0613/csubot/releases . Saatat joutua napsauttamaan Show all assets -painiketta löytääksesi alustallesi sopivan tiedoston.

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

Koska kyseessä on zip-pakattu tiedosto, pura se:

unzip csubot-linux-amd64.zip

Jos et voi suorittaa tätä komentoa, varmista, että unzip-paketti on asennettu onnistuneesti.

Siirry csubotin hakemistoon,

Voit tarkastella piilotettua .env.example-tiedostoa seuraavalla komennolla.

ls -la

Luo tekstieditorillasi (kuten nano, vim) uusi tiedosto .env ja määritä se esimerkkiedoston .env.example mukaisesti.

Yritä suorittaa:

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

Käännä itse

Suorita komento projektin päähakemistossa:

go build -o csubot

Yritä suorittaa:

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

HTTPS

Taustaosa ei tarjoa suoraan https-tukea, vain http-yhteys on mahdollinen.

Voit määrittää HTTPS:n palveluilla, kuten Apache, Nginx, Microsoft Internet Information Services (IIS).

Jos käytät Cloudflare CDN:ää, voit myös asettaa SSL/TLS-salauksen salaustilan Flexible. Tällöin käyttäjät käyttävät Cloudflare-palvelinta Cloudflaren automaattisesti määrittämällä https-protokollalla, ja sitten Cloudflare käyttää http-protokollaa päästäkseen määrittämällesi taustapalvelun palvelimelle.

Suorita systemd-palveluna

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

Luo palvelun käyttäjä

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

Määritä käyttöoikeudet

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

Luo ja muokkaa /etc/systemd/system/csubot.service ja kirjoita

[Unit]
Description=CSUBOT Backend
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

# Lataa ympäristömuuttujatiedosto
EnvironmentFile=/usr/local/bin/csubot/.env
# Käynnistä palvelu
sudo systemctl start csubot.service

# Tarkastele toimintatilaa
sudo systemctl status csubot.service

# Aseta käynnistys automaattisesti
sudo systemctl enable csubot.service

Muut versiot tältä verkkosivulta

Tästä artikkelista on useita kieliversioita.

Nämä verkkosivut tukevat vain selaamista, eivätkä salli kommenttien tai viestien jättämistä, mutta ne tarjoavat enemmän kielivaihtoehtoja ja latautuvat nopeammin:

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