- PhotoPrism uzas artefaritan inteligentecon por organizi viajn fotojn loke per etikedoj, lokoj kaj altnivela serĉo.
- Klaraj postuloj: 2-kerna procesoro, 3 GB da RAM, SSD por datumbazo kaj kaŝmemoroj, kaj granda skambju-spaco.
- Facila instalado per Docker, muntado de originaloj, stokado kaj, se vi volas, importa dosierujo.
- Privateco unue: deploju malantaŭ HTTPS kun Traefik/Caddy se eksponita al la Interreto kaj regulaj sekurkopioj.
¿Kiel uzi PhotoPrism kiel privatan galerio funkciigitan per artefarita inteligenteco loke? Tenante vian fotobibliotekon sub kontroloSen dependi de la publika nubo, ĝi jam ne plu estas revo: per PhotoPrism, vi povas krei privatan, per artefarita inteligenteco funkciigitan fotogalerion sur via propra komputilo aŭ servilo kaj foliumi tra jaroj da memoroj sen kompromiti vian privatecon. Jen detala kaj praktika klarigo pri kiel ĝi funkcias, kion vi bezonas, kaj kiel agordi ĝin loke per Docker.
Por multaj, Google Fotoj estas ekstreme oportuna, sed kontraŭ tiu oportuno ekzistas raciaj duboj pri la uzo de datumoj. Se vi zorgas pri privateco Aŭ se vi bezonas plenumi regularojn kiel GDPR en profesiaj kuntekstoj, PhotoPrism estas potenca alternativo: aŭtomata organizado, etikedoj funkciigitaj per artefarita inteligenteco, altnivela serĉo kaj laborfluo desegnita por grandaj kolektoj, ĉio ene de via ekzistanta infrastrukturo.
Kio estas PhotoPrism kaj kial uzi ĝin loke

