Etusivu/Artikkeli
Esadax JournalApps

PictShare

Mikä on PictShare? PictShare on kevyt, avoimen lähdekoodin, itse isännöity tiedostonjakoalusta, joka on suunniteltu kuvien, videoiden, äänitiedostojen ja tekstikatkelmien lataamiseen, tallentamiseen, muuntamiseen ja jakamiseen. Se tarjoaa keskitetyn verkkokäyttöliittymän ja lataus-API:n,

PictShare logo

Mikä on PictShare?

PictShare on kevyt, avoimen lähdekoodin, itse isännöity tiedostonjakoalusta, joka on suunniteltu kuvien, videoiden, äänitiedostojen ja tekstikatkelmien lataamiseen, tallentamiseen, muuntamiseen ja jakamiseen.

Se tarjoaa keskitetyn verkkokäyttöliittymän ja lataus-API:n, joiden avulla käyttäjät ja sovellukset voivat julkaista tiedostoja ja hankkia jaettavia URL-osoitteita riippumatta ulkoisista tiedostojen isännöintipalveluista.

Toisin kuin perinteiset pilvitallennusalustat, PictShare keskittyy yksinkertaiseen tiedostojen isännöintiin ja median toimittamiseen. Käyttäjät voivat ladata sisältöä, luoda suoria linkkejä, muuntaa kuvia URL-parametrien kautta ja jakaa tiedostoja muiden kanssa.

Yksi sen erottavista piirteistä on sen URL-pohjainen kuvankäsittelyjärjestelmä. Käyttäjät voivat muuttaa kuvien kokoa, kiertää niitä ja käyttää niihin suodattimia muokkaamalla niiden URL-osoitteita ilman, että heidän tarvitsee luoda manuaalisesti useita versioita alkuperäisestä tiedostosta.

PictShare tukee myös videonkäsittelyä, GIF-muunnosta, tekstin isännöintiä, Markdown-renderointia, äänentoistoa ja jaettavia media-albumeita.

Sen tiedostopohjainen arkkitehtuuri ei vaadi tavanomaista tietokantaa, mikä tekee siitä erityisen sopivan kotilaboratorioille, kehittäjille ja organisaatioille, jotka tarvitsevat kompaktin tiedostojenjakopalvelun.

PictSharen historia

PictShare on avoimen lähdekoodin projekti, jonka on kehittänyt HaschekSolutions.

Projekti luotiin tarjoamaan itseisännöity vaihtoehto julkisille kuvien isännöintipalveluille, joissa painotetaan yksinkertaisuutta, joustavuutta ja ladatun sisällön hallintaa.

Sovellus kehittyi peruskuva-isännöintipalvelusta laajemmaksi median jakamisalustaksi, joka tukee kuvia, videoita, tekstikatkelmia, ulkoista tallennustilaa ja API-integraatioita.

PictSharen versio 3 esitteli merkittävän arkkitehtonisen uudistuksen, mukaan lukien päivitetyn REST-suuntautuneen API:n, lisäsisältötyypit, ulkoisen tallennustilan tuen, albumit ja sisäänrakennetun Model Context Protocol (MCP) -palvelimen.

Projekti on toteutettu ensisijaisesti PHP: ssä ja tarjoaa Docker-pohjaisen käyttöönoton.

Tärkeimmät ominaisuudet PictShare

