Lychee Docker镜像文档

镜像概述

本镜像为Lychee自托管照片管理应用的Docker化版本，已迁移至Dockerhub仓库lycheeorg/lychee。集成nginx和PHP-FPM，遵循Lychee官方推荐配置，支持多种硬件架构，提供便捷的照片库管理解决方案。

核心功能与特性

• 多架构支持：兼容amd64、aarch64、armv6、armv7架构
• 版本标签：
  • latest：最新稳定版
  • v[NUMBER]：特定稳定版本（如v4.6.0）
  • dev：开发分支（基于稳定master，通常安全可用）
  • testing：测试分支（用于内部功能测试）
• 数据库兼容：内置SQLite支持，可与外部MySQL、MariaDB、PostgreSQL数据库配合使用
• 组件集成：包含nginx（默认支持100MB图片上传）和PHP-FPM，配置符合Lychee官方最佳实践

适用场景

适用于需要自托管照片管理系统的个人用户或家庭，可搭建私有照片库，实现照片的存储、分类、检索和分享。

使用方法

快速开始

无需外部依赖即可使用内置SQLite启动：

docker run -p 80 lycheeorg/lychee:dev

容器将随机映射端口，访问对应端口即可使用。

前提条件

使用MySQL/MariaDB/PostgreSQL时，需：

1. 提前创建数据库、用户名及密码
2. 通过环境变量或挂载.env文件（至/conf/.env）配置数据库凭证

使用Docker运行

需连接数据库容器网络，示例命令：

docker run -d \
--name=lychee \
-v /host_path/lychee/conf:/conf \  # 配置文件持久化
-v /host_path/lychee/uploads:/uploads \  # 照片存储持久化
-v /host_path/lychee/sym:/sym \  # 符号链接持久化
-e PUID=1000 \  # 运行用户ID
-e PGID=1000 \  # 运行用户组ID
-e PHP_TZ=America/New_York \  # PHP时区
-e DB_CONNECTION=mysql \  # 数据库类型
-e DB_HOST=mariadb \  # 数据库主机
-e DB_PORT=3306 \  # 数据库端口
-e DB_DATABASE=lychee \  # 数据库名
-e DB_USERNAME=user \  # 数据库用户名
-e DB_PASSWORD=password \  # 数据库密码
-p 90:80 \  # 端口映射（主机:容器）
--net network_name \  # 连接数据库所在网络
--link db_name \  # 链接数据库容器
lycheeorg/lychee

注意：使用MySQL时，需确保启用mysql_native_password认证插件，可通过以下命令配置用户：

alter user 'lychee' identified with mysql_native_password by '<your password>';

使用Docker Compose运行

1. 下载示例docker-compose.yml
2. 修改环境变量（数据库凭证等）
3. 启动容器：

docker-compose up -d

建议：创建db_secrets.env存储数据库凭证，通过env_file指令引用，避免明文暴露：

env_file:
  - db_secrets.env

环境变量及默认值

未指定环境变量或挂载.env时，将使用默认配置（基于.env.example），核心Docker特定变量默认值：

高级配置

PHP配置修改

方法1：挂载自定义php.ini

-v /host_path/custom_php.ini:/etc/php/7.3/fpm/php.ini

此方法将覆盖所有PHP参数，建议仅在需要完全自定义时使用。

方法2：通过nginx.conf修改PHP参数（推荐）

1. 下载默认nginx.conf
2. 找到fastcgi_param PHP_VALUE行，添加需覆盖的参数：

   fastcgi_param PHP_VALUE "upload_max_filesize=200M \n post_max_size=200M";
   

3. 挂载自定义配置：

   -v /host_path/custom_nginx.conf:/etc/nginx/nginx.conf
   

源代码

• Lychee应用源码
• Docker镜像源码