PhotoPrism estas TTT-aplikaĵo Foto-administrado funkciigita per artefarita inteligenteco (kun Google TensorFlow por klasifiko) kiu rekonas homojn, objektojn, kolorojn kaj scenojn por etikedi kaj organizi vian bibliotekon. Ĝi estis kreita kiel mem-gastigita solvo por ke vi povu konservi viajn fotojn kaj filmetojn hejme aŭ sur via propra servilo, konservante privatecon sen oferi modernajn funkciojn.
Estas pluraj indicoj en ĝia DNA: kongruo kun RAW kaj klasikaj formatoj kiel JPEG aŭ PNG; inteligenta indeksado kun duobligita detekto; navigado laŭ templinio, lokoj kaj etikedoj; kaj serĉilo, kiu ebligas al vi kombini filtrilojn laŭ fotilo, koloro, dato, lando, kaj eĉ marki erojn kiel ŝatatajn. Ĉio funkcias sur via maŝino, kun lokaj kaŝmemoroj kaj sen dependi de triaj partioj por analizo.
La interfaco estas PWA, do ĝi estas instalita sur la ĉefekrano de komputiloj kaj porteblaj aparatoj. Ĝi funkcias aparte bone en Chrome, Chromium, Safari, Firefox kaj EdgeBonvolu noti, ke la reludigo de certaj video- kaj aŭdio-kodekoj (ekz., AAC en H.264) povas varii laŭ retumilo, kio estas normala en la moderna reto.
Alia distingiga faktoro estas ĝia integriĝo kun WebDAV kaj eksteraj servoj: Vi povas sinkronigi de porteblaj aparatoj per aplikaĵoj kiel PhotoSynckaj ankaŭ montri la galerion kun pasvort-protektitaj ligiloj, kiuj eksvalidiĝas. Plie, se vi volas mapojn kaj lokodatumojn, PhotoPrism uzas inversan geokodan servon kaj alt-privatecajn mapojn funkciigitajn de MapTiler; ĉi tiuj rimedoj estas desegnitaj por minimumigi eksponiĝon kaj plibonigi la rendimenton de kaŝmemorado. Por lerni pli, ni inkluzivis ĉi tiun gvidilon pri kiel Organizu viajn fotojn per artefarita inteligenteco sen nuba stokado: PhotoPrism kaj lokaj alternativoj.
Postuloj, aparataro kaj rendimento
Por glata loka uzo Almenaŭ du procesoraj kernoj, 3 GB da RAM, kaj 64-bita sistemo estas rekomendindaj. Preter la minimumo, estas konsilinde adapti la RAM-on al la nombro da kernoj kaj, por grandaj bibliotekoj, uzi lokan SSD-on por la datumbazo kaj kaŝmemoroj. Indeksado estas intensa; kun SSD kaj bona interŝanĝado, ĝi pliboniĝas draste.
Se via servilo havas malpli ol 4 GB da swap-memoro, aŭ vi starigis tre agresemajn limojn por memoro/swap-memoro, Vi eble spertos neatenditajn rekomencojn Kiam la indeksilo bezonas pli da rimedoj (tio estas ofta ĉe grandaj RAW-dosieroj, 360-gradaj panoramoj aŭ 4K-videoj), ebligu aŭ pliigu la interŝanĝan spacon kaj estu pacienca: ĉe multaj fotoj, la komenca indeksigo povas daŭri tagojn.
Rilate al la datumbazo, PhotoPrism subtenas SQLite 3 kaj MariaDB 10.5.12 kaj pli novajnSQLite estas facile uzebla, sed se vi serĉas rendimenton kaj skaleblecon, MariaDB estas pli bona elekto. Subteno por MySQL 8 estis ĉesigita pro malalta postulo kaj manko de funkcioj kompare kun MariaDB. Grava konsilo: evitu uzi la etikedon "plej nova" en la MariaDB-bildo; restu ĉe stabilaj versioj, kiuj estis plene testitaj.
Koncerne platformojn, la aplikaĵo estas deplojita kie ajn Docker estas havebla: Linukso, macOS kaj Vindozo kun Docker DesktopAldone al FreeBSD, Raspberry Pi, kaj multaj NAS-aparatoj, nubaj opcioj ekzistas per PikaPods aŭ DigitalOcean, kvankam ni ĉi tie koncentriĝos pri lokaj solvoj por privateco kaj kontrolo.
Instalo de Docker paŝon post paŝo
Se vi neniam uzis DockerNe zorgu: deploji per Docker Compose estas simpla. La YAML-dosiero povas esti metita en ajnan dosierujon, kiun vi preferas; unue, kreu dosierujon por PhotoPrism kaj konservu la dosieron docker-compose.yml en ĝi. La grava afero estas klare difini la volumojn por originaloj, stokado kaj, se dezirite, importado.
Jen estas la tri tipaj aranĝoj: originaloj (nurlegeblaj aŭ legeblaj/skribeblaj), stokado (kaŝmemoro, datumbazo kaj kromĉaroj) kaj importado (Nedeviga). Vi povas direkti originalojn al la dosierujo, kie vi jam havas viajn fotojn. Mia rekomendo: tenu la stokadon aparte de viaj fotoj, por ke vi ne miksu la datumbazon kaj kaŝmemoron kun viaj originaloj.
Baza ekzemplo de docker-compose kun MariaDB kaj PhotoPrism (vi povas adapti ĝin al via ĉirkaŭaĵo):
version: '3.5'
services:
mariadb:
image: 'mariadb:11'
restart: unless-stopped
security_opt:
- 'seccomp:unconfined'
- 'apparmor:unconfined'
command: >-
--innodb-buffer-pool-size=512M
--transaction-isolation=READ-COMMITTED
--character-set-server=utf8mb4
--collation-server=utf8mb4_unicode_ci
--max-connections=512
--innodb-rollback-on-timeout=OFF
--innodb-lock-wait-timeout=120
environment:
MARIADB_AUTO_UPGRADE: '1'
MARIADB_INITDB_SKIP_TZINFO: '1'
MARIADB_DATABASE: 'photoprism'
MARIADB_USER: 'photoprism'
MARIADB_PASSWORD: 'cambia-esto'
MARIADB_ROOT_PASSWORD: 'cambia-esto'
volumes:
- './database:/var/lib/mysql'
photoprism:
image: 'photoprism/photoprism:latest'
depends_on:
- mariadb
stop_grace_period: 10s
security_opt:
- 'seccomp:unconfined'
- 'apparmor:unconfined'
ports:
- '2342:2342'
environment:
PHOTOPRISM_ADMIN_USER: 'admin'
PHOTOPRISM_ADMIN_PASSWORD: 'cambia-esto'
PHOTOPRISM_AUTH_MODE: 'password'
PHOTOPRISM_SITE_URL: 'http://localhost:2342/'
PHOTOPRISM_DEFAULT_TLS: 'true'
PHOTOPRISM_DATABASE_DRIVER: 'mysql'
PHOTOPRISM_DATABASE_SERVER: 'mariadb:3306'
PHOTOPRISM_DATABASE_NAME: 'photoprism'
PHOTOPRISM_DATABASE_USER: 'photoprism'
PHOTOPRISM_DATABASE_PASSWORD: 'cambia-esto'
PHOTOPRISM_ORIGINALS_LIMIT: 5000
PHOTOPRISM_JPEG_QUALITY: 85
PHOTOPRISM_DISABLE_WEBDAV: 'false'
PHOTOPRISM_DISABLE_TENSORFLOW: 'false'
PHOTOPRISM_DETECT_NSFW: 'false'
PHOTOPRISM_SIDECAR_JSON: 'true'
PHOTOPRISM_SIDECAR_YAML: 'true'
working_dir: '/photoprism'
volumes:
- '~/Pictures:/photoprism/originals'
- './storage:/photoprism/storage'
- './import:/photoprism/import'
Kun la dosiero preta, malfermu terminalon en tiu dosierujo kaj lanĉu: docker komponi -dLa unua inicialigo elŝutas bildojn kaj kreas la datumbazon; donu al ĝi kelkajn minutojn. Poste, ĝi komencas indeksi per docker verkas ekzekutivon fotoprismo fotoprismo indeksoĜisdatiĝos estonte: docker verkas tiranta fotoprismon, docker verkas haltigi fotoprismon y docker komponu -d –no-deps fotoprismo.
Defaŭltaj akreditaĵoj: administranta uzantnomo kaj la pasvorto, kiun vi difinas en ĉirkaŭaj variabloj. Memoru ŝanĝi malfortajn pasvortojn tuj kiam vi ensalutas por la unua fojo. Se vi importos multan materialon, valoras malŝalti ML-funkciojn dum la komenca indeksado kaj poste ebligi ilin.
Sekura aliro, lokaj domajnoj, kaj inversa prokurilo
Se vi intencas malkaŝi la servon ekster via reto, Ĉiam metu ĝin post HTTPS per inversa prokurilo kiel Traefik aŭ Caddy. Sen TLS, ĉio vojaĝas en simpla teksto kaj povus esti kaptita. Konservi privatecon estas parto de la plano: uzu validajn atestilojn kaj redirektu HTTP al HTTPS.
Por aliri loke per domajno kiel photoprism.localhost sen pordo, vi havas du eblojn: mapi norman havenon sur la gastiganto (ekzemple, 80:2342, nur por loka uzo) aŭ agordu Traefik por aŭskulti sur 80 kaj direkti al la servo sur 2342. Certigu, ke la konteneretikedoj inkluzivas la enkursigilon, enirejon kaj internan servan pordon. Tipa ŝablono kun Traefik estus difini la Gastigantan regulon, la retan enirejon kaj direkti la servan pordon al 2342.
Alia ŝlosila punkto estas la fajromuro: permesas alvenantajn konektojn al la pordoj, kiujn vi uzas (reto kaj https) kaj eliraj al la geokoda API kaj Docker kiam necese. Se vi blokas tiujn elirajn konektojn, la mapoj kaj lokoj ne funkcios ĝuste.
Organizo, AI, kaj funkcioj kiuj faras diferencon
PhotoPrism funkcias kun potenca katalogo kaj kromĉaroj; Vi povas skribi metadatenojn en JSON kaj YAML Kune kun viaj originaloj, por ke ĝi ne dependas nur de la datumbazo. Klasifiko per TensorFlow (vizaĝoj, objektoj, scenoj kaj NSFW) rapidigas serĉojn, kaj decidi ĉu marki sentemajn fotojn kiel privatajn estas tiel facile kiel ebligi agordon.
Por konservi rendimenton, vi povas ĝustigi la kvaliton kaj grandecon de bildetoj, videokodekojn, pecrapidecajn limojn kaj reskalon. FFmpeg estas agordita per variabloj Kaj, se via aparataro subtenas ĝin, vi povas delegi al Intel QSV, Nvidia, Apple, aŭ VAAPI por akcelita transkodado. Per nur kelkaj klakoj, vi povas ŝanĝi de baza laborfluo al unu adaptita al via sistemo.
Navigado estas lerta: templinio, albumoj, etikedoj, ŝatataj kaj lokoj. La panelo de altnivela serĉo Ĝi permesas al vi filtri laŭ fotilo, datoj, landoj, koloroj aŭ homoj. Se vi venas el kaosaj bibliotekoj, duobligita detekto kaj metadatena normaligo helpas vin sendifekte alporti ordon.
Sur porteblaj aparatoj, ne ekzistas oficiala aplikaĵo, sed vi povas uzi la PWA-on aŭ sinkronigi kun WebDAV per aplikaĵoj kiel PhotoSync. La PWA estas tre praktikaĜi instaliĝas kiel denaska aplikaĵo, ŝparante al vi la bezonon uzi retumilon ĉiufoje. Tamen, la sperto ĉe Android TV aŭ Google TV estas limigita, kiel ĉe plej multaj solvoj en ĉi tiu sektoro; la plej fidinda opcio restas uzi retumilon sur tekokomputilo konektita al la televidilo se vi volas komforte spekti fotojn kun via familio.
Kiu plej profitas de PhotoPrism
Profesiaj fotistoj Kun miloj da RAW-dosieroj, vi trovos potencan aliancanon: indeksadon, serĉadon per lenso aŭ fotilo, detekton de duplikatoj, kaj kromprogramojn por eviti ŝanĝi la originalon. Havi vian kolekton kontrolita, etikedita kaj kunigita ŝparas horojn da laboro meztempe.
para grafikaj dizajnistoj kaj kreintojKolor-koditaj etikedoj kaj objektaj etikedoj helpas vin rapide trovi vidan inspiron. Rigardado laŭ momentoj kaj uzado de templinio helpas vin retrovi ideojn kaj materialojn sen perdi la spuron.
En la sektoro de nemoveblaĵoj, dom-makleristoj Ili povas kategoriigi ecojn laŭ loko, dato aŭ etikedoj, kaj dividi albumojn kun protektitaj ligiloj, kiuj eksvalidiĝas. Privateco estas ŝlosila ĉi tie, kaj havi kontrolon de la servilo estas avantaĝo.
Ciferecaj merkatigaj teamoj Ili ŝatas organizitan bibliotekon de aktivaĵoj, kun filtriloj por kampanjoj, datoj kaj landoj. Pluruzanta subteno kaj la uzo de kromprogramoj faciligas eviti difekton de la originaloj kaj dividi internajn kolektojn sen malkaŝi ilin ekstere.
para vojaĝantoj, ciferecaj arkivistoj kaj programistojLa avantaĝoj varias de interagaj mapoj ĝis la kapablo integri la galerion kun aliaj servoj per WebDAV. Se konformeco ankaŭ estas zorgo, konservi la datumojn sur via propra infrastrukturo helpas vin kun GDPR kaj internaj politikoj.
Popularaj alternativoj kaj kiel ili taŭgas
Immich forte batasĜi tre memorigas pri Google Fotoj, kun senjunta templinio, ŝlosil-bazitaj ŝatataĵoj, poŝtelefona sinkronigado kaj semantika serĉado laŭ konceptoj aŭ koloroj. Importi el Google Takeout estas nekredeble facile per iloj kiel Immich-Go. Malavantaĝe, la aplikaĵo Android TV estas limigita; por televidaj kunsidoj, tekokomputila retumilo estas preferinda.
En la kampo de produktivecaj programaroj, Nextcloud Fotoj kaj la kromprogramo Memoroj Ili ofertas solidan opcion se vi jam uzas Nextcloud. La aplikaĵo Recognise provizas vizaĝrekonon, kaj Imaginary kaj Preview Generator rapidigas antaŭrigardojn. La interfaco estas funkcia, kvankam rapidaj agoj kiel marki ŝatatojn ne estas tiel tujaj kiel en aliaj opcioj.
Fotostrukturo Ĝi proponas malsaman aliron, kun ĉefekrano kiu montras hazardan elekton de fotoj por helpi vin retrovi vian arkivon. Ĝi estas rapida kaj freŝa, sed ĝia Plus-reĝimo malŝlosas funkciojn kiel ŝatatajn kaj vizaĝrekonon, kiuj eble fortimigos tiujn, kiuj serĉas ĉion senpagan kaj lokan.
Piwigo, Photoview, Lychee aŭ Photonix Ili kovras diversajn scenarojn: simplajn galeriojn, bazan rekonon, aŭ organizadon laŭ etikedoj. Se via prioritato estas la templinio kaj rapidaj mallongigoj, ili eble ne sufiĉos. LibrePhotos aspektas tre promesplena surpapere, sed ĝia efektivigo povas esti pli mana kaj ĝi ne ĉiam funkcias glate sur modestaj komputiloj.
supren Plex lanĉis Plex Photos Nuntempe en beta-versio por iOS, Android kaj TTT, Plex estas interesa eblo se vi jam estas Plex-uzanto, kvankam al ĝi nuntempe mankas polurita denaska Android TV-aplikaĵo. Ente, aliflanke, malfermitkodan kodon kaj fanfaronas pri fin-al-fina ĉifrado; ĝi aspektas tre promesplena, eĉ kun komputilaj klientoj, kvankam ĝia mem-gastigado postulas iom da teknika scio.
Oftaj Demandoj por Komencantoj de Docker
Kie mi metu la YAML-dosieron?En iu ajn dosierujo, kiun vi ŝatas. La grava afero estas ruli la Docker Compose-komandojn el tiu dosierujo, por ke ĝi legu la ĝustan YAML-dosieron. Konservu docker-compose.yml kaj subdosierujojn kiel storage, database, kaj import kune, por ke vi havu ĉion facile haveblan.
Ĉu mi muntu mian nunan fotodosierujon? Jes, mapu vian fotodosierujon al /photoprism/originals. Se vi preferas ne doni skribpermesojn, vi povas munti ĝin nurlegebla, sed vi perdos la kapablojn redakti metadatenojn surloke; PhotoPrism ankaŭ evitas tuŝi la originalajn dosierojn per kromĉaroj.
Kien iras la datumbazo kaj la kaŝmemoro? Estas plej bone konservi ilin ekster via fotodosierujo, en aparta pado, kiun vi mapas al /photoprism/storage (kaj, se vi uzas MariaDB, al ./database en la DBMS-ujo). Tiel vi ne miksas kaŝmemorojn kaj datumbazojn kun viaj originalaj dosieroj.
Kiel munti dosierujon en DockerEn la ŝlosilo de volumoj, uzu la formaton gastiga_pado:ujo_pado. Ekzemple, ~/Bildoj:/fotoprismo/originaloj. Kontrolu la permesojn de la uzanto, kiu funkciigas la ujon; se necese, uzu la variablojn PHOTOPRISM_UID kaj PHOTOPRISM_GID aŭ la uzanddirektivon por akordigi permesojn.
Ĉu ni bezonas Traefik aŭ Caddy? Faru tion nur se vi volas aŭtomatan TLS, purajn domajnojn kaj padojn, aŭ se vi eksponas la servon al la interreto. Loke, mapi pordon 2342 sufiĉas. Se vi uzas Traefik, difinu la gastiganton, la retan enirejon kaj la internan pordon 2342 por la servo; tiel vi povas aliri ĝin per photoprism.localhost sen aldoni :2342.
Subteno, ĝisdatigoj kaj komunumo

