lycheeorg/lychee-laravel

Lychee Docker镜像文档

镜像概述

本镜像为Lychee自托管照片管理应用的Docker化版本，已迁移至Dockerhub仓库https://hub.docker.com/r/lycheeorg/lychee%E3%80%82%E9%9B%86%E6%88%90nginx%E5%92%8CPHP-FPM%EF%BC%8C%E9%81%B5%E5%BE%AALychee%E5%AE%98%E6%96%B9%E6%8E%A8%E8%8D%90%E9%85%8D%E7%BD%AE%EF%BC%8C%E6%94%AF%E6%8C%81%E5%A4%9A%E7%A7%8D%E7%A1%AC%E4%BB%B6%E6%9E%B6%E6%9E%84%EF%BC%8C%E6%8F%90%E4%BE%9B%E4%BE%BF%E6%8D%B7%E7%9A%84%E7%85%A7%E7%89%87%E5%BA%93%E7%AE%A1%E7%90%86%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E3%80%82

核心功能与特性

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

适用场景

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

使用方法

快速开始

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

bash
docker run -p 80 lycheeorg/lychee:dev

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

前提条件

使用MySQL/MariaDB/PostgreSQL时，需：

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

使用Docker运行

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

bash
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认证插件，可通过以下命令配置用户：

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

使用Docker Compose运行

1. 下载https://github.com/LycheeOrg/Lychee-Docker/blob/master/docker-compose.yml
2. 修改环境变量（数据库凭证等）
3. 启动容器：

bash
docker-compose up -d

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

yaml
env_file:
  - db_secrets.env

环境变量及默认值

未指定环境变量或挂载.env时，将使用默认配置（基于https://github.com/LycheeOrg/Lychee/blob/master/.env.example%EF%BC%89%EF%BC%8C%E6%A0%B8%E5%BF%83Docker%E7%89%B9%E5%AE%9A%E5%8F%98%E9%87%8F%E9%BB%98%E8%AE%A4%E5%80%BC%EF%BC%9A

高级配置

PHP配置修改

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

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

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

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

1. 下载https://github.com/LycheeOrg/Lychee-Docker/blob/master/default.conf
2. 找到fastcgi_param PHP_VALUE行，添加需覆盖的参数：

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

3. 挂载自定义配置：

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

源代码

• https://github.com/LycheeOrg/Lychee-Laravel
• https://github.com/LycheeOrg/Lychee-Laravel-Docker