【开源】耗时数月、我开发了一款功能全面【30W行代码】的AI图床

作者 _小九

2025年11月19日 18:15

AI编程发展迅猛，现在如果你是一个全栈开发，借助AI编辑器，比如Trae你可以开发很多你以往无法实现的功能，并且效率会大大提示，Tare的Coding能力已经非常智强了，借助他，我完成了这个30W行代码的开源项目，现在，想把这个项目推荐给你。

当前文章主要是介绍我们开发出的这个项目，在后续，将会新开一个文章专门介绍AI Coding的各种技巧，如何使用他，才能让他在大型项目中依然如虎添翼。

如果你想快速了解此项目、你可以访问PixelPunk官方文档。

如果你想快速体验此项目、你可以访问V1版本,前往体验功能。

如果你想完整体验前后台全面的功能、你可以访问测试环境。【root 123456】

如果您认可我的项目，愿意为我献上一个宝贵的Star，你可以前往PixelPunk项目。

开发这样一个项目在现在这个时间来看似乎没什么必要，实际上开发这样一个项目的原因其实就是在年初的时候失业了一段时间，闲在家里无聊，于是想着做一个自己的开源项目，最开始其实做的是另一个类型的项目，开发了一段时间感觉有些无聊就转战做了现在的这个项目PixelPunk图床，其实并不只是想要做一个图床，只是当前来说的一期功能比较贴合图床，后期的跌代准备支持更多格式包括视频文档等等，并且由于AI多模态模型的能力发展迅速，后期结合AI可以实现更多可玩性比较高的内容。

市面上已经有了非常多的开源图床了，开发这样一个项目要追求一些差异点才会有价值，本质上来说这类服务其实核心就是个存图片而已，其他功能并不是很重要，但是作为个人使用用户来说，除了存图也愿意去尝试一些便捷的功能，于是思考到这个点之后，我开始了这个项目的开发，项目的命名[PixelPunk] 是我让AI起的，因为要做就要做一个不一样的有特点，我要做一个ui上就不一样的图床出来，于是有了此命名，中文翻译过来是像素朋克,由于像素风格感觉ui不是很适合工具类网站使用，于是我选择了赛博朋克风格，围绕这个ui来开发了此项目。

项目概览

首先呢项目从开发就一个全栈项目，前后端放一起了，采用的技术栈是 go+vue，前端会将打包的文件放入到go中一起打包为二进制安装包，这样部署起来将非常简单。项目分为了用户端和管理端，并且同属于一个项目，不分离开发，为了符合我们定制化的ui，所有组件都是自定义的组件，项目使用了70+自定义组件。项目接入了多模态AI大模型，在以前我们的图床要实现各种功能需要对接各种各样的平台，现在有了AI，我们只需要一个模型就能完成非常多的功能，比如【语义化描述图片】，【**图片OCR识别】，【**图片自动分类】，【**图片自动打标】，【**图标自动审核NSFW、违规图、敏感图、血腥图等等】，【图片颜色提取】等等功能都只需要配置一个AI模型即可，对于成本而言，比之前的三方API可能更加便宜

关于部署

作为一个开源项目，我想的是需要使用者使用起来足够简单，部署起来也足够快，本身来讲，我们项目需要用来这些内容，mysql|Sqlite + Redis|系统内存 + qdrant向量数据库，这三件套，为了安装简单，我将向量数据库直接集成到安装包，用户可以无需关系任何内容，我们可以做到0配置启动项目，不需要你做任何配置即可超快部署项目。

我们提供了两种部署方式，一种是安装包部署，你可以下载对应平台的安装包**.zip安装包**，下载到你的服务器，解压之后里面有一个install.sh，直接sh ./install.sh即可安装，当然手动部署可能还需要两个步骤，你可以使用我们的脚本直接进行部署，也可以看看我们的部署文档，PixelPunk部署文档。

安装包一键部署 curl -fsSL https://download.pixelpunk.cc/shell/install.sh | bash

docker-compose一键部署脚本 curl -fsSL https://download.pixelpunk.cc/shell/docker-install.sh | bash

我们的部署非常简单，你只需要执行完脚本即可直接启动项目，我们的docker-compose部署方式已经配置了所有数据库缓存等信息，启动项目进入 http://ip:9520 会自动跳转到安装页面，添加管理员账号密码即可完成安装，如果使用安装包模式呢，那么就支持你可以自定义选择数据库，可以填写自己的mysql，也可以使用系统内置的Sqlite，可以选择自己的向量数据库和缓存，也可以使用系统内置的，自由选择，总之，一键脚本预估20S就可以帮你安装并且启动项目，无需你的任何配置，希望会自己内置生成一些必要信息，比如jwt，系统安装后你可以进入后台管理进行修改。

项目部分功能

我们的项目功能可以说已经非常全面了，并且还在持续迭代，目前代码总行数已经达到了30W行，很多功能需要你自己体验，我们覆盖了主流图床的全部功能，并且还在进一步持续加入更多有趣的元素，我们可以列举一些功能做简要说明。

10+精美主题

作为个人使用的工具，我一直在持续优化UI和交互，始终认为，UI还是很重要的一个步骤，目前的UI还不够精美，也是后续会持续调整的一个点，目前提供了10多套主题，并且您可以自定义主题，我在项目中放置了主题开发文档,你可以根据模板文件去替换一套变量即可完成一套主题的开发。

多语言双风格

我们目前内置了三种语言中英日,并且为了迎合我们PixelPunk风格的特色，我们新增了一种风格选项，你可以选择赛博朋克风格的文案，让系统的所有内容提示充满赛博味道~

多布局系统

