Eyeris

概述

Self-hosted photo manager for NAS and local libraries. Eyeris scans your photos, generates thumbnails, and gives you a fast searchable gallery — all on your own hardware. AI-powered image descriptions and tagging are offloaded to a connected A-Eye instance; Eyeris imports the results automatically. No cloud, no subscriptions, no local LLM required. Features include: A-Eye integration for AI descriptions and tags, EXIF and GPS metadata, duplicate and blurry photo detection, album organisation, SearXNG web image search, and a real-time dashboard.

要求

Optional but recommended: a running A-Eye instance for AI image descriptions and tagging. Optional: MariaDB for large libraries (SQLite used by default).

运行时参数

网络用户界面: http://[IP]:[PORT:8000]/
网络: bridge
外壳: bash
特权: false

模板配置

Web UI PortPorttcp

Port for the Eyeris web interface and API.

目标: 8000
默认值: 8000
价值: 8000

Photo DirectoryPathrw

Your photo library — local folder or SMB/NFS mount point.

目标: /data/images
默认值: /mnt/user/Pictures/
价值: /mnt/user/Pictures/

ThumbnailsPathrw

Where Eyeris stores generated thumbnails and face crop cache.

目标: /data/thumbnails
默认值: /mnt/user/appdata/eyeris/thumbnails/
价值: /mnt/user/appdata/eyeris/thumbnails/

DatabasePathrw

SQLite database storage. Ignored if DB_HOST is set.

目标: /data/db
默认值: /mnt/user/appdata/eyeris/db/
价值: /mnt/user/appdata/eyeris/db/

Config file (.env)Pathrw

Persistent config file — Eyeris reads and writes settings here. Create an empty file at this path before first run.

目标: /app/.env
默认值: /mnt/user/appdata/eyeris/eyeris.env
价值: /mnt/user/appdata/eyeris/eyeris.env

NAS HostVariable

IP or hostname of your NAS. Leave empty if photos are already accessible via the Photo Directory path above.

目标: SMB_HOST

NAS UsernameVariable

SMB/CIFS username for your NAS.

目标: SMB_USERNAME

NAS PasswordVariable

SMB/CIFS password for your NAS.

目标: SMB_PASSWORD

NAS SharesVariable

Comma-separated share names to scan, e.g. photos,media,camera-uploads

目标: SMB_SHARES

A-Eye URLVariable

URL of your A-Eye instance, e.g. http://192.168.1.100:7171. Connect A-Eye to enable AI image descriptions and automatic tagging.

目标: AEYE_URL

A-Eye UsernameVariable

Username for HTTP Basic Auth on your A-Eye instance. Leave empty if A-Eye is unauthenticated.

目标: AEYE_USER

A-Eye PasswordVariable

Password for HTTP Basic Auth on your A-Eye instance.

目标: AEYE_PASS

SearXNG URLVariable

URL of a SearXNG instance for the web image search feature (optional).

目标: SEARXNG_URL

Scan WorkersVariable

Number of parallel scan workers. Raise to 3-4 on fast systems; lower if your system struggles.

目标: SCAN_CONCURRENCY
默认值: 2
价值: 2

Scan Interval (minutes)Variable

How often Eyeris rescans for new photos.

目标: SCAN_INTERVAL_MINUTES
默认值: 60
价值: 60

Scan Schedule EnabledVariable

Set to true to restrict scanning to a time window (e.g. overnight only).

目标: SCAN_SCHEDULE_ENABLED
默认值: false
价值: false

Scan Schedule StartVariable

Start of the allowed scan window (24-hour HH:MM). Only used when SCAN_SCHEDULE_ENABLED=true.

目标: SCAN_SCHEDULE_START
默认值: 22:00
价值: 22:00

Scan Schedule EndVariable

End of the allowed scan window (24-hour HH:MM). An end time before the start time crosses midnight.

目标: SCAN_SCHEDULE_END
默认值: 06:00
价值: 06:00

MariaDB HostVariable

MariaDB host IP or hostname. Leave empty to use the built-in SQLite database (recommended for most users).

目标: DB_HOST

MariaDB PortVariable

MariaDB port.

目标: DB_PORT
默认值: 3306
价值: 3306

MariaDB UserVariable

MariaDB username.

目标: DB_USER
默认值: root
价值: root

MariaDB PasswordVariable

MariaDB password.

目标: DB_PASSWORD

MariaDB DatabaseVariable

MariaDB database name.

目标: DB_NAME
默认值: image_catalog
价值: image_catalog

类别

AI Productivity Media App > Photos

链接

模板支持登记处 Pro连接

详细信息

存储库

ghcr.io/vonhex/eyeris:latest

登记处

https://github.com/vonhex/Eyeris/pkgs/container/eyeris

最后更新2026-06-01

初见2026-05-04

在Unraid 上运行 Eyeris 。

Eyeris 已被列入Unraid OS 的社区应用程序。探索Unraid ，构建灵活的家庭服务器、NAS 或家庭实验室。

探索Unraid OS