Mazanoke 简介
Mazanoke 是一个开源的自托管图片优化工具，完全在浏览器中运行，支持离线使用。它专为注重隐私的用户设计，所有图片处理都在本地设备上完成，图片从不离开你的设备。
官方网站：https://mazanoke.com
GitHub项目：https://github.com/civilblur/mazanoke
主要特点
- 浏览器图片优化：调整图片质量、设置目标文件大小、设置最大宽高
- 隐私优先：完全离线工作，图片处理在本地设备上进行
- 格式转换：支持JPG、PNG、WebP、ICO等格式互转，支持HEIC、AVIF、TIFF输入
- 剪贴板支持：可直接粘贴剪贴板中的图片进行处理
- PWA应用：可安装为Web应用，支持离线使用
- EXIF清理：自动移除图片中的位置、日期等隐私信息
准备工作
在开始部署之前，请确保您已经具备以下条件：
- 已安装 Docker 和 Docker Compose（参考本站 Linux Docker 安装教程 ）
- 服务器配置建议：
- CPU: 1核以上
- 内存: 512MB 以上
- 存储: 1GB 可用空间
- （可选）准备域名，用于HTTPS访问和PWA安装
部署方案
Mazanoke 提供两种主要的部署方式：Docker部署和本地部署。根据你的需求选择合适的方案。
方案一：使用 Docker Compose 部署（推荐）
1. 创建并进入项目目录
mkdir -p ~/mazanoke
cd ~/mazanoke
2. 创建 docker-compose.yml 文件
cat > docker-compose.yml << 'EOF'
services:
mazanoke:
image: ghcr.io/civilblur/mazanoke:latest
container_name: mazanoke
restart: always
ports:
- "3474:80"
environment:
- TZ=Asia/Shanghai
EOF
参数说明
image: 使用官方最新版镜像container_name: 容器名称，便于管理ports: 默认映射到3474端口，可根据需要修改TZ: 时区设置，建议保持 Asia/Shanghairestart: always: 容器退出时自动重启
3. 启动 Mazanoke 服务
docker compose up -d
4. 验证部署
docker ps | grep mazanoke
如果看到容器状态为 Up，说明服务已成功启动。
方案二：本地部署（直接使用）
如果你不想使用Docker，或者只是想快速体验Mazanoke，可以选择本地部署方案。
1. 下载源代码
- 访问 Mazanoke Releases页面
- 下载最新版本的源代码压缩包（Source code.zip）
- 解压压缩包
2. 启动应用
-
进入解压后的目录
-
找到index.html文件 双击打开
3. 访问应用
浏览器会自动打开Mazanoke应用，你可以立即开始使用图片优化功能。
基本配置
1. 访问 Mazanoke
Docker部署访问方式：
http://你的服务器IP:3474
本地部署访问方式：
直接双击 index.html 文件，或在浏览器地址栏输入文件路径。
首次访问即可直接使用，无需注册或配置。
2. 域名与HTTPS访问（推荐）
如需通过自定义域名和HTTPS访问，推荐搭配 Nginx Proxy Manager 进行反向代理与SSL证书配置。
详细教程请参考：使用Docker快速部署Nginx Proxy Manager实现多域名反向代理
配置完成后，即可通过 https://mazanoke.yourdomain.com 安全访问。
3. 安装PWA应用（推荐）
Mazanoke支持安装为PWA应用，可以离线使用：
桌面端安装：
- 在浏览器中访问Mazanoke
- 点击地址栏右侧的"安装"图标
- 确认安装，应用将添加到桌面
移动端安装：
- 使用Safari（iOS）或Chrome（Android）访问
- 点击分享按钮，选择"添加到主屏幕"
- 确认安装，应用图标将出现在主屏幕
使用指南
1. 基本图片优化
-
上传图片：
- 点击上传区域选择图片
- 或直接拖拽图片到页面
- 支持粘贴剪贴板中的图片
-
调整设置：
- 质量：调整图片压缩质量（0-100）
- 目标大小：设置期望的文件大小
- 尺寸限制：设置最大宽度和高度
-
格式转换：
- 选择输出格式：JPG、PNG、WebP、ICO
- 支持批量转换多张图片
-
下载结果：
- 单张图片直接下载
- 多张图片打包为ZIP下载
2. 高级功能
批量处理：
- 支持同时处理多张图片
- 统一应用相同的优化设置
- 自动打包下载
隐私保护：
- 自动移除EXIF数据
- 清除GPS位置信息
- 删除拍摄时间等元数据
离线使用：
- 安装PWA后可完全离线使用
- 所有处理在本地完成
- 无需网络连接
与其他工具对比
| 特性 | Mazanoke | TinyPNG | Squoosh |
|---|---|---|---|
| 隐私保护 | ✅ 完全本地 | ❌ 上传到服务器 | ✅ 本地处理 |
| 离线使用 | ✅ 支持PWA | ❌ 需要网络 | ✅ 支持 |
| 自托管 | ✅ Docker部署 | ❌ 在线服务 | ❌ 在线服务 |
| 批量处理 | ✅ 支持 | ✅ 支持 | ❌ 单张处理 |
| 格式支持 | ✅ 丰富 | ⚠️ 有限 | ✅ 丰富 |
| 使用限制 | ✅ 无限制 | ❌ 有限制 | ✅ 无限制 |
部署方案对比
| 特性 | Docker部署 | 本地部署 |
|---|---|---|
| 技术要求 | 需要Docker知识（文章讲解的hen） | 无技术要求 |
| 部署难度 | 中等 | 极简单 |
| 网络访问 | ✅ 支持局域网/互联网访问 | ❌ 仅限本机 |
| 多设备共享 | ✅ 支持 | ❌ 不支持 |
| 自动启动 | ✅ 开机自启 | ❌ 需手动打开 |
| 服务管理 | ✅ 自动重启、日志管理 | ❌ 无服务管理 |
| 资源占用 | 中等（Docker + 应用） | 极低（仅浏览器） |
| 离线使用 | ✅ 支持 | ✅ 完全离线 |
| 便携性 | ❌ 需要Docker环境 | ✅ 可放U盘携带 |
| 更新方式 | Docker命令更新 | 重新下载文件 |
| 适用场景 | 团队共享、长期使用 | 个人使用、临时需求 |
常见问题（FAQ）
Docker部署相关
| 问题 | 解决方案 |
|---|---|
| 如何更新 Mazanoke？ | 在项目目录执行 docker compose pull && docker compose up -d --force-recreate |
| 如何查看日志？ | docker logs mazanoke |
| 如何修改访问端口？ | 修改 docker-compose.yml 的 ports 映射并运行 docker compose restart |
本地部署相关
| 问题 | 解决方案 |
|---|---|
| 如何更新本地版本？ | 重新下载最新版本源代码，替换旧文件 |
| 本地版本无法打开？ | 确保浏览器支持本地文件访问，或使用简单HTTP服务器 |
| 如何在局域网共享？ | 使用 python -m http.server 8000 在目录下启动HTTP服务 |
通用问题
| 问题 | 解决方案 |
|---|---|
| PWA安装失败怎么办？ | 确保使用HTTPS访问，或在浏览器设置中手动添加 |
| 支持哪些图片格式？ | 输入：HEIC、AVIF、TIFF、GIF、SVG、JPG、PNG；输出：JPG、PNG、WebP、ICO |
| 图片处理速度慢？ | 图片处理在客户端进行，速度取决于设备性能和图片大小 |
| 如何批量处理图片？ | 选择多个文件或拖拽多个图片到上传区域 |
总结
通过本教程，您已成功部署了 Mazanoke 图片优化工具。无论选择 Docker 部署还是本地部署，Mazanoke 都能提供安全、私密的图片处理体验，是注重隐私用户的理想选择。
主要优势：
- 隐私保护：图片从不离开本地设备
- 功能丰富：支持压缩、转换、批量处理
- 使用便捷：PWA应用，支持离线使用
- 完全免费：开源项目，无使用限制
- 部署简单：单容器部署，维护方便
适用场景：
- 个人图片处理和优化
- 家庭共享的图片工具
- 企业内网图片处理
- 隐私敏感的图片优化需求
如果在使用过程中遇到任何问题，欢迎在评论区留言，我会尽快为您解答。
评论