荔枝相册完整使用指南：Docker部署与私有化照片管理实战

荔枝（Lychee）是一款开源且免费的照片管理工具，设计用于在您自己的服务器或网络存储空间上独立运行。它提供了媲美本地应用程序的完整体验，支持照片的上传、组织管理与共享。该工具集成了您所需的核心功能，并确保所有照片数据均安全地存储于您掌控的环境中。

您可以通过在线演示环境预先体验其功能： https://lychee-demo.fly.dev

部署安装：通过Docker Compose快速搭建

最便捷的部署方式是使用 Docker Compose。以下是一个完整的配置示例，您可以根据自己的网络环境调整参数。

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应用最终被访问的完整URL地址，请根据您的实际网络情况修改。
• DB_CONNECTION：指定数据库类型，例如mysql。
• DB_HOST：数据库服务的主机地址，在Compose网络中通常使用服务名。
• DB_PORT：数据库服务的连接端口。
• DB_DATABASE：指定要连接的数据库名称。
• DB_USERNAME：拥有上述数据库访问权限的用户名。
• DB_PASSWORD：对应用户的数据库访问密码。 :::

使用指南：从初始化配置到日常操作

完成部署后，在浏览器地址栏输入 http://您的服务器IP:8080 即可访问Lychee的Web界面。

初始配置向导

首次访问将进入安装向导。点击“下一步”开始。

系统会进行环境检测，所有检查项应显示为绿色通过状态，然后继续点击“下一步”。

确认数据库连接信息无误后，再次点击“下一步”。

点击“安装”按钮执行初始化。此过程可能需要等待片刻，系统会自动创建所需的数据表。

提示： 如果一切顺利，页面会提示安装成功。您也可以手动登录数据库验证表是否创建。

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

验证无误后，点击按钮进入管理员账号设置环节。

根据页面要求，填写用户名、邮箱和密码等管理员账户信息。

设置完成后，系统将自动跳转到登录页面。

基础功能与操作

输入刚才设置的管理员账号和密码，点击登录进入主界面。

点击左上角菜单图标展开侧边栏，然后进入“设置”页面。

在设置中，您可以将界面语言更改为中文。更改后若未立即生效，刷新网页即可。请注意，当前版本的汉化可能不完全。

返回相册主页面，点击右上角的按钮即可创建一个新相册。

为相册命名并保存。

进入相册后，支持通过拖放或选择文件的方式批量上传照片。

重要提示： 如果上传后图片无法正常显示，很可能是APP_URL环境变量配置有误。您可以检查并修改conf目录下的.env配置文件。

上传的图片会自动进行处理，生成优化后的缩略图，从而确保在浏览时能够快速加载。

在相册封面图下方，功能栏依次提供了幻灯片播放、全屏查看、分享链接以及下载等实用选项。

页面底部允许您在不同风格的瀑布流布局之间进行切换，以适应不同的浏览偏好。

对任意图片单击鼠标右键，会弹出快捷菜单，可以执行设为封面、旋转、下载或删除等操作。

Lychee支持嵌套相册结构，您可以在一个相册内继续创建子相册，以便更精细地分类管理。

单张图片的浏览界面简洁明了，支持左右切换。

下载单张图片时，可以选择下载由系统自动生成的不同尺寸版本，包括原始大小。

您还可以直接下载整个相册，系统会将其打包为ZIP文件，并保持原有的目录结构和文件命名。

设置页面提供了丰富的自定义选项，包括界面、导入、图像处理等。对于大多数用户，默认设置已足够，您也可以根据个人需求进行深度调整。

综合评价与总结

总体而言，荔枝相册的部署过程虽然涉及多个步骤，但通过上述提供的Docker Compose模板可以大幅简化配置工作，降低上手门槛。在功能方面，它提供了相当丰富的照片管理特性，包括多级相册、批量处理、多种视图模式以及完整的分享下载选项，自定义设置空间也很大，例如许多用户期待的自动幻灯片播放功能也已内置。

当然，当前版本也存在一些可优化的空间，例如部分界面元素的汉化尚未完成，用户界面设计也有提升的潜力。尽管许多主流NAS系统已自带相册应用，但像Lychee这样能够通过Docker灵活部署、实现完全私有化管理的开源方案，仍然满足了特定用户群体对数据掌控权和定制化的需求。

简要评分参考：

• 综合推荐指数：⭐⭐⭐（对于缺乏相册工具或追求私有化部署的用户，值得尝试）
• 使用体验指数：⭐⭐（受限于部分汉化缺失，初始设置有一定学习成本）
• 部署难易指数：⭐⭐⭐（借助成熟模板，部署过程属于中等难度）