La projekto celas esti la plej privatec-amika opcio Kaj ĝi havas dinamikan vojmapon. Ili celas politikon de nulaj difektoj, kaj tial ne fiksas fiksajn datojn por novaj funkcioj: la ritmo ankaŭ dependas de financado kaj komunuma subteno. Se ĝi taŭgas por vi, fariĝi membro akcelas la disvolviĝon de tio, kio plej interesas vin.
Por solvi iujn ajn dubojn, vi havas Diskutoj ĉe GitHub kaj komunuma babilejoArĝentaj, Oraj kaj Platenaj membroj ankaŭ povas kontakti teknikan subtenon. Antaŭ ol malfermi cimo-raporton, kontrolu la problemsolvajn kontrollistojn; ofte la problemo estas loka agorda problemo kaj povas esti solvita rapide.
En ĝisdatigoj, vi povas aŭtomatigi per Gvatoturo Se vi komfortas pri tio, bone; alie, estas pli bone uzi procezon de "tiri, haltigi, kaj suprenigi" kiam stabila versio estas publikigita. En seriozaj medioj, uzu fiksitajn versiojn kaj evitu uzi la plej novan version, kaj en PhotoPrism kaj en MariaDB, por certigi kontrolitajn ĝisdatigojn.
Se vi zorgas pri mapoj kaj inversa geokodado, PhotoPrism kaj MapTiler Ĉi tiuj servoj ofertas tre altan nivelon de privateco. Ilia uzo estas kovrita de la projekto, kun kaŝmemoro por plibonigi rendimenton kaj malhelpi troeksponiĝon de viaj serĉdemandoj.
Fine, memoru la evidentan sed esencan: Fari sekurkopiojn ne estas laŭvolaSe vi administras familiajn memorojn aŭ klientajn materialojn, la respondeco estas via. Faru sekurkopiojn de via datumbazo, stokado, kaj, plej grave, de viaj originalaj dosieroj en almenaŭ du malsamaj lokoj. Evitu malmultekostajn USB-diskojn aŭ malrapidajn retajn dosierujojn por via datumbazo.
En ĉi tiu etapo, FotoPrismo Li gajnis la postenon Kiel fortika solvo por havi viajn proprajn lokajn Google Fotojn: artefarita inteligenteco por ordigo, SSD-rapido, kromĉaroj por konservi originalojn, kaj polurita PWA. Se vi prioritatigas ĝuon super katalogado, vi eble altiriĝos al alternativoj kiel Immich pro ilia interfaco; se zorgema organizado estas via afero, PhotoPrism brilas. Kiaj ajn viaj bezonoj, kun bona agordo de Docker Compose, sufiĉa interŝanĝa spaco, HTTPS por interreta aliro, kaj sekurkopioj, vi havos solidan sistemon instalitan por la venontaj jaroj.
Pasiigita pri teknologio ekde li estis malgranda. Mi amas esti ĝisdatigita en la sektoro kaj ĉefe komuniki ĝin. Tial mi jam de multaj jaroj dediĉas min al komunikado en teknologiaj kaj videoludaj retejoj. Vi povas trovi min skribante pri Android, Vindozo, MacOS, iOS, Nintendo aŭ ajna alia rilata temo, kiu venas al la menso.