PictShare tarjoaa useita ominaisuuksia tiedostojen lataamiseen, hallintaan, muuntamiseen ja jakamiseen.

  • Kuva Hosting: Lataa ja jaa kuvia kautta suoria URL-osoitteita.
  • Video Hosting: Lataa ja jakaa tuettuja videoformaatteja.
  • Tekstin isännöinti: Tallenna tekstikatkelmia ja tee niistä saatavilla jaettavien linkkien kautta.
  • Markdown Rendering: Näytä ladatut Markdown-tiedostot muotoiltuna HTML: nä.
  • Audio Hosting: Tuki ääniformaatteja, kuten MP3, WAV, OGG, FLAC, ja M4A.
  • URL-pohjaiset muunnokset: Muuta kuvien kokoa, kierrä niitä ja käytä niihin suodattimia suoraan niiden URL-osoitteiden kautta.
  • Automaattinen WebP-muunnos: Tarjoa yhteensopivia kuvia WebP-muodossa, kun pyytävä selain tukee sitä.
  • GIF Conversion: Muuntaa animoituja GIF-tiedostoja MP4 videoita.
  • Videokäsittely: Muuta tuettujen videoiden kokoa ja luo esikatselukuvia.
  • Kaksinkertainen havaitseminen: Käytä uudelleen olemassa olevia tiedostoja, kun identtinen sisältö on ladattu.
  • Lataa API: Integroi tiedostojen lataukset komentosarjoihin, sovelluksiin ja automatisoituihin työnkulkuihin.
  • URL Tuonti: Lataa tiedostoja tarjoamalla esteetön kauko URL.
  • Jaettavissa Albumit: Yhdistä useita ladattuja tiedostoja yhdeksi galleria linkki.
  • Tiedostojen poistokoodit: Luo yksittäisiä poistokoodeja ladatuille tiedostoille.
  • Ulkoinen tallennustila: Säilytä tiedostoja S3-yhteensopivilla palveluilla ja muilla tallennusjärjestelmillä.
  • Tallennustilan salaus: Salaa tiedostot, jotka on tallennettu tuettujen ulkoisten tallennuslaitteiden ohjainten kautta.
  • EXIF-tietojen poisto: Poista upotetut EXIF-metatiedot ladatuista valokuvista, mukaan lukien GPS-koordinaatit ja kameratiedot.
  • MCP-integrointi: Anna yhteensopivien tekoälyagenttien ladata, hakea, muuntaa ja hallita tiedostoja.
  • Docker-tuki: Ota sovellus käyttöön käyttämällä virallista Docker-kuvaa.

Esimerkkejä käytöstä

PictShare sopii yksityishenkilöille, kehittäjille ja organisaatioille, jotka tarvitsevat yksinkertaisen tiedoston lataus ja jakaminen infrastruktuuria.

Yleisiä käyttötapauksia ovat:

  • Image Hosting: Lataa kuvakaappauksia, valokuvia, grafiikkaa ja muita kuvia.
  • Videon jakaminen: Julkaise lyhyitä videoita ja tuettuja mediatiedostoja kautta suoria linkkejä.
  • Sovelluksen latauksen päätepisteet: Tarjoa keskitetty kohde ulkoisten sovellusten luomille tiedostoille.
  • Kehittäjän työnkulut: Jaa kuvakaappauksia, lokit, ja kehitys artefakteja.
  • Tekninen tuki: Lataa virhe kuvakaappauksia ja diagnostiikka tiedostoja tukipyyntöjä.
  • Tekstin jakaminen: Julkaise kokoonpanoesimerkkejä, koodikatkelmia ja teknisiä muistiinpanoja.
  • Verkkosivuston media: Isännöi kuvia ja optimoitua mediaa verkkosivustoille ja sovelluksille.
  • Väliaikainen tiedostojen jakelu: Jaa tiedostoja luotujen URL-osoitteiden ja yksittäisten poistolinkkien kautta.
  • Dokumentaatio: Isännöi kuvakaappauksia ja muita teknisessä dokumentaatiossa käytettäviä resursseja.
  • Automaatio: Integroi lataukset komentosarjoihin, käyttöönoton työnkulkuihin ja ulkoisiin palveluihin.
  • Kotilaboratorion infrastruktuuri: Yksityisen vaihtoehdon tarjoaminen julkisille kuva- ja tiedostopalveluille.

PictSharen hyödyt

  • Kevyt, itse isännöity tiedostojenjakoalusta
  • Perinteistä tietokantaa ei tarvita
  • Tukee kuvia, videoita, ääntä ja tekstiä
  • Automaattiset kuvamuunnokset URL-osoitteiden kautta
  • GIF-to-MP4 ja kuva-to-WebP muuntaminen
  • Yksinkertainen REST-suuntautunut lataus API
  • Etä-URL-tuonti
  • Kaksoiskappaleiden tunnistus vähentää tallennustilan kulutusta
  • Yksittäiset tiedostojen poistokoodit
  • Valinnaiset master-poisto-ohjaimet
  • S3-yhteensopiva ulkoisen tallennustilan tuki
  • Ulkoisesti tallennettujen tiedostojen valinnainen salaus
  • Automaattinen EXIF-metatietojen poisto
  • Docker-pohjainen käyttöönotto
  • Sisäänrakennettu MCP-palvelin tekoälyagenttien integrointia varten
  • Parempi hallinta ladatuista tiedostoista ja hosting-infrastruktuurista

