一款漂亮且功能强大的在线海报图片设计器,仿稿定设计。
适用于海报图片生成、电商分享图、文章长图、视频/公众号封面等多种场景。
- 丝滑的操作体验,丰富的交互细节,基础功能完善
- 采用服务端生成图片,确保多端出图统一性,支持各种 CSS 特性
- 支持将上传的 PSD 文件解析成模板,方便导入已有设计图
- 技术栈:Vue3 、Vite2 、Vuex 、ElementPlus
- 图片生成:Puppeteer、Express
- 导入 PSD 设计稿,导出图片下载
- 元素拖拽、组合、缩放、层级调整、对齐等操作。
- 图片素材插入、替换、裁剪,图片容器等功能。
- SVG 素材颜色、透明度编辑,文字花字组合。
- 画布自定义尺寸、滚轮缩放、自适应画布
- 吸附对齐、辅助引导线、标尺功能。
- 键盘快捷键、右键菜单快捷操作,复制删除等常用操作。
- 风格二维码编辑,支持单色、渐变、自定义 logo 等。
- 图层操作,支持拖拽变更层级。
- 颜色调色板,原生级取色器颜色吸管(Chrome)。
环境需求:Node.js v16 以上版本
git clone https://github.com/palxiao/poster-design.git
cd poster-design
npm run prepared
网络太慢?尝试运行:npm config set registry https://registry.npmmirror.com 再安装依赖
npm run serve
将会同时运行前端界面与图片生成服务:
如果你本地没有成功启动两个服务,可能是 win 系统不兼容,手动进
screenshot
目录安装依赖并启动服务,或是使用 VSCode 自带的终端来运行命令,不要使用 CMD。
合成图片时本地会启动一个 Chrome 浏览器实例。
npm run v-build <- 前端页面
npm run build <- 图片生成服务( sreenshot 目录下)
可参考接口 API 文档自行实现服务端。
代码位于 screenshots
目录下,查看接口 API 文档。
目录结构比较简单,主要就实现了三个接口,其中 api/screenshots 即是项目中所使用到的图片生成接口,在真实生产项目中可以把该服务单独部署,于内网调用,这样利于做一些鉴权之类的处理。
另外 api/printscreen 这个接口实现的是网页截图的 API,该接口可以传入一个 URL 对整个网页进行截图,本项目中不依赖此接口。
在 Linux 环境下,npm 自动安装的 Chrome 浏览器有可能会出错,所以推荐从外部安装好浏览器,再给项目中的配置文件 config.js
设置好路径,例如:
exports.executablePath = '/opt/google/chrome-unstable/chrome'
一些可能用到的 linux 命令参考:
google-chrome --version # 查看浏览器版本号
apt-get update
apt-get install -y google-chrome-stable // 安装最新稳定版谷歌浏览器
可以通过 Docker 运行一个带 Linux 浏览器的容器,然后暴露一个截图服务以供使用,我所使用的基础镜像为:
docker pull howard86/puppeteer_node:12
运行容器命令参考(其中映射了 /cache
为临时目录,放生成图片用):
docker run -itd -v /data/docker-home:/home -v /data/cache:/cache -p 7001:7001 --name screenshot howard86/puppeteer_node:12
运行后可以手动进入容器中查看谷歌浏览器版本,看需不需要升级,然后安装 pm2 作为服务管理工具,服务启动/重部署相关脚本命令可参考:
docker exec screenshot /bin/bash -c 'pm2 delete screenshot-service'
docker exec screenshot /bin/bash -c 'cd /home/ && yarn'
docker exec screenshot /bin/bash -c 'pm2 start /home/screenshot-service.js'
docker exec screenshot /bin/bash -c 'pm2 flush'
如果不想像上面这样直接操作容器,可以在本地/服务器先运行镜像,进入容器中照例配置好 pm2,然后把该容器导出为新的镜像,例如:new-design/screenshot,命令运行参考:
docker run -itd -u root -v ~/data/tmp/screenshot:/cache -p 9001:9001 --name screenshot2 new-design/screenshot /bin/sh -c "/usr/local/bin/pm2 start /home/dist/server.js && /usr/local/bin/pm2 flush"
这种方式只需要一个镜像以及一个启动命令即可部署,重新跑一遍命令也就相当于重启整个容器。
本项目使用或参考了一些优秀开源项目,包括但不限于:
- moveable: 提供了画布中选择、拖动缩放等能力
- html2canvas: 前端生成图片兜底方案
- qr-code-styling: 风格化二维码
- sky: 参考了其 PSD 解析的实现
Q:我想二次开发,但是不会编写代码,可以付费开发吗?
A:抱歉,本人时间精力有限,无法提供私有化部署或二次开发的服务,不接受定制化开发的需求。如果您对项目有任何建议或意见,非常欢迎与我交流。
Q:服务端源码不开源吗?
A:考虑到服务端的开发语言、数据库类型都可能不尽相同,且分离代码出来有一定成本,所以暂时不考虑直接开源,只提供接口 API 文档供参考。目前服务端仅是一些简单的增删改查,自行实现的技术难度并不高。
项目最早使用 Vue2 开发,后改用 Vue3 重构,所以有部分代码混合了 Options 写法。
如果你也对开发图片编辑器感兴趣,欢迎一起共建项目!
或许你在工作中有这类需求,如果能给到你一些微薄的帮助,那就更好不过了!
目前本项目也还在不断迭代中,有很多的不足之处,我也是一边学习一边成长。开源不易,希望看到这里的你可以给本项目点个 Star 支持一下~ 感谢!