简介

一个瀑布流摄影图库，也是专为摄影师做的独立网络相册程序，它是基于Moment二次开发的，提供前后端分离、docker部署方式，支持云端一键部署，加入了丰富个性化的一些功能，你可以本地使用或上传至oss存储，同样支持添加视频及一键备份等

演示：https://memory.noisework.cn

开源：https://github.com/rcy1314/Memory

桌面端下载：https://github.com/rcy1314/Memory/releases

网盘下载：https://pan.quark.cn/s/6477646cfa30

注意：我只有mac，m1芯片下运行正常，如果如果你运行后首页显示Network eroor的情况属于后端未运行，在最新版本的软件包内实际有后端文件，如果未自动运行，可手动运行解决报错，或者下载源码后执行后端命令，后端：python3 run.py

特征

• 支持 linux/amd64 和 linux/arm64 两个平台
• 支持本地、S3/R2三种oss存储上传方式
• 支持多种数据库的选择连接，支持一键迁移，一键备份本地数据库
• 自适应瀑布流布局，参考pinterest
• 支持首页多张封面大图的自定义设置
• 支持相册合集，首页会有合集中图片数显示
• 支持添加B站、YouTube、直链视频，可自动识别B站、YouTube链接并解析相关视频信息
• 支持后台批量上传不同存储渠道
• 支持上传图片前的压缩和一键转换为webp格式的功能

加载特性

缩略图后缀优化

• 系统支持配置 thumbnail_suffix 参数，会自动在原图URL后添加缩略图后缀
• 如果配置了缩略图后缀，封面会使用 image.image_url + thumbnail_suffix 的优化版本
• 如果没有配置后缀，则直接使用原图URL

响应式尺寸优化

封面图片会根据设备类型和网络状况动态调整参数：

移动端优化：

• 尺寸：180×250像素

• 质量：慢网络30%，正常网络40%

• URL参数： w=180&h=250&fit=crop&auto=compress,format&q=30-40
  平板端优化：

• 尺寸：250×350像素

• 质量：慢网络35%，正常网络45%

• URL参数： w=250&h=350&fit=crop&auto=compress,format&q=35-45
  桌面端优化：

• 尺寸：200×280像素

• 质量：慢网络35%，正常网络45%

• URL参数： w=200&h=280&fit=crop&auto=compress,format&q=35-45

智能加载策略

• 懒加载 ：使用 IntersectionObserver 实现视口内才加载
• 并发控制 ：限制同时加载的图片数量，避免网络拥塞
• 预加载 ：优先加载前4-6张封面图片
• 错误处理 ：加载失败时自动回退到原图
• 格式优化 ：自动转换为WebP等现代格式

性能优化特性

• 硬件加速 ：使用 transform: translateZ(0) 启用GPU加速
• 渐进式加载 ：显示加载动画和进度提示
• 缓存机制 ：避免重复加载相同图片
• 网络检测 ：根据3G/4G/WiFi调整加载策略

前后端运行

前端：web目录下npm run dev

后端：python run.py

docker运行

1
2
3
4
5
6
7
8
9

docker run -d \
  --name memory \
  --platform linux/amd64 \
  -p 4314:9999 \
  --add-host host.docker.internal:host-gateway \
  -e DB_HOST=host.docker.internal \
  -e EXTERNAL_DB_HOST=host.docker.internal \
  -e TZ=Asia/Shanghai \
  noise233/memory:latest

如果你想挂载本地数据库文件，比如：

1
2
3
4
5
6
7
8
9
10

docker run -d \
  --name memory \
  --platform linux/amd64 \
  -p 4314:9999 \
  -v /www/wwwroot/memory.noisework.cn/data:/app/data \
  --add-host host.docker.internal:host-gateway \
  -e DB_HOST=host.docker.internal \
  -e EXTERNAL_DB_HOST=host.docker.internal \
  -e TZ=Asia/Shanghai \
  noise233/memory:latest

连接 Neon 免费数据库的 Docker 运行命令

1
2
3
4
5
6
7

docker run -d \
  --name memory \
  --platform linux/amd64 \
  -p 4314:9999 \
  -e DATABASE_URL="postgresql://username:password@ep-xxx-xxx.us-east-2.aws.neon.tech/dbname?sslmode=require" \
  -e TZ=Asia/Shanghai \
  noise233/memory:latest

docker-compose

由于桌面版和docker后端api有冲突，docker请使用/api/v1，如果你想自己构建docker：