Kuinka asentaa PictShare

Asenna PictShare Esadaxin kautta noudattamalla seuraavia ohjeita:

  1. Osta sovellus Esadaxin kautta.
  2. Oston jälkeen sinua pyydetään antamaan tarvittavat kokoonpanoparametrit.
  3. Määritä julkinen sovelluksen URL-osoite verkkotunnuksesi tai aliverkkotunnuksesi avulla.
  4. Määritä pysyvä tallennustila ladatuille tiedostoille.
  5. Määritä latauskoodi, jos latausten pitäisi vaatia todennusta.
  6. Määritä tiedostojen käsittelyvaihtoehdot tarvittaessa.
  7. Määritä tarvittaessa ulkoinen tallennustila.
  8. Käynnistä sovellus valitsemalla Ota käyttöön.
  9. Käytä PictSharea sille määritetyn sovellus-URL:n kautta.
  10. Lataa testikuva ja tarkista, että luotu URL-osoite toimii.
  11. Testaa kuvan muunnoksia ja tiedostojen poistoa.
  12. Määritä API-integraatiot sovelluksille, jotka tarvitsevat automaattisia latauksia.

Kun PictShare on otettu käyttöön, se tarjoaa keskitetyn päätepisteen tiedostojen lataamiseen ja jakamiseen.

Kuvien lataaminen ja jakaminen

PictShare tarjoaa web-käyttöliittymän kuvien lataamiseen ja jaettavien URL-osoitteiden luomiseen.

Kun lataus on valmis, sovellus luo yksilöllisen tiedostonimen ja tekee kuvan saataville sen julkisen URL-osoitteen kautta.

Yleinen työnkulku on:

  1. Valitse kuva laitteesta.
  2. Lataa tiedosto verkkokäyttöliittymän tai API:n kautta.
  3. PictShare validoi ja käsittelee ladatun sisällön.
  4. Tiedosto tallennetaan määritettyyn tallennuspalvelimeen.
  5. Yksilöllinen URL-osoite luodaan.
  6. Jaa URL-osoite muiden käyttäjien tai sovellusten kanssa.

PictShare luo myös yksilöllisiä poistokoodeja, joiden avulla ladatut tiedostot voidaan poistaa ilman suoraa pääsyä palvelimen tiedostojärjestelmään.

Ulkoiset sovellukset, komentosarjat ja komentorivityökalut voivat käyttää samaa lähetysinfrastruktuuria.

URL-pohjaiset kuvamuunnokset

Yksi PictSharen hyödyllisimmistä ominaisuuksista on sen URL-pohjainen kuvankäsittelyjärjestelmä.

Useiden kuvakokojen manuaalisen luomisen sijaan käyttäjät voivat pyytää eri versioita ladatusta kuvasta muokkaamalla sen URL-osoitetta.

Käytettävissä olevia toimintoja ovat:

  • Kuvien koon muuttaminen
  • Kuvien pyörittäminen
  • Kuvasuodattimien käyttö
  • Yhteensopivien kuvien muuntaminen WebP-muotoon
  • Paikanvaraajakuvien luominen
  • Identikonien luominen

Esimerkiksi ladattu kuva voi olla saatavilla osoitteessa:

https://files.example.com/image123.jpg

Muutetun kokoinen versio voidaan pyytää käyttämällä:

https://files.example.com/800x600/image123.jpg

Lisämuunnoksia voidaan yhdistää URL-osoitteessa.

PictSharen versio 3 edellyttää, että URL-osoitteen viimeinen osa on alkuperäinen tiedostonimi. Tämä eroaa vanhemmista versioista, jotka sallivat tiedoston nimen näkyvän muualla polussa.

Tämä lähestymistapa tekee PictShare erityisen hyödyllinen sivustoja ja sovelluksia, jotka tarvitsevat useita kuvakokoja ilman ylläpitää erillisiä kopioita jokaisen kuvan.

Videoiden isännöinti ja käsittely

PictShare tukee videotiedostojen lataamista ja jakamista luotujen URL-osoitteiden kautta.

Alusta sisältää videonkäsittelyominaisuuksia median valmistelemiseksi selainpohjaista toistoa ja jakelua varten.

