PictShare är en lätt, öppen källkod, self-hosted fildelning plattform utformad för att ladda upp, lagra, omvandla och dela bilder, videor, ljudfiler och textutdrag.
Det ger ett centraliserat webbgränssnitt och ladda upp API som tillåter användare och program att publicera filer och få delbara webbadresser utan att vara beroende av externa fil-hosting tjänster.
Till skillnad från traditionella molnlagringsplattformar fokuserar PictShare på enkel filhantering och medieleverans. Användare kan ladda upp innehåll, generera direktlänkar, omvandla bilder genom URL-parametrar och dela filer med andra.
En av dess utmärkande egenskaper är dess URL-baserade bildbehandlingssystem. Användare kan ändra storlek, rotera och använda filter på bilder genom att ändra deras webbadresser, utan att manuellt skapa flera versioner av originalfilen.
PictShare stöder också videobearbetning, GIF-konvertering, text hosting, Markdown rendering, ljuduppspelning och delbara mediaalbum.
Dess filbaserade arkitektur kräver inte en konventionell databas, vilket gör den särskilt lämplig för hemlabb, utvecklare och organisationer som behöver en kompakt fildelningstjänst.
PictShare är ett open-source-projekt som utvecklats av HaschekSolutions.
Projektet skapades för att tillhandahålla ett eget värdalternativ till offentliga bildvärdstjänster, med tonvikt på enkelhet, flexibilitet och kontroll över uppladdat innehåll.
Applikationen utvecklades från en grundläggande bildvärdtjänst till en bredare mediedelningsplattform som stöder bilder, videor, textutdrag, extern lagring och API-integrationer.
PictShare version 3 introducerade en betydande arkitektonisk omarbetning, inklusive en uppdaterad REST-orienterad API, ytterligare innehållstyper, stöd för extern lagring, album och en inbyggd Model Context Protocol (MCP) server.
Projektet är främst implementerat i PHP och tillhandahåller Docker-baserad distribution.
PictShare ger flera funktioner för att ladda upp, hantera, omvandla och dela filer.
PictShare är lämplig för privatpersoner, utvecklare och organisationer som behöver en enkel fil-uppladdning och delning infrastruktur.
Vanliga användningsfall inkluderar:
För att installera PictShare genom Esadax, följ dessa steg:
När PictShare har distribuerats tillhandahåller det en centraliserad slutpunkt för uppladdning och distribution av filer.
PictShare ger ett webbgränssnitt för att ladda upp bilder och generera delbara webbadresser.
När en uppladdning är klar genererar programmet ett unikt filnamn och gör bilden tillgänglig via dess offentliga URL.
Det allmänna arbetsflödet är:
PictShare genererar också individuella raderingskoder som tillåter uppladdade filer att tas bort utan att kräva direkt tillgång till serverns filsystem.
Samma uppladdningsinfrastruktur kan användas av externa program, skript och kommandoradsverktyg.
En av PictShares mest användbara funktioner är dess URL-baserade bildbehandlingssystem.
Istället för att manuellt generera flera bildstorlekar kan användare begära olika versioner av en uppladdad bild genom att ändra dess webbadress.
Tillgängliga operationer inkluderar:
En uppladdad bild kan till exempel finnas tillgänglig på:
https://files.example.com/image123.jpg
En storleksändrad version kan begäras med hjälp av:
https://files.example.com/800x600/image123.jpg
Ytterligare omvandlingar kan kombineras i webbadressen.
PictShare version 3 kräver att det ursprungliga filnamnet är den sista komponenten i URL:en. Detta skiljer sig från äldre versioner, som tillät filnamnet att visas någon annanstans i sökvägen.
Detta tillvägagångssätt gör PictShare särskilt användbar för webbplatser och program som behöver flera bildstorlekar utan att upprätthålla separata kopior av varje bild.
PictShare stöder uppladdning och delning av videofiler via genererade webbadresser.
Plattformen innehåller videobearbetningsfunktioner för att förbereda media för webbläsarbaserad uppspelning och distribution.
Videofunktionalitet inkluderar:
Videobearbetning är beroende av FFmpeg.
För installationer som hanterar stora videor eller frekventa konverteringar bör tillräckliga CPU-resurser allokeras till programmet.
PictShare stöder också en separat FFmpeg-arbetare som behandlar köade konverteringsuppgifter, vilket gör att resurskrävande operationer kan köras oberoende av huvudwebbförfrågan.
PictShare är inte begränsad till bilder och videor.
Den stöder också text hosting, så att användarna kan ladda upp textinnehåll och distribuera den via delbara webbadresser.
Vanliga exempel är:
Markdown-filer kan återges som formaterad HTML, vilket gör PictShare användbar för att dela lätt dokumentation.
Textinnehåll kan också nås via rådatavyer eller laddas ner, beroende på vilken innehållstyp och konfiguration som stöds.
Detta ger ett bekvämt alternativ till att manuellt dela textfiler eller använda externa klistra in-tjänster.
PictShare stöder hosting ljudfiler och ger en webbläsarbaserad ljudspelare.
Format som stöds inkluderar:
Uppladdade ljudfiler kan nås via genererade webbadresser och spelas med hjälp av kompatibla webbläsare.
Detta gör PictShare användbar för att dela ljudinspelningar, korta ljudklipp och annat ljudinnehåll som stöds.
PictShare ger ett album funktion för att gruppera flera uppladdade filer till en enda delbar galleri.
Istället för att distribuera separata länkar för varje bild kan användarna skapa ett album som innehåller flera filer.
Albumfunktionalitet inkluderar:
Album är särskilt användbara för att dela skärmdumpar, händelsefotografier, samlingar av grafik och andra relaterade medier.
PictShare ger en HTTP API som tillåter externa program att ladda upp filer programmatiskt.
API:t returnerar JSON-svar som innehåller information om det uppladdade innehållet och dess genererade URL.
En grundläggande uppladdningsbegäran använder slutpunkten /api/upload.
Exempel med cURL:
curl -F "file=@image.jpg" \
https://files.example.com/api/upload
Ett lyckat svar innehåller information som:
PictShare stöder också ladda upp innehåll från fjärranslutna webbadresser genom sin URL-import funktionalitet.
Vanliga integrationsscenarier inkluderar:
API gör PictShare särskilt användbart för utvecklare som behöver fil-hosting funktionalitet utan att genomföra en separat uppladdning infrastruktur.
PictShare innehåller en inbyggd Model Context Protocol-server.
MCP gör det möjligt för kompatibla AI-applikationer och agenter att interagera med fildelningstjänsten genom ett standardiserat verktygsgränssnitt.
Slutpunkten finns på:
POST /mcp
Tillgängliga verktyg inkluderar:
När UPLOAD_CODE är konfigurerat måste MCP-klienter tillhandahålla uppladdningskoden som en innehavartoken.
Den här integrationen är användbar för automatiserade arbetsflöden där AI-agenter behöver ladda upp skärmdumpar, bearbeta mediereferenser eller hantera filer via en egen värdtjänst.
PictShare stöder extern lagring backends genom sin lagringsstyrenhet arkitektur.
Detta gör att uppladdade filer kan lagras utanför huvudprogramkatalogen.
Konfigurationer som stöds inkluderar:
S3-kompatibel lagring kan vara användbar när du är värd för stora mediesamlingar eller använder flera PictShare-instanser.
Programmet kan också kryptera filer som lagras via externa lagringskontroller som stöds.
Kryptering utförs automatiskt under uppladdningar och nedladdningar när lämplig krypteringsnyckel är konfigurerad.
Detta gör det möjligt för organisationer att separera sin applikationsinfrastruktur från sin medielagring samtidigt som de behåller ytterligare skydd för externt lagrade filer.
PictShare innehåller dubbletter upptäckt för att undvika att lagra identiska uppladdningar flera gånger.
När en exakt dubblett laddas upp kan programmet återanvända den befintliga lagrade filen istället för att skapa en annan fysisk kopia.
Detta bidrar till att minska lagringsförbrukningen när flera användare eller program laddar upp samma innehåll.
Filhantering funktionalitet inkluderar:
Borttagningskoden som returneras under en uppladdning bör lagras säkert eftersom den kan krävas för att ta bort den associerade filen.
PictShare är utformad som en lätt fildelningstjänst, så administratörer bör vara särskilt uppmärksamma på uppladdningsbehörigheter och innehållet som är värd.
Viktiga säkerhetsrutiner inkluderar:
UPLOAD_CODE när offentliga anonyma uppladdningar inte krävs.ALLOWED_SUBNET när det är lämpligt.MASTER_DELETE_CODE om global borttagningsfunktionalitet är aktiverad.MASTER_DELETE_IP för att begränsa huvudborttagningsåtgärder.TRUSTED_PROXIES korrekt när du kör bakom en omvänd proxy.PictShare tar bort EXIF-metadata under bilduppladdningar, vilket hjälper till att förhindra oavsiktlig publicering av inbäddade GPS-koordinater och kamerainformation.
PictShare stöder hosting råa HTML-sidor, men denna funktion är inaktiverad som standard.
När det är aktiverat kan uppladdad HTML exekvera godtycklig JavaScript på samma ursprung som PictShare-programmet.
Detta kan utsätta besökare och autentiserade administrativa sessioner för allvarliga säkerhetsrisker.
Aktivera endast HTML-hosting när det finns ett tydligt krav, och använd en dedikerad HTML_UPLOAD_CODE som är separat från den normala uppladdningskoden.
För offentliga fildelningsdistributioner rekommenderar vi starkt att du lämnar HTML-värdtjänsten inaktiverad.
Efter att ha köpt denna ansökan på Esadax, kommer du att uppmanas att tillhandahålla de konfigurationsparametrar som krävs av distributionen.
Esadax lägger till de tillhandahållna variablerna i driftsättningen så att applikationen kan startas med den konfiguration den kräver.
PictShare version 3 använder en konfigurationsfil som heter:
inc/config.inc.php
Förrådet tillhandahåller också en exempelkonfigurationsfil:
inc/example.config.inc.php
Följande alternativ stöds av uppströmskonfigurationen:
| Parametrar | Beskrivning |
|---|---|
URL |
Offentlig bas-URL som används vid generering av länkar. Måste avslutas med ett efterföljande snedstreck. |
UPLOAD_CODE |
Valfri kod krävs för uppladdningar via API som stöds och uppladdningsbegäranden. |
ALLOWED_SUBNET |
Kommaseparerade IP-adresser, CIDR-intervall eller värdnamn som tillåts ladda upp filer och komma åt administrationspanelen. |
TRUSTED_PROXIES |
IP-adresser, CIDR-intervall eller värdnamn för betrodda omvända proxies. |
MASTER_DELETE_CODE |
Valfri huvudkod som tillåter radering av någon lagrad fil. |
MASTER_DELETE_IP |
Begränsar åtgärder för huvudborttagning till angivna klienter. |
LOG_UPLOADER |
Aktiverar loggning av överförarens IP-adresser till /data/uploads.csv. |
LOG_VIEWS |
Aktiverar loggning av begäran för felsökningsändamål. |
| Parametrar | Beskrivning |
|---|---|
PNG_COMPRESSION |
PNG-komprimeringsnivå, från 0 till 9. |
JPEG_COMPRESSION |
JPEG-kvalitetsinställning, från 0 till 100. |
WEBP_COMPRESSION |
WebP-kvalitetsinställning, från 0 till 100. |
ALWAYS_WEBP |
Visar kompatibla JPEG-bilder som WebP när det stöds av den begärande webbläsaren. |
CORS_ALLOW_ORIGIN |
Konfigurerar svarshuvudet Access-Control-Allow-Origin. |
FFMPEG_BINARY |
Sökväg till den körbara FFmpeg-filen som används för mediebearbetning. |
| Parametrar | Beskrivning |
|---|---|
CONTENTCONTROLLERS |
Valfri kommaavgränsad vitlista över innehållstyper som stöds. |
HTML_HOSTING_ENABLED |
Aktiverar uttryckligen rå HTML-hosting. Inaktiverat som standard. |
HTML_UPLOAD_CODE |
Separat auktoriseringskod krävs för att publicera HTML-innehåll. |
Värden för innehållskontroller som stöds är bland annat:
IMAGESVGTEXTVIDEOURLHTMLHTML-hosting kräver också att HTML_HOSTING_ENABLED och HTML_UPLOAD_CODE konfigureras.
| Parametrar | Beskrivning |
|---|---|
ALT_FOLDER |
Ytterligare lokal eller monterad filsystemsplats där uppladdade filer kopieras. |
ENCRYPTION_KEY |
Base64-kodad krypteringsnyckel som används för externa lagringsstyrenheter som stöds. |
S3_BUCKET |
Namn på den S3-kompatibla lagringshinken. |
S3_ACCESS_KEY |
Åtkomstnyckel som används för att ansluta till extern lagring. |
S3_SECRET_KEY |
Hemlig nyckel som används för att ansluta till extern lagring. |
S3_ENDPOINT |
Slutpunkts-URL för den S3-kompatibla lagringstjänsten. |
S3_REGION |
Region som är kopplad till lagringshinken. |
Ytterligare FTP-lagringsinställningar är tillgängliga när motsvarande lagringsstyrenhet används.
Uppströmsdokumentationen listar även några äldre eller planerade konfigurationsalternativ som inte är implementerade. Förlita dig inte på UPLOAD_QUOTA, MAX_RESIZED_IMAGES eller de dokumenterade Redis-arbetsinställningarna som aktiva funktioner utan att verifiera den valda versionen.
De exakta konfigurationsparametrarna beror på Esadax-distributionspaketet. Använd de parametrar som presenteras under inköps- och distributionsprocessen.
När de nödvändiga värdena har konfigurerats klickar du på Deploy för att starta PictShare.
PictShare tillhandahåller en officiell Docker-bild:
ghcr.io/hascheksolutions/pictshare
Standarddistributionen kan startas med följande kommando:
docker run -d \
-p 8080:80 \
--name pictshare \
ghcr.io/hascheksolutions/pictshare
Programmet lyssnar på containerporten 80.
Den externa porten kan mappas enligt din driftsättningsmiljö.
För beständiga distributioner konfigurerar du en volym för uppladdade filer och bevarar programkonfigurationen.
PictShare tillhandahåller också en Docker Compose-konfiguration som kan bygga programmet lokalt och ladda inställningar från en .env-fil.
PictShare använder filbaserad lagring istället för en konventionell relationsdatabas.
Uppladdad media lagras på filsystemet eller via konfigurerade externa lagringsstyrenheter.
Standarddistributionen av Docker använder /data som sin beständiga uppladdningskatalog.
För tillförlitlig drift:
/data till beständig lagring.Eftersom uppladdade filer lagras oberoende av en databas kan grundläggande säkerhetskopior utföras genom att kopiera de relevanta filerna och bevara deras katalogstruktur.
När du använder krypterad extern lagring måste krypteringsnyckeln också behållas säkert för att säkerställa att uppladdat innehåll förblir tillgängligt.
PictShare kan skalas genom extern lagring och flera programinstanser.
S3-kompatibel lagring och nätverksmonterade kataloger gör det möjligt för flera instanser att komma åt samma uppladdade innehåll.
Prestanda kan förbättras genom:
Bild- och videoomvandlingar förbrukar serverresurser, särskilt vid bearbetning av stora filer eller generering av flera versioner.
För installationer som hanterar betydande videotrafik bör du överväga att separera arbetsbelastningar för mediebearbetning från vanliga förfrågningar om uppladdning och nedladdning.
PictShare är en lätt, öppen källkod fildelning plattform som syftar till att förenkla uppladdning, omvandla och distribuera bilder, videor, ljud och textutdrag.
Med sin URL-baserade bildbehandling, uppladdning API, duplicera upptäckt, delbara album, extern lagring integrationer, och inbyggd MCP-server, ger det mer funktionalitet än en konventionell bild-hosting program samtidigt som en relativt enkel distributionsmodell.
Dess databasfria arkitektur, Docker-stöd och flexibla lagringsalternativ gör det särskilt lämpligt för hemlabb, utvecklare och organisationer som behöver ett eget alternativ till offentliga fildelningstjänster.
PictShare är en praktisk lösning för att bygga en centraliserad media uppladdning slutpunkt som kan integreras i webbplatser, program, skript och automatiserade arbetsflöden.