Wat is Pixelfed?
Pixelfed is een gedecentraliseerd, open-source platform voor het delen van foto's dat is ontworpen voor het delen van foto's, het ontdekken van creatieve inhoud en de interactie met andere gebruikers via een gefedereerd sociaal netwerk.
Gebouwd rond het ActivityPub-protocol, stelt Pixelfed gebruikers in staat om accounts aan te maken, foto's te publiceren, albums te delen, andere gebruikers te volgen en te communiceren met inhoud van verschillende compatibele platforms in het Fediverse.
In tegenstelling tot gecentraliseerde sociale mediaplatforms, stelt Pixelfed individuen en organisaties in staat om hun eigen onafhankelijke servers te beheren terwijl ze verbonden blijven met een breder gedecentraliseerd netwerk.
Het biedt een vertrouwde sociale media-ervaring met fotoposts, bijschriften, hashtags, likes, opmerkingen, verzamelingen en gebruikersprofielen, zonder dat gebruikers afhankelijk zijn van een enkele gecentraliseerde service.
Pixelfed is met name geschikt voor fotografen, creatieve gemeenschappen, privacybewuste gebruikers en organisaties die hun eigen gedecentraliseerde foto-sharing communities willen beheren.
Geschiedenis van Pixelfed
Pixelfed is gemaakt door Daniel Supernault (dansup) als een open-source alternatief voor gecentraliseerde foto-sharing platforms.
Het project richt zich op het bieden van een gedecentraliseerde sociale netwerkervaring die is gebouwd rond fotografie en visuele inhoud.
Door gebruik te maken van ActivityPub kunnen onafhankelijke servers met elkaar communiceren en sociale activiteiten uitwisselen.
Deze interoperabiliteit stelt gebruikers in staat om accounts te volgen die op verschillende servers worden gehost en met hun berichten te communiceren zonder dat er accounts op dezelfde instantie nodig zijn.
Pixelfed is voornamelijk ontwikkeld met behulp van PHP en Laravel, met een webinterface en ondersteunende diensten voor mediaverwerking, caching en achtergrondtaken.
Het project wordt gedistribueerd onder de GNU Affero General Public License (AGPL).
Belangrijkste kenmerken van Pixelfed
Pixelfed biedt een verzameling van sociale netwerken en foto management functies.
- Foto's delen: Publiceer foto's en visuele inhoud via persoonlijke of organisatorische accounts.
- Albums: Combineer meerdere foto's in een enkele post.
- ActivityPub Federatie: Interactie met gebruikers en inhoud van andere compatibele Fediverse platforms.
- Gebruikersprofielen: Maak aanpasbare profielen met biografieën, profielfoto's en gepubliceerde berichten.
- Volgen en Volgers: Volg andere accounts en bouw een gepersonaliseerd sociaal netwerk.
- Likes en Reacties: Interactie met foto's door middel van likes en reacties.
- Hashtags: Categoriseer en ontdek inhoud met behulp van hashtags.
- Content Discovery: Verken openbare foto's en ontdek nieuwe makers.
- Mediafilters: Pas visuele aanpassingen en filters toe op foto's voordat u ze publiceert.
- Verhalen: Deel tijdelijke visuele inhoud met behulp van ondersteunde Story-functionaliteit.
- Collecties: Foto's organiseren en opslaan in persoonlijke collecties.
- Waarschuwingen voor inhoud: Markeer gevoelige inhoud, zodat media kunnen worden verborgen voordat ze worden bekeken.
- Alternatieve tekst: Voeg toegankelijkheidsbeschrijvingen toe aan foto's.
- Geolocatie: Associatie van geografische informatie met gepubliceerde foto's.
- Privacy Controls: Configureer account en post zichtbaarheid.
- Moderatietools: Blokkeer, demp, meld en beheer ongewenste interacties.
- Mobiele toegang: Gebruik compatibele mobiele applicaties en browserinterfaces.
- REST API: Integreer externe applicaties met ondersteunde Pixelfed functionaliteit.
- OAuth-ondersteuning: Sta compatibele toepassingen toe om zich via het platform te verifiëren.
- Docker-implementatie: Host de toepassing met behulp van Docker Compose.
Gebruik van gevallen
Pixelfed is geschikt voor individuen, fotografen, gemeenschappen en organisaties die geïnteresseerd zijn in het decentraal delen van foto's.
Veelvoorkomende gebruiksscenario's zijn onder meer:
- Fotografie Gemeenschappen: Bouw gemeenschappen waar fotografen hun werk kunnen publiceren en delen.
- Persoonlijke Photo Sharing: Deel alledaagse foto's met volgers en vrienden.
- Creatieve portfolio's: Publiceer foto's, illustraties en andere visuele inhoud.
- Gedecentraliseerde Sociale Netwerken: Bedien een onafhankelijke instantie voor het delen van foto's die is verbonden met het Fediverse.
- Community Platforms: Maak speciale ruimtes voor fotografie liefhebbers en creatieve groepen.
- Reizen Fotografie: Deel foto's, reiservaringen en geografische ontdekkingen.
- Artistieke gemeenschappen: Bouw gemeenschappen gericht op beeldende kunst en creatieve expressie.
- Privégemeenschappen: Gebruik op uitnodiging beheerde instanties voor geselecteerde gebruikers.
- Open Social Networking: Interactie met gebruikers over Pixelfed, Mastodon, en andere compatibele ActivityPub platforms.
- Self-Hosted Media Communities: Behoud de controle over de community-infrastructuur en geüploade foto's.
Voordelen van Pixelfed
- Open-source en zelf gehost platform voor het delen van foto's
- Gedecentraliseerd sociaal netwerk via ActivityPub
- Interoperabiliteit met compatibele Fediverse-platforms
- Onafhankelijk server- en communitybeheer
- Fotoberichten en albums met meerdere afbeeldingen
- Hashtags en content discovery
- Gebruikersprofielen en sociale interacties
- Privacy- en zichtbaarheidsinstellingen
- Waarschuwingen voor inhoud en toegankelijkheidsbeschrijvingen
- Verhalen en mediacollecties
- Moderatie en accountbeheer
- REST API en OAuth integratie
- Configureerbare mediaopslag
- Op Docker gebaseerde implementatie
- Meer controle over gemeenschapsgegevens en infrastructuur
Hoe Pixelfed te installeren
Volg deze stappen om Pixelfed via Esadax te installeren:
- Koop de applicatie via Esadax.
- Na aankoop wordt u gevraagd de vereiste configuratieparameters op te geven.
- Configureer het openbare domein dat uw Pixelfed-instantie identificeert.
- Configureer de databaseverbinding en referenties.
- Redis configureren voor caching en achtergrondtaken.
- Genereer en configureer de coderingssleutel van de toepassing.
- Configureer SMTP-instellingen voor accountregistratie en meldingen.
- Configureer permanente opslag voor geüploade foto's en video's.
- Schakel ActivityPub-federatie in als de instantie moet communiceren met het Fediverse.
- Klik op Deploy om Pixelfed te starten.
- Toegang Pixelfed via de toegewezen toepassing URL.
- Voltooi de eerste beheerders- en instantie-instellingen.
- Registratiebeleid en moderatie-instellingen configureren.
- Maak uw gebruikersaccount aan en pas uw profiel aan.
- Begin met het publiceren van foto's en interactie met andere verenigde gemeenschappen.
Eenmaal geconfigureerd, Pixelfed biedt een self-hosted social networking platform voor het delen van foto's en verbinding maken met de bredere Fediverse.
Foto- en albumbeheer
Pixelfed is voornamelijk ontworpen rond het delen van foto's.
Gebruikers kunnen afzonderlijke foto's publiceren of meerdere afbeeldingen combineren in albums.
Elke publicatie kan beschrijvende tekst, hashtags, vermeldingen, toegankelijkheidsbeschrijvingen en andere ondersteunde metagegevens bevatten.
Mogelijkheden voor fotobeheer omvatten:
- Het uploaden van foto's
- Albums met meerdere afbeeldingen publiceren
- Bijschriften en beschrijvingen toevoegen
- Ondersteunde afbeeldingsfilters toepassen
- Hashtags en vermeldingen toevoegen
- Waarschuwingen voor inhoud instellen
- Alternatieve tekst toevoegen
- Locatie-informatie koppelen
- Gepubliceerde berichten beheren
- Inhoud verwijderen of bewerken
Albums bieden een handige manier om meerdere gerelateerde foto's samen te publiceren.
Een fotograaf kan bijvoorbeeld een album maken met afbeeldingen van een bepaalde gebeurtenis, locatie of fotografieproject.
ActiviteitenPub en Fediverse Federatie
Een van de belangrijkste kenmerken van Pixelfed is de integratie met ActivityPub.
ActivityPub is een open sociaal netwerkprotocol waarmee onafhankelijk beheerde platforms met elkaar kunnen communiceren.
Pixelfed gebruikt dit protocol om activiteiten uit te wisselen met compatibele applicaties zoals Mastodon en andere Fediverse software.
Met Federation kunnen gebruikers:
- Volg accounts die op andere servers worden gehost.
- Ontvang berichten van externe accounts.
- Deel foto's met volgers op afstand.
- Vind federatieve berichten leuk en reageer erop.
- Ondersteunde inhoud opnieuw delen.
- Ontdek gebruikers van andere instanties.
- Ontvang volgersverzoeken.
- Onderhoud sociale verbindingen tussen onafhankelijke servers.
Zo kan een Pixelfed-gebruiker een Mastodon-account volgen zonder een apart Mastodon-account aan te maken.
Op dezelfde manier kunnen gebruikers op compatibele platforms Pixelfed-accounts volgen met behulp van hun gefedereerde adressen.
Een account volgt over het algemeen het formaat:
@username@example.com
Het domein identificeert de server waarop het account wordt gehost.
Federatie stelt elke server in staat om zijn eigen administratie, registratiebeleid en moderatieregels te behouden, terwijl het deel blijft uitmaken van een groter gedecentraliseerd netwerk.
Gebruikersprofielen en sociale interactie
Pixelfed biedt gebruikersprofielen voor het publiceren van foto's en het opbouwen van sociale connecties.
Elk account heeft een profielpagina met informatie zoals:
- Gebruikersnaam
- Naam voor weergave
- Profielafbeelding
- Biografie
- De gepubliceerde foto's
- Albums
- Volgers
- De volgende informatie
Gebruikers kunnen andere accounts volgen, reageren op hun publicaties en hun eigen sociale netwerken opbouwen.
Het platform biedt verschillende interactiemechanismen:
- Het leuk vinden van foto's
- Reageren op berichten
- Het volgen van accounts
- Andere gebruikers vermelden
- Het delen van ondersteunde publicaties
- Accounts ontdekken via zoekopdrachten en hashtags
Deze functies creëren een vertrouwde sociale ervaring terwijl de compatibiliteit met gedecentraliseerde netwerkstandaarden behouden blijft.
Content Discovery en Hashtags
Pixelfed bevat ontdekkingsfunctionaliteit voor het bladeren door foto's en het vinden van accounts.
Hashtags bieden een manier om visuele inhoud te categoriseren en gebruikers te helpen publicaties te ontdekken die betrekking hebben op specifieke onderwerpen.
Voorbeelden hiervan zijn:
#photography#landscape#architecture#streetphotography#nature#travel
Gebruikers kunnen zoeken naar hashtags en inhoud verkennen die door verschillende accounts is gepubliceerd.
Met openbare inhoudsdetectie kunnen gebruikers ook fotografen en gemeenschappen vinden buiten hun bestaande lijst met volgers.
De zichtbaarheid van federatieve inhoud is afhankelijk van de privacyinstellingen van het account, de zichtbaarheid van publicaties, het moderatiebeleid en het gedrag van de serverfederatie.
Verhalen en tijdelijke inhoud
Pixelfed ondersteunt Stories voor het delen van tijdelijke visuele content.
Verhalen bieden een andere publicatie-ervaring dan permanente fotoposts.
Ze zijn handig voor:
- Foto's achter de schermen
- De dagelijkse updates
- Momenten van reizen
- Korte visuele aankondigingen
- Informele gemeenschapsinteracties
Pixelfed implementeert ook ActivityPub-extensies voor het uitwisselen van ondersteunde Story-activiteiten.
Verhaalfederatie is niet universeel voor alle compatibele platforms en wordt momenteel voornamelijk ondersteund tussen bekende Pixelfed-instanties.
Privacy- en zichtbaarheidsinstellingen
Pixelfed biedt privacy-instellingen waarmee gebruikers de zichtbaarheid van hun accounts en publicaties kunnen beheren.
Afhankelijk van de ondersteunde instellingen kunnen gebruikers het volgende configureren:
- Openbare accountzichtbaarheid
- Privéaccounts waarvoor goedkeuring van volgers is vereist
- Zichtbaarheid van publicaties
- Toegang voor volgers
- Waarschuwingen voor inhoud
- Toestemmingen voor reacties
- Account blokkeren en muten
Privéaccounts vereisen dat gebruikers inkomende volgverzoeken goedkeuren voordat hun volgers toegang hebben tot beveiligde inhoud.
Met inhoudswaarschuwingen kunnen potentieel gevoelige media worden verborgen achter een extra actie.
Gebruikers moeten begrijpen dat het openbaar publiceren van inhoud of het delen ervan met federatieve servers ertoe kan leiden dat kopieën worden opgeslagen in de cache of worden gedistribueerd buiten hun oorspronkelijke instantie.
Het verwijderen van een bericht van de oorspronkelijke server garandeert niet dat elke externe kopie onmiddellijk wordt verwijderd.
Federatie met Mastodon en andere platformen
Pixelfed maakt deel uit van de bredere Fediverse, een netwerk van onafhankelijk beheerde sociale platforms die communiceren via open protocollen.
ActivityPub interoperabiliteit maakt het mogelijk om te communiceren met gebruikers in verschillende toepassingen.
Compatibele platforms zijn onder andere:
- Mastodon: Volg accounts, bekijk ondersteunde berichten en communiceer met gefedereerde inhoud.
- Andere Pixelfed instanties: Exchange foto's, volgers, en sociale activiteiten.
- Andere ActivityPub Platforms: Interactie met compatibele diensten volgens hun protocol implementaties.
Federatie introduceert ook administratieve verantwoordelijkheden.
Instancebeheerders kunnen communitybeleid opstellen, lokale gebruikers modereren en interacties met externe servers beheren.
Een beheerder kan specifieke externe instanties blokkeren wanneer hun inhoud of moderatiebeleid in strijd is met de vereisten van de lokale community.
API- en ontwikkelaarsintegraties
Pixelfed biedt API-functionaliteit waarmee compatibele applicaties kunnen communiceren met het platform.
De API is gebaseerd op Mastodon-compatibele eindpunten en Pixelfed-specifieke functionaliteit.
Veelvoorkomende integratiescenario's zijn onder andere:
- Verificatie van externe toepassingen.
- Foto's programmatisch publiceren.
- Accountinformatie ophalen.
- Toegang tot ondersteunde tijdlijnen.
- Het beheren van sociale interacties.
- Het integreren van fotopublicaties in externe applicaties.
- Het ontwikkelen van aangepaste clients.
- Automatiseren van ondersteunde accountbewerkingen.
Pixelfed ondersteunt ook OAuth-verificatie voor externe toepassingen.
API-toegang kan worden geconfigureerd volgens de verificatie-instellingen en toepassingsmachtigingen van de instantie.
Voor productie-implementaties kunt u API-referenties beschermen en de toegang tot geautoriseerde toepassingen beperken.
Mediaverwerking en -opslag
Pixelfed verwerkt geüploade foto’s en video’s alvorens deze beschikbaar te stellen via het platform.
Mediaverwerking kan omvatten:
- Grootte van afbeelding wijzigen
- Het genereren van miniaturen
- Optimalisatie van afbeeldingen
- Extractie van metagegevens
- Validatie van het formaat
- Video thumbnail generatie
- Opslag en levering van media
De toepassing ondersteunt verschillende stuurprogramma's voor beeldverwerking, waaronder:
- libvips
- GD
- ImageMagick
Het geselecteerde beeldstuurprogramma is van invloed op de verwerkingsmogelijkheden en prestaties.
Pixelfed ondersteunt ook compatibele cloudopslagdiensten via de configuratie van het bestandssysteem.
Voor grotere instanties kan externe S3-compatibele objectopslag de hoeveelheid mediagegevens die rechtstreeks op de toepassingsserver wordt onderhouden, verminderen.
Beveiliging / beheer / configuratie
Pixelfed biedt administratie- en moderatiefunctionaliteit voor het beheren van gebruikers, registratie, media en instantiegedrag.
Omdat een federatieve instantie voor het delen van foto's persoonlijke gegevens en openbaar gedistribueerde media verwerkt, zijn passende beveiligingsmaatregelen essentieel.
Belangrijke beveiligingspraktijken omvatten:
- Gebruik sterke beheerdersreferenties.
- Genereer een unieke coderingssleutel voor toepassingen.
- Schakel HTTPS in voor alle openbare toegang.
- Stel
APP_DEBUGin opfalsein productie. - Bescherm database-inloggegevens.
- Veilige Redis-toegang.
- Beperk administratieve functionaliteit.
- Configureer registratiebeleid zorgvuldig.
- Schakel e-mailverificatie in wanneer dat nodig is.
- Bewaak gebruikersrapporten en moderatieactiviteiten.
- Configureer vertrouwde proxy's correct.
- Bescherm mediaopslag en databaseback-ups.
- Houd Pixelfed en zijn afhankelijkheden up-to-date.
- Bekijk federatiebeleid en beleid voor externe instanties.
- Beperk openbare registratie wanneer u een privégemeenschap beheert.
Het instantiedomein moet worden geselecteerd voordat federatie wordt gestart.
Het wijzigen van het canonieke domein nadat accounts en berichten zijn samengevoegd, kan problemen veroorzaken met accountidentiteiten, media-URL's en externe verwijzingen.
Beheerders moeten ook begrijpen dat federatieve inhoud kan worden gerepliceerd en in de cache kan worden opgeslagen door externe servers.
Aanbevolen procedures voor Pixelfed
- Kies een stabiel domein voor de instantie voordat u deze implementeert.
- Configureer HTTPS voor de toepassing.
- Genereer en maak een veilige back-up van
APP_KEY. - Schakel ActivityPub alleen in wanneer federatie is bedoeld.
- Redis configureren voor caching en achtergrondtaakverwerking.
- Voer de wachtrijwerker en -planner continu uit.
- Configureer SMTP voor accountverificatie en meldingen.
- Stel redelijke uploadlimieten in.
- Gebruik permanente opslag voor mediabestanden.
- Overweeg S3-compatibele opslag voor grotere instanties.
- Stel duidelijke gemeenschapsrichtlijnen op.
- Bekijk het registratie- en moderatiebeleid.
- Federatieactiviteiten en mislukte achtergrondtaken controleren.
- Maak een back-up van de database en geüploade media.
- Houd de toepassing en de componenten voor beeldverwerking up-to-date.
- Test upgrades voordat u ze toepast op de productie.
Parameters van de configuratie
Na aankoop van deze applicatie op Esadax, wordt u gevraagd om de configuratieparameters te verstrekken die nodig zijn voor de implementatie.
Pixelfed gebruikt omgevingsvariabelen, over het algemeen gedefinieerd in een .env bestand, om de applicatie en ondersteunende diensten te configureren.
De volgende parameters zijn gebaseerd op de upstream Docker-configuratie.
Configuratie van toepassingen
| Parameter | Beschrijving |
|---|---|
APP_NAME |
Naam weergegeven door de Pixelfed instantie. |
APP_ENV |
Toepassingsomgeving, normaal production. |
APP_KEY |
Unieke toepassingscoderingssleutel die tijdens de initialisatie wordt gegenereerd. |
APP_DEBUG |
Hiermee schakelt u foutopsporing in toepassingen in of uit. Moet false in productie zijn. |
APP_LOCALE |
Standaard toepassingstaal. |
APP_URL |
Volledige openbare URL van de Pixelfed-instantie, inclusief HTTPS. |
APP_DOMAIN |
Primair domein dat door de instantie wordt gebruikt. |
ADMIN_DOMAIN |
Domein geconfigureerd voor beheerderstoegang tot toepassingen. |
SESSION_DOMAIN |
Domein gebruikt voor sessiecookies. |
OPEN_REGISTRATION |
Hiermee wordt bepaald of nieuwe gebruikers accounts kunnen registreren. |
ENFORCE_EMAIL_VERIFICATION |
Vereist e-mailverificatie tijdens registratie. |
PF_MAX_USERS |
Maximaal aantal gebruikers dat is toegestaan door de instantieconfiguratie. |
PF_MIN_REGISTRATION_AGE |
Minimumleeftijd geconfigureerd voor nieuwe registraties. |
INSTANCE_DISCOVER_PUBLIC |
Hiermee wordt openbare instantiedetectie beheerd. |
Configuratie van database
Pixelfed gebruikt een relationele database om accounts, berichten, interacties en applicatie-informatie op te slaan.
| Parameter | Beschrijving |
|---|---|
DB_CONNECTION |
Databasestuurprogramma, normaal gesproken mysql. |
DB_HOST |
Hostnaam van de databaseserver. |
DB_PORT |
Databaseserverpoort. |
DB_DATABASE |
Naam van de database. |
DB_USERNAME |
Database gebruikersnaam. |
DB_PASSWORD |
Database wachtwoord. |
DB_ROOT_PASSWORD |
Root-wachtwoord voor de databaseservice bij gebruik van de meegeleverde Docker Compose-database. |
De officiële Docker configuratie maakt gebruik van MySQL.
Huidige upstream-ondersteuning omvat MySQL 8+ en MariaDB 11+. PostgreSQL 14+ wordt vermeld als best-effort-ondersteuning en wordt niet aanbevolen voor productie.
Redis- en wachtrijconfiguratie
| Parameter | Beschrijving |
|---|---|
REDIS_CLIENT |
Redis client implementatie. |
REDIS_SCHEME |
Redis-verbindingsschema, normaal tcp. |
REDIS_HOST |
Hostnaam van Redis-server. |
REDIS_PORT |
Redis-serverpoort. |
REDIS_PASSWORD |
Redis-verificatiewachtwoord. |
SESSION_DRIVER |
Opslag backend gebruikt voor applicatiesessies. |
CACHE_STORE |
Cache backend, normaal redis. |
QUEUE_DRIVER |
Achtergrond taakwachtrij backend, normaal redis. |
HORIZON_PREFIX |
Voorvoegsel gebruikt voor Laravel Horizon-wachtrijbewaking. |
ActiviteitenPub en Federatie
| Parameter | Beschrijving |
|---|---|
ACTIVITY_PUB |
Hiermee schakelt u ActivityPub-federatie in of uit. |
AP_REMOTE_FOLLOW |
Maakt het volgen van accounts op afstand mogelijk. |
AP_INBOX |
Schakelt ActivityPub-inboxverwerking in. |
AP_OUTBOX |
Schakelt de ActivityPub-outboxfunctionaliteit in. |
AP_SHAREDINBOX |
Schakelt de verwerking van gedeelde postvakken in. |
Deze instellingen moeten worden geconfigureerd afhankelijk van of de instantie bedoeld is om deel te nemen aan het Fediverse.
Configuratie van media
| Parameter | Beschrijving |
|---|---|
IMAGE_DRIVER |
Stuurprogramma voor beeldverwerking: vips, gd of imagick. |
PF_OPTIMIZE_IMAGES |
Maakt beeldoptimalisatie mogelijk. |
IMAGE_QUALITY |
Standaard beeldoptimalisatiekwaliteit. |
MAX_PHOTO_SIZE |
Maximale geconfigureerde uploadgrootte voor foto's. |
MAX_CAPTION_LENGTH |
Maximale lengte van fotobijschriften. |
MAX_ALBUM_LENGTH |
Maximaal aantal toegestane mediabijlagen in een album. |
MEDIA_TYPES |
Geaccepteerde standaard media MIME-typen. |
MODERN_MEDIA_TYPES |
Geaccepteerde moderne beeldformaten, afhankelijk van het beeldstuurprogramma. |
Configuratie van e-mail
| Parameter | Beschrijving |
|---|---|
MAIL_DRIVER |
Stuurprogramma voor e-mailbezorging, normaal smtp. |
MAIL_HOST |
Hostnaam van SMTP-server. |
MAIL_PORT |
SMTP-serverpoort. |
MAIL_USERNAME |
SMTP-verificatie gebruikersnaam. |
MAIL_PASSWORD |
SMTP-verificatiewachtwoord. |
MAIL_ENCRYPTION |
SMTP-verbindingscodering, zoals tls. |
MAIL_FROM_ADDRESS |
E-mailadres van de afzender. |
MAIL_FROM_NAME |
Weergavenaam van afzender. |
MAIL_AUTO_TLS |
Hiermee wordt automatische STARTTLS-onderhandeling beheerd. |
Configuratie van externe opslag
Pixelfed ondersteunt externe objectopslag via compatibele S3-services.
| Parameter | Beschrijving |
|---|---|
PF_ENABLE_CLOUD |
Maakt integratie van cloudopslag mogelijk. |
FILESYSTEM_CLOUD |
Bestandssysteem opslag backend, normaal s3. |
AWS_ACCESS_KEY_ID |
Toegangssleutel voor objectopslag. |
AWS_SECRET_ACCESS_KEY |
Objectopslag geheime sleutel. |
AWS_DEFAULT_REGION |
Objectopslagregio. |
AWS_BUCKET |
Naam van de opslagemmer. |
AWS_URL |
Openbare opslag-URL wanneer geconfigureerd. |
AWS_ENDPOINT |
S3-compatibel opslageindpunt. |
AWS_USE_PATH_STYLE_ENDPOINT |
Schakelt indien nodig S3-adressering in padstijl in. |
De exacte configuratieparameters zijn afhankelijk van het Esadax-implementatiepakket. Gebruik de waarden die tijdens het aankoop- en implementatieproces worden gepresenteerd.
Genereer een beveiligde APP_KEY tijdens de eerste installatie en bewaar deze bij upgrades en containervervangingen.
Zodra de vereiste waarden zijn geconfigureerd, klikt u op Deploy om Pixelfed te starten.
Database en opslag
Pixelfed is afhankelijk van verschillende ondersteunende diensten om een gefedereerde instantie voor het delen van foto's te beheren.
De belangrijkste componenten omvatten:
- Toepassing: Behandelt gebruikersaccounts, berichten, profielen en API-aanvragen.
- MySQL of MariaDB: Slaat gebruikers, berichten, opmerkingen, relaties en metagegevens van toepassingen op.
- Redis: Biedt caching- en achtergrondtaakwachtrijfunctionaliteit.
- Horizon: Verwerkt achtergrondtaken, inclusief mediaverwerking en federatielevering.
- Scheduler: Voert geplande toepassingstaken uit.
- Permanente opslag: Hier worden geüploade foto's, video's, gegenereerde miniaturen en toepassingsbestanden opgeslagen.
De officiële Docker Compose-implementatie bevat afzonderlijke applicatie-, Horizon-, planner-, database- en Redis-services.
De opslagmap van de toepassing is gekoppeld op:
/var/www/html/storage
Zorg ervoor dat deze map permanent is, zodat geüploade media- en toepassingsbestanden niet verloren gaan wanneer containers opnieuw worden gemaakt.
Voor een betrouwbare werking:
- Gebruik permanente opslag voor toepassingsmedia.
- Configureer permanente MySQL- of MariaDB-opslag.
- Redis-gegevens behouden waar vereist door de implementatie.
- Maak regelmatig een back-up van de database.
- Neem geüploade media en gegenereerde toepassingsbestanden op in back-ups.
- Bescherm toepassingsgeheimen en configuratiebestanden.
- Bewaak het opslagverbruik en de databaseprestaties.
- Test restauratieprocedures.
Achtergrondverwerking en schaalbaarheid
Pixelfed is sterk afhankelijk van achtergrondtaken om media te verwerken en gefedereerde activiteiten uit te wisselen.
De Laravel Horizon-werker verwerkt taken zoals:
- Beeld- en video-optimalisatie
- Het genereren van miniaturen
- Importeren van media
- Postbezorging op afstand
- Federation-inboxverwerking
- Updates van de tijdlijn
- Meldingen van volgers
- Onderhoud van accounts
Een afzonderlijke planningsservice voert terugkerende toepassingstaken uit.
Deze services moeten operationeel blijven voor betrouwbare productie-implementaties.
De officiële Docker Compose-configuratie scheidt de webapplicatie, Horizon-werker en planner in afzonderlijke containers.
Voor grotere instanties kunnen beheerders de gelijktijdigheid van wachtrijwerkers aanpassen aan de hand van serverbronnen en activiteitsniveaus.
De prestaties zijn afhankelijk van het aantal gebruikers, geüploade media, federatieactiviteit, vereisten voor beeldverwerking en databasebelasting.
ActivityPub-federatie en netwerkvereisten
Een openbaar gefedereerde Pixelfed-instantie vereist een stabiel openbaar domein en werkende externe connectiviteit.
Voor federatie om correct te werken:
- Configureer een geldige openbare HTTPS-URL.
- Zorg ervoor dat DNS-records worden opgelost naar de server.
- Externe HTTPS-aanvragen toestaan.
- Configureer de reverse proxy om aanvragen correct door te sturen.
- Stel het canonieke toepassingsdomein in.
- Schakel de vereiste ActivityPub-instellingen in.
- Zorg ervoor dat achtergrondwachtrijwerkers actief zijn.
- Configureer de instantie-actor tijdens de eerste installatie.
Federation gebruikt ActivityPub-eindpunten om activiteiten uit te wisselen tussen servers.
In tegenstelling tot een privéfotogalerij moet een federatieve instantie bereikbaar blijven voor andere servers, zodat externe accounts profielen kunnen ophalen, berichten kunnen ontdekken en interacties kunnen leveren.
Een privé-instantie kan Pixelfed nog steeds gebruiken zonder openbare federatie, maar het zal niet dezelfde gedecentraliseerde sociale netwerkervaring bieden.
Conclusie
Pixelfed is een gedecentraliseerd, open-source platform voor het delen van foto's dat is ontworpen om individuen en organisaties controle te geven over hun eigen sociale netwerkinfrastructuur.
Met fotopublicatie, albums, hashtags, sociale interacties, privacycontroles en ActivityPub-federatie biedt het een modern alternatief voor gecentraliseerde platforms voor het delen van foto's.
De mogelijkheid om te communiceren met Mastodon en andere compatibele Fediverse-services maakt het bijzonder nuttig voor het bouwen van onafhankelijke fotografiegemeenschappen zonder in te boeten aan interoperabiliteit.
Met Docker-gebaseerde implementatie, configureerbare mediaopslag, achtergrondverwerking en community-beheertools is Pixelfed een praktische oplossing voor iedereen die op zoek is naar een zelfgehoste en gedecentraliseerde service voor het delen van foto's.
Officiële bronnen (Engels)
- Pixelfed Officiële Website
- [Documentatie] (https://pixelfed.github.io/docs-next/)
- GitHub Repository
- Docker Compose-configuratie
- Configuratie van Docker-omgeving
- Installatiehandleiding
- [Voorwaarden] (https://pixelfed.github.io/docs-next/running-pixelfed/prerequisites.html)
- [Configuratie referentie] (https://pixelfed.github.io/docs-next/running-pixelfed/configuration.html)
- ActivityPub-documentatie

