Islet 是一个自托管多用户图床,基于 Go + React 19 构建。标准 OIDC 单点登录(PKCE)、本地管理员账号、用户分组配额、多存储策略(本地磁盘 / 阿里云 OSS / S3 兼容对象存储)、PicGo 兼容上传 API、回收站与统计看板。单容器双端口部署,前端嵌入 Go 二进制。
- 认证:标准 OIDC(Authorization Code + PKCE S256,后端代理 token 交换,兼容 Logto / Authentik / Keycloak 等任何规范 IdP)或本地 bcrypt 管理员账号;RBAC(super_admin / admin / user)。OIDC 登录按钮的名称与图标可在后台自定义。
- 用户分组:分组决定「能用多少、能传什么、存到哪里」——总配额、单文件上限、格式白名单、可用存储策略、每小时上传频率。内置管理员组与默认组。
- 多存储策略:本地磁盘 / S3 兼容(阿里云 OSS 自动 endpoint 归一化与地域校验、MinIO、R2、COS 等);图片统一经应用读取并校验访问状态;密钥 AES-256-GCM 加密入库;一键连通性测试。
- 上传:Web 拖拽 / 粘贴 / 批量、PicGo 兼容 API 与 PicList 配置;sha256 内容去重、自动宽高解析、480px 缩略图、三种命名规则(保留原名 / 随机 / 日期目录)。
- 图片管理:图库筛选(相册 / 标签 / 类型 / 关键词)、直链 / Markdown / HTML / BBCode 复制、相册、标签、回收站(软删除 + 保留期自动清理)。
- 图片审核:管理员按上传者和访问状态查看全站图片,填写违规原因后限制公开访问;公开链接显示策略提示图,保留原文件,支持原图复核、批量审核和恢复访问。
- CDN 分发:默认使用配置的加速域名;审核、回收和恢复自动生成持久刷新任务,失败重试,显示全网同步状态。
- 看板:总量 / 用量 / 趋势 / 分组分布统计,审计日志。
- 初始化向导:首次启动在管理端完成 MySQL / Redis / 管理员身份 / 站点设置,无需手改配置文件;业务进程内热启用。
| 层 | 技术 |
|---|---|
| 后端 | Go、Gin、GORM、minio-go、go-redis |
| 前端 | React 19、TypeScript、Vite、5plus1-ui |
| 存储 | MySQL 8(业务数据)、Redis 7(可选:上传限流)、对象存储(图片) |
| 部署 | Docker / Docker Compose,单容器双端口 |
cp deploy/.env.example deploy/.env # 修改 MySQL 密码
# 本地构建
docker compose --env-file deploy/.env -f deploy/docker-compose.yml up --build -d
# 或预构建镜像
docker compose --env-file deploy/.env -f deploy/docker-compose.server.yml up -d启动后访问 http://127.0.0.1:18091 完成初始化向导。详细步骤、OIDC 回调地址配置、反向代理示例与故障排查见 deploy/DEPLOY.md。
| 端口 | 用途 | 建议 |
|---|---|---|
18090 |
公网:图片 /i/{key}、缩略图 /t/{key}、Token 上传 API |
对外开放 |
18091 |
管理端:SPA、管理 API、初始化向导 | 仅内网 / 反代 + 访问控制 |
- 管理端「API Token」创建 Token(
isl_...,仅创建时展示一次)。 - PicGo 自定义 Web 图床:URL
http://your-host:18090/api/v1/upload?picgo=1,HeaderAuthorization: Bearer isl_...,POST multipart,字段files。 - 响应
{"success":true,"result":[url]}。
# 后端
cd backend && go build ./... && go test ./...
# 前端(Vite 代理 API 到 127.0.0.1:18091)
cd frontend/admin && npm run dev # 开发
cd frontend/admin && npm run build # 类型检查 + 构建
# 部署配置
docker compose -f deploy/docker-compose.yml config前端构建产物在 Docker 构建时自动嵌入 backend/internal/web/admin;本地开发无需手动复制。
v0.1.0:认证 / 分组配额 / 多存储策略 / 上传访问 / PicGo / 相册标签 / 回收站 / 统计看板 / 初始化向导 / Docker 化 已全部实现并通过容器全链路验收。
Islet 采用 GPL-3.0-only。共享组件库 5plus1-ui 独立采用 MIT,随包提供对应源码与构建入口;第三方依赖遵循各自许可证,见 第三方声明。