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:
- Osta sovellus Esadaxin kautta.
- Oston jälkeen sinua pyydetään antamaan tarvittavat kokoonpanoparametrit.
- Määritä julkinen sovelluksen URL-osoite verkkotunnuksesi tai aliverkkotunnuksesi avulla.
- Määritä pysyvä tallennustila ladatuille tiedostoille.
- Määritä latauskoodi, jos latausten pitäisi vaatia todennusta.
- Määritä tiedostojen käsittelyvaihtoehdot tarvittaessa.
- Määritä tarvittaessa ulkoinen tallennustila.
- Käynnistä sovellus valitsemalla Ota käyttöön.
- Käytä PictSharea sille määritetyn sovellus-URL:n kautta.
- Lataa testikuva ja tarkista, että luotu URL-osoite toimii.
- Testaa kuvan muunnoksia ja tiedostojen poistoa.
- 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:
- Valitse kuva laitteesta.
- Lataa tiedosto verkkokäyttöliittymän tai API:n kautta.
- PictShare validoi ja käsittelee ladatun sisällön.
- Tiedosto tallennetaan määritettyyn tallennuspalvelimeen.
- Yksilöllinen URL-osoite luodaan.
- 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_IPrajoittamaan pääpoistotoimintoja. - Suojaa ladatut tiedostot ja tallennushakemistot.
- Määritä
TRUSTED_PROXIESoikein, 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:
IMAGESVGTEXTVIDEOURLHTML
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ä
/datapysyvää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.

