LibreTranslaten itseisännöinti vuonna 2026: mallit, API-rajoitukset ja pysyvät tiedot
Isännöi LibreTranslate itse oikeilla porteilla, pysyvällä tallennustilalla, HTTPS:llä, salaisuuksilla, varmuuskopioilla ja päivitystarkistuksilla. Opi korjaamaan tilanne, jossa malleja ei ladattu.
Jos olet jo yrittänyt isännöidä LibreTranslatea itse, tämä turhauttava tilanne on todennäköisesti tuttu: käyttöliittymä näkyy, mutta malleja ei ladattu tai pyydetty kielipari ei ole saatavilla. Säilön luominen uudelleen korjaa harvoin URL-osoitteiden, tilan ja riippuvuuksien välisen ristiriidan.
Tässä ohjeessa käytetään yhtä konkreettista hyväksymiskriteeriä: asennettujen kielten luettelointi, kiinteän lauseen kääntäminen molempiin suuntiin sekä API-avaimen kiintiön ja virhevastausten testaaminen. Jokainen määritysvalinta arvioidaan tämän kriteerin eikä vihreän säilömerkin perusteella.
LibreTranslaten palauttaminen tyhjälle isännälle
Luettele tila ennen ensimmäisen varsinaisen tietueen luomista: ladatut mallit, API-avaintietokanta ja mukautettu määritys. Liitä /home/libretranslate/.local ennen bootstrap-vaihetta, kirjoita harmitonta esimerkkidataa ja korvaa säilö osoittaaksesi, että polku on todella pysyvä. Vahvista liitos kirjoittamalla harmitonta dataa, korvaamalla LibreTranslate ja lukemalla data takaisin.
Tilannevedokset ovat hyödyllisiä nopeaan palautukseen, mutta erillinen varmuuskopio tarvitaan, jos isäntä tai taltio katoaa. Palauta tiedot tyhjään ympäristöön kiinnitetyn imagen avulla ja varmista, että mallit ja API-avaimen tila palautuvat ja että regressiotestiaineisto suoritetaan hyväksyttävällä tuloksella. Käytä pysyviä taltioita ja tilannevedoksia, jotta nämä kaksi palautusmekanismia pysyvät erillään.
Portit, prosessit ja yksityiset palvelut
Älä anna LibreTranslaten imagen määrittää tuotantoarkkitehtuuria vahingossa. Image tarjoaa prosessin portissa 5000, mutta tallennus, reititys ja ulkoiset vaatimukset tarvitsevat edelleen harkitut elinkaaret. Paikallinen suoritusympäristö tarvitsee mallien lataustilaa sekä kielipareihin sopivan suorittimen tai grafiikkasuorittimen. Pidä sen elinkaari eksplisiittisenä, jotta LibreTranslaten siirtäminen isännältä toiselle ei muuta toimintaa huomaamatta.
Käyttöönotto on valmis perusteellisempaa testausta varten, kun se pystyy luetteloimaan asennetut kielet, kääntämään kiinteän lauseen molempiin suuntiin sekä testaamaan API-avaimen kiintiön ja virhevastausten toimintaa. Seuraa tapahtumaa lokeista ja tarkkaile ladattuja kielimalleja, suorittimen päättelyaikaa, rinnakkaisia pyyntöjä ja mallien latausten kuluttamaa levytilaa. Näiden havaintojen avulla selviää, eristääkö nykyinen topologia oikean komponentin.
LibreTranslate-käyttöönoton todentaminen alusta loppuun
LibreTranslaten tuotantokriteerin pitäisi olla sellainen, että sen voi suorittaa henkilö, joka ei rakentanut käyttöönottoa. Anna hänelle kiinnitetty versio, ei-arkaluonteinen testitili ja tämä tehtävä: luetteloi asennetut kielet, käännä kiinteä lause molempiin suuntiin sekä testaa API-avaimen kiintiö ja virhevastausten toiminta. Jos ohjeet edellyttävät dokumentoimatonta shell-käyttöä, palvelu ei ole vielä operatiivisesti valmis.
Toista testi, kun olet vaihtanut vain säilön. Palauta sitten ladatut mallit, API-avaintietokanta ja mukautettu määritys tyhjään infrastruktuuriin ja osoita, että mallit ja API-avaimen tila palautuvat ja että regressiotestiaineisto suoritetaan hyväksyttävällä tuloksella. Mittaa ladatut kielimallit, suorittimen päättelyaika, rinnakkaiset pyynnöt ja mallien latausten kuluttama levytila molempien onnistuneiden suoritusten aikana; odottamattomat erot paljastavat usein puuttuvan välimuistin, indeksin, workerin tai dataliitoksen.
Lisää vikatilanneharjoitus: lähetä harmitonta syötettä lähellä tähän rajatapaukseen liittyvää resurssi- tai muotorajoitusta: malleja ei ladattu tai pyydetty kielipari ei ole saatavilla. LibreTranslaten pitäisi antaa hyödyllinen virheilmoitus, säilyttää olemassa oleva tila ja palautua, kun kelvollinen ehto palaa voimaan. Tallenna aikaleimat ja olennaiset lokirivit sekä poista salaisuudet näkyvistä. Näistä todisteista tulee vertailukohta seuraavalle imagelle tai määritysmuutokselle.
Tarkistettavat säilöasetukset
Käytä komentoa, joka tuo kaikki tärkeät valinnat näkyviin. Tämä perusmääritys sitoo LibreTranslaten isännän loopback-osoitteeseen, lisää tunnetut dataliitokset ja toimittaa ensimmäisen pakollisen asetuksen. Vahvista paikallinen vaatimus ennen julkaisua: mallien lataustila sekä kielipareihin sopiva suoritin tai grafiikkasuoritin.
docker run -d \
--name libretranslate \
--restart unless-stopped \
-p 127.0.0.1:5000:5000 \
-v libretranslate-data:/home/libretranslate/.local \
-e LT_API_KEYS=true \
libretranslate/libretranslate:latest
Korvaa vaihtuvat tagit testatulla versiolla tai digestillä. Käynnistyksen jälkeen tarkista docker logs --tail 200 libretranslate ja varmista, että prosessi kuuntelee porttia 5000. Suorita sen jälkeen LibreTranslaten hyväksymistesti; juurisivun vastaus ei voi todistaa koko skenaarion onnistumista: luetteloi asennetut kielet, käännä kiinteä lause molempiin suuntiin sekä testaa API-avaimen kiintiö ja virhevastausten toiminta.
Tunnistetiedot, roolit ja ulospäin näkyvät rajapinnat
Sovelluskohtainen tietoturvariski on rajattoman julkisen API:n ajaminen niin, että muut voivat kuluttaa sen resurssit loppuun. Operatiivinen ratkaisu on ottaa API-avaimet tai upstream-todennus käyttöön, rajoittaa julkisten kutsujien nopeutta ja asentaa vain tarvittavat kieliparit. Suorita bootstrap rajoitetun reitin kautta ja poista väliaikainen käyttöoikeus heti sen jälkeen.
LT_API_KEYS ohjaa toimintaa, ei luottamuksellisuutta; vahvista sen tyyppi ja arvo ja säilytä varsinaiset LibreTranslate-tunnistetiedot erillään. Anna LibreTranslate-prosessille vain dokumentoidut liitokset ja riippuvuusreitit; vältä isännän root-käyttöoikeutta ja Docker-socketin käyttöä. Kirjaa epäonnistuneet todennukset ja määritysvirheet, mutta poista tokeneista, yhteysmerkkijonoista ja käyttäjäsisällöstä arkaluonteiset tiedot.
Pidä sisäiset ja ulkoiset URL-osoitteet erillään
TLS:n myöntäminen on vain puolet LibreTranslate-reitistä. Tarjoa API HTTPS:n kautta ja dokumentoi oikea peruspolku. Ohjaa liikenne sisäisesti porttiin 5000 ja välitä ulkoinen skeema, jotta luodut URL-osoitteet ja turvalliset evästeet pysyvät yhdenmukaisina.
Käytä koko LibreTranslate-skenaariota puhtaasta verkosta, älä pelkästään juurisivua. 502- tai varmennevirhe voidaan rajata automaattisella domain- ja TLS-määrityksellä. Jos liikenne saavuttaa prosessin ja malleja ei ladattu tai pyydetty kielipari ei ole saatavilla, selvitä ongelma siinä kohdassa, jossa se ilmenee, äläkä lisää uudelleenohjauksia kerros kerrokselta.
LibreTranslaten vikatilanneharjoitukset
Kapasiteettitestien tulee käyttää ladattuja kielimalleja, suorittimen päättelyaikaa, rinnakkaisia pyyntöjä ja mallien latausten kuluttamaa levytilaa, ei toistuvaa /-pyyntöä. Suorita skenaario ”luetteloi asennetut kielet, käännä kiinteä lause molempiin suuntiin sekä testaa API-avaimen kiintiö ja virhevastausten toiminta” realistisella rinnakkaisuudella ja kirjaa viive, virheprosentti sekä tallennustilan kasvu.
Päivityssuunnittelussa on huomioitava tämä riski: mallipaketit ja palvelinjulkaisut voivat muuttaa käännösten tuloksia, joten ylläpidä pientä regressiotestiaineistoa. Testaa uusi julkaisu edustavalla syötteellä, toista sitten hyväksymistapahtuma ja vertaa tulosta. Jos malleja ei ladattu tai pyydetty kielipari ei ole saatavilla, tallenna epäonnistunut tapahtuma ja tarkista ensimmäinen siihen liittyvä rajapinta sen sijaan, että olettaisit ingressin olevan vastuussa.
LibreTranslaten käyttöönotto Dockupissa rajoja rikkomatta
Dockup-mallin tulisi koodata image, portti 5000, liitokset, health-tarkistuksen ajoitus, domain, TLS ja salaisuuksien välitys. Dockupin tulee säilyttää LibreTranslaten suoritusympäristön asetukset samalla, kun ylläpitäjä vahvistaa tämän paikallisen vaatimuksen: mallien lataustila sekä kielipareihin sopiva suoritin tai grafiikkasuoritin. Sama käyttöönotto voidaan kohdistaa Dockup-palvelimille tai asiakkaan liittämään kapasiteettiin.
Kun reitti on käytössä, ota julkinen asetus käyttöön ja yritä luetteloida asennetut kielet, kääntää kiinteä lause molempiin suuntiin sekä testata API-avaimen kiintiö ja virhevastausten toiminta. Varmuuskopioi ladatut mallit, API-avaintietokanta ja mukautettu määritys ja pidä palautusharjoitus osana käyttöönottosuunnitelmaa; nämä ovat LibreTranslaten vastuulla olevia asioita, jotka pysyvät näkyvissä infrastruktuurin provisioinnin jälkeenkin.
Usein kysytyt kysymykset
Mitä LibreTranslate tarvitsee tuotantokäyttöönottoon?
Reititä LibreTranslate-säilö portissa 5000 yhden HTTPS-alkuperän kautta. Paikallinen suoritusympäristö tarvitsee mallien lataustilaa sekä kielipareihin sopivan suorittimen tai grafiikkasuorittimen. Älä katso LibreTranslatea valmiiksi, ennen kuin pystyt luetteloimaan asennetut kielet, kääntämään kiinteän lauseen molempiin suuntiin sekä testaamaan API-avaimen kiintiön ja virhevastausten toimintaa.
Mitkä LibreTranslaten tiedot kuuluvat varmuuskopioon?
Säilytä /home/libretranslate/.local pysyvästi ja sisällytä ladatut mallit, API-avaintietokanta ja mukautettu määritys samaan palautusmanifestiin. Puhdas LibreTranslate-palautus onnistuu vasta, kun mallit ja API-avaimen tila palautuvat ja regressiotestiaineisto suoritetaan hyväksyttävällä tuloksella.
Edellyttääkö LibreTranslate HTTPS:ää käänteisproxy-palvelimen takana?
Käytä julkisessa LibreTranslate-alkuperässä HTTPS:ää ja pidä portti 5000 sisäisessä reitissä. Määritä LibreTranslaten asetus oikein: tarjoa API HTTPS:n kautta ja dokumentoi oikea peruspolku. LibreTranslatessa HTTPS suojaa tunnistetietoja tai käyttäjäsisältöä siirron aikana ja pitää alkuperästä riippuvan asiakaskäyttäytymisen yhdenmukaisena.
Miten LibreTranslaten päivitys pitäisi testata?
Palauta nykyinen LibreTranslate-tila eristettyyn käyttöönottoon, ota ehdokasversio käyttöön ja toista sen hyväksymistapahtuma. Kiinnitä erityistä huomiota siihen, että mallipaketit ja palvelinjulkaisut voivat muuttaa käännösten tuloksia, joten ylläpidä pientä regressiotestiaineistoa. Säilytä edellinen LibreTranslate-image, kunnes sen datamigraation ja palautuksen rajat on ymmärretty.