一、Mazanoke介绍

1.1 Mazanoke简介

Mazanoke 是一款在浏览器中运行的本地图像优化工具，支持离线使用，提供图像压缩、格式转换与隐私保护功能，所有操作均在设备端完成，无需上传数据。

1.2 Mazanoke主要特点

• 浏览器内直接运行，无需安装额外软件。
• 调整图像质量（0-100%）、目标文件大小及最大宽高限制。
• 支持 JPG、PNG、WebP、ICO 格式互转，并兼容 HEIC、AVIF、TIFF、GIF、SVG 等格式转换。
• 支持剪贴板直接粘贴图像进行优化。
• 完全离线工作，所有处理数据不离开设备。
• 自动移除 EXIF 元数据（如位置、拍摄时间等隐私信息）。
• 无用户跟踪，严格保护用户隐私。
• 可安装为渐进式网页应用（PWA），支持多设备使用。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下部署mazanoke简单图像优化工具。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

root@jeven:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
     Active: active (running) since Tue 2025-12-02 00:51:31 CST; 1min 11s ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 75393 (dockerd)
      Tasks: 32
     Memory: 34.1M (peak: 34.8M)
        CPU: 1.248s
     CGroup: /system.slice/docker.service

3.2 检查Docker版本

检查Docker版本

root@jeven:~# docker -v
Docker version 28.5.0, build 887030f

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

root@jeven:~# docker compose version
Docker Compose version v2.39.4

四、拉取mazanoke镜像

下载mazanoke镜像，镜像名称为：ghcr.io/civilblur/mazanoke:latest。

docker pull ghcr.io/civilblur/mazanoke:latest

五、部署mazanoke服务

5.1 创建部署目录

• 创建部署目录

mkdir -p /data/mazanoke && cd /data/mazanoke

5.2 docker compose方式部署

使用docke-cli方式部署，可参考如下命令：

docker run -d \
   --restart always \
   --name mazanoke \
   -p 6630:80 \
   ghcr.io/civilblur/mazanoke:latest

新建及编辑docker-compose.yaml文件，宿主机映射端口可自行设置，注意防止端口冲突。

vim docker-compose.yaml

version: '3'

services:
  mazanoke:
    image: ghcr.io/civilblur/mazanoke:latest
    container_name: mazanoke
    restart: always
    ports:
      - "6630:80"

5.3 创建mazanoke容器

执行以下命令，创建mazanoke容器。

docker compose up -d

5.4 查看mazanoke容器状态

检查mazanoke容器运行状态，确保mazanoke容器正常启动。

root@jeven:/data/mazanoke#  docker compose ps
WARN[0000] /data/mazanoke/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
NAME       IMAGE                               COMMAND                   SERVICE    CREATED          STATUS          PORTS
mazanoke   ghcr.io/civilblur/mazanoke:latest   "/docker-entrypoint.…"   mazanoke   32 seconds ago   Up 32 seconds   0.0.0.0:6630->80/tcp, [::]:6630->80/tcp

5.5 检查mazanoke容器日志

检查容器运行日志，确保mazanoke服务正常运行。

docker compose logs

六、访问mazanoke服务

6.1 访问mazanoke首页

浏览器地址： http://<个人的服务器IP>:6630，访问mazanoke初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。

6.2 压缩图片

可根据需要，自行调整压缩参数，如下所示：

七、总结

本次实践成功完成了 Mazanoke 本地图像优化工具的 Docker 部署与功能验证，整个流程顺畅高效。通过 docker compose 方式部署，服务快速启动并稳定运行，无需依赖外部网络或后端服务。实际使用中，Mazanoke 能在浏览器中完成图片压缩、格式转换及 EXIF 数据清除，充分体现了其离线处理与隐私保护的优势。该工具轻量、安全、易用，非常适合注重数据隐私的个人用户或开发团队本地部署使用。