- PhotoPrism käyttää tekoälyä järjestääkseen valokuvasi paikallisesti tunnisteiden, paikkojen ja tarkennetun haun avulla.
- Selkeät vaatimukset: 2-ytiminen suoritin, 3 Gt RAM-muistia, SSD-levy tietokantaa ja välimuistia varten sekä runsaasti swap-tilaa.
- Helppo asennus Dockerilla, alkuperäisten liittäminen, tallennus ja halutessasi tuontikansio.
- Tietosuoja ensin: ota käyttöön HTTPS:n takana Traefik/Caddy-protokollan avulla, jos olet alttiina internetille, ja säännöllisillä varmuuskopioilla.

¿Kuinka PhotoPrismiä käytetään yksityisenä tekoälyllä toimivana galleriana paikallisesti? Kuvakirjaston hallintaIlman julkisen pilven käyttöä se ei ole enää unelma: PhotoPrismin avulla voit luoda yksityisen, tekoälyllä toimivan valokuvagallerian omalle tietokoneellesi tai palvelimellesi ja selata vuosien muistoja vaarantamatta yksityisyyttäsi. Tässä on yksityiskohtainen ja käytännöllinen selitys siitä, miten se toimii, mitä tarvitset ja miten se asennetaan paikallisesti Dockerin avulla.
Monille Google Kuvat on erittäin kätevä, mutta vastineeksi tästä mukavuudesta on perusteltuja epäilyksiä datan käytöstä. Jos olet huolissasi yksityisyydestä Tai jos sinun on noudatettava ammatillisissa yhteyksissä GDPR:n kaltaisia määräyksiä, PhotoPrism on tehokas vaihtoehto: automaattinen järjestely, tekoälyllä toimivat tunnisteet, edistynyt haku ja suurille kokoelmille suunniteltu työnkulku – kaikki nykyisen infrastruktuurisi sisällä.
Mikä on PhotoPrism ja miksi sitä käytetään paikallisesti?