Videotoiminnot sisältävät:

  • Tuettujen videotiedostojen lataaminen
  • Esikatselukuvien luominen
  • Tuetut MP4-videoiden koon muuttaminen
  • Yhteensopimattomien videokoodausten muuntaminen mahdollisuuksien mukaan
  • GIF-to-MP4 muuntaminen
  • Käsitellyn videon tarjoaminen suorien URL-osoitteiden kautta

Videokäsittely luottaa FFmpegiin.

Suuria videoita tai usein toistuvia muunnoksia käsittelevissä asennuksissa sovellukselle tulisi varata riittävästi suorittimen resursseja.

PictShare tukee myös erillistä FFmpeg-työntekijää, joka käsittelee jonossa olevia muuntotehtäviä, jolloin resursseja vaativat toiminnot voivat toimia riippumattomasti pääverkkopyynnöstä.

Tekstipätkiä ja Markdown Hosting

PictShare ei rajoitu kuvia ja videoita.

Se tukee myös tekstin isännöintiä, jolloin käyttäjät voivat ladata tekstisisältöä ja jakaa sen jaettavien URL-osoitteiden kautta.

Yleisiä esimerkkejä ovat:

  • Lähdekoodin katkelmia
  • Asetustiedostot
  • Lokit
  • Tekniset huomautukset
  • Otteita dokumentaatiosta
  • Markdown-asiakirjat
  • Pelkkä tekstimuotoinen tieto

Markdown-tiedostot voidaan esittää muotoiltuna HTML: nä, joten PictShare on hyödyllinen kevyiden asiakirjojen jakamiseen.

Tekstisisältöä voi käyttää myös raakatietonäkymien kautta tai ladata, riippuen tuetusta sisältötyypistä ja kokoonpanosta.

Tämä tarjoaa kätevän vaihtoehdon tekstitiedostojen manuaaliselle jakamiselle tai ulkoisten liitospalveluiden käyttämiselle.

Äänen hosting-palvelut

PictShare tukee äänitiedostojen isännöintiä ja tarjoaa selainpohjaisen äänisoittimen.

Tuettuja formaatteja ovat:

  • MP3-tiedosto
  • WAV
  • OGG
  • FLAC
  • M4A

Lähetetyt äänitiedostot voidaan käyttää luotujen URL-osoitteiden kautta ja toistaa yhteensopivilla selaimilla.

Tämä tekee PictSharesta hyödyllisen äänitallenteiden, lyhyiden äänileikkeiden ja muun tuetun äänisisällön jakamiseen.

Albumit ja mediagalleriat

PictShare tarjoaa albumi ominaisuus ryhmittelyyn useita ladattuja tiedostoja yhteen jaettavissa galleriaan.

Jokaisen kuvan erillisten linkkien jakamisen sijaan käyttäjät voivat luoda albumin, joka sisältää useita tiedostoja.

Albumin toiminnallisuus sisältää:

  • Olemassa olevien latausten yhdistäminen albumiin
  • Ainutlaatuisen albumin URL-osoitteen luominen
  • Useiden tiedostojen jakaminen yhden linkin kautta
  • Tiedostojen esittäminen galleriassa
  • Kokoelmien luominen ladatusta sisällöstä

Albumit ovat erityisen hyödyllisiä kuvakaappausten, tapahtumavalokuvien, grafiikkakokoelmien ja muun aiheeseen liittyvän median jakamiseen.

Lataa API- ja kehittäjäintegraatiot

PictShare tarjoaa HTTP API, jonka avulla ulkoiset sovellukset voi ladata tiedostoja ohjelmallisesti.

API palauttaa JSON-vastauksia, jotka sisältävät tietoja ladatusta sisällöstä ja sen luomasta URL-osoitteesta.

Peruslatauspyyntö käyttää /api/upload-päätepistettä.

Esimerkki käyttäen cURL:

curl -F "file=@image.jpg" \
  https://files.example.com/api/upload

Onnistunut vastaus sisältää muun muassa seuraavat tiedot:

  • Lähetyksen tila
  • Luotu tiedoston hajautusarvo
  • Tiedostotyyppi
  • Julkinen URL-osoite
  • Yksilöllinen poistokoodi
  • Poisto-URL

PictShare tukee myös sisällön lataamista etä-URL-osoitteista URL-tuontitoiminnon kautta.

