Memory-不负时光摄影相册程序

作者 : noise 发布时间： 2025-08-10

简介

一个瀑布流摄影图库，也是专为摄影师做的独立网络相册程序，它是基于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运行

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

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

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 运行命令

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请修改为

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

# 是否启用代理
VITE_USE_PROXY = true

# base api
VITE_BASE_API = '/api/v1'

web/.env.development请修改为

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

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

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

然后运行

docker-compose up -d

🚀 一键部署

本地快速部署

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

云平台部署

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

📖 完整部署指南

支持的平台：

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

双平台构建发布

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

Podman（替代Docker）

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

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小时内缓存
  • 添加载入动画及提示弹窗
  • 增加本地上传和备份功能
  • 增加压缩转换图片的功能选项

预览

后台页

视频上传自动识别

点击图片查看

视频播放

🔨 构建说明

桌面应用构建

本项目支持构建为桌面应用程序，基于 Tauri 框架开发。

环境要求

通用要求：

  • Node.js 16+
  • npm 或 yarn
  • Rust 1.70+

Windows 构建要求：

  • Windows 10/11
  • Microsoft C++ Build Tools 或 Visual Studio 2019/2022
  • Windows SDK

macOS 构建要求：

  • macOS 10.15+
  • Xcode Command Line Tools

Linux 构建要求：

  • Ubuntu 18.04+ / Debian 10+ / Fedora 32+ 等
  • 系统开发工具包

构建步骤

  1. 安装依赖 
    # 进入前端目录
cd web

# 安装 Node.js 依赖
npm install

# 安装 Tauri CLI
npm install -g @tauri-apps/cli
  2. 开发模式运行 
    # 启动开发服务器
npm run tauri dev
  3. 生产构建 
    # 构建桌面应用
npm run tauri build

Windows 平台构建

环境配置：

  1. 安装 Rust 
    # 下载并安装 Rust
# 访问 https://rustup.rs/ 下载安装程序
# 或使用 winget
winget install Rustlang.Rustup
  2. 安装 Microsoft C++ Build Tools 
    # 使用 winget 安装
winget install Microsoft.VisualStudio.2022.BuildTools

# 或下载 Visual Studio Installer
# 选择 "C++ build tools" 工作负载
  3. 安装 Windows SDK 
    # 通过 Visual Studio Installer 安装
# 或使用 winget
winget install Microsoft.WindowsSDK

构建命令：

# 进入项目目录
cd web

# 安装依赖
npm install

# 构建 Windows 应用
npm run tauri build

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

输出文件位置：

  • 可执行文件：web/src-tauri/target/release/memory-app.exe
  • 安装包：web/src-tauri/target/release/bundle/msi/Memory-不负时光相册程序_1.0.0_x64_en-US.msi
  • 便携版：web/src-tauri/target/release/bundle/nsis/Memory-不负时光相册程序_1.0.0_x64-setup.exe

macOS 平台构建

# 进入项目目录
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

输出文件位置：

  • 应用包：web/src-tauri/target/release/bundle/macos/Memory-不负时光相册程序.app
  • DMG 安装包：web/src-tauri/target/release/bundle/dmg/Memory-不负时光相册程序_1.0.0_aarch64.dmg

Linux 平台构建

# 安装系统依赖（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

输出文件位置：

  • 可执行文件：web/src-tauri/target/release/memory-app
  • AppImage：web/src-tauri/target/release/bundle/appimage/memory-app_1.0.0_amd64.AppImage
  • DEB 包：web/src-tauri/target/release/bundle/deb/memory-app_1.0.0_amd64.deb

跨平台构建

如需在一个平台上构建多个平台的应用，可以使用 GitHub Actions 或其他 CI/CD 服务。

🚀 GitHub Actions 自动构建

本项目已配置 GitHub Actions 工作流，支持自动构建多平台桌面应用：

工作流文件：

  • .github/workflows/build-windows.yml – 专门构建 Windows 平台
  • .github/workflows/build-multiplatform.yml – 构建所有平台（Windows、macOS、Linux）

触发方式：

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

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

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

构建产物：

  • Windows: MSI 安装包、NSIS 便携版、可执行文件
  • macOS: DMG 安装包、.app 应用包（Universal Binary）
  • Linux: AppImage、DEB 包、可执行文件

配置要求：

在 GitHub 仓库设置中添加以下 Secrets（可选）：

  • TAURI_PRIVATE_KEY: Tauri 应用签名私钥
  • TAURI_KEY_PASSWORD: 私钥密码

使用方法：

  1. Fork 本仓库到你的 GitHub 账户
  2. 推送代码或创建标签
  3. 在 Actions 页面查看构建进度
  4. 从 Artifacts 或 Releases 下载构建产物

详细说明请查看：GitHub Actions 构建指南

手动构建示例：

# .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

构建配置

构建配置文件位于 web/src-tauri/tauri.conf.json，可以自定义：

  • 应用名称和版本
  • 图标和资源
  • 窗口设置
  • 构建目标
  • 安装包类型

故障排除

常见问题：

  1. Rust 编译错误 
    # 更新 Rust 工具链
rustup update

# 清理构建缓存
cd web/src-tauri
cargo clean
  2. Windows 构建失败
    • 确保安装了正确版本的 Visual Studio Build Tools
    • 检查 Windows SDK 是否正确安装
    • 尝试以管理员身份运行命令
  3. 依赖安装失败 
    # 清理 npm 缓存
npm cache clean --force

# 删除 node_modules 重新安装
rm -rf node_modules package-lock.json
npm install

其它

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

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

桌面版运行报错

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

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

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

打赏微海报分享
来自NOISE资源阁-noisevip.cn
NOISE宝藏阁 » Memory-不负时光摄影相册程序
noise

noise SVIP

分享到：

相关推荐

发表回复

  • 2311本站运营(天)
  • 3255用户总数
  • 1823资源数(个)
  • 3近7天更新(个)
  • 1000资源大小(GB)
立即查看
QQ
1129159201
微信
微信
我会尽快回复。
取消