Lychee相册完整安装与使用教程：高效管理个人照片库

November 27, 2025

Lychee是一款功能强大的免费照片管理工具，能够在您的服务器或网络空间中轻松部署运行。它支持用户像使用本地应用程序一样便捷地上传、整理和共享照片。该工具集成了所有必需功能，确保您的所有照片数据安全可靠地存储。

在线演示地址：https://lychee-demo.fly.dev

安装步骤

通过Docker Compose快速部署Lychee相册服务。

services:  
lychee:  
    image: lycheeorg/lychee:latest  
    container_name: lychee  
    ports:  
      - 8080:80  
    environment:  
      - PUID=1000  
      - PGID=1000  
      - PHP_TZ=Asia/Shanghai  
      - TIMEZONE=Asia/Shanghai  
      - APP_URL=http://192.168.31.90:8080  
      - DB_CONNECTION=mysql  
      - DB_HOST=lychee_db  
      - DB_PORT=3306  
      - DB_DATABASE=lychee  
      - DB_USERNAME=user  
      - DB_PASSWORD=password  
    volumes:  
      - ./conf:/conf  
      - ./uploads:/uploads  
      - ./sym:/sym  
    restart: unless-stopped  
  
lychee_db:  
    image: mariadb:10  
    container_name: lychee_db  
    environment:  
      - MYSQL_ROOT_PASSWORD=rootpassword  
      - MYSQL_DATABASE=lychee  
      - MYSQL_USER=user  
      - MYSQL_PASSWORD=password  
    volumes:  
      - ./mysql:/var/lib/mysql  
    restart: unless-stopped

参数详细说明（更多配置选项建议查阅官方文档）

:::tips
PUID（环境变量，可选）：用户ID权限设置

PGID（环境变量，可选）：用户组ID权限设置

PHP_TZ（环境变量）：PHP运行时区配置

TIMEZONE（环境变量）：系统时区设置

APP_URL（环境变量）：配置Lychee应用的访问地址，请根据实际环境修改

DB_CONNECTION（环境变量）：指定数据库类型

DB_HOST（环境变量）：数据库服务器地址

DB_PORT（环境变量）：数据库连接端口

DB_DATABASE（环境变量）：指定连接的数据库名称

DB_USERNAME（环境变量）：数据库访问用户名

DB_PASSWORD（环境变量）：数据库访问密码

:::

使用指南

在浏览器中输入 http://NAS的IP:8080 即可访问Lychee相册界面。

初始化设置

点击下一步按钮继续初始化流程。

确保所有检查项均为绿色状态，然后点击下一步。

确认无误后继续点击下一步。

点击安装按钮开始安装过程（可能需要等待片刻，系统会进行相关配置）。

提示：如果安装过程顺利，也可以通过数据库验证表结构是否创建成功。

mysql -u root -p  
show databases;  
use lychee;  
show tables;

确认无误后，点击设置管理员账号选项。

按照要求填写管理员账号的详细信息。

设置完成后系统会自动跳转到登录界面。

基本操作

输入管理员用户名和密码，点击登录按钮进入系统。

点击左上角菜单展开选项，进入设置页面。

将界面语言设置为中文（设置后若未立即生效，可刷新页面，部分内容可能仍未完全翻译）。

返回相册主界面，点击右上角按钮创建新相册。

输入相册的名称信息。

支持批量上传多张照片文件。

提示：如果图片无法正常显示，可能是APP_URL参数配置有误（可前往conf目录修改.env文件进行调整）。

上传的图片会自动进行处理，生成缩略图以提升加载和浏览速度。

封面下方的功能栏依次提供幻灯片播放、全屏查看、分享链接和下载选项。

界面下方允许用户切换不同的瀑布流布局样式。

通过鼠标右键点击图片，可以快速执行相关操作命令。

支持在现有相册内创建子相册结构。

打开图片后可查看详细的浏览效果。

下载图片时可以选择不同尺寸版本（系统会自动生成原图及多种规格）。

能够直接打包下载整个相册数据，保持完整的目录结构和原始图片名称。

设置项非常丰富，通常使用默认配置即可，也可根据个人需求进行个性化调整。

综合评估

整体而言，部署过程略显复杂，但本文已提供配置模板，只需修改参数即可使用，大大简化了配置步骤。功能方面相当丰富，提供了大量可自定义的设置选项，还包括用户询问过的自动播放幻灯片功能。当前版本仍有一些优化空间，例如部分选项汉化不完整，用户界面设计也有提升潜力。尽管国内多数NAS系统内置了相册功能，但这种可部署在Docker环境中的相册工具依然满足了许多用户的需求，有兴趣的用户可以尝试部署使用。

综合推荐指数：⭐⭐⭐（尚无相册系统的用户可以部署试用）

使用体验评分：⭐⭐（汉化不完全，初始设置有一定复杂度）

部署难度评级：⭐⭐⭐（中等水平）