Yleisiä integrointiskenaarioita ovat:

  • Kuvakaappausten lataaminen automaattisesti.
  • Luotujen sovelluskuvien lähettäminen keskitettyyn päätelaitteeseen.
  • Tiedostojen jakaminen shell-skripteistä.
  • Lähetysten integrointi verkkosovelluksiin.
  • Videoiden lataaminen automatisoiduista työnkuluista.
  • Lokien ja tekstikatkelmien julkaiseminen.
  • Albumien luominen useista latauksista.
  • Tiedostojen hallinta ulkoisten sovellusten kautta.

API tekee PictSharesta erityisen hyödyllisen kehittäjille, jotka tarvitsevat tiedostojen isännöintitoiminnon ilman erillistä latausinfrastruktuuria.

Model Context Protocol (MCP) -integrointi

PictShare sisältää sisäänrakennetun Model Context Protocol -palvelimen.

MCP mahdollistaa yhteensopivien tekoälysovellusten ja agenttien vuorovaikutuksen tiedostonjakopalvelun kanssa standardoidun työkalurajapinnan kautta.

Päätepiste on saatavilla osoitteessa:

POST /mcp

Käytettävissä olevia työkaluja ovat:

  • upload_from_url: Lataa kauko HTTP tai HTTPS resurssi ja tallentaa sen PictShare.
  • upload_base64: Lataa sisältöä, joka on koodattu Base64-muodossa tai toimitettu data-URI:na.
  • get_file_info: Hae tietoja ladatusta tiedostosta.
  • delete_file: Poistaa tiedoston käyttäen sen poistokoodia.
  • create_album: Ryhmitä olemassa olevat lataukset jaettavissa olevaan albumiin.
  • transform_image: Luo URL-osoitteita koon muuttaneille, suodatetuille tai pyöritetyille kuville.

Kun UPLOAD_CODE on määritetty, MCP-asiakkaiden on annettava latauskoodi haltijatunnuksena.

Tämä integraatio on hyödyllinen automatisoiduissa työnkuluissa, joissa tekoälyagenttien on ladattava kuvakaappauksia, käsiteltävä mediaviittauksia tai hallittava tiedostoja itse isännöidyn palvelun kautta.

Ulkoinen tallennus ja salaus

PictShare tukee ulkoista tallennustilaa backends kautta sen varastointi ohjain arkkitehtuuri.

Tämä mahdollistaa ladattujen tiedostojen tallentamisen sovelluksen päähakemiston ulkopuolelle.

Tuettuja kokoonpanoja ovat:

  • Paikallisen tiedostojärjestelmän tallennus
  • S3-yhteensopiva objektitallennus
  • MinIO
  • FTP-tallennustila
  • Sovelluksen tukemat lisätallennusohjaimet

S3-yhteensopiva tallennustila voi olla hyödyllinen isännöitäessä suuria mediakokoelmia tai käytettäessä useita PictShare-esiintymiä.

Sovellus voi myös salata tiedostoja, jotka on tallennettu tuettujen ulkoisten tallennusohjainten kautta.

Salaus suoritetaan automaattisesti lähetysten ja latausten aikana, kun asianmukainen salausavain on määritetty.

Tämän ansiosta organisaatiot voivat erottaa sovellusinfrastruktuurinsa mediatallennustilasta ja säilyttää samalla ulkoisesti tallennettujen tiedostojen lisäsuojauksen.

Kaksoiskappaleiden tunnistus ja tiedostojen hallinta

PictShare sisältää kaksoiskappaleiden havaitsemisen, jotta vältetään samanlaisten latausten tallentaminen useita kertoja.

Kun tarkka kaksoiskappale ladataan, sovellus voi käyttää uudelleen olemassa olevaa tallennettua tiedostoa sen sijaan, että luotaisiin toinen fyysinen kopio.

Tämä auttaa vähentämään tallennustilan kulutusta, kun useat käyttäjät tai sovellukset lataavat samaa sisältöä.

Tiedostojen hallintaominaisuuksiin kuuluu:

  • Yksilölliset tiedostotunnisteet
  • Yksittäiset poistokoodit
  • Valinnaiset master-poisto-ohjaimet
  • Tiedostojen metatietojen haku
  • Albumin järjestäminen
  • Ulkoisen tallennustilan tuki
  • Lataa toiminnan kirjaaminen

Lähetyksen aikana palautettu poistokoodi tulisi tallentaa turvallisesti, koska sitä voidaan tarvita liittyvän tiedoston poistamiseksi.

Tietoturva / ylläpito / konfigurointi

