kolex/lychee

Lychee + Docker

!Lychee

什么是Lychee？

Lychee是一款免费的照片管理工具，可运行在您的服务器或网络空间上。安装仅需几秒，能像原生应用一样上传、管理和分享照片，且所有照片均安全存储。

您也可以在https://hub.docker.com/r/kolex/lychee%E6%9F%A5%E7%9C%8B%E6%88%91%E4%BB%AC%E7%9A%84%E9%95%9C%E5%83%8F%EF%BC%81

核心功能

• 基于nginx-alpine镜像构建，体积轻量
• 使用https://github.com/LycheeOrg/Lychee%E7%9A%84%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC
• 构建过程中验证下载二进制文件的校验和，提升安全性
• 不以root用户运行（使用内置的"nginx"用户）
• 不使用其他镜像常用的chmod 777操作，减少安全风险

安全性说明

关于安全性的详细信息，请查看https://github.com/konstantingoretzki/lychee-docker/blob/master/SECURITY.md%E3%80%82

镜像概述

此镜像包含Lychee的可运行安装，基于nginx:1.17.0-alpine镜像。基础镜像提供安装了nginx的alpine系统，我们添加了php7环境和Lychee的核心文件。镜像设计注重小巧、安全和简洁，若发现可改进之处，欢迎反馈。

使用场景

适用于个人或小型团队在私有服务器上部署照片管理系统，用于存储、分类和分享个人/工作照片，支持持久化数据存储。

配置说明

依赖要求

Lychee需要MySQL/MariaDB数据库，若没有现成数据库，建议使用docker-compose示例（包含MariaDB）快速部署。

Docker Run 示例

docker
docker run -d -it \
  --name lychee \
  --restart unless-stopped \
  -p 80:80 \
  -v /path/to/host/config:/usr/share/nginx/html/data \
  -v /path/to/host/images:/usr/share/nginx/html/uploads \
  kolex/lychee:3.2.16

Docker Compose 示例

以下示例包含MariaDB数据库，便于快速启动Lychee并持久化数据。替换密码变量后保存为docker-compose.yml，执行docker-compose up -d启动：

yml
version: '3'
services:
  lychee:
    image: kolex/lychee:3.2.16
    container_name: lychee
    restart: unless-stopped
    ports:
      - 80:80
    networks:
      - lychee
    volumes:
      - config:/usr/share/nginx/html/data
      - images:/usr/share/nginx/html/uploads

  db:
    image: mariadb
    container_name: lychee_db
    restart: unless-stopped
    networks:
     - lychee
    volumes:
     - db:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: <您的安全密码1>
      MYSQL_DATABASE: lychee
      MYSQL_USER: lychee
      MYSQL_PASSWORD: <您的安全密码2>

networks:
  lychee:

volumes:
  config:
  images:
  db:

首次配置

打开网页界面后，输入数据库凭据（使用上述docker-compose示例时）：

• 数据库主机: db
• 数据库用户名: lychee
• 数据库密码: 您设置的MYSQL_PASSWORD
• 数据库名: lychee

设置管理员凭据后即可使用。
重要提示: 安装成功后建议移除docker-compose.yml中的MYSQL密码行，因密码已持久化存储在卷中，无需保留。