> ## Content Index
> Fetch the complete content index at: https://blog.esadax.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# PictShare
- URL: https://blog.esadax.com/fi/pictshare-fi-3/
- Published: 2026-11-15T05:11:46.000Z
- Updated: 2026-11-15T05:11:46.000Z
- Author: Esadax 
- Tags: #tr-apps-03-catalog-pictshare, #fi, #mdx-imported, Apps

# 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:

```bash
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:

```bash
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

- [PictShare GitHub Repository](https://github.com/HaschekSolutions/pictshare?ref=blog.esadax.com)
- [PictShare virallinen sivusto](https://pictshare.net/?ref=blog.esadax.com)
- \[Määritysten viite\] ([https://github.com/HaschekSolutions/pictshare/blob/master/rtfm/CONFIG.md](https://github.com/HaschekSolutions/pictshare/blob/master/rtfm/CONFIG.md?ref=blog.esadax.com))
- [Ohjelmointirajapinnan dokumentaatio](https://github.com/HaschekSolutions/pictshare/blob/master/rtfm/API.md?ref=blog.esadax.com)
- [Docker-kuva](https://github.com/HaschekSolutions/pictshare/pkgs/container/pictshare?ref=blog.esadax.com)
- [MCP-dokumentaatio](https://github.com/HaschekSolutions/pictshare/blob/master/rtfm/MCP.md?ref=blog.esadax.com)