Foxel Logo
Foxel - 智能图像检索与管理系统

核心功能 部署 适配存储 贡献

Foxel 是一个基于 .NET 9 开发的现代化智能图像检索与管理系统,集成先进的 AI 视觉模型向量嵌入技术,提供高效的图像搜索与管理功能。

## 🌐 社区交流 加入我们的社区,与其他用户交流使用心得,获取技术支持,参与项目讨论: | 平台 | 群组信息 | 联系方式 | |:----------:|:------------------|:-----------------| | 💬 **QQ群** | **群名:** Foxel 小狐狸 | 群号:458449115 | | 📱 **微信群** | **群名:** Foxel 小狐狸 | 添加微信:drizzle2001 | > 💡 **社区规则:** > - 保持友善,互相帮助 > - 发布问题时请提供详细信息 > - 禁止发布与项目无关的广告内容 > - 遵守各平台社区准则 --- > 🖥️ **在线演示:** > 访问 [https://foxel.cc](https://foxel.cc) 体验 Foxel 部分功能。 > 管理员账号:`demo@foxel.cc` 密码: `foxel_demo` > ⚠️ **注意:演示环境数据可能不定期清理,请勿存放重要信息。** --- ## ✨ 核心功能 | 功能模块 | 主要特性 | |:----------|:------------------------------------| | 🤖 智能图像检索 | - 基于 AI 的图像内容检索与相似度匹配
- 快速定位目标图片 | | 🗂️ 图像管理 | - 支持图片分类、标签管理、批量操作
- 多分辨率与格式化处理 | | 🖼️ 图床功能 | - 图片上传、存储与分享
- 支持多种链接格式,访问权限灵活控制 | | 👥 多用户支持 | - 用户注册、登录、权限与分组管理 | | 💬 轻社交功能 | - 点赞、评论、分享 | | 🔗 第三方登录 | - 支持 GitHub、LinuxDo 等第三方账号快捷登录 | --- ## 🚀 部署指南 ### 📋 前提条件 - 已安装 [Docker](https://www.docker.com/)。 ### ⚙️ 一键部署 1. **拉取并运行容器** ```bash docker run -d -p 80:80 --name foxel \ -v /path/to/uploads:/app/Uploads \ -e 'DEFAULT_CONNECTION=Host=foxel;Username=foxel_dev;Password=foxel;Database=foxel_dev' \ --pull always \ ghcr.io/drizzletime/foxel:dev ``` > ⚠️ **重要提示:** > 请根据您的实际配置替换上述命令中的参数: > > **数据库连接配置 (`DEFAULT_CONNECTION`):** > - `Host`:数据库主机地址 > - `Username`:数据库用户名 > - `Password`:数据库密码 > - `Database`:数据库名称 > > **端口映射配置 (`-p`):** > - `-p 80:80`:将容器的 80 端口映射到主机的 80 端口 > - 可根据需要修改为其他端口,如 `-p 8080:80` > > **数据挂载配置 (`-v`):** > - `-v /path/to/uploads:/app/Uploads`:将主机目录挂载到容器的上传目录 > - 请将 `/path/to/uploads` 替换为您希望存储图片的实际主机路径 2. **访问服务** 打开浏览器访问 `http://localhost` 或您的服务器 IP 地址即可使用 Foxel。 3. **获取管理员权限** 容器启动后,第一个注册的用户将自动获得管理员权限。 > ⚠️ **注意:** > Foxel 目前处于早期实验阶段,数据库结构和各项功能仍在持续迭代中,未来版本可能会有**较大变动**。建议在生产环境使用前充分测试,并关注项目更新动态。 > ⚠️ **注意:** > Foxel 依赖 PostgreSQL 数据库,并需要在数据库中启用 [vector 扩展](https://github.com/pgvector/pgvector)。 > 请确保您的 PostgreSQL 实例已正确安装并启用 `vector` 扩展,否则安装失败。 --- ## 📖 适配存储 Foxel 提供多种存储后端选择,满足不同场景下的部署需求: - 📁 本地存储 - 📡 Telegram Channel - ☁️ Amazon S3 - 🔐 Tencent Cloud COS - 🌐 WebDAV 未来将持续适配更多主流云存储平台,欢迎社区贡献新的存储适配器! --- ## 🤝 贡献指南 我们欢迎所有对 Foxel 感兴趣的开发者加入贡献,共同改进和提升这个项目。 | 步骤 | 说明 | |:------------:|:--------------------------------------------------------------------------------------------| | **提交 Issue** | - 发现 Bug 或有建议时,请提交 Issue。
- 请详细描述问题及复现步骤,便于快速定位和修复。 | | **贡献代码** | - Fork 本项目并创建新分支。
- 遵循项目代码规范。 | | **功能扩展** | - 欢迎参与以下重点功能开发:
• 更智能的图像检索算法
• 增强社交互动
• 云存储/网盘集成
• 更多智能图像处理方法(如自动标注、风格迁移、图像增强等) | 如有任何疑问或建议,欢迎通过 Issue 与我们联系。感谢您的贡献! --- ![Star History Chart](https://api.star-history.com/svg?repos=DrizzleTime/Foxel&type=Date)

MIT License 感谢