PictShare on suunniteltu kevyeksi tiedostojenjakopalveluksi, joten järjestelmänvalvojien tulisi kiinnittää erityistä huomiota latausoikeuksiin ja isännöitävään sisältöön.

Tärkeitä turvallisuuskäytäntöjä ovat:

  • Ota HTTPS käyttöön käänteisen välityspalvelimen kautta.
  • Määritä UPLOAD_CODE, kun julkisia nimettömiä latauksia ei tarvita.
  • Rajoita latauksia ja hallinnollisia käyttöoikeuksia käyttämällä ALLOWED_SUBNET: ta tarvittaessa.
  • Käytä vahvaa MASTER_DELETE_CODE, jos globaali poisto toiminto on käytössä.
  • Määritä MASTER_DELETE_IP rajoittamaan pääpoistotoimintoja.
  • Suojaa ladatut tiedostot ja tallennushakemistot.
  • Määritä TRUSTED_PROXIES oikein, kun se toimii käänteisen välityspalvelimen takana.
  • Vältä hallinnollisten toimintojen paljastamista tarpeettomasti.
  • Seuraa tallennustilan kulutusta ja lataustoimintaa.
  • Käytä erillisiä tunnistetietoja ulkoista tallennustilaa varten.
  • Suojaa salausavaimet ja määritystiedostot.
  • Pidä Docker-kuva päivitettynä.
  • Varmuuskopioi ladattu sisältö säännöllisesti.

PictShare poistaa EXIF-metatiedot kuvien lataamisen aikana, mikä auttaa estämään upotettujen GPS-koordinaattien ja kameratietojen tahattoman julkaisemisen.

Tärkeä huomio: HTML-isännöinti

PictShare tukee hosting raaka HTML-sivuja, mutta tämä toiminto on oletuksena pois käytöstä.

Kun tämä on käytössä, lähetetty HTML voi suorittaa mielivaltaista JavaScriptiä samassa alkuperässä kuin PictShare-sovellus.

Tämä voi altistaa vierailijat ja todennetut hallinnolliset istunnot vakaville tietoturvariskeille.

Ota HTML-isännöinti käyttöön vain silloin, kun siihen on selkeä tarve, ja käytä erillistä HTML_UPLOAD_CODE-koodia, joka on erillään normaalista latauskoodista.

Julkisessa tiedostojen jakamisessa HTML-isännöinnin jättäminen pois käytöstä on erittäin suositeltavaa.

PictSharen parhaat käytännöt

  • Käytä erillistä verkkotunnusta tai aliverkkotunnusta ladatuille tiedostoille.
  • Ota HTTPS käyttöön kaikessa ulkoisessa käytössä.
  • Määritä lataustodennus tarvittaessa.
  • Aseta tiedostokokorajoitukset käänteisessä välityspalvelimessa.
  • Seuraa levyn kulutusta ja kaistanleveyden käyttöä.
  • Käytä ulkoista objektitallennustilaa suuremmille mediakokoelmille.
  • Ota tallennustilan salaus käyttöön, kun sitä tuetaan ja tarvitaan.
  • Pidä poistokoodit turvassa.
  • Rajoita järjestelmänvalvojan käyttöoikeutta.
  • Määritä luotetut välityspalvelimet tarkasti.
  • Vältä HTML-isännöinnin käyttöönottoa, ellei se ole välttämätöntä.
  • Käytä sallittuja sisältötyyppejä tarpeettomien toimintojen rajoittamiseen.
  • Sisällytä ladatut tiedostot säännöllisiin varmuuskopioihin.
  • Testaa palautusmenettelyt.
  • Pidä sovellus ja FFmpeg-komponentit ajan tasalla.

Määritysparametrit

Kun olet ostanut tämän sovelluksen Esadax, sinua pyydetään antamaan käyttöönoton edellyttämät kokoonpanoparametrit.

Esadax lisää toimitetut muuttujat käyttöönottoon, jotta sovellus voidaan käynnistää sen vaatimalla kokoonpanolla.

PictShare versio 3 käyttää asetustiedostoa nimeltä:

inc/config.inc.php

Arkistosta löytyy myös esimerkki asetustiedostosta:

inc/example.config.inc.php

Seuraavat vaihtoehdot ovat tuettuja ylemmän tason kokoonpanossa:

Sovellus- ja käyttöoikeusasetukset

