Docker环境下Ralbum部署指南：轻松管理你的照片库

Docker环境下Ralbum部署指南：轻松管理你的照片库

• 1.1 Ralbum 简介

• 1.2 主要特点

• 2.1 本地环境规划

• 2.2 本次实践介绍

• 3.1 检查Docker服务状态

• 3.2 检查Docker版本

• 3.3 检查docker compose 版本

• 5.1 创建部署目录

• 5.2 docker-cli方式部署（可选）

• 5.3 编辑部署文件

• 5.4 创建Ralbum容器

• 5.5 查看Ralbum容器状态

• 6.1 访问Ralbum初始页

• 6.2 上传照片

• 6.3 浏览照片

• 6.4 搜索照片

一、Ralbum介绍

1.1 Ralbum 简介

Ralbum 是一款用于管理和浏览存储在文件系统中的图像和文件的Web应用程序。它通过生成文件夹和图像列表，让用户可以方便地查看和管理他们的图片库。Ralbum 提供了一个轻量级且用户友好的界面，支持多种浏览方式，包括按钮点击、智能手机上的滑动手势以及键盘快捷键导航。该工具确保原始文件的安全性，仅执行读取操作而不进行任何写入动作。

1.2 主要特点

1. 图像浏览

   • 用户可以选择浏览原始图像或查看默认提供的调整大小后的版本，这对于慢速网络连接尤为方便。

   • 通过 settings.json 文件，用户可以控制缩略图的尺寸。

   • 缩略图可以在访问时即时生成，或者使用 cron.php 脚本一次性批量创建，提高加载速度。

2. 搜索功能

   • 如果启用了定时任务（cron），用户可以通过右上角的搜索框快速查找图像。

   • 支持多词搜索以进一步缩小结果范围，帮助用户更精确地找到所需图片。

3. 地理信息展示

   • 内嵌地理信息（EXIF 数据）的图像可以在地图上显示，用户可以通过搜索功能的子菜单找到地图链接，从而直观地浏览带有地理位置标记的照片。

4. 用户体验优化

   • 当主图像文件夹为空时，Ralbum 会自动展示最近添加的图像、历史同日期的图像以及随机选择的图像，为用户提供多样化的浏览体验。

   • 图像以光箱形式呈现，提供沉浸式的观看体验，并支持多种交互方式以适应不同设备和用户的偏好。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为Centos7。

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎； 2.在Docker环境下部署Ralbum应用。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

[root@VM-8-9-centos ~]# systemctl status docker ● docker.service - Docker Application Container Engine Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; vendor preset: disabled) Active: active (running) since Thu 2025-01-09 20:59:40 CST; 4 days ago Main PID: 1424 (dockerd) Tasks: 9 Memory: 1.0G CGroup: /system.slice/docker.service

3.2 检查Docker版本

检查Docker版本

[root@VM-8-9-centos ~]# docker -v Docker version 26.1.3, build b72abbb

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

[root@VM-8-9-centos ~]# docker compose version Docker Compose version v2.27.1

四、下载Ralbum镜像

执行以下命令，拉取以下Ralbum镜像。

[root@VM-8-9-centos ~]# docker pull ralbum/ralbum Using default tag: latest latest: Pulling from ralbum/ralbum 2cc3ae149d28: Pull complete 01c187ab622c: Pull complete 4382a8829fff: Pull complete 43046b340e34: Pull complete 199ce03f09e6: Pull complete 82f77a5a3aed: Pull complete 60517e1132d4: Pull complete 048a128f8a9b: Pull complete 29fca939395b: Pull complete 73e70c64ea4e: Pull complete a39eb8ce7fab: Pull complete 8ba7f5c30795: Pull complete 4cd80e85911a: Pull complete 07589881cfe4: Pull complete b99bc60f0f6d: Pull complete ac9d30138e4b: Pull complete 74e1ee756161: Pull complete 1d2adc0cbd38: Pull complete ae688b5697af: Pull complete 1ed03a8cd15d: Pull complete 90dd6e2ce6c9: Pull complete 049d8c4047f2: Pull complete 57785e0eaca5: Pull complete Digest: sha256:ff6677b8ef15fa9a19bb3b2efc667d497f961b19ed73ed725502058e78ebc4c3 Status: Downloaded newer image for ralbum/ralbum:latest docker.io/ralbum/ralbum:latest

五、部署Ralbum应用

5.1 创建部署目录

• 创建部署目录

mkdir -p /data/ralbum/{cache,data,photo} && cd /data/ralbum

• 目录授权

chmod -R 777 /data/ralbum/

5.2 docker-cli方式部署（可选）

可使用以下docker-cli方式，快速部署Ralbum应用。

docker run -d --restart always --name ralbum -p 6200:80 -v $(pwd)/photo:/var/data -v $(pwd)/cache:/var/www/html/cache -v $(pwd)/data:/var/www/html/data ralbum/ralbum

5.3 编辑部署文件

本次实践使用docker compose方式部署，在部署目录下，创建docker-compose.yaml文件，其中宿主机映射端口等可以自定义配置。

vim docker-compose.yaml

version: '3' services: ralbum: image: ralbum/ralbum container_name: ralbum restart: always ports: - "6200:80" volumes: - /data/ralbum/photo:/var/data - /data/ralbum/cache:/var/www/html/cache - /data/ralbum/data:/var/www/html/data

5.4 创建Ralbum容器

执行以下命令，创建Ralbum容器。

[root@VM-8-9-centos ralbum]# docker compose up -d WARN[0000] /data/ralbum/docker-compose.yaml: `version` is obsolete [+] Running 2/2 ✔ Network ralbum_default Created 0.1s ✔ Container ralbum Started 0.5s

5.5 查看Ralbum容器状态

检查Ralbum容器状态状态，确保Ralbum容器正常启动。

[root@VM-8-9-centos ralbum]# docker compose ps WARN[0000] /data/ralbum/docker-compose.yaml: `version` is obsolete NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS ralbum ralbum/ralbum "docker-php-entrypoi…" ralbum 31 seconds ago Up 29 seconds 0.0.0.0:6200->80/tcp, :::6200->80/tcp

六、访问Ralbum服务

6.1 访问Ralbum初始页

访问地址：http://IP地址:6200，将IP替换为自己服务器IP地址。如果无法访问到以下页面，则检查宿主机的防火墙是否关闭或者放行相关端口，云服务器则还需要设置安全组规则。

6.2 上传照片

在宿主机挂载目录/data/ralbum/photo下，上传本地照片。

[root@VM-8-9-centos photo]# pwd /data/ralbum/photo [root@VM-8-9-centos photo]# ls 中秋图片.jpg 云计算.png

6.3 浏览照片

刷新浏览器，可以看到照片显示了。

在这里插入图片描述

6.4 搜索照片

执行以下命令，启用搜索功能。

docker exec ralbum /var/www/html/ralbum_cron.sh

在搜索栏，搜索图片名称，可以看到可以成功搜索到图片。

七、总结

Ralbum 是一款专为管理和浏览文件系统中的图像和文件而设计的轻量级Web应用程序，它提供了直观的用户界面和支持多种设备的交互方式，确保了便捷高效的图片库管理体验。该工具注重安全性，仅对原始文件执行读取操作，并通过缩略图生成和搜索功能优化了用户的浏览效率。此外，Ralbum 还支持地理信息展示等高级特性，极大地丰富了用户的互动和使用体验。

作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～