KiberCloud
Web 应用自托管后端 + 前端一体
自托管的图片管理 / 图床平台:前台瀑布流画廊 + 后台控制台 + 第三方调用开放 API。对象存储走腾讯云 COS,元数据存放在 PostgreSQL。
KiberCloud 是三款产品里的「服务端」。它本身是一个完整的 Web 应用:你把它部署在自己的服务器(或腾讯云轻量上), 数据全部留在自己桶里,外界访问的是一个公开画廊。
核心功能
- 公开画廊:匿名访客按分类、标签、关键词、排序浏览已发布图片;下载原图需要「下载码」。
- 下载码机制:管理员通过控制台或 API 为指定图片签发带配额/时效的下载码,访客凭码兑换短期签名 URL,签名链接 5 分钟内有效。
- 管理控制台:登录(含图形验证码、登录锁定、双令牌轮换、RBAC)后发布/编辑/删除图片、归类管理、维护下载码与开放 API 令牌、查看操作日志。
- 开放发布 API:使用
kbc_前缀的长期 Bearer 令牌调用/api/v1/openapi/*,方便桌面/移动端/脚本直接发布图片,并可为自己发布的图签发下载码。 - 审计日志:所有写操作自动留痕,请求体按敏感字段脱敏(密码、令牌、Secret 等),可分页查询、CSV 导出。
- 主题切换:亮 / 暗 / 跟随系统 + 主色自定义,刷新保持首屏不闪白。
快速上手
KiberCloud 是自托管部署形态:当前不提供官方的托管服务镜像,你从仓库拉取源码后,按 README.md 在自己的服务器上:
- 准备 PostgreSQL 16 实例(任意位置,本机或远端皆可)。
- 配置腾讯云 COS 桶(推荐子账号
kibermod-cos,最小权限策略:仅本桶Put/Get/Delete Object与PutObjectACL)。 make run启动后端(自动建表 + 幂等种子 + 默认管理员)。npm run build构建前端,由 nginx 反向代理/api到 Go 服务。- 详细流程见 KiberCloud 仓库根目录的
README.md与.kiro/specs/image-hub/。
系统要求
运行后端
Go 1.24+ · Linux amd64 静态二进制
数据库
PostgreSQL 14 及以上
对象存储
腾讯云 COS(任意地域)
运行内存建议
≥ 1 GB(前端由 nginx 提供静态托管)
当前阶段
Beta · 仍在迭代
开源许可
自托管部署,无独立分发
常见问题
有官方托管版吗?
目前不提供托管服务。KiberCloud 的全部价值在于「自托管、数据归你」,托管会破坏这一点。
能跑 SQLite 或 MySQL 吗?
不能。当前实现依赖 PostgreSQL 14+ 的若干特性(生成列、`gen_random_uuid()`、范围索引等),迁移到其它数据库需要同步改动较多代码。
能跑在 NAS / 软路由上吗?
可以。Go 后端是纯静态二进制且无 CGO,提供 aarch64 构建;只要本机能跑 PostgreSQL 与有可写的 COS 桶即可。
下载
当前查看 KiberCloud 的全部下载项。其它产品请前往 下载总览。
Linux 共 2 项
服务端部署包含 Go 二进制、前端 dist、systemd unit 与 nginx 配置
Linux · x86_64
.tar.gz 已声明
—
vBeta
服务端部署包ARM 服务器 / 软路由等场景
Linux · aarch64
.tar.gz 已声明
—
vBeta