web/.env.productuon请修改为

1
2
3
4
5
6
7
8

# 资源公共路径,需要以 /开头和结尾
VITE_PUBLIC_PATH = '/'

# 是否启用代理
VITE_USE_PROXY = true

# base api
VITE_BASE_API = '/api/v1'

web/.env.development请修改为

1
2
3
4
5
6
7
8
9

# Docker环境下的前端配置
# 资源公共路径,需要以 /开头和结尾
VITE_PUBLIC_PATH = '/'

# 是否启用代理 - Docker环境下不需要代理
VITE_USE_PROXY = false

# base api - Docker环境下使用相对路径
VITE_BASE_API = '/api/v1'

然后运行

1

docker-compose up -d

构建跨平台桌面端时

web/.env.productuon请修改为

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# Tauri桌面端环境配置
# 资源公共路径,需要以 /开头和结尾
VITE_PUBLIC_PATH = '/'

# 桌面端API配置 - 指向本地后端服务
VITE_BASE_API = 'http://127.0.0.1:9999/api/v1'

# 桌面端不使用代理
VITE_USE_PROXY = false

# 是否启用压缩
VITE_USE_COMPRESS = true

# 压缩类型
VITE_COMPRESS_TYPE = gzip

web/.env.development请修改为

1
2
3
4
5
6
7
8
9

# Docker环境下的前端配置
# 资源公共路径,需要以 /开头和结尾
VITE_PUBLIC_PATH = '/'

# 是否启用代理
VITE_USE_PROXY = true

# base api
VITE_BASE_API = 'http://127.0.0.1:9999/api/v1'

🚀 一键部署

本地快速部署

1
2

# 使用一键部署脚本
./deploy.sh

云平台部署

我们支持多种云平台的一键部署，详细说明请查看：

📖 完整部署指南

支持的平台：

• Zeabur - 使用 zeabur.json
• Fly.io - 使用 fly.toml
• Railway - 使用 railway.json
• Render - 使用 render.yaml
• Docker / Docker Compose - 本地部署

双平台构建发布

1

docker buildx build --platform linux/amd64,linux/arm64 -t noise233/memory:latest --push --no-cache .

Podman（替代Docker）

1
2
3
4

podman manifest create noise233/memory:latest
podman build --platform linux/amd64 --manifest noise233/memory:latest .
podman build --platform linux/arm64 --manifest noise233/memory:latest .
podman manifest push noise233/memory:latest

1
2
3
4

podman manifest create noise233/memory:dev
podman build --platform linux/amd64 --manifest noise233/memory:dev .
podman build --platform linux/arm64 --manifest noise233/memory:dev .
podman manifest push noise233/memory:dev

Docker下使用

• 使用<服务器IP地址>:4314或域名访问相册
• 后台管理：<服务器IP地址>:4314/admin/或<域名>/admin
• 默认管理员账号：admin，密码：123456，请登录后及时修改用户名和密码

后台配置使用指南

• 系统设置

  通用设置为后台工作台显示设置

• 网站设置

  支持icon、logo、网站名称、封面自定义设置

• 内容设置

  首页每次加载图片数为每一页加载显示的图片数，支持略缩图的后缀，但不要轻易设置

• 存储设置

  允许上传-选项很重要，打开才支持图片的上传设置（包括批量上传也依赖这个开关）

  本地存储-默认路径为程序内的images文件夹，不要轻易设置url前缀，因为程序自动识别上传链接，如果你有自定义网址，可以当cdn加速前缀使用

  备份相册-检测并打包下载本地上传的所有图片，如果本地上传过多图片速度会慢

  备份数据库-仅限本地存储模式，可一键下载程序的数据库文件

  云端存储-支持cloudflareR2\S3及兼容oss存储，以cloudflarer2为例：
  前往https://cloudflare.com注册，并在账户主页找到“R2对象存储”，点击“创建存储桶”并设置存储桶名称并点击api设置管理密钥，再点击将r2和api配合使用面板记录账户ID

  

  

  点进新创建的存储桶，找到设置并点击可查看具体存储信息

  回到后台页：

  端点（Endpoint）-对应S3 API

  区域-对应位置，只填写英文如APAC

  访问ID-对应帐户ID,在api设置将r2和api配合使用面板中

  访问密钥-API密钥

  存储桶（Bucket）-存储桶名称

  存储路径-默认按年月日路径：{year}/{month}/{timestamp}_{filename}

  URL前缀-对应公共开发 URL或者自定义域名

  URL后缀-非必要不用填写

