开源照片浏览工具Ralbum

发表于 2024-12-18 更新于 2025-10-28 分类于各种折腾 Waline：阅读次数：本文字数： 2.2k 阅读时长 ≈ 2 分钟

Ralbum 是一个开源的照片浏览工具，旨在生成和展示文件系统中的图像列表。

什么是 Ralbum ？

Ralbum 是一个开源的照片浏览工具，旨在生成和展示文件系统中的图像列表。为个人或小型团队的使用，提供了一种方便的方式来管理和展示图片。

主要功能：

图像浏览：用户可以查看原始图像或调整大小后的版本，适合在慢速连接下使用。
轻量级界面：支持灯箱效果浏览，用户可以通过按钮、手势或键盘轻松导航。
搜索功能：允许用户通过搜索框查找图像，支持多关键词搜索。
地图显示：可以展示带有地理位置信息的图像，利用 EXIF 数据显示在地图上。
安装灵活：支持通过 Docker 或直接在服务器上安装，使用 Docker 是最简单的方式。

【注意】：如果群晖内核版本太低，会遇到下面的错误，这个 AH00141 已经遇到多次了，老苏除了换机器，也没找到其他的办法；

1	Function not implemented: AH00141: Could not initialize random number generator

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 ralbum ，选择第一个 ralbum/ralbum，版本选择 latest。

本文写作时，只有一个 latest 版本

容器名称

容器名称建议用 ralbum，因为后面还会用到

卷

在 docker 文件夹中，创建一个新文件夹 ralbum，并在其中建三个子文件夹 cache 、data、photo

其中 cache 和 data 目录，需要有 everyone 的读写权限

否则在打开页面时，是会报错的

1	Fatal error: Uncaught Exception: Cannot write to cache directory

文件夹	装载路径	说明
`docker/ralbum/cache`	`/var/www/html/cache`	缓存目录
`docker/ralbum/data`	`/var/www/html/data`	索引目录
`docker/ralbum/photo`	`/var/data`	存放照片文件

端口

本地端口不冲突就行，不确定的话可以用命令查一下

1 2	# 查看端口占用 netstat -tunlp \| grep 端口号

本地端口	容器端口
`3247`	`80`

命令行安装

如果你熟悉命令行，可能用 docker cli 更快捷

# 新建文件夹 ralbum 和 子目录
mkdir -p /volume1/docker/ralbum/{cache,data,photo}

# 进入 ralbum 目录
cd /volume1/docker/ralbum

# 修改目录权限
chmod a+rw {cache,data}

# 运行容器
docker run -d \
   --restart unless-stopped \
   --name ralbum \
   -p 3247:80 \
   -v $(pwd)/photo:/var/data \
   -v $(pwd)/cache:/var/www/html/cache \
   -v $(pwd)/data:/var/www/html/data \
   ralbum/ralbum

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

version: '3'

services:
  ralbum:
    image: ralbum/ralbum
    container_name: ralbum
    restart: unless-stopped
    ports:
      - "3247:80"
    volumes:
      - ./photo:/var/data
      - ./cache:/var/www/html/cache
      - ./data:/var/www/html/data

然后执行下面的命令

# 新建文件夹 ralbum 和 子目录
mkdir -p /volume1/docker/ralbum/{cache,data,photo}

# 进入 ralbum 目录
cd /volume1/docker/ralbum

# 修改目录权限
chmod a+rw {cache,data}

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d