Parametri Kuvaus
URL Julkinen perus-URL, jota käytetään linkkejä luotaessa. Täytyy päättyä vinoviivaan.
UPLOAD_CODE Valinnainen koodi, jota tarvitaan ladattaessa tuetun API:n ja latauspyyntöjen kautta.
ALLOWED_SUBNET Pilkuilla erotetut IP-osoitteet, CIDR-alueet tai isäntänimet, jotka sallivat tiedostojen lataamisen ja hallintapaneelin käytön.
TRUSTED_PROXIES Luotettujen käänteisten välityspalvelimien IP-osoitteet, CIDR-alueet tai isäntänimet.
MASTER_DELETE_CODE Valinnainen pääkoodi, joka mahdollistaa minkä tahansa tallennetun tiedoston poistamisen.
MASTER_DELETE_IP Rajoittaa pääpoistotoiminnot määritettyihin asiakkaisiin.
LOG_UPLOADER Ottaa käyttöön lähettäjän IP-osoitteiden kirjaamisen /data/uploads.csv:een.
LOG_VIEWS Ottaa käyttöön pyyntöjen kirjaamisen virheenkorjausta varten.

Kuvankäsittelyn asetukset

Parametri Kuvaus
PNG_COMPRESSION PNG-pakkaustaso, 0 - 9.
JPEG_COMPRESSION JPEG-laadun asetus, 0 - 100.
WEBP_COMPRESSION WebP-laadun asetus, 0 - 100.
ALWAYS_WEBP Tarjoaa yhteensopivat JPEG-kuvat WebP-muodossa, kun pyytävä selain tukee sitä.
CORS_ALLOW_ORIGIN Määrittää Access-Control-Allow-Origin-vastauksen otsikon.
FFMPEG_BINARY Polku suoritettavaan FFmpeg-tiedostoon, jota käytetään median käsittelyyn.

Sisältötyypin asetukset

Parametri Kuvaus
CONTENTCONTROLLERS Valinnainen pilkuin erotettu tuettujen sisältötyyppien valkoinen luettelo.
HTML_HOSTING_ENABLED Ottaa nimenomaisesti käyttöön raaka HTML-isännöinnin. Ei oletusarvoisesti käytössä.
HTML_UPLOAD_CODE HTML-sisällön julkaisuun tarvitaan erillinen valtuutuskoodi.

Tuetut sisältöohjaimen arvot ovat seuraavat:

  • IMAGE
  • SVG
  • TEXT
  • VIDEO
  • URL
  • HTML

HTML-isännöinti edellyttää myös HTML_HOSTING_ENABLED:n ja HTML_UPLOAD_CODE:n määrittämistä.

Tallennustilan kokoonpano

Parametri Kuvaus
ALT_FOLDER Ylimääräinen paikallinen tai liitetty tiedostojärjestelmän sijainti, johon lähetetyt tiedostot kopioidaan.
ENCRYPTION_KEY Base64-koodattu salausavain, jota käytetään tuettujen ulkoisten tallennuslaitteiden ohjaimissa.
S3_BUCKET S3-yhteensopivan tallennusämpärin nimi.
S3_ACCESS_KEY Käyttöavain, jota käytetään yhteyden muodostamiseen ulkoiseen tallennustilaan.
S3_SECRET_KEY Salainen avain, jota käytetään yhteyden muodostamiseen ulkoiseen tallennustilaan.
S3_ENDPOINT S3-yhteensopivan tallennuspalvelun päätepisteen URL-osoite.
S3_REGION Tallennuslokeroon liittyvä alue.

FTP-tallennustilan lisäasetukset ovat käytettävissä, kun käytetään vastaavaa tallennustilaohjainta.

Alkuperäinen dokumentaatio luettelee myös joitain vanhoja tai suunniteltuja asetusvaihtoehtoja, joita ei ole toteutettu. Älä luota UPLOAD_QUOTA:een, MAX_RESIZED_IMAGES:een tai dokumentoituihin Redis-työasetusasetuksiin aktiivisena toimintona ilman valitun version vahvistamista.

Tarkat määritysparametrit riippuvat Esadaxin käyttöönottopaketista. Käytä osto- ja käyttöönottoprosessin aikana esitettyjä parametreja.

Kun tarvittavat arvot on määritetty, käynnistä PictShare valitsemalla Deploy.

Dockerin käyttöönotto

PictShare tarjoaa virallisen Docker-kuvan:

ghcr.io/hascheksolutions/pictshare

