mewlab/mewimage repository overview

⁠MewImage

GitHub 源码与完整文档⁠ | 问题反馈⁠

⁠功能特点

• 支持 OpenAI Image、Responses API、Nano Banana 和 OpenAI 兼容 图像接口。
• 支持文本生图、参考图编辑、多图生成和连续修改。
• 支持 1K、2K、4K 比例预设和自定义分辨率。
• 游客无需注册即可使用本地会话、历史、参考图、收藏夹和服务商配置。
• 登录并通过管理员审批后，可以手动同步图片、会话、收藏和配置到其他设备。
• 支持服务器本地文件存储和 S3 兼容对象存储。
• 支持用户注册、强密码检查、管理员审批和用户管理。
• 支持 ZIP 数据导出、合并导入和分类清除。

⁠数据与隐私

• 游客工作区和图片默认保存在浏览器 IndexedDB，不写入服务器硬盘。
• 游客使用代理时，API Key 只在请求期间进入后端内存，不写入数据库和对象存储。
• 云同步只在用户主动点击时执行，不会在后台自动上传工作区。
• 登录用户的服务器图片使用独立用户目录隔离。
• API Key 可以仅保存在当前浏览器，也可以选择经过客户端加密后同步。

⁠Docker Compose 快速部署

服务器需要安装 Docker 和 Docker Compose。下载部署文件：

mkdir -p mewimage && cd mewimage

curl -LO https://raw.githubusercontent.com/Rabbit-bot-No-002/MewImage/main/docker-compose.yml
curl -o .env https://raw.githubusercontent.com/Rabbit-bot-No-002/MewImage/main/.env.example

生成两个随机密钥：

openssl rand -hex 32
openssl rand -base64 32

编辑 .env，至少填写：

MEW_AUTH_SECRET=第一条命令生成的随机值
MEW_ADMIN_TOKEN=第二条命令生成的随机值
MEW_ALLOWED_ORIGINS=https://你的正式域名

启动服务：

docker compose pull
docker compose up -d
docker compose logs -f app

默认端口为 3188：

http://服务器IP:3188

首次打开页面后，注册第一个账号，并在管理员初始化入口填写 MEW_ADMIN_TOKEN。后续普通用户注册后需要管理员审批，才能使用服务器图片存储和跨设备同步。

⁠HTTPS 反向代理

通过 Nginx Proxy Manager、Nginx 或 Caddy 部署 HTTPS 时，推荐设置：

MEW_ALLOWED_ORIGINS=https://你的正式域名
MEW_SESSION_SECURE=true
MEW_TRUST_PROXY_HEADERS=true

只有当 MewImage 后端端口无法绕过反向代理从公网直接访问时，才能启用 MEW_TRUST_PROXY_HEADERS，否则客户端可能伪造来源 IP 绕过限流。

⁠持久化数据

Docker Compose 默认将数据保存到部署目录下的 ./data：

data/
├── mew-image.db
└── assets/

• mew-image.db 保存用户、会话、同步快照和图片索引。
• assets/ 保存已审批登录用户同步到服务器的图片。
• 游客浏览器中的图片不会写入该目录。

⁠当前限制

• 当前镜像平台为 linux/amd64，暂未提供 ARM64 镜像。
• 纯静态网页无法提供完整代理、账号、同步和资源存储能力。
• 第三方中转站可能不会完整支持请求的分辨率、画幅或质量参数。
• Local 与 S3 存储之间暂时需要手动迁移文件。

⁠License

MewImage is released under the MIT License⁠.