• Token设置

  是为外部链接相册使用的，是为未来做插件而准备的，目前未完善

• 数据库设置

  你可以选择不同的数据库连接类型，支持本地SQlite、postgreSQL、mysql

  以Neon免费数据库为例进入网站面板，点击Connect to your database，查看链接信息

  比如：postgresql://nedb_owner:n44g_fFkBjTxr6@ep-dark-wid-ae7n-pooler.c-2.us-est-2.aws.n.tech/neondb?sslmode=require&cha_binding=rire
  主机地址-为@后的直到/的地址（ep-dark-wid-ae7n-pooler.c-2.us-est-2.aws.n.tech）

  端口-5432

  数据库名-Database选项下你创建的数据库名

  用户名-Role选项下显示的同时也是//之后:之前的nedb_owne

  密码-为@符合之前的n44g_fFkBjTxr6

  注意：点击测试连接需要最后保存，迁移数据库是增量迁移，如果字段相同不会覆盖，数据过多时花费时间会久

• 内容管理

  如果是本地上传的图片在列表页面点击删除时会一同删除源文件，链接图片则不会

  使用批量上传前请确保已开启“图片上传”选项并选择了本地还是云端存储

更新

• 增加多平台数据库连接及一键迁移

• 增加用户token设置，目前认证方式：JWT token+API token

• 增加批量上传案例脚本
• 优化手机端渲染速度及布局
• 优化首页缓存逻辑，浏览器默认24小时内缓存
• 添加载入动画及提示弹窗
• 增加本地上传和备份功能
• 增加压缩转换图片的功能选项

预览

后台页

视频上传自动识别

点击图片查看

视频播放

🔨 构建说明

1
2
3
4
5
6
7
8
9
10
11

# 进入项目目录
cd web

# 安装依赖
npm install

# 构建 Windows 应用
npm run tauri build

# 构建特定目标（可选）
npm run tauri build -- --target x86_64-pc-windows-msvc

1
2
3
4
5
6
7
8
9
10
11
12

# 进入项目目录
cd web

# 安装依赖
npm install

# 构建 macOS 应用
npm run tauri build

# 构建特定架构（可选）
npm run tauri build -- --target aarch64-apple-darwin  # Apple Silicon
npm run tauri build -- --target x86_64-apple-darwin   # Intel Mac

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# 安装系统依赖（Ubuntu/Debian）
sudo apt update
sudo apt install -y libwebkit2gtk-4.0-dev build-essential curl wget libssl-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev

# 安装系统依赖（Fedora）
sudo dnf install webkit2gtk3-devel openssl-devel curl wget libappindicator-gtk3-devel librsvg2-devel

# 进入项目目录
cd web

# 安装依赖
npm install

# 构建 Linux 应用
npm run tauri build

1
2
3
4
5
6
7
8

# 1. 推送代码自动构建
git push origin main

# 2. 创建标签自动发布
git tag v1.0.0
git push origin v1.0.0

# 3. 手动触发（在 GitHub Actions 页面）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

# .github/workflows/build.yml 示例
name: Build Desktop App

on:
  push:
    tags: ['v*']

jobs:
  build:
    strategy:
      matrix:
        platform: [macos-latest, ubuntu-20.04, windows-latest]
    
    runs-on: ${{ matrix.platform }}
    
    steps:
      - uses: actions/checkout@v4
      
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 18
          
      - name: Install Rust
        uses: dtolnay/rust-toolchain@stable
        
      - name: Install dependencies (Ubuntu)
        if: matrix.platform == 'ubuntu-20.04'
        run: |
          sudo apt update
          sudo apt install -y libwebkit2gtk-4.0-dev build-essential curl wget libssl-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev
          
      - name: Install frontend dependencies
        run: |
          cd web
          npm install
          
      - name: Build Tauri app
        run: |
          cd web
          npm run tauri build

其它

Docker 环境下外部数据库连接配置指南

二次开发时请注意该项目使用v-model:value语法编写

桌面版运行报错

如果你运行后首页显示Network eroor的情况属于后端未运行，在最新版本的软件包内实际有后端文件，如果未自动运行，可手动运行解决报错，或者下载源码后执行后端命令，后端：python3 run.py

仓库根目录中有很多python脚本是我用来测试api的非必要可删除文件

如果云端使用请上传压缩或webp格式图片，避免加载慢