Vakiokäyttöönoton voi aloittaa seuraavalla komennolla:

docker run -d \
  -p 8080:80 \
  --name pictshare \
  ghcr.io/hascheksolutions/pictshare

Sovellus kuuntelee konttiportissa 80.

Ulkoinen portti voidaan yhdistää käyttöönottoympäristön mukaan.

Määritä pysyviä käyttöönottoja varten taltio ladatuille tiedostoille ja säilytä sovelluksen kokoonpano.

PictShare tarjoaa myös Docker Compose -kokoonpanon, joka voi rakentaa sovelluksen paikallisesti ja ladata asetukset .env-tiedostosta.

Säilytys ja pysyvyys

PictShare käyttää tiedostopohjaista tallennusta perinteisen relaatiotietokannan sijaan.

Lähetetty media tallennetaan tiedostojärjestelmään tai määritettyjen ulkoisten tallennusohjainten kautta.

Normaali Docker-käyttöönotto käyttää /data: ta pysyvänä lataushakemistonaan.

Luotettavaa toimintaa varten:

  • Liitä /data pysyvään tallennustilaan.
  • Varmuuskopioi ladatut tiedostot säännöllisesti.
  • Säilytä asetustiedosto.
  • Sisällytä ulkoisen tallennustilan tunnistetiedot suojattuihin varmuuskopioihin.
  • Suojaa tallennustilan salausavaimet erikseen.
  • Valvo levyn kapasiteettia ja latausvolyymia.
  • Testaa palautusmenettelyt.

Koska ladatut tiedostot tallennetaan tietokannasta riippumatta, perusvarmuuskopiot voidaan suorittaa kopioimalla asiaankuuluvat tiedostot ja säilyttämällä niiden hakemistorakenne.

Kun käytät salattua ulkoista tallennustilaa, salausavain on myös säilytettävä turvallisesti, jotta varmistetaan, että ladattu sisältö pysyy käytettävissä.

Skaalautuvuus ja suorituskyky

PictShare voidaan skaalata ulkoisen tallennustilan ja useiden sovellusten kautta.

S3-yhteensopiva tallennustila ja verkossa asennetut hakemistot mahdollistavat useiden esiintymien pääsyn samaan ladattuun sisältöön.

Suorituskykyä voidaan parantaa seuraavin keinoin:

  • SSD-taustainen paikallinen tallennustila
  • Tehokas PHP- ja web-palvelimen konfigurointi
  • Selainyhteensopiva WebP-toimitus
  • Kaksoiskappaleiden havaitseminen
  • Ulkoinen objektitallennus
  • Sopivat kuvanpakkausasetukset
  • Omistettu FFmpeg-työntekijät videomuunnoksiin
  • Käänteinen välityspalvelimen välimuisti tarvittaessa

Kuvan ja videon muunnokset kuluttavat palvelimen resursseja erityisesti silloin, kun käsitellään suuria tiedostoja tai luodaan useita versioita.

Huomattavaa videoliikennettä käsittelevissä asennuksissa kannattaa harkita median käsittelyyn liittyvien työkuormien erottamista tavallisista lähetys- ja latauspyynnöistä.

Johtopäätös

PictShare on kevyt, avoimen lähdekoodin tiedostojenjakoalusta, joka on suunniteltu yksinkertaistamaan kuvien, videoiden, äänen ja tekstikatkelmien lataamista, muuntamista ja jakelua.

URL-pohjaisen kuvankäsittelyn, lataus-API: n, kaksoiskappaleiden havaitsemisen, jaettavien albumien, ulkoisten tallennusintegraatioiden ja sisäänrakennetun MCP-palvelimen ansiosta se tarjoaa enemmän toimintoja kuin tavanomainen kuva-hosting-sovellus säilyttäen suhteellisen yksinkertaisen käyttöönottomallin.

Sen tietokantavapaa arkkitehtuuri, Docker-tuki ja joustavat tallennusvaihtoehdot tekevät siitä erityisen sopivan kotilaboratorioille, kehittäjille ja organisaatioille, jotka tarvitsevat itse isännöidyn vaihtoehdon julkisille tiedostonjakopalveluille.

PictShare on käytännöllinen ratkaisu rakentaa keskitetty media lataus päätepisteen, joka voidaan integroida verkkosivuilla, sovelluksia, komentosarjoja, ja automatisoituja työnkulkuja.

Viralliset resurssit

Tilaa