前言

在数字世界高速发展的今天，您是否察觉到那些静默增长的视觉数据正在悄然蚕食存储空间？随着影像记录成为日常习惯，各类智能设备中积累的图像文件正以几何级数扩张。当您整理电子相册时，看似有序的视觉档案背后，实则隐藏着巨大的存储压力。

特别是未经处理的原始影像文件，它们如同数字世界的存储黑洞，不断吞噬着可用空间。为解决这一困境，我们创新推出MAZANOKE视觉优化平台。该系统通过智能算法重构图像数据，在保障视觉质量的前提下实现存储效率的质的飞跃，使珍贵的记忆既能以最佳状态保存，又能在数字载体中实现轻量化传播。

1. 关于MAZANOKE

MAZANOKE不是来自未来的魔法棒，但它确实可以让你的照片瞬间瘦身！它是一个简单易用的图像优化工具，可以在你的浏览器中运行，支持离线工作，并且最重要的是——所有的处理都在本地完成。这意味着你可以随心所欲地压缩、转换格式而不用担心隐私泄露。

MAZANOKE的特点：

• 即时压缩与转换：无论是调整图片质量，设定目标文件大小，还是限制最大尺寸，都能轻松搞定。
• 支持多种格式：JPG、PNG、WebP、HEIC、AVIF、GIF、SVG等都手到擒来。
• 隐私保护：所有处理都在本地完成，你的照片从不离开你的设备。
• 可安装的网页应用（PWA）：适合桌面、平板和移动设备使用。

2. Docker部署

本例使用Ubuntu 22.04进行演示，使用Docker进行部署，如果没有安装Docker，可以查看这篇教程进行安装：《Docker安装教程——Linux、Windows、MacOS》

输入这行命令，一键部署运行：

sudo docker run -d \
   --restart unless-stopped \
   --name mazanoke \
   -p 3474:80 \
   ghcr.io/civilblur/mazanoke:latest

部署完毕以后打开浏览器，输入http://localhost:3474就能打开MAZANOKE的主页面了。

3. 简单使用MAZANOKE

右上角可以设置黑白主题。

下滑可以按照自己喜好来设置图形管理器。

使用非常简单，只要将图片打开或者直接拖入即可

可以看到压缩成很小，但是画质没什么变化，非常实用又小巧。

4. 安装cpolar内网穿透

不过我们目前只能在本地局域网内访问刚刚部署的MAZANOKE，如果想不在同一局域网内时，也能在外部网络环境使用手机、平板、电脑等设备远程访问与使用它，应该怎么办呢？我们可以使用cpolar内网穿透工具来实现远程访问的需求。无需公网IP，也不用准备云服务器那么麻烦。

下面是安装cpolar步骤：

Cpolar官网地址: https://www.cpolar.com

使用一键脚本安装命令：

sudo curl https://get.cpolar.sh | sh

安装完成后，执行下方命令查看cpolar服务状态：（如图所示即为正常启动）

sudo systemctl status cpolar

Cpolar安装和成功启动服务后，在浏览器上输入ubuntu主机IP加9200端口即:【http://localhost:9200】访问Cpolar管理界面，使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可：

5. 配置公网地址

登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道：

• 隧道名称：可自定义，本例使用了:maza，注意不要与已有的隧道名称重复
• 协议：http
• 本地地址：3474
• 域名类型：随机域名
• 地区：选择China Top

点击创建：

创建成功后，打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了两个公网地址，接下来就可以在其他电脑或者移动端设备（异地）上，使用任意一个地址在浏览器中访问即可。

现在就已经成功实现用cpolar生成的公网地址异地远程访问本地部署的MAZANOKE啦！

小结

为了方便演示，我们在上边的操作过程中使用cpolar生成的HTTP公网地址隧道，其公网地址是随机生成的。这种随机地址的优势在于建立速度快，可以立即使用。然而，它的缺点是网址是随机生成，这个地址在24小时内会发生随机变化，更适合于临时使用。

如果有长期使用MAZANOKE，或者异地访问与使用其他本地部署的服务的需求，但又不想每天重新配置公网地址，还想让公网地址好看又好记并体验更多功能与更快的带宽，那我推荐大家选择使用固定的二级子域名方式来配置公网地址。

6. 配置固定公网地址

使用cpolar为其配置二级子域名，该地址为固定地址，不会随机变化。

注意需要将cpolar套餐升级至基础套餐或以上，且每个套餐对应的带宽不一样。【cpolar.cn已备案】

点击左侧的预留，选择保留二级子域名，地区选择china top，然后设置一个二级子域名名称，我这里演示使用的是maza，大家可以自定义。填写备注信息，点击保留。

保留成功后复制保留的二级子域名地址：

登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道maza，点击右侧的编辑。

修改隧道信息，将保留成功的二级子域名配置到隧道中

• 域名类型：选择二级子域名
• Sub Domain：填写保留成功的二级子域名
• 地区: China Top

点击更新

更新完成后，打开在线隧道列表，此时可以看到随机的公网地址已经发生变化，地址名称也变成了保留和固定的二级子域名名称。

最后，我们使用固定的公网地址在任意设备的浏览器中访问，可以看到成功访问本地部署的MAZANOKE页面，这样一个永久不会变化的二级子域名公网网址即设置好了。

了解更多项目详情大家可以访问作者github主页进行查看：civilblur/mazanoke：在浏览器中运行的自托管本地图像优化器。

总结

本手册通过结构化实践指导，让用户全面掌握MAZANOKE图像优化平台的本地部署策略及远程连接配置方案。重点解析了以Ubuntu操作系统为载体的容器化实施路径，并结合内网穿透技术搭建了稳定的云端访问桥梁。

通过本方案的实操，用户可达成多项关键功能实现：包括在独立服务器环境快速构建开源图像处理系统、创建可固定绑定的网络接入端口，以及部署跨区域的数字资产管理架构。这种技术整合方案不仅突破了传统文件传输的地域限制，更为构建弹性化的数字资产管理系统提供了创新解决方案。