むい

HMW

DIGITAL SPACE

Lychee|个人PHP云相册

Lychee 是一款专为网页空间和服务器设计的轻量级、免费开源的相册管理系统。基于 PHP 和 MySQL/MariaDB 构建,凭借极其易用的界面和流畅体验,让我们可以快捷安全地存储、浏览与分享照片。

第一部分:SSH设定

Step 1:生成SSH密钥对(本地电脑)
Mac / Linux:

# 打开终端执行
ssh-keygen -t ed25519 -C "xserver-lychee"

# 回车
#设置密码短语(例如a)
# 生成两个文件:
# ~/.ssh/id_ed25519      ← 秘密鍵
# ~/.ssh/id_ed25519.pub  ← 公開鍵(Xserver登録用)

# 查看公開鍵内容
cat ~/.ssh/id_ed25519.pub

Step 2:在Xserver注册公開鍵
截图中点击 「+ 公開鍵を登録」

登録方式:手動
ラベル:任意名称(例:my-macbook)
公開鍵:把上面 cat 命令输出的内容完整粘贴进去

格式类似:
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA... xserver-lychee

注册后在「設定状況」列点击 ON

Step 3:SSH连接测试

ssh -i ~/.ssh/id_ed25519 -p 10022 hmw@sv13397.xserver.jp

# 参数说明:
# -i  指定秘密鍵路径
# -p 10022  Xserver的SSH端口固定是10022
# 例:用户名为 hmw   你的用户名
#例:服务器(host名)sv13397.xserver.jp

需要确认是否执行,输入yes
输入刚才设定的密码短语(例如a)
成功后会看到:

[hmw@sv13397 ~]$

Step 4:设置SSH配置
先退出服务器,回到本地终端
在本地执行

# 编辑 ~/.ssh/config 文件
nano ~/.ssh/config

写入:

Host xserver
    HostName sv13398.xserver.jp
    User hmw9118
    Port 10022
    IdentityFile ~/.ssh/id_ed25519

保存:Ctrl+O → 回车 → Ctrl+X 退出
测试简化连接:

ssh xserver

输入密码后,
提示符显示[hmw@sv13397 ~]$ 
说明 ssh xserver 这个简化命令已经生效,SSH配置全部设置完成。
第一部分「SSH设定」到此结束。
 exit 退出。

第二部分:Lychee 部署

SSH连接成功后,执行以下脚本。
准备工作:先在Xserver控制面板建数据库
控制面板 →「MySQL設定」→「MySQL追加」:

データベース名:hmw_lychee
ユーザー名:hmw_ly
パスワード:(建议字母+数字组合)

用 cat 直接在服务器写入(最简单,不需要编辑器)

一键部署脚本
SSH连接后,把以下内容整体复制粘贴执行:

cat > deploy_lychee.sh << 'SCRIPT_END'

#!/bin/bash
# ===================================
# Lychee 一键部署脚本 for Xserver
# 执行前请修改下方变量
# ===================================

# ★ 修改这里 ★
DOMAIN="houmengwei.com"          # 域名
DB_HOST="localhost"
DB_NAME="hmw_lychee"          # 数据库名
DB_USER="hmw_ly"              # 数据库用户名
DB_PASS="********"        # 数据库密码

# ===================================
# 以下不需要修改
# ===================================

WEB_ROOT="/home/hmw9118/${DOMAIN}/public_html"
LYCHEE_DIR="${WEB_ROOT}/photos"

echo "▶ 开始部署 Lychee..."

# 1. 下载最新版 Lychee
cd /tmp
echo "▶ 下载 Lychee..."
wget -q https://github.com/LycheeOrg/Lychee/releases/latest/download/Lychee.zip -O Lychee.zip

# 2. 解压到目标目录
echo "▶ 解压文件..."
mkdir -p ${LYCHEE_DIR}
unzip -q Lychee.zip -d ${LYCHEE_DIR}
rm Lychee.zip

# 3. 设置权限
echo "▶ 设置权限..."
find ${LYCHEE_DIR} -type f -exec chmod 644 {} \;
find ${LYCHEE_DIR} -type d -exec chmod 755 {} \;
chmod -R 775 ${LYCHEE_DIR}/storage
chmod -R 775 ${LYCHEE_DIR}/public/uploads
chmod -R 775 ${LYCHEE_DIR}/bootstrap/cache

# 4. 生成 .env 配置文件
echo "▶ 生成配置文件..."
cat > ${LYCHEE_DIR}/.env << EOF
APP_NAME=MyPhotos
APP_ENV=production
APP_KEY=
APP_DEBUG=false
APP_URL=https://${DOMAIN}/photos

DB_CONNECTION=mysql
DB_HOST=${DB_HOST}
DB_PORT=3306
DB_DATABASE=${DB_NAME}
DB_USERNAME=${DB_USER}
DB_PASSWORD=${DB_PASS}

CACHE_DRIVER=file
SESSION_DRIVER=file
QUEUE_DRIVER=sync

TIMEZONE=Asia/Tokyo
EOF

# 5. 设置PHP版本(Xserver需要指定)
echo "▶ 设置PHP版本..."
cat > ${LYCHEE_DIR}/.htaccess << 'EOF'
AddHandler application/x-httpd-php82 .php
<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteBase /photos/public/
    RewriteRule ^$ app/index.php [L]
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule . /photos/public/index.php [L]
</IfModule>
EOF

echo ""
echo "✅ 文件部署完成!"
echo ""
echo "接下来请用浏览器访问:"
echo "https://${DOMAIN}/photos/public/"
echo ""
echo "按照安装向导填入数据库信息完成安装。"

SCRIPT_END

确认无误后执行:

chmod +x deploy_lychee.sh
./deploy_lychee.sh

第三部分:使用Lychee创建相册

安装完成后的初始设置
① 设置管理员账号

浏览器访问:https://houmengwei.com/photos/public/
首次访问自动进入安装向导
设置用户名 + 密码(管理员账号)

② 整站密码保护

登录后 → 左上角菜单 →「admin」→「Settings」
→ 「Permissions」标签
→ 勾选「Require user to login to access gallery.」

③ 创建相册

左上角「+」→ 「New Album」
→ 输入相册名
→ 点击相册进入
→ 上传照片

④ 设置相册访问权限

相册右上角「↓」键 
→ 「Public」
→ 可以设置访客具体权限,访问密码等

⑤ 生成相册分享链接

相册右上角 → 「Share」

总结流程图

① 生成SSH密钥 → 注册到Xserver → SSH连接成功
        ↓
② 控制面板建数据库
        ↓
③ SSH执行一键脚本 → 浏览器完成安装向导
        ↓
④ Lychee后台设置密码保护
        ↓
⑤ 创建相册 → 生成分享链接 → 发给朋友