Mingyue Blog

English

简体中文
Español
日本語
한국어

English

简体中文
Español
日本語
한국어

Appearance

Mazanoke 简介 ​

Mazanoke 是一个开源的自托管图片优化工具，完全在浏览器中运行，支持离线使用。它专为注重隐私的用户设计，所有图片处理都在本地设备上完成，图片从不离开你的设备。

官方网站：https://mazanoke.com
GitHub项目：https://github.com/civilblur/mazanoke

主要特点 ​

  • 浏览器图片优化：调整图片质量、设置目标文件大小、设置最大宽高
  • 隐私优先：完全离线工作，图片处理在本地设备上进行
  • 格式转换：支持JPG、PNG、WebP、ICO等格式互转，支持HEIC、AVIF、TIFF输入
  • 剪贴板支持：可直接粘贴剪贴板中的图片进行处理
  • PWA应用：可安装为Web应用，支持离线使用
  • EXIF清理：自动移除图片中的位置、日期等隐私信息

准备工作 ​

在开始部署之前，请确保您已经具备以下条件：

  1. 已安装 Docker 和 Docker Compose（参考本站 Linux Docker 安装教程）
  2. 服务器配置建议：
    • CPU: 1核以上
    • 内存: 512MB 以上
    • 存储: 1GB 可用空间
  3. （可选）准备域名，用于HTTPS访问和PWA安装

部署方案 ​

Mazanoke 提供两种主要的部署方式：Docker部署和本地部署。根据你的需求选择合适的方案。

方案一：使用 Docker Compose 部署（推荐） ​

1. 创建并进入项目目录 ​

bash
mkdir -p ~/mazanoke
cd ~/mazanoke

2. 创建 docker-compose.yml 文件 ​

bash
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/Shanghai
  • restart: always: 容器退出时自动重启

3. 启动 Mazanoke 服务 ​

bash
docker compose up -d

4. 验证部署 ​

bash
docker ps | grep mazanoke

如果看到容器状态为 Up，说明服务已成功启动。

方案二：本地部署（直接使用） ​

如果你不想使用Docker，或者只是想快速体验Mazanoke，可以选择本地部署方案。

1. 下载源代码 ​

  1. 访问 Mazanoke Releases页面
  2. 下载最新版本的源代码压缩包（Source code.zip）
  3. 解压压缩包

2. 启动应用 ​

  1. 进入解压后的目录

  2. 找到index.html文件 双击打开

3. 访问应用 ​

浏览器会自动打开Mazanoke应用，你可以立即开始使用图片优化功能。

基本配置 ​

1. 访问 Mazanoke ​

Docker部署访问方式：

bash
http://你的服务器IP:3474

本地部署访问方式： 直接双击 index.html 文件，或在浏览器地址栏输入文件路径。

首次访问即可直接使用，无需注册或配置。

2. 域名与HTTPS访问（推荐） ​

如需通过自定义域名和HTTPS访问，推荐搭配 Nginx Proxy Manager 进行反向代理与SSL证书配置。

详细教程请参考：使用Docker快速部署Nginx Proxy Manager实现多域名反向代理

配置完成后，即可通过 https://mazanoke.yourdomain.com 安全访问。

3. 安装PWA应用（推荐） ​

Mazanoke支持安装为PWA应用，可以离线使用：

桌面端安装：

  1. 在浏览器中访问Mazanoke
  2. 点击地址栏右侧的"安装"图标
  3. 确认安装，应用将添加到桌面

移动端安装：

  1. 使用Safari（iOS）或Chrome（Android）访问
  2. 点击分享按钮，选择"添加到主屏幕"
  3. 确认安装，应用图标将出现在主屏幕

使用指南 ​

1. 基本图片优化 ​

  1. 上传图片：

    • 点击上传区域选择图片
    • 或直接拖拽图片到页面
    • 支持粘贴剪贴板中的图片

  2. 调整设置：

    • 质量：调整图片压缩质量（0-100）
    • 目标大小：设置期望的文件大小
    • 尺寸限制：设置最大宽度和高度

  3. 格式转换：

    • 选择输出格式：JPG、PNG、WebP、ICO
    • 支持批量转换多张图片

  4. 下载结果：

    • 单张图片直接下载
    • 多张图片打包为ZIP下载

2. 高级功能 ​

批量处理：

  • 支持同时处理多张图片
  • 统一应用相同的优化设置
  • 自动打包下载

隐私保护：

  • 自动移除EXIF数据
  • 清除GPS位置信息
  • 删除拍摄时间等元数据

离线使用：

  • 安装PWA后可完全离线使用
  • 所有处理在本地完成
  • 无需网络连接

与其他工具对比 ​

特性MazanokeTinyPNGSquoosh
隐私保护✅ 完全本地❌ 上传到服务器✅ 本地处理
离线使用✅ 支持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应用，支持离线使用
  • 完全免费：开源项目，无使用限制
  • 部署简单：单容器部署，维护方便

适用场景：

  • 个人图片处理和优化
  • 家庭共享的图片工具
  • 企业内网图片处理
  • 隐私敏感的图片优化需求

如果在使用过程中遇到任何问题，欢迎在评论区留言，我会尽快为您解答。