我们网站为了更好的工作体验，提供了两种的布局方式,传统布局,工作布局，既可以使用传统的轻量化的布局让人轻松，也可以使用工作台布局让工作更高效。并且您还可以在后台限制这些功能，使用固定布局而不开放这些功能，在后台管理部分都可以实现。

多种登录方式

我们内置默认使用传统邮箱的登录方式，并且支持关闭注册，邮箱配置也是后台配置即可，同时系统对接了Github、Google、LinuxDo三种接入成本非常低的快捷登录方式，并且可能由于你是国内服务器，无法直接访问这些服务，所以系统贴心的准备了(代理服务)配置，让你即使是国内服务器也依然可以顺利完成这些快捷登录。

强大的特色文件上传

文件上传是一个基础的功能，所有图床都支持，我们当然也支持，我们在此功能上进行了耐心的打磨，支持很多特色功能，

支持后台动态配置允许格式，动态配置上传图片限制尺寸
支持大文件分片上传、断点续传等功能。
支持秒传，后台动态开启是否启用
支持游客模式，限制游客上传数量，并限制上传资源有效时间
支持自定义资源保存时间，后台可配置用户允许选择有效期，精确到分钟
支持重复图检测，重复图自动秒传，不占用空间
支持水印，并且特色化水印，开发了一个水印专用面板用于你配置特色化水印，支持文字、图片水印。
支持中断上传,取消上传
支持上传实时进度提示
支持自动优化图片，自定义上传文件夹。
支持文件夹上传,拖拽上传,项目内全局上传（任意页面都支持上传）。
支持原图复制,MD格式复制,HTML格式复制,缩略图格式复制,全部图片链接批量复制
支持公开、私密、受保护,三种权限设置，公开图片可以在任何地方显示并且授权给管理员可以用于推荐，并且在作者首页可以展示对外，私密则仅自己可见，系统其他人不可见，受保护权限图片只能在系统观看打开，无法产生链接，除自己登录系统外，其他人无法观看。
支持持久化，你可以选择图片并且上传中，跳转到任何页面而不会中断你的上传，你可以在上传过程中干任何事情
支持特色悬浮球，当你不在上传页面的其他页面，如果有上传内容，会有一个特色上传球实时告知您上传的进度，并且你可以随意拖动控制悬浮球的位置。

超过上传渠道支持

作为一个图床的基本素养，都会支持对接三方，目前我们已经支持了10+的三方云储存渠道，并且添加时候可以测试渠道保障你的配置，首先我们支持服务器自身存储，这也是系统默认渠道，你可以在后台渠道配置更多，比如阿里云COS,腾讯云OSS,七牛云,雨云,又拍云,S3,Cloudfare R2,WebDav,AZure,Sftp,Ftp,等等渠道，S3协议本身就可以支持非常多的基于S3协议的渠道了，并且，如果你想要更多渠道，可以去往我们官网网站提起诉求，我们可以很快支持新的渠道。

特色AI功能

AI也是我们图床的一大特色，我们利用AI做了这些事情

自动分类
自动打标
语义化图片，提取信息，提取色调
实现ai自然语言搜索
实现相似图搜索
实现NSFW违规图审核

而这些，仅仅只需要配置一个openai的gpt4-mini即可完成，后续会支持更多渠道（目前仅支持配置OPENAI格式的渠道），目前测试感觉gpt-4.1-mini足以胜任工作，并且价格低廉，性价比很高。

违规图片检测可以自定义等级宽松或严格

自然语言搜索图片

相似图搜索

图片ai描述

自动分类打标签

文件夹功能

文件分类是一个和合理的诉求，所以我们可以自定义创建文件夹，同样可以控制不同的权限，并且文件夹可以无限嵌套你可以自定义多层级的文件夹合理管理你的文件，并且我们支持文件夹移动，图片移动，批量操作，右键菜单，拖拽排序等等特色功能，你可以灵活的管理你的文件。

右键菜单

分享系统

我们拥有大量素材，或者一些收藏资源需要分享给好友，我们可以任意创建分享，可以分享自己的文件夹，图片，也可以组合分享，也可以分享用户公开的推荐图，选择任意探索广场的图进行分享，并且可以统计访问次数，限制访问次数，达到访问次数关闭分享，密码分享，限制时间有效期分享，邮箱通知等等功能。

您可以观看我们的演示分享内容

创建分享

防盗链管理

图床安全始终是一个问题，经常会遇到被盗刷的风险，由于流量费用贵，鄙人有幸被刷破产过一次（TMD），我们加入了防盗链配置，可以配置白黑名单域名|IP，可以配置网站refer等内容，并且对于违规的用户，我们可以配置让其302到他地址,可以自定义返回固定图,也可以直接拒绝。

当我们对接三方渠道的时候，正常情况我们会拿到远程url地址，我们依然可以在后台配置渠道将其隐藏远程url地址，如果配置，那么域名请求将会从我们服务器代理获取，可以隐藏掉三方的地址，或者配置私有存储桶通过秘钥去动态获取图片，防止你的图片被盗刷大量流量

开放API

图床的基本功能之一，我们可以生成秘钥在三方进行上传文件，不同的是，我们系统支持了设置秘钥时可以限制其使用的空间，限制上传次数，可以指定上传的文件夹,指定文件格式等等，并位置提供了完整的上传文档，支持单文件上传,多文件上传。

随机图片

经常会有人需要一个随机图片的API，但是受限于使用别人的不够稳定，也不够灵活，于是我们开放了一个随机API功能，你可以动态的配置，选择其绑定你需要随机的图片，比如指定随机任意文件夹，指定返回方式302重定向，或直接返回图片，你可以点击pixelpunk随机图片API演示，每次刷新你可以获取新的图片。