现代化自托管图床系统，兼顾上传体验、存储灵活性与后台可控性。
基于 Vue 3 + Go 构建，适合个人站点、博客、团队内容管理和多存储备份场景。
在线演示 · API 文档 · 作者主页 · 赞助支持 · QQ 群
OneImg 是一个功能完整的自托管图床与图片管理系统。它的核心目标不只是「能传图」，而是将上传、管理、访问、同步和存储切换整合成一套顺手的完整工作流。
相比传统图床方案，OneImg 在以下几个维度上做了更深的设计：
- 自托管可控：数据完全掌握在自己手中，避免平台绑定与服务关停风险
- 多存储统一管理：同时接入本地磁盘、对象存储和第三方通道，一套界面管理所有存储后端
- 链接稳定可迁移：图片 URL 可长期保持不变，底层存储随时切换或扩展，对访问方完全透明
- 完整后台能力：用户体系、权限控制、标签分类、容量统计、系统配置一应俱全
适用场景：个人博客与技术站点图床、团队文档配图管理、需要数据可控的自托管图片服务、以及希望将本地存储与对象存储/Telegram/FTP/WebDAV 统一纳入管理的环境。
支持多种上传方式，覆盖日常内容生产的全部习惯：
- Ctrl+V 剪贴板粘贴：截图后直接粘贴即传，无需额外操作
- 拖拽上传：将图片拖入上传区域即可
- 批量选择：一次选择多张图片，配合实时进度条
- URL 远程上传：输入图片链接，服务端拉取后入库
- 支持格式：JPEG / PNG / GIF / WebP / SVG / BMP
支持 6 种存储后端，可按需组合使用：
| 存储类型 | 说明 |
|---|---|
| 本地磁盘 | 默认存储，数据直接落盘 |
| S3 兼容 | 支持 Cloudflare R2、阿里云 OSS 等 S3 协议存储 |
| FTP | 传统 FTP 服务器 |
| WebDAV | 支持 Nextcloud、坚果云等 WebDAV 服务 |
| Telegram | 通过 Telegram Bot 将图片发送到频道/私聊 |
核心设计理念：
- 稳定链接：每张图片拥有固定 URL，不因存储切换而改变
- 访问源切换：不换链接即可切换实际读取的存储副本，方便在多个存储间调度
- 多存储同步：本机与远程存储可协同工作，一张图可同时存在于多个存储后端
- 故障自动回退：远程源停用时，已选该源的图片自动回退到本机读取，不中断服务、不删除文件
从登录到存储，多层防护组合使用：
- POW 工作量证明登录：暴力破解成本指数级提升，有效抵御自动化攻击
- AES-256-GCM 图片加密：支持全部存储后端，加密后的文件即使泄露也无法直接查看
- Session 会话管理：超时自动失效，防止会话劫持
- 密码 bcrypt 加密：拒绝明文存储，符合安全最佳实践
- 配置加密：敏感配置项（如存储密钥）支持加密存储
如果启用了图片加密存储，请务必妥善保管
CONFIG_SECRET。更换或丢失该密钥会导致历史加密内容无法正常解密。
提供完整的 Web 管理界面，所有操作集中在一处完成：
- 图片管理：列表浏览、详情查看、标签分类、批量删除
- 用户与权限：多用户体系，按角色分配操作权限
- 存储管理：各存储后端状态监控、容量统计、同步状态追踪
- 系统设置：全局配置、安全策略、上传限制等
- 数据概览：仪表板实时展示上传量、存储用量等关键指标
- 深色 / 浅色主题无缝切换
- 全响应式布局，移动端友好
- 流畅过渡动画，操作反馈明确
现代化后台布局，覆盖上传、图库、标签、存储管理、用户权限与系统设置等核心场景。
几分钟即可跑起来，适合先本地体验，再逐步接入对象存储或远程存储。
git clone https://github.com/onexru/oneimg.git
cd oneimg
docker compose up -d启动后访问 http://localhost:8080
docker run -d \
--name oneimg \
-p 8080:8080 \
-v /data/oneimg:/app/data \
--restart unless-stopped \
onexru/oneimg-oneimg账号：admin
密码：123456
首次部署后请立即修改默认密码，并根据实际环境调整
.env配置。
- Docker 20.10.0+
- Docker Compose v2.0.0+
建议挂载以下目录以保证数据安全：
| 目录 | 用途 |
|---|---|
./data |
数据库与系统配置 |
./uploads |
本地上传文件 |
支持三种数据库：
- sqlite （默认）
- mysql
- postgres
修改数据库在
.env内DB_TYPE配置
使用 Telegram 作为存储后端时，需要获取 Telegram User ID：
向机器人 @userinfobot 发送 /start，即可获取你的 ID。
通过环境变量或项目根目录下的 .env 文件进行调整，关键配置项包括存储后端凭证、安全策略、上传限制等。
项目全程免费开源、持续稳定维护，若本项目对你有帮助，欢迎点亮 ⭐ Star 支持开源，也可通过打赏通道助力作者持续优化迭代！
欢迎加入官方技术交流群，反馈使用问题、提出优化建议、交流部署与二次开发经验！