MYGallery - 个人照片墙系统

📷 MYGallery

一个简约、美观、功能完整的个人照片墙系统

---

📸 界面预览

暗色模式 · 瀑布流画廊

默认暗色主题，5 列紧凑瀑布流布局，侧栏 SVG 简笔画图标导航。

亮色模式

一键切换亮色/暗色主题，偏好自动记忆。

灯箱查看器 · EXIF 信息面板

ChronoFrame 风格全屏查看器，右侧信息面板分区展示 EXIF 元数据，底部缩略图条可快速跳转。

灯箱 · GPS 迷你地图

当照片包含 GPS 坐标时，信息面板顶部嵌入 Leaflet 迷你地图，实时显示拍摄位置。

灯箱 · 全屏模式

点击 ℹ 按钮关闭信息面板后，照片自动铺满全屏居中展示。

表态系统

访客可对照片进行 emoji 表态（👍❤️😍😂😮😢🔥✨），无需登录，基于指纹识别。

表态选择器	表态已添加

照片地图

基于 Leaflet + OpenStreetMap 的全屏地图，展示带 GPS 坐标的照片位置，支持聚合标记。

地图标记	标记弹窗

后台管理

ChronoFrame 风格侧栏导航，仪表盘统计，拖拽上传，照片/分类管理。

---

✨ 特性

🎨 前端展示

• 瀑布流布局 — 5/4/3/2 列自适应，4px 紧凑间距
• 暗色模式默认 — ChronoFrame 风格中性配色
• 侧栏图标导航 — SVG 简笔画图标，极简设计
• 灯箱查看器 — 全屏查看 + 右侧信息面板 + 底部缩略图导航
• GPS 迷你地图 — 信息面板嵌入 Leaflet 地图显示拍摄位置
• 表态系统 — 8 种 emoji 表态，指纹识别匿名用户
• 分享链接 — 一键复制照片直链（?photo=ID），支持 Deep Link
• 分类筛选 — 按分类快速筛选，横向滑动支持
• 搜索功能 — 搜索标题、描述、标签、位置
• 亮暗切换 — 一键切换，记忆用户偏好

📱 移动端友好

• 移动端底部栏导航
• 卡片触摸交互，灯箱触摸滑动
• 移动端信息面板自适应为底部弹出
• 分类横向滚动

⚙️ 后台管理

• 侧栏导航：仪表盘、分类管理、网站设置、地图、前台
• 拖拽上传，批量上传，实时进度
• EXIF 自动提取 + 手动编辑
• Live Photo 上传（照片 + 配套视频）

📍 照片地图

• Leaflet + OpenStreetMap，无需 API Key
• 照片缩略图标记 + 弹出详情卡
• 密集区域聚合标记
• 缩放控制 + 重置

📸 EXIF 元数据

兼容相机（Nikon / Canon / Sony / Fujifilm）和手机（iPhone / Android），提取字段：

字段	说明
品牌 / 型号	Camera Make / Model
镜头型号	Lens Model
焦距 / 光圈 / 快门 / ISO	Focal / Aperture / Shutter / ISO
GPS 坐标	纬度 / 经度（自动过滤 0,0）
拍摄时间	DateTimeOriginal
软件 / 固件	Software
白平衡 / 闪光灯	White Balance / Flash
曝光模式 / 测光模式	Exposure / Metering
曝光补偿 / 色彩空间	Exposure Bias / Color Space
场景类型 / 方向	Scene Type / Orientation

缩略图生成时自动根据 EXIF 方向旋转。

🎬 Live Photo

• 上传时附加配套 .mov 视频
• 前端 LIVE 徽章标识
• API 支持 live_photo 字段

🔧 灵活配置

• 多数据库 — SQLite（默认）、MySQL、PostgreSQL
• 多存储 — 本地（默认）、AWS S3、MinIO、阿里云 OSS
• 云端缩略图 — 所有存储后端支持缩略图自动上传

---

📦 快速开始

环境要求

