





# 一、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。


|hostname| IP地址  | 操作系统版本   |Docker版本   |部署项目|备注
|--|--| --|  --|--|--|
|jeven |192.168.3.88  | Ubuntu 24.04.2 LTS| 28.5.0   |mazanoke  |  ——


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





# 三、本地环境检查

## 3.1 检查Docker服务状态
>检查Docker服务是否正常运行，确保Docker正常运行。



```bash
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
```
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/abb255efc952dabcb17c36c31c1cd133.png)




## 3.2  检查Docker版本
>检查Docker版本

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


## 3.3 检查docker compose 版本
>检查Docker compose版本，确保2.0以上版本。


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

```


# 四、拉取mazanoke镜像



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



```bash
docker pull ghcr.io/civilblur/mazanoke:latest
```



![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/2e5f13f678c4abfe4f66f961de1ddb6b.png)

















# 五、部署mazanoke服务

## 5.1 创建部署目录
- 创建部署目录

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


## 5.2 docker compose方式部署


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

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


```


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

```bash
vim docker-compose.yaml
```

```yaml
version: '3'

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


```



## 5.3 创建mazanoke容器

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


```bash
docker compose up -d
```


![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/75ec04d898573bfd780203924d64275c.png)














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

```bash
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服务正常运行。




```bash
docker compose logs
```




![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/9023b65aee4f7dec2011d854dc6a0c20.png)




# 六、访问mazanoke服务
## 6.1 访问mazanoke首页





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




![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/4db302a2f8b82a4c8ddd0f946d2c8276.png)
## 6.2 压缩图片

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

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/4d4ed4d16424be50a9cbc95420e9054e.png)
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/132922297c44e4611ead64f1424f522d.png)


# 七、总结

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



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

告别云端压缩：Docker部署开源图片处理神器Mazanoke指南

开发工具

运维

Mazanoke是一款浏览器本地图像优化工具，支持离线压缩、格式转换和隐私保护，所有处理在设备端完成。本文详细介绍在Ubuntu24.04系统通过Docker部署Mazanoke的完整步骤，包括环境检查、镜像拉取、容器创建和服务访问。该工具支持JPG/PNG/WebP等格式互转，自动移除EXIF数据，保障用户隐私安全。

云服务器

代码解释

服务器

防火墙

容器

Docker

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

告别云端压缩：Docker部署开源图片处理神器Mazanoke指南-腾讯云开发者社区-腾讯云

告别云端压缩：Docker部署开源图片处理神器Mazanoke指南

告别云端压缩：Docker部署开源图片处理神器Mazanoke指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