PhotoPrism on verkkosovellus Tekoälyllä toimiva valokuvien hallinta (Google TensorFlow'lla luokittelua varten), joka tunnistaa ihmiset, esineet, värit ja kohtaukset ja lisää niihin tunnisteita ja järjestää kirjastosi. Se luotiin itse isännöidyksi ratkaisuksi, jotta voit säilyttää valokuvia ja videoita kotona tai omalla palvelimellasi yksityisyyttä säilyttäen tinkimättä nykyaikaisista ominaisuuksista.
Sen DNA:ssa on useita vihjeitä: yhteensopivuus RAW- ja klassisten formaattien kanssa kuten JPEG tai PNG; älykäs indeksointi kaksoiskappaleiden tunnistuksella; navigointi aikajanan, sijaintien ja tunnisteiden mukaan; sekä hakukone, jonka avulla voit yhdistää suodattimia kameran, värin, päivämäärän, maan mukaan ja jopa merkitä kohteita suosikeiksi. Kaikki toimii omalla koneellasi paikallisten välimuistien avulla ja ilman kolmansien osapuolten analyysejä.
Käyttöliittymä on PWA, joten se asennetaan tietokoneiden ja mobiililaitteiden aloitusnäyttöön. Se toimii erityisen hyvin Chromessa, Chromiumissa, Safarissa, Firefoxissa ja EdgessäHuomaa, että tiettyjen video- ja äänikoodekkien (esim. AAC H.264:ssä) toisto voi vaihdella selaimen mukaan, mikä on normaalia nykyaikaisessa verkossa.
Toinen erottava tekijä on sen integrointi WebDAVin ja ulkoisten palveluiden kanssa: Voit synkronoida mobiililaitteista sovelluksilla, kuten PhotoSyncja näyttää myös gallerian salasanalla suojatuilla linkeillä, jotka vanhenevat. Lisäksi, jos haluat karttoja ja sijaintitietoja, PhotoPrism käyttää käänteistä geokoodauspalvelua ja MapTilerin tuottamia korkean yksityisyyden karttoja; nämä resurssit on suunniteltu minimoimaan altistuminen ja parantamaan välimuistin suorituskykyä. Lisätietoja on tässä oppaassa, jossa kerrotaan, miten Järjestä valokuvasi tekoälyn avulla ilman pilvitallennustilaa: PhotoPrism ja paikalliset vaihtoehdot.
Vaatimukset, laitteisto ja suorituskyky
Sujuvaan paikalliseen käyttöön Suositellaan vähintään kahta suorittimen ydintä, 3 Gt RAM-muistia ja 64-bittistä järjestelmää. Minimimäärän lisäksi on suositeltavaa sovittaa RAM-muistin määrä ydinten määrään ja suurissa kirjastoissa käyttää paikallista SSD-levyä tietokannan ja välimuistien tallentamiseen. Indeksointi on intensiivistä; SSD-levyn ja hyvän swappauksen avulla se paranee huomattavasti.
Jos palvelimellasi on alle 4 Gt swap-muistia tai olet asettanut erittäin tiukat muisti-/swap-rajoitukset, Saatat kokea odottamattomia uudelleenkäynnistyksiä Kun indeksoija tarvitsee lisää resursseja (tämä on yleistä suurten RAW-tiedostojen, 360-panoraamojen tai 4K-videoiden kanssa), ota käyttöön tai lisää sivutustilaa ja ole kärsivällinen: useiden kuvien kohdalla alustava indeksointi voi kestää päiviä.
Tietokannan osalta PhotoPrism tukee SQLite 3:a ja MariaDB 10.5.12:ta ja uudempia versioitaSQLiten käyttöönotto on helppoa, mutta jos etsit suorituskykyä ja skaalautuvuutta, MariaDB on parempi valinta. MySQL 8:n tuki on lopetettu alhaisen kysynnän ja MariaDB:hen verrattuna ominaisuuksien puutteen vuoksi. Tärkeä vinkki: vältä "uusin"-tagin käyttöä MariaDB-levykuvassa; käytä vakaita versioita, jotka on testattu perusteellisesti.
Alustojen osalta sovellus otetaan käyttöön kaikkialla, missä Docker on saatavilla: Linux, macOS ja Windows Docker DesktopillaFreeBSD:n, Raspberry Pin ja monien NAS-laitteiden lisäksi pilvipalveluvaihtoehtoja on saatavilla PikaPodien tai DigitalOceanin kautta, vaikka keskitymme tässä paikallisiin ratkaisuihin yksityisyyden ja hallinnan varmistamiseksi.
Dockerin asennus vaihe vaiheelta
Jos et ole koskaan käyttänyt DockeriaÄlä huoli: käyttöönotto Docker Composen avulla on suoraviivaista. YAML-tiedosto voidaan sijoittaa mihin tahansa haluamaasi kansioon; luo ensin hakemisto PhotoPrismille ja tallenna docker-compose.yml-tiedosto sen sisään. Tärkeintä on määritellä selkeästi alkuperäisten, tallennustilan ja haluttaessa myös tuonnin taltiot.
Nämä ovat kolme tyypillistä asetelmaa: alkuperäiset (vain luku- tai luku/kirjoitus), tallennustila (välimuisti, tietokanta ja sivuautot) ja tuonti (Valinnainen). Voit osoittaa alkuperäiset tiedostot kansioon, jossa sinulla jo on kuvasi. Suositukseni: pidä tallennustila erillään kuvistasi, jotta et sekoita tietokantaa ja välimuistia alkuperäisten tiedostojen kanssa.
Docker-composen perusesimerkki MariaDB:n ja PhotoPrismin avulla (voit mukauttaa sen ympäristöösi):
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 tiedosto on valmis, avaa pääteohjelma kyseisessä kansiossa ja suorita: telakka säveltää -dEnsimmäinen alustus lataa kuvat ja luo tietokannan; anna sille muutama minuutti. Sitten se alkaa indeksoida docker compose exec photoprism photoprism indexPäivitetään tulevaisuudessa: docker-kommentointi, vetäminen, fotoprisma, docker-kommentointi pysäytys fotoprisma y docker compose up -d –no-deps fotoprisma.
Oletusarvoiset tunnistetiedot: järjestelmänvalvojan käyttäjätunnus ja salasana, jotka määrität ympäristömuuttujissa. Muista vaihtaa heikot salasanat heti ensimmäisen sisäänkirjautumisen yhteydessä. Jos aiot tuoda paljon materiaalia, kannattaa poistaa koneoppimistoiminnot käytöstä indeksoinnin alkuvaiheessa ja ottaa ne käyttöön myöhemmin.
Suojattu käyttöoikeus, paikalliset verkkotunnukset ja käänteinen välityspalvelin
Jos aiot paljastaa palvelun verkkosi ulkopuolelle, Laita se aina HTTPS:n jälkeen käänteisellä välityspalvelimella, kuten Traefikilla tai Caddylla. Ilman TLS:ää kaikki liikkuu selkokielisenä tekstinä ja voidaan siepata. Yksityisyyden ylläpitäminen on osa suunnitelmaa: käytä voimassa olevia varmenteita ja ohjaa HTTP uudelleen HTTPS:ään.
Paikalliseen käyttöön verkkotunnuksella, kuten photoprism.localhost, ilman porttia on kaksi vaihtoehtoa: standardiportin kartoittaminen isännässä (esimerkiksi 80:2342, vain paikalliseen käyttöön) tai määritä Traefik kuuntelemaan 80:tä ja reitittämään palveluun portin 2342 kautta. Varmista, että säilön otsikot sisältävät reitittimen, sisääntulopisteen ja sisäisen palveluportin. Tyypillinen toimintatapa Traefikissä olisi määrittää isäntäsääntö, web-sisääntulopiste ja osoittaa palveluportti porttiin 2342.
Toinen tärkeä seikka on palomuuri: sallii saapuvat yhteydet käyttämiisi portteihin (web ja https) ja lähtevät yhteydet geokoodauksen API:in ja Dockeriin tarvittaessa. Jos estät nämä lähtevät yhteydet, kartat ja paikat eivät toimi oikein.
Organisointi, tekoäly ja ominaisuudet, jotka tekevät eron
PhotoPrism toimii tehokkaan luettelon ja sivuvaunujen kanssa; Voit kirjoittaa metatietoja JSON- ja YAML-muodossa Alkuperäisten kuvien rinnalla, joten se ei ole pelkästään tietokannan varassa. TensorFlow'lla luokittelu (kasvot, objektit, kohtaukset ja työpaikalle sopimaton työ) nopeuttaa hakuja, ja arkaluonteisten kuvien merkitsemisestä yksityisiksi päättäminen on yhtä helppoa kuin asetuksen käyttöönotto.
Suorituskyvyn ylläpitämiseksi voit säätää pikkukuvien laatua ja kokoa, videokoodekkeja, bittinopeusrajoituksia ja skaalausta. FFmpeg konfiguroidaan muuttujien avulla Ja jos laitteistosi tukee sitä, voit delegoida Intel QSV:lle, Nvidialle, Applelle tai VAAPI:lle nopeutettua transkoodausta varten. Muutamalla napsautuksella voit siirtyä perustyönkulusta järjestelmällesi räätälöityyn työnkulkuun.
Navigointi on ketterää: aikajana, albumit, tunnisteet, suosikit ja paikat. Tarkennettu haku -paneeli Sen avulla voit suodattaa kameran, päivämäärien, maiden, värien tai ihmisten mukaan. Jos kirjastosi ovat kaoottisia, kaksoiskappaleiden tunnistus ja metadatan normalisointi auttavat sinua järjestämään tekstisi kivuttomasti.
Mobiililaitteille ei ole virallista sovellusta, mutta voit käyttää PWA:ta tai synkronoida WebDAV:n kanssa esimerkiksi PhotoSyncin kaltaisilla sovelluksilla. PWA on erittäin käytännöllinenSe asentuu kuin natiivisovellus, joten sinun ei tarvitse käyttää selainta joka kerta. Android TV:n tai Google TV:n käyttökokemus on kuitenkin rajallinen, kuten useimpien tämän alan ratkaisujen kanssa; luotettavin vaihtoehto on edelleen televisioon kytketyn kannettavan tietokoneen selaimen käyttö, jos haluat katsella valokuvia mukavasti perheesi kanssa.
Kuka hyötyy eniten PhotoPrismistä
ammattivalokuvaajat Tuhansien RAW-tiedostojen joukosta löydät tehokkaan liittolaisen: indeksoinnin, objektiivin tai kameran mukaan hakemisen, kaksoiskappaleiden tunnistuksen ja sivutiedostot alkuperäisen muokkaamisen välttämiseksi. Kokoelman hallinta, taggaus ja yhdistäminen säästää tuntikausia työtä keskipitkällä aikavälillä.
Sillä graafiset suunnittelijat ja luovat tekijätVärikoodatut otsikot ja objektitunnisteet auttavat sinua löytämään visuaalista inspiraatiota nopeasti. Hetkien tarkastelu ja aikajanan käyttö auttavat sinua hakemaan ideoita ja materiaaleja menettämättä kulkuaan.
Kiinteistöalalla kiinteistönvälittäjät He voivat luokitella kiinteistöjä sijainnin, päivämäärän tai tunnisteiden mukaan ja jakaa albumeita, joissa on suojattuja linkkejä, jotka vanhenevat. Yksityisyys on tässä avainasemassa, ja palvelimen hallinta on plussaa.
Digitaalisen markkinoinnin tiimit He arvostavat järjestelmällistä resurssikirjastoa, jossa on suodattimia kampanjoille, päivämäärille ja maille. Usean käyttäjän tuki ja sivuvaunujen käyttö helpottavat alkuperäisten rikkoutumisen välttämistä ja sisäisten kokoelmien jakamista ilman, että ne paljastuvat ulkoisille käyttäjille.
Sillä matkailijat, digitaaliset arkistonhoitajat ja kehittäjätEdut vaihtelevat interaktiivisista kartoista gallerian integrointimahdollisuuteen muihin palveluihin WebDAV:n kautta. Jos vaatimustenmukaisuus on myös huolenaihe, tietojen pitäminen omassa infrastruktuurissasi auttaa sinua GDPR:n ja sisäisten käytäntöjen noudattamisessa.
Suosittuja vaihtoehtoja ja miten ne sopivat
Immich iskee kovaaSe muistuttaa hyvin paljon Google Kuvat -sovellusta saumattomalla aikajanalla, avainpohjaisilla suosikeilla, mobiilisynkronoinnilla ja semanttisella haulla käsitteiden tai värien perusteella. Tuonti Google Takeoutista on uskomattoman helppoa työkaluilla, kuten Immich-Go. Haittapuolena on Android TV -sovelluksen rajoitus; TV-sessioiden katseluun kannettavan tietokoneen selain on parempi.
Tuottavuuspakettien alalla Nextcloud Photos ja Memories-laajennus Ne tarjoavat vankan vaihtoehdon, jos käytät jo Nextcloudia. Recognize-sovellus tarjoaa kasvojentunnistuksen, ja Imaginary ja Preview Generator nopeuttavat esikatseluja. Käyttöliittymä on toimiva, vaikka nopeat toiminnot, kuten suosikkeihin merkitseminen, eivät ole yhtä välittömiä kuin muissa vaihtoehdoissa.
Valokuvarakenne Se tarjoaa erilaisen lähestymistavan, jossa aloitusnäyttö näyttää satunnaisen valikoiman kuvia, jotka auttavat sinua löytämään arkistosi uudelleen. Se on nopea ja raikas, mutta sen Plus-tila avaa ominaisuuksia, kuten suosikit ja kasvojentunnistuksen, jotka saattavat pelottaa pois niitä, jotka etsivät kaikkea ilmaista ja paikallista.
Piwigo, Photoview, Lychee tai Photonix Ne kattavat erilaisia skenaarioita: yksinkertaisia gallerioita, perustunnistusta tai organisointia tunnisteiden avulla. Jos prioriteettisi on aikajana ja nopeat oikotiet, ne eivät välttämättä riitä. LibrePhotos näyttää paperilla erittäin lupaavalta, mutta sen toteutus voi olla manuaalisempi, eikä se aina toimi sujuvasti vaatimattomilla tietokoneilla.
Kunnes Plex on julkaissut Plex Photosin Tällä hetkellä iOS:lle, Androidille ja verkolle beta-vaiheessa oleva Plex on mielenkiintoinen vaihtoehto, jos olet jo Plexin käyttäjä, vaikka siitä puuttuukin viimeistelty natiivi Android TV -sovellus. Ente puolestaan on avoimen lähdekoodin koodin tekijä ja ylpeilee päästä päähän -salauksella; se näyttää erittäin lupaavalta jopa työpöytäohjelmien kanssa, vaikka sen itsenäinen ylläpito vaatiikin jonkin verran teknistä osaamista.
Usein kysytyt kysymykset Docker-aloittelijoille
Minne laitan YAML-tiedoston?Missä tahansa haluamassasi kansiossa. Tärkeintä on suorittaa Docker Compose -komennot kyseisestä hakemistosta, jotta se lukee oikean YAML:n. Pidä docker-compose.yml ja alikansiot, kuten storage, database ja import, yhdessä, jotta kaikki on helposti saatavilla.
Pitäisikö minun liittää nykyinen valokuvakansioni? Kyllä, yhdistä valokuvakansiosi kansioon /photoprism/originals. Jos et halua myöntää kirjoitusoikeuksia, voit liittää sen vain luku -tilassa, mutta menetät metatietojen muokkausominaisuudet paikan päällä. PhotoPrism välttää myös alkuperäisten tiedostojen koskettamisen sivuvaunuilla.
Minne tietokanta ja välimuisti menevät? On parasta tallentaa ne valokuvat-kansion ulkopuolelle erilliseen polkuun, jonka yhdistät hakemistoon /photoprism/storage (ja jos käytät MariaDB:tä, hakemistoon ./database DBMS-säiliössä). Tällä tavoin et sekoita välimuisteja ja tietokantoja alkuperäisten tiedostojesi kanssa.
Kansion liittäminen DockeriinKäytä volumes-avaimessa muotoa host_path:container_path. Esimerkiksi ~/Pictures:/photoprism/originals. Tarkista säilöä suorittavan käyttäjän käyttöoikeudet; käytä tarvittaessa PHOTOPRISM_UID- ja PHOTOPRISM_GID-muuttujia tai käyttäjädirektiiviä käyttöoikeuksien yhdenmukaistamiseen.
Tarvitsemmeko Traefikiä vai Caddyä? Tee tämä vain, jos haluat automaattisen TLS:n, puhtaat verkkotunnukset ja polut tai jos altistat palvelun internetille. Paikallisesti portin 2342 yhdistäminen riittää. Jos käytät Traefikiä, määritä palvelulle isäntä, verkkotunnuksen aloituspiste ja sisäinen portti 2342; tällä tavoin voit käyttää sitä photoprism.localhost-komennolla lisäämättä :2342-osoitetta.
Tuki, päivitykset ja yhteisö

Hankkeen tavoitteena on olla yksityisyyttä suojaavin vaihtoehto Ja sillä on dynaaminen etenemissuunnitelma. He pyrkivät nollavirhepolitiikkaan, eivätkä siksi aseta kiinteitä päivämääriä uusille ominaisuuksille: tahti riippuu myös rahoituksesta ja yhteisön tuesta. Jos se sopii sinulle, jäseneksi liittyminen nopeuttaa sinua eniten kiinnostavien asioiden kehitystä.
Voit ratkaista mahdolliset epäilykset Keskustelut GitHubissa ja yhteisöchatissaHopea-, Kulta- ja Platina-jäsenet voivat myös ottaa yhteyttä tekniseen tukeen. Ennen vikailmoituksen avaamista tarkista vianmäärityslistat; usein ongelma on paikallinen kokoonpano-ongelma ja se voidaan ratkaista nopeasti.
Päivityksissä voit automatisoida seuraavat asiat: Vartiotorni Jos se sopii sinulle, okei; muussa tapauksessa on parempi käyttää pull-, stop- ja up-prosessia, kun vakaa versio julkaistaan. Vaativissa ympäristöissä käytä korjattuja versioita ja vältä uusimman version käyttöä sekä PhotoPrismissä että MariaDB:ssä varmistaaksesi hallitut päivitykset.
Jos olet huolissasi kartoista ja käänteisestä geokoodauksesta, PhotoPrism ja MapTiler Nämä palvelut tarjoavat erittäin korkean yksityisyystason. Projekti kattaa niiden käytön, ja niiden välimuisti parantaa suorituskykyä ja estää kyselyidesi ylikuormituksen.
Lopuksi, muista itsestäänselvyys mutta olennainen: Varmuuskopioiden ottaminen ei ole valinnaistaJos hallinnoit perheen muistoja tai asiakasmateriaaleja, vastuu on sinun. Varmuuskopioi tietokanta, tallennustila ja ennen kaikkea alkuperäiset tiedostosi vähintään kahteen eri paikkaan. Vältä halpoja USB-asemia tai hitaita verkkokansioita tietokannan varmuuskopiointia varten.
Tässä vaiheessa, PhotoPrism Hän on ansainnut aseman Vankkana ratkaisuna omien paikallisten Google Kuvien ylläpitämiseen: tekoäly lajitteluun, SSD-nopeus, sivuvaunut alkuperäisten säilyttämiseen ja viimeistelty PWA. Jos nautinto on luetteloinnin sijasta tärkeämpää, Immich saattaa olla sinulle mieluinen käyttöliittymän ansiosta. Jos huolellinen organisointi on sinun juttusi, PhotoPrism loistaa. Olivatpa tarpeesi mitkä tahansa, hyvällä Docker Compose -asennuksella, riittävällä swap-tilalla, HTTPS-internetyhteydellä ja varmuuskopioilla sinulla on vankka järjestelmä vuosiksi eteenpäin.
Intohimoinen teknologiaan pienestä pitäen. Rakastan olla ajan tasalla alalla ja ennen kaikkea viestiä siitä. Siksi olen omistautunut viestintään teknologia- ja videopelisivustoilla useiden vuosien ajan. Löydät minut kirjoittamasta Androidista, Windowsista, MacOS:sta, iOS:stä, Nintendosta tai mistä tahansa muista mieleen tulevista aiheista.