• Go 1.24+（需 CGO，SQLite 驱动依赖）
• GCC（C 编译器）

本地运行

git clone https://github.com/danzai233/mygallery.git
cd mygallery
go mod download
cp config.example.yaml config.yaml
make init
go run main.go

访问：

页面	地址
📷 前台画廊	http://localhost:8080
⚙️ 后台管理	http://localhost:8080/admin
🗺️ 照片地图	http://localhost:8080/map.html
👤 默认账号	admin / admin123

Docker 部署

cp config.example.yaml config.yaml
docker compose build && docker compose up -d

Makefile

make help    # 所有命令
make run     # 运行
make build   # 编译
make test    # 测试
make dev     # 热重载

---

🔧 配置

配置文件 config.yaml，从 config.example.yaml 复制修改。

数据库

database:
  type: "sqlite"  # sqlite / mysql / postgres
  sqlite:
    path: "./data/mygallery.db"

存储

storage:
  type: "local"  # local / s3 / minio / aliyun
  local:
    upload_dir: "./uploads"
    thumbnail_dir: "./uploads/thumbnails"
    url_prefix: "/uploads"

S3 / MinIO / 阿里云 OSS 配置

# AWS S3
storage:
  type: "s3"
  s3:
    region: "us-east-1"
    bucket: "mygallery"
    access_key: "YOUR_KEY"
    secret_key: "YOUR_SECRET"
    url_prefix: "https://bucket.s3.amazonaws.com"

# MinIO
storage:
  type: "minio"
  minio:
    endpoint: "localhost:9000"
    bucket: "mygallery"
    access_key: "minioadmin"
    secret_key: "minioadmin"
    use_ssl: false
    url_prefix: "http://localhost:9000/mygallery"

# 阿里云 OSS
storage:
  type: "aliyun"
  aliyun:
    endpoint: "oss-cn-hangzhou.aliyuncs.com"
    bucket: "mygallery"
    access_key: "YOUR_KEY"
    secret_key: "YOUR_SECRET"
    url_prefix: "https://mygallery.oss-cn-hangzhou.aliyuncs.com"

---

🌐 API

公开接口

方法	路径	说明
GET	/api/photos	照片列表（page, size, category, search）
GET	/api/photos/:id	照片详情
GET	/api/categories	分类列表
GET	/api/settings	网站设置
GET	/api/photos/:id/reactions	表态统计
POST	/api/photos/:id/reactions	添加/更新表态
DELETE	/api/photos/:id/reactions	删除表态
GET	/health	健康检查

需认证接口

方法	路径	说明
POST	/api/auth/login	登录
POST	/api/photos	上传照片（支持 live_photo 字段）
PUT	/api/photos/:id	更新照片
DELETE	/api/photos/:id	删除照片
POST	/api/categories	创建分类
PUT / DELETE	/api/categories/:id	更新 / 删除分类

---

🚀 部署

二进制运行

go build -o mygallery main.go
cp config.example.yaml config.yaml
mkdir -p data uploads uploads/thumbnails
./mygallery

Nginx 反向代理

server {
    listen 80;
    server_name gallery.example.com;
    client_max_body_size 50M;
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

Systemd 服务

[Unit]
Description=MYGallery
After=network.target
[Service]
Type=simple
WorkingDirectory=/opt/mygallery
ExecStart=/opt/mygallery/mygallery
Restart=on-failure
[Install]
WantedBy=multi-user.target

---

🔒 安全建议

1. 修改默认密码和 JWT 密钥
2. 生产环境启用 HTTPS
3. 配置防火墙
4. 定期备份 data/ 和 uploads/

🛠️ 技术栈

组件	技术
后端	Go + Gin + GORM
认证	JWT
EXIF	rwcarlsen/goexif
图片	disintegration/imaging
数据库	SQLite / MySQL / PostgreSQL
存储	Local / S3 / MinIO / Aliyun OSS
前端	Vanilla JS + Tailwind CSS
地图	Leaflet + OpenStreetMap

📄 License

MIT

---

Made with ❤️ by MYGallery